catbuffer-parser 1.0.0a1

Symbol Catbuffer Parser

catbuffer

The catbuffer library defines the protocol to serialize and deserialize Symbol entities. Code generators from the catbuffer-generators project can then produce the leanest code necessary to serialize and deserialize those entities.

Using catbuffer-generators, developers can generate builder classes for a given set of programming languages. For example, the Symbol SDKs use the generated code to interact with the entities in binary form before announcing them to the network.

The schemas folder contains definitions for each entity's data structure. These definitions are always kept up to date and in sync with the catapult server code.

Requirements

• Python >= 3.4

Installation

1. Clone the catbuffer-parser repository:

git clone https://github.com/nemtech/catbuffer-parser

2. (optional) Install lint requirements:

pip3 install -r lint_requirements.txt

Usage

python3 -m catbuffer_parser [OPTIONS]

Option	Description	Default
-s, --schema TEXT	Input CATS file
-o, --output TEXT	Output directory	_generated
-i, --include TEXT	Schema root directory	./schemas
-g, --generator TEXT	Generator to use to produce output files (see the available generators).
-c, --copyright TEXT	File containing copyright data to use with output files.	../HEADER.inc

Examples

In order to produce any output file, the catbuffer-generators project is needed. Please see this project's usage examples.

However, catbuffer-parser can still be used on its own to parse input files and check their validity:

git clone --depth 1 --branch v1.0.0 https://github.com/nemtech/catbuffer-schemas.git
python3 -m catbuffer_parser --schema catbuffer-schemas/schemas/transfer/transfer.cats --include catbuffer-schemas/schemas

There is also a script in the scripts folder to parse and validate all schemas:

scripts/generate_all.sh