mirror of
https://github.com/protocolbuffers/protobuf
synced 2026-08-26 02:23:14 -04:00
Add custom option numbers for use by ProtoWire (#28919)
Reserves a contiguous block of custom option numbers — **1314–1363** — for **ProtoWire** (https://protowire.org), an open interchange stack (text/binary codecs, schema-extension compiler, validation engine) built on protobuf descriptors.
> **2026-08-02 update:** originally requested as 1311–1360; rebased and shifted to **1314–1363** after #28790 (proto2mcp, 1311–1313) merged while this PR was awaiting merge post-approval. No other changes.
### This re-files #27290
#27290 was **approved** by @esrauchg and then closed automatically, not on the merits: its head fork was deleted during an account migration on my side, which GitHub treats as closing the PR. It cannot be reopened, because the head repository no longer exists. Apologies for the churn — this PR is the same one-line-per-entry change, rebased onto current `main`.
The content is unchanged from the approved state apart from the start number; `1314–1363` is free (the registry currently ends at `1313`, proto2mcp).
### Why a block of 50
Per @haberman's request on the original PR, the entry was moved off the contested number and starts after the ranges claimed in the meantime (1307–1313: proto2type, protoc-gen-openapi, Motif, Teleport, proto2mcp).
Since the first version of the request (10 numbers for two annotation groups), the project's published option surface has grown to five orthogonal families, all currently parked in the internal 50000+ space and being migrated to registered numbers ahead of an IETF draft submission:
| Family | Extendees | In use | Growth headroom |
| --- | --- | --- | --- |
| PXF text-format annotations (`pxf.*`) | FieldOptions | 3 | +2 |
| SBE binary-format annotations (`sbe.*`) | File/Message/FieldOptions | 5 | +5 |
| Schema-extension carriers (`protowire.schema.v1.*`) | all 8 Options messages (one shared number) + FileOptions | 5 | +5 |
| Validation constraints (`protocheck.*`) | Field/Message/OneofOptions | 3 | +5 |
| OpenAPI generation options | Method/ServiceOptions | 0 | +5 |
That's 16 numbers in active published use with a documented path to ~40, hence the request for 50.
Happy to trim if that exceeds what you're comfortable granting in one row — same offer as on the original PR.
Closes #28919
COPYBARA_INTEGRATE_REVIEW=https://github.com/protocolbuffers/protobuf/pull/28919 from trendvidia:protowire-options-range a3d24a95ff
PiperOrigin-RevId: 961811298
This commit is contained in:
parent
eed5007774
commit
c27007fc25
1 changed files with 5 additions and 0 deletions
|
|
@ -594,6 +594,11 @@ about your project (name and website) so we can add an entry for you.
|
|||
* Website: https://github.com/protocgen/proto2mcp
|
||||
* Extensions: 1311-1313
|
||||
|
||||
1. ProtoWire
|
||||
|
||||
* Website: https://protowire.org
|
||||
* Extensions: 1314-1363
|
||||
|
||||
1. Flyte
|
||||
|
||||
* Website: https://github.com/flyteorg/flyte
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue