NeTEx Protobuf definitions

This project contains setup to generate Protocol Buffers Definition files (.proto files) from the NeTEx XML schema.

The conversion is done using schema2proto and configuration netex_to_protobuf_config.yaml

Based on a copy of https://github.com/entur/NeTEx/commit/55cd207e7b6d49ea0aa2905fd4adee1241bad6cb (v1.11) (no tag or release exist yet)

Backwards compatibility check is handled by protolock (https://github.com/nilslice/protolock) and called from Maven via plugin proto-backwards-compat-maven-plugin (https://github.com/salesforce/proto-backwards-compat-maven-plugin).

Building

mvn clean install

NOTE: There is a Maven profile protoc which is active by default. This profile performs Java compilation of the generated stubs, and is meant only as a step to verify that the protoc compiler can handle the resulting proto. The compilation step is heavy. To run without use

mvn clean install -P'!protoc'

Handling breaking changes

If breaking changes needs to be accepted into the proto.lock file, run the following command to update it (do not delete as schema2proto needs the file for backwards compatibility check as well)

protolock commit --force --protoroot target/proto/