PEGParser 开源项目教程

PEGParser 开源项目教程

PEGParser💡 Build your own programming language! A C++17 PEG parser generator supporting parser combination, memoization, left-recursion and context-dependent grammars.项目地址:https://gitcode.com/gh_mirrors/pe/PEGParser

1. 项目的目录结构及介绍

PEGParser/
├── cmake/
│   └── cmake example/
├── glue/
├── include/
│   └── peg_parser/
├── source/
├── test/
├── .clang-format
├── .cmake-format
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
├── codecov.yaml
└── example/

• cmake/: 包含 CMake 配置示例。
• glue/: 包含项目的一些胶水代码。
• include/peg_parser/: 包含项目的头文件。
• source/: 包含项目的源代码。
• test/: 包含项目的测试代码。
• .clang-format: 代码格式化配置文件。
• .cmake-format: CMake 格式化配置文件。
• .gitignore: Git 忽略文件配置。
• CMakeLists.txt: 项目的主要 CMake 配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• codecov.yaml: 代码覆盖率配置文件。
• example/: 包含项目的示例代码。

2. 项目的启动文件介绍

项目的启动文件位于 example/ 目录下。具体文件为 example/calculator.cpp，这是一个计算器示例，展示了如何使用 PEGParser 解析和计算表达式。

#include <iostream>
#include <peg_parser/peg_parser.h>

int main() {
    peg::PEGParser g;
    g["Sum"] << "Product (('+' | '-') Product)*";
    g["Product"] << "Atomic (('*' | '/') Atomic)*";
    g["Atomic"] << "Number | '(' Sum ')'";
    g["Number"] << "'-' [0-9]+ ('.' [0-9]+)?";

    g.setStart(g["Sum"]);

    auto input = "1 + 2 * (3+4)/2 - 3";
    float result = g.run(input);
    std::cout << input << " = " << result << std::endl;
}

3. 项目的配置文件介绍

• CMakeLists.txt: 项目的主要 CMake 配置文件，定义了项目的构建规则和依赖关系。
• .clang-format: 代码格式化配置文件，用于统一代码风格。
• .cmake-format: CMake 格式化配置文件，用于统一 CMake 脚本的风格。
• .gitignore: Git 忽略文件配置，定义了哪些文件和目录不需要被 Git 管理。
• codecov.yaml: 代码覆盖率配置文件，用于配置代码覆盖率工具。

以上是 PEGParser 开源项目的目录结构、启动文件和配置文件的介绍。希望这份文档能帮助你更好地理解和使用该项目。

PEGParser💡 Build your own programming language! A C++17 PEG parser generator supporting parser combination, memoization, left-recursion and context-dependent grammars.项目地址:https://gitcode.com/gh_mirrors/pe/PEGParser