ahamez/protox
72.6
Strong · 15 November 2026
5.8k
lines of production code
Elixir
primary language
5
measurements over time
What this system is
Features
Add manual schema definitions for Google Protobuf well-known types
The library now includes explicit \MessageSchema\ definitions for Google Protobuf well-known types (such as \Any\, \Timestamp\, \Duration\, \FieldMask\, \Struct\, \Value\, and various scalar wrapper types like \BoolValue\ and \Int32Value\) in \lib/google/protobuf\. These files define the structure of these standard types using the internal \Protox.Define\ DSL, enabling the library to recognize and handle these specific message types during encoding and decoding operations.
lib/google · high confidence
Expanded benchmark schema coverage with synthetic and vendor datasets
The benchmark harness now includes a broader set of Protocol Buffer schemas to provide more realistic and isolated performance measurements. This adds synthetic message definitions (protox.benchmark.synthetic\_5 through synthetic\_200) designed to test specific encoding paths, such as deep nesting, map-heavy structures, and edge cases like NaN/Infinity or negative varints. Additionally, the harness vendors external benchmark datasets from Google (proto2 and proto3), OpenTelemetry (v1.7.0 trace protocol), and Prometheus (v3.6.0 remote-write), with the Prometheus schemas modified to remove unsupported gogo.proto annotations to ensure compatibility.
benchmark/protos · high confidence
New Mix task to build and run the protobuf conformance test runner
A new Mix task, \Mix.Tasks.Protox.Conformance\, has been added to the \conformance/mix\ directory. This task automates the process of downloading, configuring, and building the C++ protobuf conformance test runner using CMake, and then executing it against the \protox\_conformance\ test suite. Users can control the verbosity of the build and test output via a \--quiet\ flag, force a rebuild of the runner with \--force-runner-build\, or stop after compilation using \--compile-only\. The task handles resolving the runner path, ensuring the binary exists, and reporting success or failure based on the runner's exit code.
conformance/mix · high confidence
New conformance test runner escript for protobuf validation
A new escript (\Protox.Conformance.Escript\) has been added to serve as the execution target for the protobuf conformance test suite. This tool reads conformance test requests from standard input, decodes them using the \Conformance.ConformanceRequest\ schema, and processes them by decoding the payload (currently supporting only protobuf input), re-encoding the message via \Protox.encode!()\, and writing the result back to standard output. It generates detailed text reports in a \conformance\_report\ directory, capturing parse successes, serialization errors, and skipped tests (such as those involving JSON or text formats, which are currently unsupported). The runner specifically handles \TestAllTypesProto2\ and \TestAllTypesProto3\ message types to validate encoding/decoding behavior against the official protobuf conformance standards.
conformance/protox · high confidence
New mix task to generate Elixir code from Protobuf definitions
A new \mix protox.generate\ task is now available, allowing users to generate Elixir code directly from \.proto\ files via the command line. The task supports specifying an output path, multiple include paths for dependencies, a namespace prefix for generated modules, and a \--multiple-files\ option to split output into separate files per module for improved parallel compilation.
lib/mix · high confidence
Architecture
Introduce standardized development tooling and configuration
The repository now includes explicit configuration files for code formatting (\.formatter.exs\ with the Quokka plugin), linting (\.credo.exs\), and static analysis (\.dialyzer\_ignore.exs\), alongside a \coveralls.json\ for coverage reporting. These files establish a consistent coding style and quality-checking pipeline for the project, supported by new \AGENTS.md\ and \CONTRIBUTING.md\ documentation that outlines the required development commands and standards.
(repo-wide) · high confidence
Behavioural changes
Benchmark harness restructured with configurable mix tasks and realistic value profiles
The benchmarking tooling has been refactored into a dedicated mix task (\mix protox.benchmark.run\) that allows users to specify tasks (encode/decode), control run durations, and tag results for comparison. A new corpus of benchmark payloads is generated using a \RealisticValues\ profile, which produces production-like data distributions (e.g., specific integer ranges, ASCII strings, and binary sizes) rather than the edge-case heavy profiles used in testing. The harness now compiles a broader set of synthetic and vendor protobuf schemas (including OpenTelemetry and Prometheus) to provide more comprehensive performance measurements.
benchmark · high confidence
Enforce commit signature verification on push
The pre-push hook now validates that all commits not yet pushed to the remote are cryptographically signed. If unsigned commits are detected, the push is blocked with an error message, ensuring that only signed history is shared.
.lefthook · high confidence
Expanded benchmark payload generation with real-world datasets
The benchmark harness now generates a broader set of test payloads, including specific inputs for OpenTelemetry traces and Prometheus write requests, alongside existing synthetic schemas. It also incorporates real captured payloads from Google's benchmark suite to ensure more realistic encoding and decoding measurements.
benchmark/mix/tasks/protox/benchmark/generate · high confidence
Protox v2 code generation with compile-time version mismatch detection
The library now generates code using generator version 2, introducing a compile-time check that raises an error if the runtime version of Protox does not match the version used to generate the protobuf modules. This ensures compatibility between the generated structs and the runtime library, preventing silent failures due to version drift.
lib · high confidence
Protox v2: Complete code generation rewrite with compile-time schema validation
The \lib/protox\ library has been rewritten for version 2, replacing the previous runtime-based code generation with a new compile-time architecture. The library now uses a \Protox.Define\ macro to generate Elixir structs, encoders, and decoders directly from \Protox.MessageSchema\ definitions at compile time, significantly improving performance and reducing runtime overhead. This change introduces a strict version check in generated modules to prevent incompatibility between the generated code and the runtime library. Additionally, the new implementation enforces Protobuf 3 field presence semantics, changes the unknown fields struct key to \\_\uf\\_\, and removes the deprecated \Protox.Encoder.encode/1\ API in favor of the new \encode/1\ and \encode!/1\ functions that return \{:ok, iodata(), size}\ tuples.
lib/protox · high confidence
Refactored benchmark harness with separate run and report tasks
The benchmarking workflow has been restructured into two distinct Mix tasks: \mix protx.benchmark.run\ and \mix protx.benchmark.report\. The run task now handles execution with configurable options for warmup, time, and profiling scopes (time, memory, calls), while the report task is responsible for generating console and HTML outputs from saved Benchee data. This separation allows users to run benchmarks with specific configurations and generate reports independently, improving flexibility and clarity in the benchmarking process.
benchmark/mix/tasks/protox/benchmark · high confidence
Removal of legacy config/config.exs file
The project has removed the main \config/config.exs\ file, which previously contained boilerplate comments and configuration for dependencies like \protox\ and \logger\. This change indicates a shift in how application configuration is managed, likely moving towards environment-specific config files or configuration defined directly in \mix.exs\, as suggested by the comments in the deleted file.
config · high confidence
Test coverage
Added property-based test infrastructure using StreamData; Added sample .proto files for testing; Expanded test coverage for Protox decoding, encoding, and generation; Expanded test coverage for code generation, conformance, and protocol features.
Dependencies
Major version upgrade to 2.1.0 with Elixir 1.15 requirement and dependency overhaul
The library has been upgraded to version 2.1.0, raising the minimum supported Elixir version from 1.3 to 1.15. This release replaces the legacy \varint\ dependency with the \protobuf\ library (pulled from the official protocolbuffers GitHub repository) and removes \Poison\ support entirely, shifting to a model where JSON encoding/decoding is no longer built-in. Development tooling has been significantly updated: \credo\ is now restricted to dev/test with \runtime: false\, \dialyxir\ configuration uses the new \plt\_local\_path\ option, and \muex\ replaces \muzak\ for mutation testing. The package metadata has also been expanded to include a description, source URL, and explicit license information.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 71 → 73 (+2.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 98 → 98 (-0.3)
- Architecture 100 → 100 (+0.0)
- Maturity 62 → 67 (+5.2)
- Readiness 67 → 67 (+0.0)
- Security 94 → 90 (-3.9)
- Performance 80 → 80 (+0.0)
New (4)
- Edited copies of one member (3 members, 1+ corresponding lines) (lib/protox/varint.ex)
- Edited copies of one member (3 members, 2+ corresponding lines) (lib/protox/varint.ex)
- Edited copies of one member (4 members, 4+ corresponding lines) (lib/protox/varint.ex)
- Edited copy of a member (1 corresponding lines) (lib/protox/varint.ex)
Changes since last survey
- 2 commits — 2 feature/other, 0 fixes
By area
- (root) — 2 commits
Notable commits
- change: chore(deps-dev): bump muex from 0.12.0 to 0.13.0 (#321)
- change: chore(deps-dev): bump muex from 0.13.0 to 0.13.1 (#322)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
ahamez/protox was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 1ac59f98479beb1d2a465ae2d31fcc9079559e18 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.