Skip to content

Conversation

@Ericson2314
Copy link
Member

@Ericson2314 Ericson2314 commented Nov 7, 2025

Motivation

This makes the proto serializer characterisation test data be
accompanied by JSON data.

This is arguably useful for a reasons:

  • The JSON data is human-readable while the binary data is not, so it
    provides some indication of what the test data means beyond the C++
    literals.

  • The JSON data is language-agnostic, and so can be used to quickly rig
    up tests for implementation in other languages, without having source
    code literals at all (just go back and forth between the JSON and the
    binary).

  • Even though we have no concrete plans to place the binary protocol 1-1
    or with JSON, it is still nice to ensure that the JSON serializers and
    binary protocols have (near) equal coverage over data types, to help
    ensure we didn't forget a JSON (de)serializer.

Context

JSON cleanup #13570

Depends on #14502
Depends on #14503


Add 👍 to pull requests you find important.

The Nix maintainer team uses a GitHub project board to schedule and track reviews.

@Ericson2314 Ericson2314 requested a review from edolstra as a code owner November 7, 2025 04:41
@github-actions github-actions bot added documentation new-cli Relating to the "nix" command with-tests Issues related to testing. PRs with tests have some priority labels Nov 7, 2025
@dpulls
Copy link

dpulls bot commented Nov 10, 2025

🎉 All dependencies have been resolved !

@Ericson2314 Ericson2314 force-pushed the json-along-side-rpc-proto-test-data branch 2 times, most recently from fc24ed5 to f8ca0f7 Compare November 10, 2025 23:31
This makes the proto serializer characterisation test data be
accompanied by JSON data.

This is arguably useful for a reasons:

- The JSON data is human-readable while the binary data is not, so it
  provides some indication of what the test data means beyond the C++
  literals.

- The JSON data is language-agnostic, and so can be used to quickly rig
  up tests for implementation in other languages, without having source
  code literals at all (just go back and forth between the JSON and the
  binary).

- Even though we have no concrete plans to place the binary protocol 1-1
  or with JSON, it is still nice to ensure that the JSON serializers and
  binary protocols have (near) equal coverage over data types, to help
  ensure we didn't forget a JSON (de)serializer.
@Ericson2314 Ericson2314 force-pushed the json-along-side-rpc-proto-test-data branch from f8ca0f7 to 2047492 Compare November 10, 2025 23:32
@dpulls
Copy link

dpulls bot commented Nov 11, 2025

🎉 All dependencies have been resolved !

@Mic92 Mic92 added this pull request to the merge queue Nov 11, 2025
Merged via the queue into NixOS:master with commit 091c0a9 Nov 11, 2025
16 checks passed
@Ericson2314 Ericson2314 deleted the json-along-side-rpc-proto-test-data branch November 11, 2025 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation new-cli Relating to the "nix" command with-tests Issues related to testing. PRs with tests have some priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants