Skip to content

Proposal (draft): named connections - #185

Merged
Kinflou merged 2 commits into
mainfrom
proposals/named-connections
Nov 15, 2026
Merged

Kinflou merged 2 commits into
mainfrom
proposals/named-connections

Conversation

@Kinflou

@Kinflou Kinflou commented Nov 15, 2026

Copy link
Copy Markdown
Member

Draft proposal, not for merge: nothing in it is decided. Every choice is an open question for the user.

A package gets exactly one connection today (one Services, ClientServices, accept, serve, connect and Connection<T>). This proposal sets out letting a package declare several named sets of protocols, each generating entry points of its own, against keeping one connection per package and one package per application. It develops the declared set that Connections decision 2 (2026-10-20) left unbuilt.

Pages, under docs/docs/proposals/named-connections/:

  • index.md: the question, where things stand (checked against the docs, generation and the runtime), a comparison table, 15 numbered open questions, and what it touches.
  • options.md: Option 0 (status quo, Proposal C's model), 1 (sets in the manifest, in config.idp or comline.toml), 2 (a connection block or an annotation), 3 (a world-like declaration that can name dependency protocols, tying into Proposal A); what each generates and checks, versioning, tools, migration.
  • prior-art.md: protoc and Buf, gRPC and tonic, Thrift, Cap'n Proto, Smithy, WIT, FIDL and Mojo, each claim with its source.

Also lists it in proposals/index.md (Connections, with the other drafts) and in the mkdocs.yml nav.

The strict build job is the check; mkdocs was not built locally.

Kinflou added 2 commits November 15, 2026 11:42
Draft. Lays out one connection per package (with a package per application)
against named sets declared in the manifest, in the IDL, or by a world-like
declaration, with prior art. Every choice is an open question.
@Kinflou
Kinflou marked this pull request as ready for review November 15, 2026 12:04
@Kinflou
Kinflou merged commit 7071710 into main Nov 15, 2026
8 checks passed
@Kinflou
Kinflou deleted the proposals/named-connections branch November 15, 2026 12:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant