fastforge-cli 0.0.1__py3-none-any.whl

fastforge/infra_template/cookiecutter.json

@@ -0,0 +1,11 @@
+{
+  "project_slug": "my-fastapi-service",
+
+  "log_agent": ["none", "vector", "fluentbit"],
+  "log_aggregator": ["none", "vector", "logstash"],
+  "streaming": ["none", "enabled"],
+  "secrets": ["none", "vault"],
+  "database": ["none", "postgres", "mongodb"],
+
+  "_copy_without_render": []
+}

fastforge/infra_template/hooks/post_gen_project.py

@@ -0,0 +1,77 @@
+"""Post-generation hook for infrastructure template — removes unused service files."""
+
+import os
+import shutil
+
+PROJECT_DIR = os.path.realpath(os.path.curdir)
+
+
+def remove_path(rel_path: str) -> None:
+    abs_path = os.path.join(PROJECT_DIR, rel_path)
+    if os.path.isdir(abs_path):
+        shutil.rmtree(abs_path)
+    elif os.path.isfile(abs_path):
+        os.remove(abs_path)
+
+
+# ── Log Agent ────────────────────────────────────────────────────────────────
+log_agent = "{{ cookiecutter.log_agent }}"
+log_aggregator = "{{ cookiecutter.log_aggregator }}"
+
+if log_agent == "none":
+    remove_path("docker-compose.vector-agent.yml")
+    remove_path("docker-compose.fluentbit.yml")
+elif log_agent == "vector":
+    remove_path("docker-compose.fluentbit.yml")
+    remove_path("fluentbit")
+elif log_agent == "fluentbit":
+    remove_path("docker-compose.vector-agent.yml")
+    remove_path("vector/vector-agent.toml")
+
+# ── Log Aggregator ───────────────────────────────────────────────────────────
+if log_aggregator == "none":
+    remove_path("docker-compose.vector-aggregator.yml")
+    remove_path("docker-compose.logstash.yml")
+    remove_path("docker-compose.elasticsearch.yml")
+elif log_aggregator == "vector":
+    remove_path("docker-compose.logstash.yml")
+    remove_path("logstash")
+elif log_aggregator == "logstash":
+    remove_path("docker-compose.vector-aggregator.yml")
+    remove_path("vector/vector-aggregator.toml")
+
+# Clean up empty vector dir if neither uses it
+if log_agent != "vector" and log_aggregator != "vector":
+    remove_path("vector")
+
+# Remove FluentBit if not used as agent
+if log_agent != "fluentbit":
+    remove_path("fluentbit")
+
+# Remove Logstash if not used as aggregator
+if log_aggregator != "logstash":
+    remove_path("logstash")
+
+# No log pipeline means no ES/Kibana needed
+if log_agent == "none" and log_aggregator == "none":
+    remove_path("docker-compose.elasticsearch.yml")
+
+# ── Kafka ────────────────────────────────────────────────────────────────────
+# Kafka needed for streaming OR as log transport
+needs_kafka = "{{ cookiecutter.streaming }}" != "none" or log_agent != "none"
+if not needs_kafka:
+    remove_path("docker-compose.kafka.yml")
+
+# ── Database ─────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.database }}" != "postgres":
+    remove_path("docker-compose.postgres.yml")
+if "{{ cookiecutter.database }}" != "mongodb":
+    remove_path("docker-compose.mongodb.yml")
+
+# ── Vault ────────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.secrets }}" != "vault":
+    remove_path("docker-compose.vault.yml")
+    remove_path("vault")
+
+print("\n✅ Infrastructure stack generated: {{ cookiecutter.project_slug }}-infrastructure/")
+print("   cd {{ cookiecutter.project_slug }}-infrastructure && docker compose up -d")

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/README.md

@@ -0,0 +1,41 @@
+# {{ cookiecutter.project_slug }} — Infrastructure Stack
+
+Docker Compose stack for supporting services (local development / staging).
+
+## Quick Start
+
+```bash
+docker compose up -d
+```
+
+## Services
+
+| Service | Port | Description |
+|---------|------|-------------|
+| App | 8000 | FastAPI application |
+{%- if cookiecutter.log_agent == "vector" %}
+| Vector Agent | — | Log collector (file → Kafka) |
+{%- elif cookiecutter.log_agent == "fluentbit" %}
+| Fluent Bit | — | Log collector (file → Kafka) |
+{%- endif %}
+{%- if cookiecutter.log_aggregator == "vector" %}
+| Vector Aggregator | — | Log pipeline (Kafka → Elasticsearch) |
+{%- elif cookiecutter.log_aggregator == "logstash" %}
+| Logstash | — | Log pipeline (Kafka → Elasticsearch) |
+{%- endif %}
+{%- if cookiecutter.log_agent != "none" or cookiecutter.log_aggregator != "none" %}
+| Elasticsearch | 9200 | Log storage |
+| Kibana | 5601 | Log visualization |
+{%- endif %}
+{%- if cookiecutter.streaming != "none" or cookiecutter.log_agent != "none" %}
+| Kafka | 9092 | Message broker |
+{%- endif %}
+{%- if cookiecutter.database == "postgres" %}
+| PostgreSQL | 5432 | Database |
+{%- endif %}
+{%- if cookiecutter.database == "mongodb" %}
+| MongoDB | 27017 | Database |
+{%- endif %}
+{%- if cookiecutter.secrets == "vault" %}
+| Vault | 8200 | Secret management |
+{%- endif %}

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.app.yml

@@ -0,0 +1,27 @@
+services:
+  app:
+    build:
+      context: ..
+      dockerfile: Dockerfile
+    container_name: {{ cookiecutter.project_slug }}-app
+    ports:
+      - "8000:8000"
+    environment:
+      - APP_ENV=development
+    volumes:
+{%- if cookiecutter.log_agent != "none" %}
+      - app-logs:/var/log/app
+{%- endif %}
+      - ../app:/code/app:ro
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:8000/health || exit 1"]
+      interval: 15s
+      timeout: 5s
+      retries: 3
+
+{%- if cookiecutter.log_agent != "none" %}
+
+volumes:
+  app-logs:
+    name: {{ cookiecutter.project_slug }}-app-logs
+{%- endif %}

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.elasticsearch.yml

@@ -0,0 +1,32 @@
+services:
+  elasticsearch:
+    image: docker.elastic.co/elasticsearch/elasticsearch:8.15.0
+    container_name: {{ cookiecutter.project_slug }}-elasticsearch
+    environment:
+      - discovery.type=single-node
+      - xpack.security.enabled=false
+      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
+    ports:
+      - "9200:9200"
+    volumes:
+      - esdata:/var/lib/elasticsearch/data
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:9200/_cluster/health || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+
+  kibana:
+    image: docker.elastic.co/kibana/kibana:8.15.0
+    container_name: {{ cookiecutter.project_slug }}-kibana
+    environment:
+      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
+    ports:
+      - "5601:5601"
+    depends_on:
+      elasticsearch:
+        condition: service_healthy
+
+volumes:
+  esdata:
+    name: {{ cookiecutter.project_slug }}-esdata

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.fluentbit.yml

@@ -0,0 +1,14 @@
+services:
+  fluentbit:
+    image: fluent/fluent-bit:3.1
+    container_name: {{ cookiecutter.project_slug }}-fluentbit
+    volumes:
+      - ./fluentbit/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf:ro
+      - ./fluentbit/parsers.conf:/fluent-bit/etc/parsers.conf:ro
+      - app-logs:/var/log/app:ro
+    depends_on:
+      - kafka
+
+volumes:
+  app-logs:
+    name: {{ cookiecutter.project_slug }}-app-logs

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.kafka.yml

@@ -0,0 +1,20 @@
+services:
+  kafka:
+    image: confluentinc/cp-kafka:7.7.0
+    container_name: {{ cookiecutter.project_slug }}-kafka
+    environment:
+      KAFKA_NODE_ID: 1
+      KAFKA_PROCESS_ROLES: broker,controller
+      KAFKA_CONTROLLER_QUORUM_VOTERS: 1@kafka:9093
+      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9092,CONTROLLER://0.0.0.0:9093
+      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092
+      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,CONTROLLER:PLAINTEXT
+      KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER
+      CLUSTER_ID: {{ cookiecutter.project_slug }}-kafka-cluster
+    ports:
+      - "9092:9092"
+    healthcheck:
+      test: ["CMD-SHELL", "kafka-broker-api-versions --bootstrap-server localhost:9092"]
+      interval: 30s
+      timeout: 10s
+      retries: 5

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.logstash.yml

@@ -0,0 +1,14 @@
+services:
+  logstash:
+    image: docker.elastic.co/logstash/logstash:8.15.0
+    container_name: {{ cookiecutter.project_slug }}-logstash
+    volumes:
+      - ./logstash/pipeline:/usr/share/logstash/pipeline:ro
+    environment:
+      LS_JAVA_OPTS: "-Xms256m -Xmx256m"
+      XPACK_MONITORING_ENABLED: "false"
+    depends_on:
+      kafka:
+        condition: service_healthy
+      elasticsearch:
+        condition: service_healthy

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.mongodb.yml

@@ -0,0 +1,17 @@
+services:
+  mongodb:
+    image: mongo:7
+    container_name: {{ cookiecutter.project_slug }}-mongodb
+    ports:
+      - "27017:27017"
+    volumes:
+      - mongodata:/data/db
+    healthcheck:
+      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  mongodata:
+    name: {{ cookiecutter.project_slug }}-mongodata

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.postgres.yml

@@ -0,0 +1,21 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: {{ cookiecutter.project_slug }}-postgres
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: {{ cookiecutter.project_slug | replace('-', '_') }}
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  pgdata:
+    name: {{ cookiecutter.project_slug }}-pgdata

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.vault.yml

@@ -0,0 +1,19 @@
+services:
+  vault:
+    image: hashicorp/vault:1.17
+    container_name: {{ cookiecutter.project_slug }}-vault
+    cap_add:
+      - IPC_LOCK
+    environment:
+      VAULT_DEV_ROOT_TOKEN_ID: dev-only-token
+      VAULT_DEV_LISTEN_ADDRESS: 0.0.0.0:8200
+    ports:
+      - "8200:8200"
+    volumes:
+      - ./vault/config.hcl:/vault/config/config.hcl:ro
+      - ./vault/policies:/vault/policies:ro
+    healthcheck:
+      test: ["CMD-SHELL", "vault status || true"]
+      interval: 10s
+      timeout: 5s
+      retries: 3

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.vector-agent.yml

@@ -0,0 +1,13 @@
+services:
+  vector-agent:
+    image: timberio/vector:0.41.1-alpine
+    container_name: {{ cookiecutter.project_slug }}-vector-agent
+    volumes:
+      - ./vector/vector-agent.toml:/etc/vector/vector.toml:ro
+      - app-logs:/var/log/app:ro
+    depends_on:
+      - kafka
+
+volumes:
+  app-logs:
+    name: {{ cookiecutter.project_slug }}-app-logs

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.vector-aggregator.yml

@@ -0,0 +1,9 @@
+services:
+  vector-aggregator:
+    image: timberio/vector:0.41.1-alpine
+    container_name: {{ cookiecutter.project_slug }}-vector-aggregator
+    volumes:
+      - ./vector/vector-aggregator.toml:/etc/vector/vector.toml:ro
+    depends_on:
+      - kafka
+      - elasticsearch

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/docker-compose.yml

@@ -0,0 +1,31 @@
+# Infrastructure Stack — {{ cookiecutter.project_slug }}
+# Usage:
+#   docker compose -f infrastructure/docker-compose.yml up -d
+
+include:
+  - docker-compose.app.yml
+{%- if cookiecutter.log_agent == "vector" %}
+  - docker-compose.vector-agent.yml
+{%- elif cookiecutter.log_agent == "fluentbit" %}
+  - docker-compose.fluentbit.yml
+{%- endif %}
+{%- if cookiecutter.log_aggregator == "vector" %}
+  - docker-compose.vector-aggregator.yml
+{%- elif cookiecutter.log_aggregator == "logstash" %}
+  - docker-compose.logstash.yml
+{%- endif %}
+{%- if cookiecutter.log_agent != "none" or cookiecutter.log_aggregator != "none" %}
+  - docker-compose.elasticsearch.yml
+{%- endif %}
+{%- if cookiecutter.streaming != "none" or cookiecutter.log_agent != "none" %}
+  - docker-compose.kafka.yml
+{%- endif %}
+{%- if cookiecutter.database == "postgres" %}
+  - docker-compose.postgres.yml
+{%- endif %}
+{%- if cookiecutter.database == "mongodb" %}
+  - docker-compose.mongodb.yml
+{%- endif %}
+{%- if cookiecutter.secrets == "vault" %}
+  - docker-compose.vault.yml
+{%- endif %}

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/fluentbit/fluent-bit.conf

@@ -0,0 +1,24 @@
+[SERVICE]
+    Flush        1
+    Daemon       Off
+    Log_Level    info
+    Parsers_File parsers.conf
+
+[INPUT]
+    Name         tail
+    Path         /var/log/app/*.log
+    Tag          app.*
+    Parser       json
+    Read_from_Head True
+    Refresh_Interval 5
+    Rotate_Wait  30
+    DB           /fluent-bit/etc/tail.db
+
+[OUTPUT]
+    Name         kafka
+    Match        app.*
+    Brokers      kafka:9092
+    Topics       app-logs
+    Format       json
+    Timestamp_Key @timestamp
+    Retry_Limit  5

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/fluentbit/parsers.conf

@@ -0,0 +1,5 @@
+[PARSER]
+    Name        json
+    Format      json
+    Time_Key    timestamp
+    Time_Format %Y-%m-%dT%H:%M:%S.%L%z

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/logstash/pipeline/logstash.conf

@@ -0,0 +1,31 @@
+input {
+  kafka {
+    bootstrap_servers => "kafka:9092"
+    topics => ["app-logs"]
+    group_id => "logstash-aggregator"
+    codec => "json"
+    consumer_threads => 1
+  }
+}
+
+filter {
+  mutate {
+    add_field => {
+      "service" => "{{ cookiecutter.project_slug }}"
+      "indexed_at" => "%{@timestamp}"
+    }
+  }
+
+  if [environment] == "" {
+    mutate {
+      add_field => { "environment" => "unknown" }
+    }
+  }
+}
+
+output {
+  elasticsearch {
+    hosts => ["http://elasticsearch:9200"]
+    index => "{{ cookiecutter.project_slug }}-logs-%{+YYYY.MM.dd}"
+  }
+}

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/vault/config.hcl

@@ -0,0 +1,10 @@
+storage "file" {
+  path = "/vault/file"
+}
+
+listener "tcp" {
+  address     = "0.0.0.0:8200"
+  tls_disable = 1
+}
+
+ui = true

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/vault/policies/app-policy.hcl

@@ -0,0 +1,7 @@
+path "secret/data/{{ cookiecutter.project_slug }}/*" {
+  capabilities = ["read", "list"]
+}
+
+path "secret/metadata/{{ cookiecutter.project_slug }}/*" {
+  capabilities = ["list"]
+}

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/vector/vector-agent.toml

@@ -0,0 +1,36 @@
+# Vector Agent — collects logs from file → forwards to Kafka
+
+[sources.app_logs]
+type = "file"
+include = ["/var/log/app/*.log"]
+read_from = "beginning"
+fingerprint.strategy = "device_and_inode"
+
+[transforms.parse_json]
+type = "remap"
+inputs = ["app_logs"]
+source = '''
+parsed, err = parse_json(.message)
+if err == null {
+  . = merge(., parsed)
+  del(.message)
+} else {
+  .raw_message = .message
+  del(.message)
+}
+.source = "vector-agent"
+.pipeline = "file-to-kafka"
+.log_file = .file
+'''
+
+[sinks.kafka]
+type = "kafka"
+inputs = ["parse_json"]
+bootstrap_servers = "kafka:9092"
+topic = "app-logs"
+encoding.codec = "json"
+
+[sinks.kafka.buffer]
+type = "disk"
+max_size = 268435456
+when_full = "block"

fastforge/infra_template/{{cookiecutter.project_slug}}-infrastructure/vector/vector-aggregator.toml

@@ -0,0 +1,29 @@
+# Vector Aggregator — consumes from Kafka → sinks to Elasticsearch
+
+[sources.kafka]
+type = "kafka"
+bootstrap_servers = "kafka:9092"
+group_id = "vector-aggregator"
+topics = ["app-logs"]
+decoding.codec = "json"
+
+[transforms.enrich]
+type = "remap"
+inputs = ["kafka"]
+source = '''
+.environment = get_env_var("APP_ENV") ?? "unknown"
+.service = "{{ cookiecutter.project_slug }}"
+.indexed_at = now()
+'''
+
+[sinks.elasticsearch]
+type = "elasticsearch"
+inputs = ["enrich"]
+endpoints = ["http://elasticsearch:9200"]
+bulk.index = "{{ cookiecutter.project_slug }}-logs-%Y-%m-%d"
+encoding.except_fields = ["source_type"]
+
+[sinks.elasticsearch.buffer]
+type = "disk"
+max_size = 268435456
+when_full = "block"

fastforge/template/cookiecutter.json

@@ -0,0 +1,34 @@
+{
+  "project_name": "my-fastapi-service",
+  "project_slug": "{{ cookiecutter.project_name.lower().replace(' ', '-').replace('_', '-') }}",
+  "package_name": "{{ cookiecutter.project_slug.replace('-', '_') }}",
+  "description": "A production-grade FastAPI service",
+  "author_name": "Your Name",
+  "author_email": "you@example.com",
+  "python_version": "3.11",
+  "port": "8000",
+
+  "model_name": "item",
+  "model_name_class": "Item",
+  "model_name_plural": "items",
+
+  "database": ["none", "postgres", "mysql", "sqlite", "mongodb"],
+  "cache": ["none", "redis", "memcached", "in_memory"],
+  "streaming": ["none", "kafka", "rabbitmq", "redis_pubsub", "nats"],
+  "secrets": ["none", "vault", "aws_sm", "azure_kv", "gcp_sm"],
+
+  "logging": ["structlog", "none"],
+  "log_format": ["json", "console"],
+  "log_connector": ["stdout", "file"],
+
+  "quality_gate": ["none", "sonarqube", "sonarcloud", "qodana", "codeclimate"],
+
+  "docker": ["yes", "no"],
+  "docker_debug": ["yes", "no"],
+
+  "precommit": ["yes", "no"],
+
+  "_copy_without_render": [
+    "*.html"
+  ]
+}

fastforge/template/hooks/post_gen_project.py

@@ -0,0 +1,71 @@
+"""Post-generation hook — removes files and directories for disabled features."""
+
+import os
+import shutil
+
+PROJECT_DIR = os.path.realpath(os.path.curdir)
+
+
+def remove_path(rel_path: str) -> None:
+    abs_path = os.path.join(PROJECT_DIR, rel_path)
+    if os.path.isdir(abs_path):
+        shutil.rmtree(abs_path)
+    elif os.path.isfile(abs_path):
+        os.remove(abs_path)
+
+
+# ── Logging ──────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.logging }}" == "none":
+    remove_path("app/logging_config.py")
+    remove_path("app/middleware/logging_middleware.py")
+
+# ── Database ─────────────────────────────────────────────────────────────────
+database = "{{ cookiecutter.database }}"
+if database == "none":
+    remove_path("app/db")
+elif database in ("postgres", "mysql", "sqlite"):
+    remove_path("app/db/mongodb.py")
+elif database == "mongodb":
+    remove_path("app/db/sqlalchemy.py")
+
+# ── Cache ────────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.cache }}" == "none":
+    remove_path("app/cache.py")
+
+# ── Streaming ────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.streaming }}" == "none":
+    remove_path("app/streaming")
+
+# ── Secrets ──────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.secrets }}" == "none":
+    remove_path("app/secrets.py")
+
+# ── Quality Gate ─────────────────────────────────────────────────────────────
+quality_gate = "{{ cookiecutter.quality_gate }}"
+if quality_gate != "sonarqube" and quality_gate != "sonarcloud":
+    remove_path("sonar-project.properties")
+if quality_gate != "qodana":
+    remove_path("qodana.yaml")
+if quality_gate != "codeclimate":
+    remove_path(".codeclimate.yml")
+
+# ── Docker ───────────────────────────────────────────────────────────────────
+if "{{ cookiecutter.docker }}" != "yes":
+    remove_path("Dockerfile")
+    remove_path(".dockerignore")
+    remove_path("docker-compose.yml")
+    remove_path("docker-compose.debug.yml")
+elif "{{ cookiecutter.docker_debug }}" != "yes":
+    remove_path("docker-compose.debug.yml")
+
+# ── Pre-commit ───────────────────────────────────────────────────────────────
+if "{{ cookiecutter.precommit }}" != "yes":
+    remove_path(".pre-commit-config.yaml")
+
+# ── Init git repo ────────────────────────────────────────────────────────────
+os.system("git init -q")
+os.system("git add .")
+os.system('git commit -q -m "Initial project from FastForge"')
+
+print("\n✅ {{ cookiecutter.project_name }} generated successfully!")
+print("   cd {{ cookiecutter.project_slug }} && pip install -e '.[dev]'")

fastforge/template/{{cookiecutter.project_slug}}/.codeclimate.yml

@@ -0,0 +1,40 @@
+version: "2"
+
+plugins:
+  pep8:
+    enabled: true
+  radon:
+    enabled: true
+    config:
+      threshold: "C"
+  bandit:
+    enabled: true
+
+checks:
+  argument-count:
+    config:
+      threshold: 5
+  complex-logic:
+    config:
+      threshold: 4
+  file-lines:
+    config:
+      threshold: 300
+  method-complexity:
+    config:
+      threshold: 10
+  method-count:
+    config:
+      threshold: 15
+  method-lines:
+    config:
+      threshold: 30
+  return-statements:
+    config:
+      threshold: 4
+
+exclude_patterns:
+  - "tests/"
+  - ".venv/"
+  - "__pycache__/"
+  - "migrations/"