protowire-python

proto) schemas. It addresses the challenges of data serialization by supporting three distinct wire formats—PXF (Proto eXpressive Format) for human-readable text, the standard protobuf binary wire format, and SBE (Simple Binary Encoding) for low-latency binary applications. The system enables users to serialize and deserialize messages in any of these formats using the same schema, eliminating the need to learn a new schema language and ensuring type-checking, versioning, and wire compatibility across formats.

A notable feature of ProtoWire is its ability to distinguish between set, null, and absent field states, which is particularly useful for PATCH semantics and configuration inheritance. The PXF text format is designed to be both readable and expressive, allowing for assignments, blocks, lists, and maps within a consistent syntax. It also supports multiple comment styles and triple-quoted strings for preserving multi-line content. ProtoWire includes support for inlining well-known types such as RFC 3339 timestamps and Go-style durations directly in the text format, making it easier to write and read configuration data.

proto file. Required fields and default values can be annotated directly in the schema, and the decoder will enforce these constraints, rejecting documents missing required fields and applying defaults only to absent fields, not to fields explicitly set to null or to the proto3 zero value. The system also provides features for handling repeated messages, integer maps, and oneof constructs with nested choices.

For data transfer and system integration, ProtoWire introduces the @dataset directive, which allows for row-oriented bulk data with declared types, addressing common issues found in CSV-based data handoff. By pairing @dataset with @proto, the schema travels with the data, ensuring that producers and consumers are aligned on data structure before parsing begins. This approach helps prevent data bugs related to ambiguous types or missing schema information. The tool is suitable for users who require robust, schema-driven serialization for configuration, data exchange, or system integration scenarios.