fastapp-cli 0.1.0__tar.gz

fastapp_cli-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+
+# 构建产物
+dist/
+build/
+
+# 测试与工具缓存
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+.DS_Store

fastapp_cli-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.5
+Name: fastapp-cli
+Version: 0.1.0
+Summary: FastAPI 项目脚手架：一条命令生成完整可运行的 FastAPI 工程
+Author: aidenmo
+License: MIT
+Keywords: cli,fastapi,scaffold,sqlmodel,template
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: typer>=0.12.0
+Description-Content-Type: text/markdown
+
+# fastapp-cli
+
+FastAPI 项目脚手架：一条命令生成**完整、可直接运行**的 FastAPI 工程。
+
+```bash
+fastapp create my-server
+```
+
+## 特性
+
+- **分层架构**：`api / schemas / crud / services / models` 分层，内置泛型 CRUD / Service 基类
+- **开箱即用的工程能力**：统一响应 / 异常体系、TraceID 中间件、loguru 日志、pydantic-settings 多环境配置
+- **分页 CRUD + 过滤**：基于 fastapi-pagination 与 fastapi-filter 的完整示例（`/api/v1/items`）
+- **Celery 骨架**：默认 redis broker，本地无 redis 时启动自动降级 `memory://` 并告警
+- **Alembic 迁移**：接入 SQLModel.metadata，含 autogenerate 过滤钩子
+- **优雅降级**：MySQL 缺席不阻塞启动，`/api/v1/health` 返回 `database: up/down`
+- **工程化配套**：Makefile、scripts/、pre-commit、ruff + mypy + pytest 配置全套
+- **可选部署文件**：`--pm2` / `--docker` 按需生成
+
+## 安装
+
+```bash
+# uv tool（推荐）
+uv tool install fastapp-cli
+
+# 或 pipx
+pipx install fastapp-cli
+
+# 或一次性使用
+uvx fastapp create demo
+```
+
+## 使用
+
+```bash
+fastapp create <project_name> [options]
+```
+
+| 参数 | 默认 | 说明 |
+|---|---|---|
+| `project_name` | 必填 | 项目名；小写字母/数字/连字符，如 `my-server` |
+| `--description` | 交互提问 | 项目描述 |
+| `--pm2 / --no-pm2` | 交互提问 | 是否生成 `pm2.config.json` |
+| `--docker / --no-docker` | 交互提问 | 是否生成 `Dockerfile` |
+| `--python` | `3.12` | 目标 Python 版本（写入 `.python-version`） |
+| `--author` | `git config user.name` | 作者署名 |
+| `--force` | 关 | 目标目录已存在时覆盖重建 |
+| `--no-git` | 关 | 跳过 `git init` |
+
+全部关键项通过 flag 提供时零交互：
+
+```bash
+fastapp create my-server --description "demo" --no-pm2 --no-docker
+```
+
+生成完成后：
+
+```bash
+cd my-server && uv sync
+make dev        # 访问 /api/v1/docs
+```
+
+## 生成项目依赖
+
+fastapi、sqlmodel、alembic、celery[redis]、fastapi-pagination、fastapi-filter、loguru、pydantic-settings 等，dev 组含 pytest / ruff / mypy / pre-commit。
+
+## 开发 fastapp-cli 自身
+
+```bash
+uv sync --group dev
+uv run pytest          # 单元 + 冒烟测试
+uv run ruff check .
+```
+
+## 发布
+
+```bash
+uv build     # 构建 sdist + wheel（模板随包发布）
+uv publish   # 发布到 PyPI
+```
+
+版本策略：v0.1.0 起，语义化版本。

fastapp_cli-0.1.0/PLAN.md

@@ -0,0 +1,311 @@
+# fastapp-cli 项目计划（第一阶段交付物）
+
+> 状态：**第二阶段已完成**。CLI 已实现并通过全部验证（§11 全项），`uv build` 打包校验通过。
+> 参考架构：`/Users/aidenmo/projects/ai-lyric-server`（已完整勘察）。
+
+---
+
+## 1. 目标与范围
+
+构建 Python CLI 工具 `fastapp-cli`（命令名 `fastapp`），执行：
+
+```bash
+fastapp create <project_name>
+```
+
+生成一个**完整、可直接运行**的 FastAPI 项目：完整复刻参考项目的通用工程能力（分层架构、配置、日志、异常、TraceID、统一响应、分页 CRUD、过滤、Celery 骨架、Alembic、测试、Lint），剥离全部业务与腾讯内部耦合，用户基于生成物继续开发完整业务。
+
+### 已确认的设计决策
+
+| 决策点 | 结论 |
+|---|---|
+| CLI 框架 | Typer |
+| 模板渲染 | 内置 Jinja2（模板随包发布，`importlib.resources` 加载） |
+| 生成项目依赖管理 | uv（pyproject + uv.lock） |
+| fastapp-cli 分发 | PyPI + `uv tool install fastapp-cli` / `pipx` |
+| 数据层 | SQLModel + **MySQL 默认**，缺席时**降级不阻塞启动**（见 §7） |
+| 能力集 | 参考项目的通用能力**全量纳入**：分页 CRUD（fastapi-pagination）、通用过滤（fastapi-filter）、认证占位、Celery 骨架 |
+| 部署配套 | `scripts/` + Makefile 默认生成；**pm2、Dockerfile 由用户在 create 时选择** |
+| 交互模式 | 混合模式：关键项交互提问，提供 flag 则跳过提问，其余全默认 |
+| 应用包名 | 生成项目的应用包**固定位 `app/`**（与参考项目一致），`project_name` 仅用于目录名与 pyproject name |
+| Celery 默认 broker | 默认 `redis://localhost:6379`，redis 不可达时**自动降级 `memory://`** 并告警 |
+
+---
+
+## 2. CLI 命令设计
+
+### 2.1 v1 命令面
+
+```
+fastapp                          # 显示帮助
+fastapp --version                # 版本号
+fastapp create <project_name>    # 生成脚手架项目（核心命令）
+```
+
+### 2.2 `fastapp create` 参数
+
+| 参数 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `project_name` | 位置参数 | 必填 | 项目名；小写字母/数字/连字符，如 `my-server`（仅用于目录名与 pyproject name，应用包固定位 `app`） |
+| `--description` | option | `A FastAPI project created by fastapp-cli` | 项目描述；**交互提问** |
+| `--pm2 / --no-pm2` | flag | 未指定时**交互提问** | 是否生成 `pm2.config.json` |
+| `--docker / --no-docker` | flag | 未指定时**交互提问** | 是否生成 `Dockerfile` |
+| `--python` | option | `3.12` | 生成项目的目标 Python 版本（写入 `.python-version` 与 pyproject） |
+| `--author` | option | 取 `git config user.name` | 作者署名 |
+| `--force` | flag | 关 | 目标目录已存在时覆盖重建 |
+| `--no-git` | flag | 关 | 跳过 `git init` |
+
+### 2.3 交互流程（混合模式）
+
+```text
+$ fastapp create my-server
+? 项目描述 [A FastAPI project created by fastapp-cli]:
+? 是否包含 pm2 配置? [y/N]
+? 是否包含 Dockerfile? [y/N]
+✔ 生成项目 my-server/（23 个文件）
+✔ 已初始化 git 仓库
+下一步：
+  cd my-server && uv sync
+  make dev        # 或 uv run uvicorn app.main:app --reload
+```
+
+- 三个提问项：**描述、pm2、Dockerfile**（与决策"关键项提问、pm2/Dockerfile 用户选择"一致）；全部通过 flag 提供时零交互。
+- 数据库不提问：固定 MySQL 形态 + 降级保底（§7.1）；Celery 必含，broker 默认 redis、缺席自动降级 memory（§7.3）。
+- 参数校验：`project_name` 非法字符拒绝并提示（仅用于目录名与 pyproject name；应用包固定为 `app`，无需派生包名）。
+- 完成后打印下一步指引（`uv sync` → `make dev` → 访问 `/api/v1/docs`）。
+
+---
+
+## 3. fastapp-cli 自身工程结构
+
+```text
+fastapp-cli/
+├── pyproject.toml              # hatchling 构建；requires-python >=3.10
+├── README.md                   # 使用说明（中文）
+├── PLAN.md                     # 本计划文档
+├── src/
+│   └── fastapp_cli/
+│       ├── __init__.py         # __version__
+│       ├── main.py             # Typer 应用入口（console script: fastapp）
+│       ├── create.py           # create 命令：校验→渲染→git init→输出指引
+│       ├── prompts.py          # 混合模式交互提问（Typer prompt/confirm）
+│       ├── naming.py           # project_name 校验（目录名 / pyproject name）
+│       ├── render.py           # Jinja2 引擎：变量注入、条件文件、原样拷贝与残留自检
+│       └── templates/
+│           └── project/        # 生成项目模板根（清单见 §5、§6）
+└── tests/
+    ├── test_naming.py          # 命名校验单元测试
+    ├── test_render.py          # 渲染：无 {{ }} 残留、条件文件随 flag 增减
+    └── test_create.py          # 冒烟：tmp 目录 create → 断言关键文件树
+```
+
+依赖：`typer`、`jinja2`（仅两个运行时依赖）；dev 组：`pytest`、`ruff`、`mypy`。
+
+---
+
+## 4. 生成项目目录结构
+
+以下为 `fastapp create demo-server` 的产物（应用包**固定位 `app/`**，与参考项目结构一致，便于沿用既有开发习惯）：
+
+```text
+demo-server/
+├── .python-version                 # 3.12
+├── .env.example                    # 环境变量样例（MySQL 占位 + Celery redis://localhost）
+├── .env.development.example
+├── .env                            # 从 .env.example 复制，本地默认配置（gitignore）
+├── .gitignore
+├── .pre-commit-config.yaml
+├── Makefile                        # sync / dev / test / lint / format / migrate / revision
+├── README.md                       # 快速开始、目录说明、扩展指南
+├── docs/
+│   └── SQLModel定义示例.md          # 原样拷贝自参考项目，SQLModel 建模参考手册（供开发者查阅）
+├── pyproject.toml                  # 依赖 + ruff + mypy + pytest 配置
+├── alembic.ini
+├── alembic/
+│   ├── env.py                      # 接入 settings.DATABASE_URI 与 SQLModel.metadata
+│   ├── script.py.mako
+│   └── versions/.gitkeep
+├── scripts/
+│   ├── start.sh                    # uvicorn 启动
+│   ├── celery_worker.sh
+│   ├── celery_beat.sh
+│   └── celery_flower.sh
+├── pm2.config.json                 # 条件生成（--pm2）
+├── Dockerfile                      # 条件生成（--docker）
+├── tests/
+│   ├── conftest.py                 # sqlite 内存库 + 依赖覆盖（修正参考项目缺陷）
+│   ├── api/test_health.py
+│   ├── api/test_items.py
+│   └── services/test_item_service.py
+└── app/                            # 应用包，固定名 app（分层与参考项目一致）
+    ├── main.py                     # 工厂函数 create_app + lifespan（含 DB / redis 探测降级）
+    ├── core/
+    │   ├── config.py               # pydantic-settings，.env + .env.{APP_ENV} 分层
+    │   ├── database.py             # SQLModel 引擎 + get_session（连接参数含降级探测）
+    │   ├── logging.py              # loguru 配置
+    │   ├── exceptions.py           # AppExceptionError 体系 + 全局处理器
+    │   ├── middleware.py           # TraceIDMiddleware
+    │   ├── context_var.py          # trace_id ContextVar
+    │   └── celery_app.py           # Celery 实例（redis 默认，缺席降级 memory）
+    ├── api/
+    │   ├── deps.py                 # DBSession / CurrentUser（认证占位）
+    │   └── v1/
+    │       ├── router.py
+    │       └── endpoints/
+    │           ├── health.py       # /api/v1/health（含 database up/down 状态）
+    │           └── items.py        # 分页 CRUD 示例（增删改查 + 过滤 + 分页）
+    ├── models/
+    │   ├── base.py                 # IDMixin / TimestampMixin / FormattedDatetime
+    │   ├── item.py                 # Item 模型（demo 业务域）
+    │   └── __init__.py
+    ├── schemas/
+    │   ├── common.py               # Response[T] / PageParams / PageResponse[T]
+    │   ├── item.py                 # ItemCreate / ItemUpdate / ItemFilter
+    │   └── __init__.py
+    ├── crud/
+    │   ├── base.py                 # CRUDBase 泛型
+    │   ├── item.py
+    │   └── __init__.py
+    ├── services/
+    │   ├── base.py                 # ServiceBase
+    │   ├── item_service.py
+    │   └── __init__.py
+    ├── tasks/
+    │   ├── __init__.py
+    │   └── sample_tasks.py         # Celery 示例任务
+    └── utils/
+        └── __init__.py
+```
+
+---
+
+## 5. 模板文件清单
+
+`templates/project/` 下共约 35 个文件，按两类处理：
+
+| 类别 | 文件 | 处理方式 |
+|---|---|---|
+| **Jinja 渲染**（.j2） | 全部 `.py`/`.toml`/`.md`/`.json`/`.ini`/`.sh`/`.yaml`/`Makefile`/`.env*` | 注入变量（§6），如 `main.py.j2` |
+| **原样拷贝** | `alembic/script.py.mako`、`versions/.gitkeep`、**`docs/` 整目录**（含 `SQLModel定义示例.md`） | 不渲染，原样拷贝（应用包固定位 `app/`，目录名无需模板化；`docs/` 供开发者参考） |
+
+条件生成规则（Jinja `{% if %}` 控制）：
+
+| 文件 | 条件 |
+|---|---|
+| `pm2.config.json` | `use_pm2` |
+| `Dockerfile` | `use_docker` |
+| `scripts/celery_*.sh` | 始终生成（Celery 必含） |
+| `tests/services/test_item_service.py` | 始终生成 |
+
+---
+
+## 6. 模板变量与渲染机制
+
+| 变量 | 来源 | 示例 |
+|---|---|---|
+| `project_name` | CLI 参数 | `demo-server`（应用包固定 `app`，无包名变量） |
+| `project_description` | 交互/flag | `A FastAPI project ...` |
+| `python_version` | `--python` | `3.12` |
+| `author_name` | `--author` / git config | `aidenmo` |
+| `use_pm2` / `use_docker` | 交互/flag | `true` |
+| `year` | 当前年份 | `2026` |
+| `fastapp_cli_version` | 包内版本（写入 README 生成声明） | `0.1.0` |
+
+渲染机制：
+- `importlib.resources` 读取包内模板目录，发布后离线可用、模板与 CLI 版本严格同步；
+- 渲染后统一检查输出文件中无 `{{`/`{%` 残留（自检，发现即报错）；
+- 目标目录已存在且未指定 `--force` 时拒绝执行。
+
+---
+
+## 7. 关键行为规范
+
+### 7.1 MySQL 缺席降级（已确认方案的具体化）
+
+- `lifespan` 启动时用引擎执行 `SELECT 1`（带超时）：成功 → `info` 日志；失败 → `warning` 日志（"数据库未就绪，数据接口将返回 500，请配置 .env"），**应用正常启动**；
+- `/api/v1/health` 返回体增加 `"database": "up" | "down"`，状态直观可查；
+- 访问 DB 的接口在库缺席时由统一异常处理器兜底为 `{code: 50000, message: "服务器内部错误"}`，不裸抛堆栈；
+- 测试环境（conftest）使用 sqlite 内存库，不受影响。
+
+### 7.2 认证占位
+
+`deps.get_current_user`：非生产环境返回 `settings.MOCK_USER`（默认 `dev`），生产环境抛 `UnauthorizedError`。参考项目中的 TOF/TME 登录逻辑不迁移，接入点保留。
+
+### 7.3 Celery：默认 redis，缺席自动降级 memory
+
+- `.env` 预置 `CELERY_BROKER_URL=redis://localhost:6379/0`、`CELERY_RESULT_BACKEND=redis://localhost:6379/1`；
+- lifespan 启动时对 redis 执行 `PING` 探测（带超时）：可达 → 正常使用 redis；不可达 → `warning` 日志（"redis 未就绪，Celery 已降级为 memory broker"），broker 重建为 `memory://`、backend 降级为 `cache+memory://`；
+- 降级逻辑封装在 `core/celery_app.py` 的 `build_celery_app(broker_url, backend_url)`，主应用与 worker 共用同一构造入口；
+- README 说明：生产环境在 `.env` 配置真实 redis 地址即可，无需改代码。
+
+---
+
+## 8. 依赖管理
+
+### 8.1 生成项目（对标参考项目逐项裁剪）
+
+**保留（运行时）**：`fastapi`、`uvicorn[standard]`、`sqlmodel`、`sqlalchemy`、`alembic`、`pymysql`、`pydantic`、`pydantic-settings`、`loguru`、`celery[redis]`、`flower`、`fastapi-pagination`、`fastapi-filter[sqlalchemy]`、`tenacity`、`httpx`
+
+**裁剪（业务/腾讯内部耦合）**：`rainbow-config`、`cos-python-sdk-v5`、`jieba`、`pypinyin`、`jwcrypto`、`pycryptodome`、`python-multipart`（demo 无文件接口）、`contextvars`（Python 标准库已内置，参考项目此依赖冗余）、`setuptools` 钉版
+
+**dev 组**：`pytest`、`pytest-asyncio`、`pytest-cov`、`pytest-mock`、`ruff`、`mypy`、`pre-commit`
+
+- `requires-python = ">=3.12"`：模板沿用参考项目的 PEP 695 泛型语法（`class Response[T]`）；
+- ruff/mypy/pytest 配置从参考项目 pyproject 移植（target py312，移除腾讯库 override；**删除重复的 pytest.ini**，仅保留 pyproject 配置）；
+- uv 镜像源：默认 `pypi.org`，pyproject 内附**注释掉**的腾讯镜像块，内网用户取消注释即用。
+
+### 8.2 fastapp-cli 自身
+
+- 运行时依赖仅 `typer` + `jinja2`；
+- `requires-python >=3.10`（CLI 工具放宽兼容面；模板渲染产物为纯文本，不受此限制）。
+
+---
+
+## 9. 打包与发布
+
+- **构建后端**：hatchling；`[project.scripts] fastapp = "fastapp_cli.main:app"`；
+- 模板目录经 hatchling 包含进 wheel（`src/fastapp_cli/templates` 随包发布）；
+- **发布流程**：`uv build` → `uv publish`（PyPI；发布凭据由维护者本地配置 / Trusted Publishing）；
+- **安装使用**：`uv tool install fastapp-cli`、`pipx install fastapp-cli`，或一次性 `uvx fastapp create demo`；
+- 版本策略：v0.1.0 起，语义化版本。
+
+---
+
+## 10. 与参考项目的差异清单
+
+| 类型 | 内容 |
+|---|---|
+| 剥离 | rainbow-config / TOF / TME / COS / knot / jieba / pypinyin 等业务与内部依赖；`app/utils` 业务工具 |
+| 修正 | `conftest.py` 引用不存在的 `get_db` → 统一为 `get_session`；删除重复 pytest 配置 |
+| 新增 | lifespan DB/redis 探测降级、health 状态字段、Makefile、`--pm2/--docker` 条件文件、命名校验 |
+| 替换 | 业务域 lyric → 通用 demo 域 `items`；utils 业务实现 → 空扩展位 |
+| 保留 | 分层架构与 `app/` 包名、统一响应/异常/TraceID/日志、CRUD/Service 基类、Mixin、Alembic、Celery、工程化配置全套、`docs/` 参考文档 |
+
+---
+
+## 11. 质量验证（第二阶段完成标准）
+
+1. `fastapp create demo-server` 全 flag 直通 + 零 flag 交互两条路径均成功；
+2. 生成项目内 `uv sync && uv run pytest` 全绿（无需 MySQL）；
+3. 生成项目 `make dev`（`uvicorn app.main:app --reload`）后：`/api/v1/health` 返回 `{"status":"ok","database":"down"}`（无库降级可见），配置本地 MySQL 后变为 `up`；
+4. `/api/v1/items` 分页 CRUD + 过滤端到端可用；无 redis 时 Celery 自动降级 `memory://` 并输出告警日志，配置 redis 后任务走 redis broker；
+5. CLI 自身 `pytest`（命名/渲染/冒烟）全绿；产物中无 Jinja 残留标记。
+
+---
+
+## 12. 第二阶段实施步骤（确认后执行）
+
+1. 初始化 `fastapp-cli` 包骨架（pyproject + src 布局 + Typer 入口）；
+2. 实现 `naming` / `prompts` / `render` 三个模块；
+3. 编写 `templates/project` 全量模板（从参考项目移植 + 裁剪 + 修正 + 参数化）；
+4. 实现 `create` 命令（校验→渲染→条件文件→git init→指引输出）；
+5. 编写 CLI 自身测试（单元 + 冒烟）；
+6. 端到端验证（§11 全项）并修复；
+7. 补充 README（fastapp-cli 使用说明 + 发布指引）。
+
+## 13. 路线图（v1 之后，不在本次范围）
+
+- `fastapp check`：环境/生成项目健康自检；
+- `fastapp add <feature>`：向已有项目追加模块（如 celery、docker）；
+- `--template`：自定义模板路径；
+- GitHub Actions CI 模板选项。

fastapp_cli-0.1.0/README.md

@@ -0,0 +1,82 @@
+# fastapp-cli
+
+FastAPI 项目脚手架：一条命令生成**完整、可直接运行**的 FastAPI 工程。
+
+```bash
+fastapp create my-server
+```
+
+## 特性
+
+- **分层架构**：`api / schemas / crud / services / models` 分层，内置泛型 CRUD / Service 基类
+- **开箱即用的工程能力**：统一响应 / 异常体系、TraceID 中间件、loguru 日志、pydantic-settings 多环境配置
+- **分页 CRUD + 过滤**：基于 fastapi-pagination 与 fastapi-filter 的完整示例（`/api/v1/items`）
+- **Celery 骨架**：默认 redis broker，本地无 redis 时启动自动降级 `memory://` 并告警
+- **Alembic 迁移**：接入 SQLModel.metadata，含 autogenerate 过滤钩子
+- **优雅降级**：MySQL 缺席不阻塞启动，`/api/v1/health` 返回 `database: up/down`
+- **工程化配套**：Makefile、scripts/、pre-commit、ruff + mypy + pytest 配置全套
+- **可选部署文件**：`--pm2` / `--docker` 按需生成
+
+## 安装
+
+```bash
+# uv tool（推荐）
+uv tool install fastapp-cli
+
+# 或 pipx
+pipx install fastapp-cli
+
+# 或一次性使用
+uvx fastapp create demo
+```
+
+## 使用
+
+```bash
+fastapp create <project_name> [options]
+```
+
+| 参数 | 默认 | 说明 |
+|---|---|---|
+| `project_name` | 必填 | 项目名；小写字母/数字/连字符，如 `my-server` |
+| `--description` | 交互提问 | 项目描述 |
+| `--pm2 / --no-pm2` | 交互提问 | 是否生成 `pm2.config.json` |
+| `--docker / --no-docker` | 交互提问 | 是否生成 `Dockerfile` |
+| `--python` | `3.12` | 目标 Python 版本（写入 `.python-version`） |
+| `--author` | `git config user.name` | 作者署名 |
+| `--force` | 关 | 目标目录已存在时覆盖重建 |
+| `--no-git` | 关 | 跳过 `git init` |
+
+全部关键项通过 flag 提供时零交互：
+
+```bash
+fastapp create my-server --description "demo" --no-pm2 --no-docker
+```
+
+生成完成后：
+
+```bash
+cd my-server && uv sync
+make dev        # 访问 /api/v1/docs
+```
+
+## 生成项目依赖
+
+fastapi、sqlmodel、alembic、celery[redis]、fastapi-pagination、fastapi-filter、loguru、pydantic-settings 等，dev 组含 pytest / ruff / mypy / pre-commit。
+
+## 开发 fastapp-cli 自身
+
+```bash
+uv sync --group dev
+uv run pytest          # 单元 + 冒烟测试
+uv run ruff check .
+```
+
+## 发布
+
+```bash
+uv build     # 构建 sdist + wheel（模板随包发布）
+uv publish   # 发布到 PyPI
+```
+
+版本策略：v0.1.0 起，语义化版本。

fastapp_cli-0.1.0/pyproject.toml

@@ -0,0 +1,94 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fastapp-cli"
+version = "0.1.0"
+description = "FastAPI 项目脚手架：一条命令生成完整可运行的 FastAPI 工程"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "aidenmo" }]
+keywords = ["fastapi", "scaffold", "cli", "template", "sqlmodel"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+]
+
+dependencies = [
+    "typer>=0.12.0",
+    "jinja2>=3.1.0",
+]
+
+[project.scripts]
+fastapp = "fastapp_cli.main:app"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.11.0",
+    "pytest>=8.0.0",
+    "ruff>=0.6.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fastapp_cli"]
+
+# -----------------------------------------------------------------------------
+# pytest
+# -----------------------------------------------------------------------------
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--tb=short",
+]
+
+# -----------------------------------------------------------------------------
+# Ruff
+# -----------------------------------------------------------------------------
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+respect-gitignore = true
+
+[tool.ruff.lint]
+select = ["F", "E", "W", "I", "B", "UP", "SIM", "N", "TID"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["E", "F", "I", "N", "UP"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+
+# -----------------------------------------------------------------------------
+# mypy
+# -----------------------------------------------------------------------------
+[tool.mypy]
+python_version = "3.10"
+warn_unused_ignores = true
+warn_unreachable = true
+warn_redundant_casts = true
+no_implicit_optional = true
+strict_equality = true
+check_untyped_defs = true
+show_error_codes = true
+show_column_numbers = true
+pretty = true
+
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+ignore_errors = true

fastapp_cli-0.1.0/src/fastapp_cli/__init__.py

@@ -0,0 +1,3 @@
+"""fastapp-cli: FastAPI 项目脚手架."""
+
+__version__ = "0.1.0"