Python Backend Development
Cuándo usar esta skill
- Cuando necesites modificar la API FastAPI (
backend/obsidianrag/api). - Cuando agregues nuevas dependencias o configures
pyproject.toml. - Cuando trabajes en la estructura core del paquete (
backend/obsidianrag).
Cómo usar esta skill
1. Estándares de Código
- Version: Python 3.11+
- Linter/Formatter:
ruff checkyruff format(line length 88). - Type Hints: Requeridos para todas las funciones públicas.
- Docstrings: Estilo Google.
2. Estructura del Proyecto
backend/
├── obsidianrag/
│ ├── config.py # Pydantic Settings
│ ├── api/ # FastAPI app
│ ├── core/ # RAG logic, DB service
│ └── utils/ # Logging, helpers
3. Patrones Clave
Configuración (Pydantic)
Usa obsidianrag.config.settings para acceder a la configuración global.
from obsidianrag.config import settings
def my_func():
db_path = settings.db_path
FastAPI Lifespan
La inicialización de recursos (DB, Agentes) ocurre en el lifespan en api/server.py.
Adding Dependencies
Usa uv para gestionar paquetes.
cd backend
uv add package-name
uv add --dev pytest-something
4. Antes de hacer Commit
Ejecuta siempre:
cd backend
uv run ruff format obsidianrag/ tests/
uv run ruff check obsidianrag/ tests/ --fix
uv run pytest tests/ -m "not slow"
Converted and distributed by TomeVault — claim your Tome and manage your conversions.