fastango 0.1.0__tar.gz

fastango-0.1.0/.github/FUNDING.yaml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+github: yezz123
+polar: yezz123

fastango-0.1.0/.github/SECURITY.md

@@ -0,0 +1,14 @@
+# Security Policy
+
+## Supported Versions
+
+We will endeavour to support:
+
+* the most recent minor release with bug fixes
+* the latest minor release from the last major version for 6 months after a new major version is released with critical bug fixes
+
+## Reporting a Vulnerability
+
+If you find what you think might be a security vulnerability with pydantic,
+please do not create an issue on github. Instead please email <dev@yezz.me>
+I'll reply to your email promptly and try to get a patch out ASAP.

fastango-0.1.0/.github/dependabot.yaml

@@ -0,0 +1,25 @@
+version: 2
+
+updates:
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: ⬆
+    labels:
+      - "upgrade"
+  # Python
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python-packages:
+        patterns:
+          - "*"
+    commit-message:
+      prefix: ⬆
+    labels:
+      - "upgrade"

fastango-0.1.0/.github/workflows/ci.yaml

@@ -0,0 +1,91 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: setup uv
+        uses: yezz123/setup-uv@v4.1
+        with:
+          uv-venv: ".venv"
+
+      - name: Install Dependencies
+        run: uv sync --group lint --group type --all-extras
+
+      - name: Typecheck with mypy
+        run: bash scripts/mypy.sh
+
+      - name: Lint with ruff
+        run: bash scripts/format.sh
+
+  tests:
+
+    name: test py${{ matrix.python-version }} on ${{ matrix.os }}
+
+    runs-on: ${{ matrix.os }}-latest
+
+
+    strategy:
+
+      matrix:
+
+        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14"]
+
+        os: [ubuntu]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: setup UV
+        uses: yezz123/setup-uv@v4.1
+        with:
+          uv-venv: ".venv"
+
+      - name: Install Dependencies
+        run: uv sync --group test --all-extras
+
+      - name: Test with pytest - ${{ matrix.os }} - py${{ matrix.python-version }}
+        run: bash scripts/tests.sh
+        env:
+          CONTEXT: ${{ runner.os }}-py${{ matrix.python-version }}-with-deps
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v6
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+
+  # https://github.com/marketplace/actions/alls-green#why
+  # used for branch protection checks
+  check:
+    if: always()
+
+    needs: [lint, tests]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Decide whether the needed jobs succeeded or failed
+        uses: re-actors/alls-green@release/v1
+        with:
+          jobs: ${{ toJSON(needs) }}

fastango-0.1.0/.github/workflows/release.yaml

@@ -0,0 +1,33 @@
+name: Publish
+
+on:
+  release:
+    types:
+      - created
+
+jobs:
+
+  release:
+    runs-on: ubuntu-latest
+
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: check version
+        id: check-tag
+        uses: samuelcolvin/check-python-version@v5
+        with:
+          version_file_path: fastango/__init__.py
+
+      - name: build
+        run: uv build
+
+      - name: Upload package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

fastango-0.1.0/.gitignore

@@ -0,0 +1,121 @@
+# mypy
+.mypy_cache/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+.idea/
+.vscode/
+
+# Project
+postgres-data
+.DS_Store
+
+# Generated by tests
+authx_profiling_results.*
+*.db
+
+# Generated by linting
+.ruff_cache/

fastango-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+    -   id: check-added-large-files
+    -   id: check-toml
+    -   id: check-yaml
+        args:
+        -   --unsafe
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.13
+    hooks:
+    -   id: ruff
+        args:
+        - --fix
+    -   id: ruff-format
+-   repo: https://github.com/codespell-project/codespell
+    rev: v2.4.2
+    hooks:
+    -   id: codespell
+        additional_dependencies:
+            - tomli

fastango-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yasser Tahiri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fastango-0.1.0/PKG-INFO

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: fastango
+Version: 0.1.0
+Summary: A uv-first CLI for generating FastAPI projects with optional integrations.
+Project-URL: Homepage, https://github.com/yezz123/fastango
+Project-URL: Repository, https://github.com/yezz123/fastango
+Project-URL: Issues, https://github.com/yezz123/fastango/issues
+Project-URL: Funding, https://github.com/sponsors/yezz123
+Author-email: Yasser Tahiri <hello@yezz.me>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: CLI,FastAPI,Pydantic,scaffold,template,uv
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: ai
+Requires-Dist: httpx>=0.27.0; extra == 'ai'
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD033 -->
+<p align="center">
+  <img src="https://raw.githubusercontent.com/yezz123/fastango/fa66a81b925515f2a3777c91d66132b8998b9421/docs/logo.png" alt="Fastango logo" width="240">
+</p>
+
+<p align="center">
+  <a href="https://github.com/yezz123/fastango/actions/workflows/ci.yaml">
+    <img src="https://github.com/yezz123/fastango/actions/workflows/ci.yaml/badge.svg" alt="Continuous Integration">
+  </a>
+  <a href="https://codecov.io/gh/yezz123/fastango">
+    <img src="https://codecov.io/gh/yezz123/fastango/branch/main/graph/badge.svg?token=8ZKMD474LT" alt="Codecov">
+  </a>
+  <a href="https://pypi.org/project/fastango">
+    <img src="https://img.shields.io/pypi/v/fastango?color=%2334D058&label=pypi%20package" alt="PyPI package">
+  </a>
+  <a href="https://pepy.tech/project/fastango">
+    <img src="https://static.pepy.tech/badge/fastango" alt="Downloads">
+  </a>
+  <a href="https://pydantic.dev">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/pydantic/pydantic/main/docs/badge/v2.json" alt="Pydantic Version 2">
+  </a>
+  <a href="https://github.com/astral-sh/ruff">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+  </a>
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+">
+  <img src="https://img.shields.io/badge/framework-FastAPI-009688" alt="FastAPI">
+  <img src="https://img.shields.io/badge/package%20manager-uv-654ff0" alt="uv">
+  <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT license">
+</p>
+
+<!-- markdownlint-enable MD033 -->
+
+Fastango is a `uv`-first CLI for generating FastAPI projects with polished terminal flows,
+safe AI-assisted planning, selectable templates, and a growing integration catalog.
+
+It helps teams start a serious FastAPI codebase quickly without copying random boilerplate,
+hardcoding secrets, or letting an AI write unchecked files.
+
+## Why Fastango
+
+| Need | What Fastango Gives You |
+| --- | --- |
+| Start a FastAPI app quickly | `simple` and `mvc` templates with settings, routes, tests, README, and `llms.txt`. |
+| Add common infrastructure | A searchable catalog for auth, billing, databases, queues, storage, observability, AI, deployment, and dev tools. |
+| Generate from product ideas | `fastango generate "a starter MVP"` maps prompts to supported templates, skills, presets, and integrations. |
+| Keep generation safe | The generator only uses Fastango-supported tools and validates provider suggestions before writing files. |
+| Work like modern Python teams | Generated projects use `uv`, Ruff, pytest, typed settings, and clear next-step commands. |
+
+## Highlights
+
+- Branded interactive terminal playground when you run `uvx fastango`.
+- Manual project creation with repeatable flags for CI and documentation.
+- Constrained AI generator for prompt-first FastAPI scaffolding.
+- Live model discovery for Anthropic and OpenAI API keys.
+- Curated presets for starter APIs, SaaS apps, AI APIs, data APIs, and production setups.
+- Generated `llms.txt` so AI assistants understand the project conventions.
+- Validation for integration requirements, conflicts, unsupported tools, and unsafe provider output.
+
+## Install
+
+```bash
+uv tool install fastango
+```
+
+During local development:
+
+```bash
+uv sync --all-groups
+uv run fastango --help
+```
+
+## Quick Start
+
+Run Fastango with no subcommand to open the terminal playground:
+
+```bash
+uvx fastango
+```
+
+You can also launch the playground explicitly:
+
+```bash
+fastango playground
+```
+
+Create a project without prompts:
+
+```bash
+fastango create billing-api \
+  --style mvc \
+  --python 3.12 \
+  --preset saas \
+  --integration openapi \
+  --integration authx \
+  --integration stripe \
+  --with-docker \
+  --no-interactive
+```
+
+Run the generated app:
+
+```bash
+cd billing-api
+uv sync
+cp .env.example .env
+uv run fastapi dev app/main.py
+```
+
+## Generate From A Prompt
+
+Fastango can infer a constrained FastAPI scaffold from a natural-language prompt.
+It does not write arbitrary LLM code directly to disk. It converts your prompt into a typed
+plan made from supported templates, skills, presets, and integrations.
+
+```bash
+fastango generate "a starter MVP with auth, billing, email, analytics and secure webhooks"
+fastango generate "AI SaaS with vector search" --dry-run --json
+```
+
+Optional provider enrichment is available when configured:
+
+```bash
+fastango generate "marketplace MVP with billing and uploads" --provider anthropic
+fastango generate "AI SaaS with vector search" --provider openai --model gpt-4.1-mini
+```
+
+Provider output is validated against the same supported catalog before any files are written.
+Unsupported requests are kept as `not_generated` notes in the preview.
+
+## Model Discovery
+
+If the matching API key is set, Fastango asks the provider which models your key can access.
+If no key is available, it falls back to a curated offline list.
+
+```bash
+fastango models
+fastango models --provider anthropic
+fastango models --provider openai --json
+fastango models --provider openai --static
+```
+
+| Provider | Environment Variable | Model Source |
+| --- | --- | --- |
+| Anthropic | `ANTHROPIC_API_KEY` | Live `/v1/models` discovery with curated fallback. |
+| OpenAI | `OPENAI_API_KEY` | Live `/v1/models` discovery with curated fallback. |
+
+## Templates
+
+| Template | Best For | Includes |
+| --- | --- | --- |
+| `simple` | Small APIs, internal services, demos, first FastAPI apps. | `app/main.py`, routes, schemas, settings, tests, README, `.env.example`, `llms.txt`. |
+| `mvc` | SaaS apps, production APIs, larger teams, integration-heavy projects. | API routes, core settings, services, repositories, schemas, tests, README, `.env.example`, `llms.txt`. |
+
+## Presets
+
+| Preset | Purpose | Typical Stack |
+| --- | --- | --- |
+| `api-starter` | A clean FastAPI baseline. | OpenAPI, tests, CORS, Ruff, pre-commit. |
+| `saas` | Product-ready SaaS API. | AuthX, Stripe, Postgres, Redis, Resend, PostHog, Sentry, Docker. |
+| `ai-api` | AI or RAG-ready backend. | OpenAI, Anthropic, pgvector, Postgres, Redis, tests, Docker. |
+| `data-api` | Data-heavy API with workers. | Postgres, Alembic, Redis, Celery, Prometheus, OpenTelemetry. |
+| `production` | Production hardening. | Docker, GitHub Actions, security headers, Sentry, Prometheus, health checks. |
+
+## Integration Catalog
+
+List, filter, search, and inspect integrations:
+
+```bash
+uv run fastango integrations
+uv run fastango integrations --category database
+uv run fastango integrations --search vector
+uv run fastango integrations --presets
+uv run fastango integrations --json
+```
+
+| Category | Examples |
+| --- | --- |
+| Auth and security | AuthX, FastAPI Users, OAuth, JWT, CORS, rate limiting, CSRF, security headers, roles, API keys. |
+| Databases and ORM | Postgres, SQLite, MySQL, MongoDB, SQLModel, Tortoise, Alembic, Supabase, pgvector. |
+| Cache and jobs | Redis, Celery, Dramatiq, ARQ, RQ, APScheduler, FastAPI background tasks. |
+| SaaS and payments | Stripe, Paddle, Polar, Lemon Squeezy, subscriptions, customer portal, Resend, PostHog, Sentry. |
+| Storage | S3, Cloudflare R2, Google Cloud Storage, local files, Pillow, uploads. |
+| AI and search | OpenAI, Anthropic, Ollama, LangChain, LlamaIndex, Qdrant, Pinecone, Weaviate, Elasticsearch. |
+| Observability | OpenTelemetry, Prometheus, Structlog, Logfire, health checks, audit logs. |
+| API protocols | OpenAPI, GraphQL, WebSockets, SSE, signed webhooks, versioning. |
+| Deployment and dev tools | Docker, Compose overlays, Kubernetes, GitHub Actions, pre-commit, Ruff, mypy, pytest, Dependabot. |
+
+## Generation Skills
+
+Skills are internal, allowlisted generation capabilities. They map product intents to supported
+Fastango templates and integrations.
+
+| Skill | What It Builds |
+| --- | --- |
+| `saas-mvp` | Auth, teams, subscriptions, billing provider, email, analytics, monitoring. |
+| `secure-api` | CORS, security headers, rate limiting, signed webhooks, API keys, secure settings. |
+| `ai-api` | LLM provider, vector store, RAG-ready services, cache, background jobs. |
+| `marketplace` | Users, teams, payments, uploads, webhooks, audit logs. |
+| `crud-api` | Database, CRUD routes, pagination, filters, tests. |
+| `production-api` | Docker, GitHub Actions, health checks, observability, dependency hygiene. |
+
+## Safety Model
+
+| Rule | Why It Matters |
+| --- | --- |
+| No arbitrary raw code from providers | LLMs can suggest supported IDs, but Fastango writes files only through templates and integration hooks. |
+| Secrets stay in settings and `.env.example` | Generated code avoids hardcoded tokens, API keys, and webhook secrets. |
+| Registry validation before writes | Presets, aliases, integration requirements, and conflicts are resolved before the filesystem is touched. |
+| Unsupported tech becomes a note | Requests for unsupported frameworks are shown in previews instead of silently generated. |
+
+## Development
+
+```bash
+uv sync --all-groups
+uv run pytest
+uv run ruff check .
+uv run mypy fastango
+```
+
+## Status
+
+Fastango is early and evolving quickly. The current focus is a great terminal experience,
+a reliable integration catalog, and safe prompt-to-FastAPI scaffolding.