编译器

bitproto 的编译器用来解析 bitproto 的源文件,然后生成目标语言的代码。

安装编译器

bitproto 的编译器使用 Python 编写,依赖 Python3.7+ ,最佳的安装方式是通过 pip

$ pip install bitproto

上面的命令会安装一个叫做 bitproto 的命令行工具,你可以在安装后查看下它的版本信息:

$ bitproto -v
bitproto v0.4.2

如果你对 Python 不熟悉,或者希望跳过 Python 安装,可以直接进 这个下载链接 提供了预先打包好的单文件可执行程序,包含 Mac OS, Windows 和 Linux 的三个版本,这些打包好的程序无需安装 Python3.7+ 就可以使用。

升级编译器

要通过 pip 升级 bitproto 的编译器

$ pip install -U bitproto

命令行使用

给目标语言生成代码:

$ bitproto c proto.bitproto
$ bitproto go proto.bitproto
$ bitproto py proto.bitproto

默认地,它会把代码生成到当前目录,如果想指定一个生成目录:

$ bitproto c proto.bitproto outs/

仅仅检查 bitproto 的语法是否正确,如果语法错误,编译器会以一个非零的码退出:

$ bitproto -c proto.bitproto

如果 -c 选项传入,编译器只做语法检查,而不会进行代码生成。

默认地,编译器会执行一个简单的协议风格检查器,以检查是否符合 bitproto 推荐的 语法风格。如果需要禁用它:

$ bitproto c proto.bitproto -q