XY Swagger Generator

基于 Swagger/OpenAPI 的 Dart/Flutter API/模型代码生成工具。

功能简介

• 根据 swagger.json 自动生成 Dart API 接口、模型、枚举等
• 支持 Retrofit、json_serializable 等主流生态
• 支持自定义生成规则和命名风格

快速开始

# 安装依赖
flutter pub get
# 或
pub get

# 生成模型和API
sh run_swagger.sh
# 或
dart run bin/main.dart generate --models --api

目录结构

swagger/
  bin/                # 命令行入口
  generator/          # 生成的 API、模型、文档
  lib/                # 生成器核心代码
  tests/              # 单元测试
  swagger.json        # Swagger/OpenAPI 源文件

运行测试

dart run test tests/

贡献指南

• 代码需包含中英文注释
• 新增功能请补充对应测试用例
• 生成规则/命名风格如有特殊需求请在 issue 说明

常见问题

• 生成模型/接口命名不规范？请检查 swagger 字段命名和生成规则
• 枚举、泛型、嵌套对象支持？已支持主流用法，特殊场景请补充 issue

---

更新日期：2025-07-13
作者：Max