swiftpy-framework 0.1.0__tar.gz

swiftpy_framework-0.1.0/.dockerignore

@@ -0,0 +1,30 @@
+__pycache__
+*.py[cod]
+*$py.class
+.venv
+.env
+.env.*
+!.env.example
+.git
+.github
+.gitignore
+.pytest_cache
+.mypy_cache
+.ruff_cache
+.coverage
+.coverage.*
+htmlcov
+dist
+build
+docker-compose*.yml
+Dockerfile*
+storage/cache/*
+storage/logs/*
+storage/app/public/*
+bootstrap/cache/*.json
+docs
+AGENTS.md
+DEVLOG.md
+COMMANDS.md
+PROMPTS.md
+tests

swiftpy_framework-0.1.0/.env.example

@@ -0,0 +1,101 @@
+# Application Configuration
+APP_NAME=SwiftPY
+APP_ENV=local
+APP_KEY=
+# Keep APP_DEBUG=false in staging/production; enable only for local debugging.
+APP_DEBUG=false
+APP_URL=http://localhost:8000
+
+# Server (Uvicorn)
+SERVER_HOST=127.0.0.1
+SERVER_PORT=8000
+SERVER_WORKERS=1
+SERVER_RELOAD=true
+
+# Database (PostgreSQL / asyncpg)
+DB_CONNECTION=postgresql
+DB_HOST=127.0.0.1
+DB_PORT=5432
+DB_DATABASE=swiftpy
+DB_USERNAME=postgres
+DB_PASSWORD=secret
+DB_SSL=disable
+DB_SSL_CA_FILE=
+DB_POOL_MIN_SIZE=5
+DB_POOL_MAX_SIZE=20
+DB_POOL_MAX_QUERIES=50000
+DB_POOL_MAX_INACTIVE_LIFETIME=300.0
+DB_COMMAND_TIMEOUT=60.0
+DB_CONNECT_TIMEOUT=10.0
+DB_STATEMENT_TIMEOUT=30.0
+DB_TRANSACTION_TIMEOUT=60.0
+
+# Redis (Shared or dedicated instances)
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_CACHE_DB=0
+REDIS_QUEUE_DB=1
+REDIS_EVENTS_DB=2
+
+# Cache
+CACHE_DRIVER=redis
+CACHE_PREFIX=swiftpy_cache:
+CACHE_DEFAULT_TTL=3600
+
+# Queue
+QUEUE_DRIVER=redis
+QUEUE_PREFIX=swiftpy_queue:
+QUEUE_NAME=default
+
+# Filesystems & Storage
+FILESYSTEM_DISK=local
+STORAGE_LOCAL_ROOT=storage/app/private
+STORAGE_PUBLIC_ROOT=storage/app/public
+STORAGE_PUBLIC_URL=/storage
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_ENDPOINT=
+
+# Mail Subsystem
+MAIL_MAILER=smtp
+MAIL_HOST=127.0.0.1
+MAIL_PORT=587
+MAIL_USERNAME=
+MAIL_PASSWORD=
+MAIL_ENCRYPTION=starttls
+MAIL_TIMEOUT=30.0
+MAIL_VALIDATE_CERTS=true
+MAIL_FROM_ADDRESS=noreply@example.com
+MAIL_FROM_NAME="${APP_NAME}"
+RESEND_API_KEY=
+SENDGRID_API_KEY=
+MAILGUN_API_KEY=
+MAILGUN_DOMAIN=
+
+# Authentication & Security
+AUTH_GUARD=jwt
+JWT_SECRET=
+JWT_ALGORITHM=HS256
+JWT_ACCESS_TTL=900
+JWT_REFRESH_TTL=604800
+AUTH_KEY_PEPPER=
+
+# CORS (use explicit comma-separated origins; never pair '*' with CORS_ALLOW_CREDENTIALS=true)
+CORS_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:8000
+CORS_ALLOW_CREDENTIALS=false
+CORS_MAX_AGE=600
+
+# Logging
+LOG_CHANNEL=stack
+LOG_LEVEL=info
+
+# AI Subsystem
+AI_ENABLED=true
+AI_DEFAULT_PROVIDER=openai
+OPENAI_API_KEY=
+OPENAI_MODEL=gpt-4o
+ANTHROPIC_API_KEY=
+ANTHROPIC_MODEL=claude-3-5-sonnet-20241022

swiftpy_framework-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,144 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: Test, lint, type-check, and package validation
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: pgvector/pgvector:pg16
+        env:
+          POSTGRES_DB: swiftpy
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: secret
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres -d swiftpy"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+
+      redis:
+        image: redis:7-alpine
+        command: "redis-server --requirepass secret"
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd "redis-cli -a secret ping"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+
+    env:
+      APP_ENV: testing
+      APP_KEY: "base64:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
+      JWT_SECRET: "very-long-and-secure-test-jwt-secret-key-32bytes!"
+      AUTH_KEY_PEPPER: "very-long-and-secure-test-auth-pepper-32bytes!"
+      DB_CONNECTION: postgresql
+      DATABASE_DEFAULT: postgresql
+      DB_HOST: localhost
+      DB_PORT: 5432
+      DB_DATABASE: swiftpy
+      DB_USERNAME: postgres
+      DB_PASSWORD: secret
+      DB_POOL_MAX_SIZE: 20
+      REDIS_HOST: localhost
+      REDIS_PORT: 6379
+      REDIS_PASSWORD: secret
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install SwiftPY development dependencies
+        run: uv sync --group dev --frozen || uv sync --group dev
+
+      - name: Run pytest with coverage gate
+        run: COVERAGE_FILE=/tmp/.coverage uv run pytest -vv -ra --durations=30 --timeout=120 --timeout-method=thread --cov=swiftpy --cov-report=term-missing --cov-fail-under=80
+
+      - name: Run Ruff
+        run: uv run ruff check .
+
+      - name: Run strict mypy
+        run: |
+          uv run --no-sync --with jinja2 --with aiosmtplib mypy swiftpy
+          uv run mypy swiftpy
+          uv run mypy .
+          uv run mypy --explicit-package-bases .
+
+      - name: Dependency security audit
+        run: uv run --no-sync --with pip-audit pip-audit --desc on
+
+      - name: Build and validate distributions
+        run: |
+          uv build
+          uv run --with twine twine check dist/*
+
+      - name: Smoke-test built wheel in isolated clean venv
+        run: |
+          uv venv /tmp/swiftpy-wheel-smoke --python 3.12 --clear
+          uv pip install --python /tmp/swiftpy-wheel-smoke/bin/python dist/*.whl
+          /tmp/swiftpy-wheel-smoke/bin/swiftpy --help
+          (
+            cd /tmp && /tmp/swiftpy-wheel-smoke/bin/python -c '
+          import asyncio
+          import swiftpy
+          import swiftpy.admin
+          import swiftpy.testing
+          from swiftpy import Application, Request, json_response
+          from swiftpy.ai.client import AI, AIClient
+          from swiftpy.ai.embeddings import EmbeddingsClient, generate_deterministic_embedding
+
+          assert hasattr(swiftpy, "ai")
+          app = Application(auto_discover_providers=False)
+
+          @app.get("/smoke")
+          async def smoke(req: Request):
+              return json_response({"ok": True})
+
+          sent = []
+          async def receive():
+              return {"type": "http.request", "body": b"", "more_body": False}
+
+          async def send(msg):
+              sent.append(msg)
+
+          async def main():
+              scope = {
+                  "type": "http",
+                  "asgi": {"version": "3.0"},
+                  "method": "GET",
+                  "path": "/smoke",
+                  "raw_path": b"/smoke",
+                  "query_string": b"",
+                  "headers": [],
+              }
+              await app(scope, receive, send)
+              assert sent[0]["status"] == 200
+              fake = AI.fake("smoke-ok")
+              resp = await AI.chat().user("hello").send()
+              assert resp.content == "smoke-ok"
+              fake.restore()
+              vec = generate_deterministic_embedding("hello", dimensions=8)
+              assert len(vec) == 8
+
+          asyncio.run(main())
+          '
+                    )
+          rm -rf /tmp/swiftpy-wheel-smoke

swiftpy_framework-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    name: Build and publish package
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install build tooling
+        run: uv sync --group dev --frozen || uv sync --group dev
+
+      - name: Build wheel and source distribution
+        run: uv build
+
+      - name: Validate package artifacts
+        run: uv run --with twine twine check dist/*
+
+      - name: Publish to PyPI via trusted publishing
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1 (v1.14.3)
+        with:
+          packages-dir: dist/

swiftpy_framework-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+*.pyo
+*.pyd
+
+.env
+.env.*
+!.env.example
+
+storage/cache/
+storage/logs/
+bootstrap/cache/*.json
+!bootstrap/cache/.gitkeep
+.venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+.coverage
+.coverage.*
+htmlcov/
+dist/
+build/
+*.egg-info/
+
+COMMANDS.md
+PROMPTS.md
+/docs/
+AGENTS.md
+DEVLOG.md