fastapi-fullstack 0.1.7__py3-none-any.whl

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/.dockerignore

@@ -0,0 +1,60 @@
+{%- if cookiecutter.enable_docker %}
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv
+venv/
+ENV/
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# Testing
+.pytest_cache
+.coverage
+htmlcov/
+.tox
+.nox
+
+# Documentation
+docs/_build/
+*.md
+!README.md
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# Development files
+.env
+.env.local
+*.db
+*.sqlite
+
+# Docker
+Dockerfile*
+docker-compose*.yml
+.docker
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+
+# Misc
+.DS_Store
+Thumbs.db
+*.log
+{%- else %}
+# Docker is disabled
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/.env.example

@@ -0,0 +1,155 @@
+# {{ cookiecutter.project_name }} Environment Variables
+
+# === Project ===
+PROJECT_NAME={{ cookiecutter.project_name }}
+DEBUG=true
+ENVIRONMENT=local
+
+{%- if cookiecutter.enable_logfire %}
+
+# === Logfire ===
+# Get your token at https://logfire.pydantic.dev
+LOGFIRE_TOKEN=
+LOGFIRE_SERVICE_NAME={{ cookiecutter.project_slug }}
+LOGFIRE_ENVIRONMENT=development
+{%- endif %}
+
+{%- if cookiecutter.use_postgresql %}
+
+# === PostgreSQL ===
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=postgres
+POSTGRES_DB={{ cookiecutter.project_slug }}
+{%- endif %}
+
+{%- if cookiecutter.use_mongodb %}
+
+# === MongoDB ===
+MONGO_HOST=localhost
+MONGO_PORT=27017
+MONGO_DB={{ cookiecutter.project_slug }}
+# MONGO_USER=
+# MONGO_PASSWORD=
+{%- endif %}
+
+{%- if cookiecutter.use_sqlite %}
+
+# === SQLite ===
+SQLITE_PATH=./{{ cookiecutter.project_slug }}.db
+{%- endif %}
+
+{%- if cookiecutter.use_jwt %}
+
+# === JWT Auth ===
+# Generate with: openssl rand -hex 32
+SECRET_KEY=change-me-in-production-use-openssl-rand-hex-32
+ACCESS_TOKEN_EXPIRE_MINUTES=10080
+ALGORITHM=HS256
+{%- endif %}
+
+{%- if cookiecutter.use_api_key %}
+
+# === API Key Auth ===
+API_KEY=change-me-in-production
+API_KEY_HEADER=X-API-Key
+{%- endif %}
+
+{%- if cookiecutter.enable_redis %}
+
+# === Redis ===
+REDIS_HOST=localhost
+REDIS_PORT=6379
+# REDIS_PASSWORD=
+REDIS_DB=0
+{%- endif %}
+
+{%- if cookiecutter.use_celery %}
+
+# === Celery ===
+CELERY_BROKER_URL=redis://localhost:6379/0
+CELERY_RESULT_BACKEND=redis://localhost:6379/0
+{%- endif %}
+
+{%- if cookiecutter.use_taskiq %}
+
+# === Taskiq ===
+TASKIQ_BROKER_URL=redis://localhost:6379/1
+TASKIQ_RESULT_BACKEND=redis://localhost:6379/1
+{%- endif %}
+
+{%- if cookiecutter.enable_sentry %}
+
+# === Sentry ===
+SENTRY_DSN=
+{%- endif %}
+
+{%- if cookiecutter.enable_file_storage %}
+
+# === S3/MinIO Storage ===
+S3_ENDPOINT=
+S3_ACCESS_KEY=
+S3_SECRET_KEY=
+S3_BUCKET={{ cookiecutter.project_slug }}
+S3_REGION=us-east-1
+{%- endif %}
+
+{%- if cookiecutter.enable_ai_agent %}
+
+# === AI Agent ({{ cookiecutter.ai_framework }}, {{ cookiecutter.llm_provider }}) ===
+{%- if cookiecutter.use_openai %}
+OPENAI_API_KEY=
+AI_MODEL=gpt-4o-mini
+{%- endif %}
+{%- if cookiecutter.use_anthropic %}
+ANTHROPIC_API_KEY=
+AI_MODEL=claude-sonnet-4-5-20241022
+{%- endif %}
+{%- if cookiecutter.use_openrouter %}
+OPENROUTER_API_KEY=
+AI_MODEL=anthropic/claude-3.5-sonnet
+{%- endif %}
+AI_TEMPERATURE=0.7
+{%- if cookiecutter.use_langchain %}
+
+# === LangSmith (LangChain Observability) ===
+# Get your API key at https://smith.langchain.com
+LANGCHAIN_TRACING_V2=true
+LANGCHAIN_API_KEY=
+LANGCHAIN_PROJECT={{ cookiecutter.project_slug }}
+LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
+{%- endif %}
+{%- endif %}
+
+{%- if cookiecutter.enable_cors %}
+
+# === CORS ===
+# JSON list of allowed origins (default: localhost:3000, localhost:8080)
+# Note: "*" is blocked in production - specify explicit origins
+CORS_ORIGINS=["http://localhost:3000","http://localhost:8080"]
+{%- endif %}
+
+{%- if cookiecutter.enable_docker %}
+
+# === Docker Production (Traefik) ===
+# Domain for production deployment
+DOMAIN=example.com
+
+# Let's Encrypt email for SSL certificates
+ACME_EMAIL=admin@example.com
+
+# Traefik dashboard auth (generate with: htpasswd -nb admin password)
+# TRAEFIK_DASHBOARD_AUTH=admin:$$apr1$$...
+
+{%- if cookiecutter.enable_redis %}
+# Redis password for production
+REDIS_PASSWORD=change-me-in-production
+{%- endif %}
+
+{%- if cookiecutter.use_celery %}
+# Flower monitoring credentials
+FLOWER_USER=admin
+FLOWER_PASSWORD=change-me-in-production
+{%- endif %}
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/.pre-commit-config.yaml

@@ -0,0 +1,32 @@
+{%- if cookiecutter.enable_precommit %}
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.0.0
+          - pydantic-settings>=2.0.0
+        args: [--ignore-missing-imports]
+{%- else %}
+# Pre-commit is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/Dockerfile

@@ -0,0 +1,56 @@
+{%- if cookiecutter.enable_docker %}
+# Build stage
+FROM python:{{ cookiecutter.python_version }}-slim AS builder
+
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+WORKDIR /app
+
+# Install uv
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv
+ENV UV_COMPILE_BYTECODE=1
+ENV UV_LINK_MODE=copy
+
+# Install dependencies
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --frozen --no-install-project --no-dev
+
+# Copy application
+COPY . /app
+
+# Install project
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev
+
+
+# Runtime stage
+FROM python:{{ cookiecutter.python_version }}-slim
+
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+WORKDIR /app
+
+# Copy virtual environment from builder
+COPY --from=builder /app/.venv /app/.venv
+COPY --from=builder /app /app
+
+# Add venv to path
+ENV PATH="/app/.venv/bin:$PATH"
+
+# Create non-root user
+RUN adduser --disabled-password --gecos "" appuser && \
+    chown -R appuser:appuser /app
+USER appuser
+
+EXPOSE {{ cookiecutter.backend_port }}
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD python -c "import httpx; httpx.get('http://localhost:{{ cookiecutter.backend_port }}/api/v1/health')" || exit 1
+
+CMD ["python", "-m", "cli.commands", "server", "run", "--host", "0.0.0.0", "--port", "{{ cookiecutter.backend_port }}"]
+{%- else %}
+# Docker is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/alembic/env.py

@@ -0,0 +1,76 @@
+{%- if cookiecutter.use_postgresql or cookiecutter.use_sqlite %}
+"""Alembic migration environment."""
+# ruff: noqa: I001 - Imports structured for Jinja2 template conditionals
+
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+from app.core.config import settings
+from app.db.base import Base
+
+# Import all models here to ensure they are registered with Base.metadata
+{%- if cookiecutter.use_jwt %}
+from app.db.models.user import User  # noqa: F401
+{%- endif %}
+
+config = context.config
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+
+def get_url() -> str:
+    """Get database URL from settings."""
+{%- if cookiecutter.use_postgresql %}
+    return settings.DATABASE_URL_SYNC
+{%- else %}
+    return settings.DATABASE_URL
+{%- endif %}
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode."""
+    url = get_url()
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode."""
+    configuration = config.get_section(config.config_ini_section)
+    configuration["sqlalchemy.url"] = get_url()
+
+    connectable = engine_from_config(
+        configuration,
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+        )
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()
+{%- else %}
+# Alembic - not configured (no SQL database)
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/alembic/script.py.mako

@@ -0,0 +1,30 @@
+{%- if cookiecutter.use_postgresql or cookiecutter.use_sqlite %}
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}
+{%- else %}
+# Alembic - not configured
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/alembic.ini

@@ -0,0 +1,48 @@
+{%- if cookiecutter.use_postgresql or cookiecutter.use_sqlite %}
+# Alembic Configuration
+
+[alembic]
+script_location = alembic
+prepend_sys_path = .
+version_path_separator = os
+# Human-readable migration file names: 2024-01-15_add_users_table.py
+file_template = %%(year)d-%%(month).2d-%%(day).2d_%%(slug)s
+
+[post_write_hooks]
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S
+{%- else %}
+# Alembic - not configured (no SQL database)
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/__init__.py

@@ -0,0 +1,3 @@
+"""{{ cookiecutter.project_description }}"""
+
+__version__ = "0.1.0"