The RNTuple Validation Suite provides conformance tests for the RNTuple Binary Format Specification. The goal is to cover all parts of the specification with implications on the format. It can be used to validate both writer and reader implementations of the RNTuple specification. To that end, each test comes with a written description of the schema and the expected data. Reference files for version 1.0.0 can be found under the GitHub Release.
Tests in the RNTuple Validation Suite are organized into (nested) categories.
This is mirrored by the hierarchical directory layout in the repository.
For example, the types directory contains tests related to type support in the RNTuple specification.
It has subdirectories for tests concerning fundamental types and C++ types, for example std::vector.
More tests are planned in the future, please consult the list of issues in the GitHub repository.
This repository also contains a reference implementation with ROOT macros.
They target the stable API released with ROOT v6.36 and should work on newer versions.
Compatibility with ROOT v6.34 can be tested with version v1.0 of the RNTuple Validation Suite.
It was the first official version of the RNTuple on-disk binary format, but the API was not yet finalized and all classes were in the ROOT::Experimental namespace.
For each test, we implement a write.C and read.C macro in the corresponding subdirectory.
The write.C macro produces a .root file with the contents as described in the README of each test subdirectory.
The read.C macro produces a .json file with a human-readable representation of the data in the .root file.
They can be run individually or all at once with make using the top-level Makefile.
The latter is also exercised by a GitHub Actions Workflow:
The job also uploads the produced set of .root and .json files, which can be downloaded from the Summary page.