This repo contains the templates used by the webrpc-gen CLI to code-generate webrpc Swift client code.

gen-swift is client-only.

• It generates Swift client code and runtime helpers.
• It does not generate server handlers or server runtime code.
• Passing -server is rejected as an unsupported option.

gen-swift is not added to webrpc-gen as a built-in -target=swift target yet.

Use the Swift generator repo as the target instead:

webrpc-gen -schema=example.ridl -target=github.com/webrpc/gen-swift@latest -client -out=./ExampleClient.swift

Or point -target at a local checkout of this repo:

webrpc-gen -schema=example.ridl -target=./local-templates-on-disk -client -out=./ExampleClient.swift

Generated output includes:

• schema constants
• WebRPC header/version metadata helpers
• DTOs and enums
• transport/error helpers
• service metadata helpers
• high-level async client methods

The generated client targets Swift 5.9+. The built-in URLSession transport is intended for modern Apple concurrency platforms such as iOS 15+ and macOS 12+.

Low-level helpers remain visible:

• ServiceAPI.basePath
• ServiceAPI.Method.path
• ServiceAPI.Method.urlPath
• ServiceAPI.Method.encodeRequest(...)
• ServiceAPI.Method.decodeResponse(...)

This repo pins the published webrpc tool module in tools/go.mod using Go tool dependencies.

Use the pinned tools with:

go -C tools tool webrpc-gen
go -C tools tool webrpc-test

Use the fast generator/unit suite for normal development:

go test ./...

Run the shared Swift integration package separately when you want real generated Swift compilation and runtime coverage:

./Tests/test.sh

That script clears stale SwiftPM build artifacts, regenerates Tests/Sources/Generated/Generated.swift from Tests/test.ridl, and runs swift test against a shared SwiftPM package.

The real external-schema integration remains available as an opt-in Go test:

WEBRPC_SWIFT_EXTERNAL_SCHEMA=1 go test ./...

CI runs the fast Go suite on every PR and push to master, and runs the shared Swift integration suite on macos-latest.