编译器¶
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