Compiler¶
The bitproto compiler generates language-specific code, which provides the encode and decode api functions.
Installing the compiler¶
The bitproto compiler is written in Python, and requires Python3.7+ to work, it’s best to be installed via pip:
$ pip install bitproto
This will install a command named bitproto
to your system, you can check it’s version after the installation:
$ bitproto -v
bitproto v0.4.2
If you’re new to Python, or wish to skip a Python installation, you can download the compiler from this download link directly, there provides the prebuilt one-file executables for Mac OS, Windows and Linux, which works without having to install a Python3.7+.
Upgrade the compiler¶
To upgrade bitproto via pip
:
$ pip install -U bitproto
Command line usage¶
Generates code for given language:
$ bitproto c proto.bitproto
$ bitproto go proto.bitproto
$ bitproto py proto.bitproto
It generates language-specific codes to current directory by default, to specify a output directory:
$ bitproto c proto.bitproto outs/
Validates bitproto source file syntax, exits with a non-zero code if any syntax wrongs:
$ bitproto -c proto.bitproto
The compiler won’t generate files but only run a protocol syntax checking if -c option is given.
By default, the compiler runs a simple protocol linter, which gives warnings if the given bitproto file doesn’t meet the Style Guide, to disable the linter:
$ bitproto c proto.bitproto -q