python-backend

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 check y ruff 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"