4e8e5069fa
- Added: api-patterns, app-builder, architecture, bash-linux, behavioral-modes, clean-code, code-review-checklist, database-design, deployment-procedures, docker-expert, documentation-templates, game-development, geo-fundamentals, i18n-localization, lint-and-validate, mobile-design, nestjs-expert, nextjs-best-practices, nodejs-best-practices, parallel-agents, performance-profiling, plan-writing, powershell-windows, prisma-expert, python-patterns, react-patterns, red-team-tactics, seo-fundamentals, server-management, tailwind-patterns, tdd-workflow, typescript-expert, vulnerability-scanner - Updated README: skill count 179 → 223 - Added credit for vudovn/antigravity-kit (MIT License) Source: https://github.com/vudovn/antigravity-kit
84 lines
1.7 KiB
Markdown
84 lines
1.7 KiB
Markdown
---
|
|
name: python-fastapi
|
|
description: FastAPI REST API template principles. SQLAlchemy, Pydantic, Alembic.
|
|
---
|
|
|
|
# FastAPI API Template
|
|
|
|
## Tech Stack
|
|
|
|
| Component | Technology |
|
|
|-----------|------------|
|
|
| Framework | FastAPI |
|
|
| Language | Python 3.11+ |
|
|
| ORM | SQLAlchemy 2.0 |
|
|
| Validation | Pydantic v2 |
|
|
| Migrations | Alembic |
|
|
| Auth | JWT + passlib |
|
|
|
|
---
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
project-name/
|
|
├── alembic/ # Migrations
|
|
├── app/
|
|
│ ├── main.py # FastAPI app
|
|
│ ├── config.py # Settings
|
|
│ ├── database.py # DB connection
|
|
│ ├── models/ # SQLAlchemy models
|
|
│ ├── schemas/ # Pydantic schemas
|
|
│ ├── routers/ # API routes
|
|
│ ├── services/ # Business logic
|
|
│ ├── dependencies/ # DI
|
|
│ └── utils/
|
|
├── tests/
|
|
├── .env.example
|
|
└── requirements.txt
|
|
```
|
|
|
|
---
|
|
|
|
## Key Concepts
|
|
|
|
| Concept | Description |
|
|
|---------|-------------|
|
|
| Async | async/await throughout |
|
|
| Dependency Injection | FastAPI Depends |
|
|
| Pydantic v2 | Validation + serialization |
|
|
| SQLAlchemy 2.0 | Async sessions |
|
|
|
|
---
|
|
|
|
## API Structure
|
|
|
|
| Layer | Responsibility |
|
|
|-------|---------------|
|
|
| Routers | HTTP handling |
|
|
| Dependencies | Auth, validation |
|
|
| Services | Business logic |
|
|
| Models | Database entities |
|
|
| Schemas | Request/response |
|
|
|
|
---
|
|
|
|
## Setup Steps
|
|
|
|
1. `python -m venv venv`
|
|
2. `source venv/bin/activate`
|
|
3. `pip install fastapi uvicorn sqlalchemy alembic pydantic`
|
|
4. Create `.env`
|
|
5. `alembic upgrade head`
|
|
6. `uvicorn app.main:app --reload`
|
|
|
|
---
|
|
|
|
## Best Practices
|
|
|
|
- Use async everywhere
|
|
- Pydantic v2 for validation
|
|
- SQLAlchemy 2.0 async sessions
|
|
- Alembic for migrations
|
|
- pytest-asyncio for tests
|