Libra Boot Low

Libra 家族

基于 YAML 配置 + Jinja2 模板的低代码代码生成器，一键生成 Spring Boot + Vue3 完整业务骨架代码，覆盖后端（Java）、前端（Vue3）、SQL 建表、HTTP 测试脚本全产物链路。

快速上手

# 方式一：直接从源码运行
pip install -r requirements.txt

# 使用示例配置生成
python3 generator.py config/test/t1000.yml

# 或使用交互式菜单
bash run.sh

# 批量生成全部模块
bash run.sh --all

安装

生成链路

YAML 配置  ──►  generator.py  ──►  module/gen_*.py  ──►  templates/{mode}/  ──►  out/{domain}/{code}/
  (yml/)         (主入口)          (模式生成器)         (Jinja2 模板)           (完整产物)

十二种生成模式

每种模式均有对应的 templates/{mode}/ 模板目录和 config/test/ 示例配置。

生成产物

每个模块按六段编号生成完整产物链：

out/{domain}/{code}/
├── 00-inbox/ 01-design/      # 生成物清单 + 设计说明
├── 02-sql/ 02-sql-scripts/   # 建表 DDL + SQL 执行脚本
├── 03-http/ 03-http-scripts/ # HTTP 接口测试用例 + 运行脚本
├── 04-server/                # Spring Boot 后端
│   ├── controller/ service/ mapper/  # 控制器/业务/MyBatis 数据层
│   └── entity/{param,po,vo}/         # 实体三件套
└── 05-web/                   # Vue3 前端
    ├── views/                # 页面组件
    └── service/              # API 调用

配置示例

# config/test/t1000.yml（节选——完整注释见该文件）
project:
  name: "Libra Boot Low"
  code: "demo"          # 项目编码（英文小写）
  version: "1.0.0"

modules:
  - name: "单表无附件"   # 模块中文名
    code: "t1000"       # 模块编码（英文小写）
    domain: "test"      # 业务域编码
    mode: "single"      # 生成模式（12 种之一）
    fields:             # 字段清单（type 决定 Java/SQL/Vue 三端类型）
      - { name: "title", label: "标题", type: "input", required: true }
      - { name: "status", label: "状态", type: "select" }
      - { name: "createTime", label: "创建时间", type: "date-year" }

测试

pip install pytest
python -m pytest tests/ -q   # 12 用例：配置加载/类型转换/DRY_RUN 零落盘/渲染器/单表产物结构

CLI 参数

generator.py 参数：

run.sh / run.ps1 启动器额外提供： 交互式菜单（无参数运行）、--all（批量生成全部模块）、--domain <name>（按域过滤）——由启动器循环调用 generator.py 实现。

技术栈

项目结构

libra-boot-low/
├── generator.py            # 主入口
├── run.sh                  # Shell 交互式菜单
├── run.ps1                 # PowerShell 交互式菜单
├── module/                 # 核心生成模块
│   ├── config_loader.py    # YAML 配置加载
│   ├── field_builder.py    # 字段构建器
│   ├── template_renderer.py # Jinja2 渲染器
│   └── gen_*.py            # 各模式生成器
├── templates/              # Jinja2 模板（12 种模式）
│   ├── single/
│   ├── single-with-file/
│   ├── multi-table/
│   ├── master-detail/
│   └── ...
├── config/                 # YAML 配置文件
│   ├── README.md           # 配置说明
│   └── test/               # 示例配置

License

MIT