Boson是一个语法分析器生成器（也能生成词法分析器）。采用自有的Boson脚本（Boson Script）来定义语法和词法， Boson根据输入的脚本内容和命令参数生成相应的语法分析器及词法分析器的代码。
Boson需要Python3.10的运行环境。
Boson可通过pip命令安装或从源码进行安装：
pip install boson
从GitHub的代码仓库下载或克隆Boson的源代码，在源码根目录下执行：
python setup.py install或python3 setup.py install
命令进行安装。
安装Boson之后，在控制台输入boson即可运行Boson。
输入boson -h以查看Boson的简要的使用说明：
usage: boson [-h] [-o OUTPUT] [-l] [-q] boson_script_file
Boson v1.7 - Grammar Analyzer Generator
positional arguments:
boson_script_file Input Boson Script File.
options:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output Boson Code Path(Default Is `boson`).
-l, --log Enable Boson Log.
-q, --quiet Display Nothing.
Boson运行命令形式简单，可归纳为boson <Boson脚本文件> <其他各项参数>。
上述所列参数详细说明如下：
-
-h或--help，Boson将显示简要的使用说明。 -
-o或--output，该参数后跟输出代码文件的目录，默认为boson_output文件夹。 -
-l或--log，打开日志，日志会生成在当前目录下，文件名为Boson_{当前日期时间}.log。 -
-q或--quiet，安静模式，Boson运行时不输出任何信息。
Boson自身的部分代码也由Boson生成（该过程称为“自举（Bootstrap）”）。
boson/boson_script/boson_script_parser目录是由boson boson_script.boson -o boson_script_parser生成。
boson/lexer_generator/regular_parser文件是由boson regular.boson -o regular_parser生成。
上述命令中用到的boson_script.boson文件和regular.boson是两个Boson脚本文件，可在Boson源码的scripts目录找到。
Boson脚本可分为三部分：
- 命令。
- 词法定义。
- 语法定义。
这三部分在脚本编写时无顺序关系。
Boson脚本中有一个很重要的概念叫做“符号”，符号是字母、数字加下划线的组合（数字不能出现在首位）。 “符号”是命令、词法定义和语法定义的重要组成部分。
命令的结构较为简单，都为如下形式：
%命令 参数1 参数2 ...;
命令都以%符号开头，后面为合法的符号。
在命令名中，下划线命名和驼峰命名本质上是相同意义。例如%hello_world与%HelloWorld等价。
当前Boson版本仅有一个命令，即
%option命令。
%option命令用来配置改Boson Script的一些参数，包括分析器的算法、冲突解决策略、代码生成方式等。
%option命令的使用方式为：%option 配置信息。
其中配置信息为树形结构，其语法如下（根为attribute）：
attribute : '{' key_value_list '}';
key_value_list : key_value (',' key_value)* ','?;
key_value : name '=' attribute_value;
attribute_value : name | value_list | attribute | string | number;
value_list : '[' attribute_value (',' attribute_value)+ ','? ']';
指定了Boson的工作模式，Boson将根据不同的模式产生不同的代码或数据。
默认值为
integration
| 序号 | 参数 | 含义 |
|---|---|---|
| 1 | integration | 生成集成代码，分析表的数据将以数据结构集成至分析器代码中。（当前支持唯一模式） |
| 2 | table | 生成分析表，仅生成分析表数据，不生成任何代码，用于辅助开发。（暂不支持） |
| 3 | binary | 生成二进制分析表数据，用于载入通用分析器使用。（暂不支持） |
用法示例：
{
mode = 'integration'
}
配置分析器的相关参数，包括起始分析符号、分析算法、冲突解决。 参数包括：
start_symbol（起始分析符号），指定分析符号，以字符串表示，默认值为'start'。analyzer（分析算法），可选'slr'、'lr'、'lalr'分析算法，默认值为'lalr'。conflict_resolver（冲突解决器），其中包括enable、shift_reduce、reduce_reduce子参数。
其中conflict_resolver（冲突解决器）的子参数定义为：
enable（是否打开冲突解决器），可选True、False，默认值为False。shift_reduce（“移入-规约”冲突解决策略），可选'order'、'shift'、'reduce'，默认值为'order'。其中（1）'order'脚本顺序， 根据规约语句在脚本中的位置顺序觉得优先级，越靠前的优先级越高；（2）'shift'“移入”动作优先；（3）reduce“规约”动作优先。reduce_reduce（“规约-规约”冲突解决策略），可选'order'、'long'、'short'，默认值为'order'。其中（1）'order'脚本顺序， 根据规约语句在脚本中的位置顺序觉得优先级，越靠前的优先级越高；（2）'long'较长的规约式优先；（3）'short'较短的规约式优先。
用法示例：
{
parser = {
start_symbol = 'start',
analyzer = 'lalr',
conflict_resolver = {
enable = False,
shift_reduce = 'order',
reduce_reduce = 'order',
},
}
}
TODO: 还有一部分没写。
词法定义的结构为如下形式：
词法符号 : 正则表达式 [!] [@{ 词法函数列表 }];
词法符号为任意合法的符号。当词法符号以_（下划线）开头时，该词法定义将被视为隐藏定义，
不会纳入至最终的词法定义中，词法的隐藏定义通常用于正则表达式中的“引用”。
Boson的正则表达式由一对尖括号包围（<、>），起表达式结构对于词法定义进行设计和化简，基本语法与主流正则表达式相近。
Boson正则表达式支持语法如下：
-
字符串定义，任意普通字符组合的字符串， 例如
<boson>为匹配“boson”字符串。 -
区间定义，用短横线（
-）连接两个字符形成区间定义， 例如<0-9>为匹配“0123456789”中任意1个字符。 -
选择定义，用竖线（
|）分割的任意正则定义为选择定义， 例如<boson|Boson>为匹配“boson”或“Boson”字符串。 -
正闭包，在任意正则定义后面加入
+形成正闭包， 例如<a+>为匹配至少一个字符“a”。 -
克林闭包，在任意正则定义后面加入
*形成克林包， 例如<a*>为匹配若干个字符（可以为0个）字符“a”。 -
数量区间，在任意正则定义后面加入
{n,m}代表至少n个至多m个， 例如<a{2,3}>为匹配至少2个至多3个字符“a”。 -
可有可无，在任意正则定义后面加入
？代表要么只有1个要么是0个， 其效果与{0,1}等价，例如<a？>代表配1个字符“a”或没有字符“a”。 -
选择集，使用方括号包围（
[、]）的若干字符集（可含有区间定义）， 例如<[a-zA-Z]>为匹配1个任意大小写的英文字母。 -
选择集补集，在选择集的
[后紧跟^代表该选择集为补集， 例如<[^0-9]>为匹配1个除“0123456789”以外的任意字符。 -
子定义，使用圆括号包围（
[、]）的任意正则定义为子定义， 例如<(boson|Boson)+>为匹配“boson”与“Boson”的任意组合。 -
通配符，
.为正则通配符，例如<boson.*>为匹配以“boson”开头的任意文本。 注意通配符不能出现在选择集、选择集补集中。 -
字符转义，以
\接字符进行转义，转义分为两种情况： 一是将具有语法含义的正则符号转为普通符号，例如<\.>匹配字符“.”而非通配； 二是将普通字符转为特殊字符或特殊正则定义，例如<\n>匹配换行符而非字符“n”。 目前Boson支持6种普通字符转义：\n代表换行符，\r代表回车符，\t代表制表符，\d代表0-9，\w代表a-z，\W代表A-Z。 -
引用，使用花括号包围（
{、}）的其他词法符号为引用该词法符号。 例如有词法定义_number = <[0-9]+>，则<boson{_number}>匹配以“boson”开头后接任意数字组合的文本。
<[_a-zA-Z][_a-zA-Z0-9]*>为下划线、字母和数字的任意组合，其中数字不能出现在首位。<".*[^\\]"|'.*[^\\]'>为双引号"或单引号'包围的字符串。
词法定义后缀分为两部分组成，前者为非贪婪标志，用!表示；
后者为词法函数列表，由@符号引出，花括号（{、}）包围的词法函数名。
这两部分均为可选项。
在词法定义的正则表达式之后加入!代表该表达式为非贪婪匹配，当检索到相匹配的文本时立即生成对应的词法单元。
例如string = <".*[^\\]"|'.*[^\\]'>!;表明字符串的词法定义是非贪婪匹配。
词法函数列表中可包含任意合法的符号名，有多个以空格隔开。
目前Boson有两个内置词法函数，分别为skip和newline。
skip表明该词法定义只匹配，但不生成词法单元。
newline表示词法分析器的行计数器加1。
如果词法函数中加入自定义的词法函数，则需要在后续调用注册函数进行自定义函数注册。
例如newline = <\n\r|\n>@{skip, newline};代表在匹配到换行时，忽略这些换行符，并且使行计数器加1。
Boson的语法定义类似EBNF的写法，但所用符号上更接近正则表达式的写法。
语法定义的结构通常如下：
语法符号 : 规约式 [= [语法元组名称]语法元组定义] | 规约式 [= [语法元组名称]语法元组] | ...;
语法符号为为任意合法的符号。所有语法定义中必须包含一个语法符号为起始语法符号。
起始语法符号是整个脚本语法定义的起始，可通过%start_symbol命令进行设定，也可直接使用默认的start符号。
规约式是由若干个语法符号、词法符号和文本词法以类似EBNF的方式组成。
其中
文本词法为语法定义的特殊元素，其表现形式为普通的字符串，代表该位置为一个以该字符串表示的词法单元。
下文中symbolN表示为语法符号、词法符号和文本词法中的一种。
规约式可由上述元素以空格隔开的方式进行排列：
symbol0 : symbol1 symbol2 symbol3;
使用圆括号（(、)）包围的规约式称为子规约式:
symbol0 : symbol1 (symbol2 symbol3) symbol4;
子规约式将构造一个隐藏的语法符号和对应的规约式
上述示例将实际扩展为：
symbol0 : symbol1 hidden_symbol0 symbol4;
hidden_symbol0 : symbol2 symbol3;
其中hidden_symbol0为Boson生成的隐藏语法符号。
所有规约式元素（包括symbolN、子规约式等）均可使用闭包后缀构造闭包：
symbol0 : symbol1+ (symbol2 symbol3)* symbol4;
闭包后缀的分为2种，其含义与正则表达式中的闭包类似:
*为克林闭包，代表该元素可以为0个或重复任意多个。+为正闭包，代表该元素至少为1个或重复任意多个。
闭包同样会生成相应的隐藏语法符号和规约式。
列表的词法符号list的规约式为至少1个或任意多个number构成：
list: number+;
或者该列表可以为空:
list: number*;
使用方括号（[、]）包围的规约式称为可选项：
symbol0 : [symbol1 symbol2] symbol3;
可选项的含义要么存在要么不存在。
上述语法定义等价于：
symbol0 : symbol3;
symbol0 : symbol1 symbol2 symbol3;
使用竖线（|）隔开的元素为选择项：
symbol0 : symbol1 | symbol2 | symbol3;
等价于：
symbol0 : symbol1;
symbol0 : symbol2;
symbol0 : symbol3;
语法元组是语法定义中的一个可选特性，用于修改、化简、构造由语法定义描述的抽象语法树。
语法元组包含2部分：
语法元组名称，用于语义分析时语义动作的注册和定位。语法元组定义，描述该语法定义的语法元组结构。
语法元组名称为任意合法的符号，同名的语法元组名称将获得相同的语义分析动作。
语法元组定义大致结构如下：
(元组元素, 元组元素, ...)
元组元素可为下列6种形式：
语法节点*语法节点语法节点 子语法元组定义*语法节点 子语法元组定义语法节点 *子语法元组定义*语法节点 *子语法元组定义
其中：
语法节点可表示为$N，N代表语法元素在规约式中的下标。子语法元组定义以圆括号（(、)）包围，代表规约式中子规约式（含闭包）或可选项内部的语法元组定义。*通常在语法节点之前或子语法元组定义之前，代表其后的语法节点或子语法元组定义构造抽象语法树节点需解包。
对于常规规约式，可通过语法元组定义改变其抽象语法树中的元素顺序或舍弃部分无语义的元素。
例如中置运算符的计算式的语法定义使用逆波兰式的语法元组：
expression : a '+' b = ($1, $0, $2);
在解析过程中产生的抽象语法树节点将被构造成('+', a, b)。
或子计算中舍弃无语义的标点符号：
expression : '(' expression ')' = ($1);
对于这类规约式，需定义子规约式和可选项的语法元组就需要用到子语法元组定义。
中置运算符语法定义的扩展：
expression : a ('+' | '-' | '*' | '/') b = ($1, *$0, $2);
其语法元组定义生成的抽象语法树节点结构为(运算符, a, b)，其中运算符为+、-、*、/中的一种。
例如一个函数调用的语法定义如下：
invoke_function : function_name '(' argument (',' argument)* ')' = ($0, $2, *$3*($1));
其语法元组定义生成的抽象语法树节点结构为(function_name, argument, argument, ...)。
具体分析如下：
$0代表取规约式中索引为0的语法元素，也就是function_name。$2代表取规约式中索引为2的语法元素，也就是argument。*$3*($1)为上述元组元素的第6种情况*语法节点 *子语法元组定义。
对于*$3*($1)，拆解出$3代表定义索引为3的语法元素，
也就是(',' argument)*。
而*$3中的*代表该语法元素需要解包。
如果此处没有*，那么抽象语法树节点结构将变为(function_name, argument, (argument, ...))，
因此“解包”的含义也一目了然。
后续*($1)中的($1)为子语法元组定义，其定义是(',' argument)*的语法元组，该语法由两层组成，
第一层为克林闭包：(...)*，第二层为克林闭包内部的(',' argument)。因此该子语法元组定义定义的便是
(',' argument)的语法元组。容易理解$1代表索引为1的语法元素也就是argument。
而*($1)中的*代表该语法元素需要解包。如果此处没有*，
那么抽象语法树节点结构将变为(function_name, argument, (argument), (argument)...)。
对于某些场景下，只需要提取其中某个语法元素而不需要构建语法元组，可使用直接取值来简化。
直接取值的用如下（其中元组元素与语法元组定义相同）：
[元组元素]
直接取值可替代规约式的语法元组或其中的子语法元组定义。
对于如下规约式，当仅需提取子规约式的其中一个语法元素时，通常采用如下写法:
list : '[' element (',' element)* ']' = ($1, *$2*($1));
其中$2*($1)意为(',' element)*中取element元素并解包，当使用直接取值时，可简化如下：
list : '[' element (',' element)* ']' = ($1, *$2[$1]);
对于某些场景下仅需使用规约式中的某一个语法元素，此时语法元组将失去元组的意义，重要的是增加了语法树解析阶段的取值步骤，示例如下：
expression: '(' expression ')' = ($1);
为简化这类语法元组实际意义退化成语法元素的情形，可使用直接取值进行简化处理：
expression: '(' expression ')' = [$1];
目前Boson可生成Python3和C++两种语言的代码。
在编写完Boson脚本文件之后，例如test.boson，使用Boson生成其对应的分析器代码（使用lalr分析器）：
boson test.boson -a lalr -l python3 -o test
执行成功之后，当前目录下便会生成test文件夹，包含了分析器的各类代码文件。
使用方式也较为简便，假设从文件test.txt获取将要解析的文本：
with open('test.txt', 'r', encoding='utf-8') as f:
text = f.read()构造test.py文件中的词法分析器并对文本进行解析获得词法单元列表：
from test import BosonLexicalAnalyzer
with open('test.txt', 'r', encoding='utf-8') as f:
text = f.read()
lexer = BosonLexicalAnalyzer()
if lexer.tokenize(text) != lexer.no_error_line():
"到这里说明文本有词法错误"
token_list = lexer.token_list()接下来调用test.py文件中的语法分析器构造抽象语法树：
from test import BosonLexicalAnalyzer, BosonGrammarAnalyzer
with open('test.txt', 'r', encoding='utf-8') as f:
text = f.read()
lexer = BosonLexicalAnalyzer()
if lexer.tokenize(text) != lexer.no_error_line():
"到这里说明文本有词法错误"
token_list = lexer.token_list()
parser = BosonGrammarAnalyzer()
grammar = parser.parse(token_list)
if grammar.error_index != grammar.no_error_index():
"到这里说明有语法错误"到这一步分析器已经生成完整的抽象语法树，使用者可以选择自行去解析抽象语法树做相应的后续语义分析等工作。
也可以使用Boson生成的语义分析器进行便捷的语义分析。
加入test.boson中定义了如下语法：
print_string: 'print' '(' string ')' = print($2);
那么就需要向语义分析器注册名为print的语义动作：
from test import BosonLexer, BosonParser, BosonInterpreter
with open('test.txt', 'r', encoding='utf-8') as f:
text = f.read()
lexer = BosonLexer()
if lexer.tokenize(text) != lexer.no_error_line():
"到这里说明文本有词法错误"
token_list = lexer.token_list()
parser = BosonParser()
grammar = parser.parse(token_list)
if grammar.error_index != grammar.no_error_index():
"到这里说明有语法错误"
interpreter = BosonInterpreter()
@interpreter.register_action('print')
def _print(grammar_entity): # 根据语法元组定义只有一个参数，因此len(grammar_entity) == 1。
print(grammar_entity[0])
interpreter.execute(grammar.grammar_tree) # 对抽象语法树执行语义分析。至此，程序已经结束。使用Boson生成分析器代码，可以很方便进行调用，进行许多涉及语法分析的工作。
此处有一个利用Boson和mpfr构造高精度计算器的例子（有详细构造过程和使用说明）：
作者：ict
电子邮件：[email protected]