LittleLang 项目启动与配置教程

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

LittleLang 是一个简单的编程语言编译器项目，其目录结构如下：

littlelang/
│
├── bin/                       # 存放编译后的可执行文件
├── doc/                       # 存放项目文档
├── examples/                  # 包含示例代码
├── lib/                       # 存放编译器核心库文件
├── scripts/                   # 包含项目构建和辅助脚本
├── src/                       # 存放编译器的源代码文件
│   ├── grammar/               # 语法分析相关文件
│   ├── lexer/                 # 词法分析相关文件
│   ├── main/                  # 编译器入口文件
│   └── parser/                # 解析器相关文件
└── test/                      # 存放测试用例和测试脚本

• bin/：编译后的可执行文件会放在这个目录下。
• doc/：项目文档存放位置，可能包含API文档、用户手册等。
• examples/：提供了一些使用 LittleLang 编写的示例程序。
• lib/：编译器核心库文件存放目录。
• scripts/：项目构建和运行的各种脚本。
• src/：编译器的源代码文件存放目录，包括词法分析器、语法分析器、主程序等。
• test/：测试用例和测试脚本存放目录，用于确保编译器的稳定性和正确性。

2. 项目的启动文件介绍

项目的启动文件是位于 src/main 目录下的 main.py 文件。该文件负责初始化编译器，并处理用户输入的源代码文件，进行编译。

# main.py
import sys
from parser import parse
from lexer import lex
from codegen import generate_code

def main():
    if len(sys.argv) != 2:
        print("Usage: python main.py <source_file>")
        sys.exit(1)

    source_file = sys.argv[1]
    with open(source_file, 'r') as f:
        source_code = f.read()

    tokens = lex(source_code)
    ast = parse(tokens)
    machine_code = generate_code(ast)
    print(machine_code)

if __name__ == "__main__":
    main()

此文件为编译器的入口点，用户需要通过命令行传递源代码文件路径给程序。

3. 项目的配置文件介绍

LittleLang 项目的配置文件通常位于项目根目录下，名为 config.py。此文件用于定义项目全局变量和配置选项。

# config.py
# 定义一些项目级别的配置和常量
DEBUG = True
LEXER_DEBUG = False
PARSER_DEBUG = False

在这个配置文件中，可以设置调试标志，以及是否启用词法分析和语法分析的调试信息。这些配置可以根据开发者的需要调整，以帮助调试或优化编译器。

以上即为 LittleLang 项目的启动和配置文档。根据这些信息，您可以开始自己的编译器之旅了。