[AlexisMontagne]

Typed values like ownerships (company:42) and credential references (shopify:7) are turned into strings and back by code written by hand in each language: baseutil in Go, identity-thrift-utils and base-thrift-utils in Ruby. Those copies have drifted apart. This PR describes the text form once, in the IDL, with structured annotations, and adds Go and Ruby codecs that read them at runtime. Both codecs are checked against the same test cases, so they accept and produce exactly the same texts.

include "types/annotation/text.thrift"

@text.EnumFormat{"trim_suffixes": ["OAuth"], "accept_thrift_names": true}
enum CredentialType {
  @text.Name{"value": "gmail"}
  GoogleOAuth = 1,
  ShopifyOAuth = 4, // "shopify"
}

@text.Format{"pattern": "{type}:{id}"}
struct CredentialReference {
  1: required CredentialType type;
  2: required i64 id;
}

Annotations: types/annotation/text.thrift

• Format takes a python-like f-string pattern made of {field} placeholders and literal separators, with {{ and }} as escaped braces. Format specs and conversions are not supported.
• Name overrides the text of a single enum value.
• EnumFormat sets the defaults for an enum: a Case, trim_prefixes / trim_suffixes (the first match in list order is trimmed), and accept_thrift_names, which also accepts the thrift names such as Type_Company.
• Words are split on underscores, on case changes and at the end of acronyms, while keeping IDs whole. Camel and Pascal case render the Go initialisms.

Compiler:

• Enum values accept structured annotations (thrifty.yy).
• Plugins now receive the structured annotations; they used to get an empty list (t_serializer.h).
• Go generator:
  • Each enum gets a func (T) EnumDefinition() thrift.EnumDefinition holding the annotations of the enum and of its values.
  • Struct field definitions carry their Requiredness.
• Ruby generator: enum modules gain NAME, NAMESPACE, THRIFT_NAMES (the names as declared, since VALUE_MAP capitalizes them), the enum annotations, and VALUE_LEGACY_ANNOTATIONS / VALUE_STRUCTURED_ANNOTATIONS.
• JSON generator: enum values now include their annotations.
• TEnumIterator gains operator==, which fixes the build with recent libc++ on macOS.

Go: lib/go/thrift/types/annotation/text

• MarshalStruct, UnmarshalStruct[T], MarshalEnum and UnmarshalEnum[E].
• Struct[T] and Enum[E] wrappers for JSON, SQL and flags.
• Validate reports invalid annotations, for use in tests.
• CompileStruct and CompileEnum work from definitions only, for dynamic callers such as tcurl or an MCP gateway.
• The pattern and caser code live in internal packages. internal/goinitialism is now the single Go initialisms list, shared with gocodegen, whose output doesn't change.

Ruby: Thrift::Types::Annotation::Text, loaded by require 'thrift'

• dump / load, dump_enum / load_enum and validate.
• Errors are subclasses of ArgumentError.

Plugin helpers:

• thrift.FindAnnotations[T].
• value.DecodeValue, which decodes a structured annotation value into its generated type.
• Runtime() on AnnotationDefinition, EnumDefinition and StructDefinition, which convert plugin definitions into the runtime ones. With these, a plugin can validate annotations with text.CompileEnum / text.CompileStruct.

Tests:

• test/TextTestCases.json holds the cases shared by the Go tests and the Ruby spec.

• test/TextTest.thrift is generated by the lib/go/test and lib/rb test pipelines. Both use THRIFT_TYPES_PATH, so the generated code imports the annotations the way consumer code does.

• Did you create an Apache Jira ticket? (not required for trivial changes)

• If a ticket exists: Does your pull request title follow the pattern "THRIFT-NNNN: describe my issue"?

• Did you squash your changes to a single commit? (not required, but preferred)

• Did you do your best to avoid breaking changes? If one was needed, did you label the Jira ticket with "Breaking-Change"?

• If your change does not involve any code, add [skip ci] at the end of your pull request to free up build resources.

Notes:

• The generated code of every program changes, but only by addition: Go enums get EnumDefinition(), Go struct fields get Requiredness, Ruby enums get the new constants, and JSON enum values get annotation keys.
• One edge case in Ruby: an enum with a value literally named NAME, NAMESPACE or THRIFT_NAMES would collide with the new constants.
• Committed stubs aren't regenerated. Only the text stubs are new; the other stubs under lib/ (rpc, program_definition…) will gain EnumDefinition() on their next regeneration.
• Two Ruby specs already fail on master: json_protocol_spec.rb "pretty print union" and "pretty print union with a container field". They fail the same way with code from the released v2.7.14 compiler.
• Follow-ups once this is released:
  • upfluence-if switches to types/annotation/text.thrift and drops its text-codec plugin.
  • The baseutil, identity-thrift-utils and base-thrift-utils serializers delegate to the codecs.
  • tcurl accepts text forms as input.