# eva

**Repository Path**: wild-winds/eva

## Basic Information

- **Project Name**: eva
- **Description**: fastapi脚手架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Eva

一个 CLI 工具，用于快速生成 FastAPI 项目脚手架。

统一技术栈与项目规范，让团队项目保持一致。

## 安装

```bash
git clone https://github.com/yourname/eva.git
cd eva
uv tool install -e .
```

安装后可在任意目录使用 `eva` 命令。

## 使用

```bash
# 生成 FastAPI 项目
eva init myproject

# 这将在当前目录创建 myproject/ 文件夹，包含完整的 FastAPI 项目结构
# 主应用包名称会根据项目名自动生成（PascalCase 风格）
# 例如: myproject → Myproject, user-service → UserService
```

## 生成的项目结构

```
myproject/
├── Myproject/            # 主应用包（名称由项目名自动生成）
│   ├── routers/          # 路由 + Schemas
│   ├── config.py         # 配置文件
│   ├── core/             # 异常处理 + 依赖注入
│   ├── models/           # 数据模型 + Session
│   ├── __init__.py
│   └── app.py            # FastAPI 应用入口
├── alembic/              # 数据库迁移
├── .github/workflows/    # CI 配置
├── .env                  # 环境配置
├── .gitignore
├── .dockerignore
├── conftest.py           # Pytest 配置
├── Dockerfile
├── docker-compose.yml
├── Makefile
├── README.md
├── alembic.ini
└── pyproject.toml
```

## 开发

```bash
uv sync --all-extras
uv run pytest
```

## License

MIT

## 联系方式

QQ: 1107440768