scaffld 0.1.0__tar.gz

scaffld-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fernando Aporta Franco (ferinazumaDEV)
+
+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.

scaffld-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+recursive-include src/scaffld/builtins *
+include LICENSE
+include README.md

scaffld-0.1.0/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: scaffld
+Version: 0.1.0
+Summary: Scaffold new Python projects in seconds with a friendly TUI.
+Author: Fernando Aporta Franco
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ferinazumaDEV/scaffld
+Project-URL: Source, https://github.com/ferinazumaDEV/scaffld
+Project-URL: Issues, https://github.com/ferinazumaDEV/scaffld/issues
+Keywords: scaffold,boilerplate,project-generator,cookiecutter,template,cli,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer<1.0,>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Dynamic: license-file
+
+# scaffld
+
+![Python](https://img.shields.io/badge/python-3.9%2B-blue)
+![License: MIT](https://img.shields.io/badge/License-MIT-green)
+
+**Scaffold a new, fully-wired Python project in seconds — with a friendly terminal UI.**
+
+`scaffld` generates a clean project skeleton (src layout, tests, typed code, CI,
+pre-commit, license, and an optional virtualenv) from extensible templates. No
+cookiecutter YAML to memorize, no `{% raw %}` gymnastics to keep GitHub Actions
+files intact — just answer a few prompts and start writing code.
+
+```bash
+pip install git+https://github.com/ferinazumaDEV/scaffld
+scaffld new
+```
+
+## Features
+
+- **Interactive TUI** built with [Rich](https://github.com/Textualize/rich) — pick a
+  template from a table, confirm a summary, watch the file tree appear.
+- **Batteries included** — every project ships with `pyproject.toml`, a `src/` layout,
+  `pytest` tests that pass out of the box, a GitHub Actions matrix CI, a
+  `.pre-commit-config.yaml`, a real `LICENSE`, and a sensible `.gitignore`.
+- **Three built-in templates** — `python-lib`, `python-cli`, and `python-api` (FastAPI).
+- **GitHub-Actions-safe templating** — a tiny custom engine leaves `${{ ... }}`
+  expressions untouched, so your workflow files render correctly with zero escaping.
+- **Extensible** — drop your own template folder in `~/.scaffld/templates` and it shows
+  up instantly. Templates are just a `template.toml` plus a `files/` tree.
+- **Scriptable** — `--no-input` makes `scaffld` behave in CI and Makefiles.
+- **Zero-config virtualenv** — optionally creates `.venv` for the new project.
+
+## Install
+
+```bash
+pip install git+https://github.com/ferinazumaDEV/scaffld
+# or, from a clone:
+pip install -e ".[dev]"
+```
+
+Installing from the repository needs `git` on your machine; `scaffld` is not on
+PyPI yet, so `pip install scaffld` will not find it.
+
+Requires Python 3.9+. Runtime dependencies: `typer` and `rich` (plus `tomli` on 3.9/3.10).
+
+## Usage
+
+List the available templates:
+
+```console
+$ scaffld list
+                              Available templates
+┏━━━┳━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ # ┃ Template   ┃ Kind    ┃ Description                                       ┃
+┡━━━╇━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ 1 │ python-api │ api     │ FastAPI service with a health route, typed        │
+│   │            │         │ handlers, and CI.                                 │
+│ 2 │ python-cli │ cli     │ Zero-dependency argparse CLI with a               │
+│   │            │         │ console-script entry point.                       │
+│ 3 │ python-lib │ library │ Importable Python library: src/ layout, typed     │
+│   │            │         │ API, tests, and CI.                               │
+└───┴────────────┴─────────┴───────────────────────────────────────────────────┘
+```
+
+Create a project. Run `scaffld new` with no arguments for the full interactive flow,
+or pass flags to skip the prompts:
+
+```console
+$ scaffld new "Weather Bot" -t python-cli -a "Ada Lovelace" -d "A tiny weather CLI." --no-input --no-venv
+weather-bot/
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── .gitignore
+├── .pre-commit-config.yaml
+├── LICENSE
+├── README.md
+├── pyproject.toml
+├── src/
+│   └── weather_bot/
+│       ├── __init__.py
+│       └── cli.py
+└── tests/
+    └── test_cli.py
+╭──────────────────────────────────── Done ────────────────────────────────────╮
+│ Created 9 files in /tmp/weather-bot                                          │
+╰──────────────────────────────────────────────────────────────────────────────╯
+
+Next steps:
+  cd weather-bot
+  pip install -e ".[dev]"
+  pytest
+```
+
+`scaffld show python-lib` prints the file tree a template would generate, without
+writing anything to disk.
+
+The generated project is real and works immediately:
+
+```console
+$ cd weather-bot && pip install -e ".[dev]" && pytest -q
+...                                                                        [100%]
+3 passed in 0.01s
+
+$ weather-bot Fernando
+Hello, Fernando!
+```
+
+### Useful flags
+
+| Flag | Meaning |
+| --- | --- |
+| `-t, --type` | Template to use (`scaffld list`). |
+| `-a, --author` | Author name (defaults to `SCAFFLD_AUTHOR`, then `git config user.name`, then `$USER`). |
+| `--email` | Author email (defaults to `SCAFFLD_EMAIL`, then `git config user.email`). |
+| `-d, --description` | One-line project description. |
+| `-l, --license` | `MIT`, `BSD-3-Clause`, `ISC`, or `none`. |
+| `-o, --output` | Directory to create the project in (defaults to the current directory). |
+| `--python` | Minimum Python version for the generated project (`3.N` or `3.N.P`). |
+| `--venv` / `--no-venv` | Create a `.venv` in the new project. On by default. |
+| `--no-input` | Never prompt — fail if a required value is missing (great for CI). |
+| `--force` | Write into a non-empty directory. |
+
+`scaffld -V` (or `--version`) prints the version and exits.
+
+## How it works
+
+A template is just a directory:
+
+```
+my-template/
+├── template.toml        # name, kind, description
+└── files/               # the tree that gets rendered
+    ├── pyproject.toml
+    ├── src/{{ package_name }}/__init__.py
+    └── ...
+```
+
+Both **file contents and path segments** are rendered, so a directory literally named
+`{{ package_name }}` becomes `weather_bot/` on disk.
+
+The rendering engine is deliberately small and has one property that matters for real
+projects: **unknown `{{ ... }}` expressions are left untouched.** That means a GitHub
+Actions file can contain `${{ matrix.python-version }}` right next to a scaffld variable
+like `{{ project_name }}`, and only the latter is substituted — no escaping required. It
+also supports filters (`{{ project_name | snake }}`) and nestable conditionals
+(`{% if has_license %}...{% endif %}`).
+
+Derived variables are computed once and kept consistent: give it `"Weather Bot"` and you
+get `package_name = weather_bot`, `project_slug = weather-bot`, a filled-in license, the
+year, and more. Names are transliterated to ASCII first, so `"Café Búho"` yields
+`cafe_buho` rather than a shredded `caf_b_ho`, and a name that collides with a Python
+keyword gets a trailing underscore (`class` → `class_`) so the package stays importable.
+
+## Custom templates
+
+Point `scaffld` at your own templates by dropping them in `~/.scaffld/templates/`
+(or any directory listed in the `SCAFFLD_TEMPLATES` environment variable). A user
+template that shares a name with a built-in one shadows it, so you can override the
+defaults. Available variables include `project_name`, `package_name`, `project_slug`,
+`author`, `author_email`, `description`, `license`, `python_version`, and `year`.
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## Part of the ferinazumaDEV ecosystem
+
+`scaffld` is one of a family of small, focused open-source tools I build and maintain. If it saved you some project-setup time, a few of the sibling projects tackle neighbouring problems in the same practical, batteries-included spirit.
+
+- [The GEO Handbook](https://github.com/ferinazumaDEV/generative-engine-optimization-handbook) — the open reference on getting content cited by AI answer engines (ChatGPT, Perplexity, Google AI Overviews, Gemini, Copilot).
+- [politeclient](https://github.com/ferinazumaDEV/politeclient) — a polite, bulletproof HTTP client for Python: retries with backoff, per-host rate-limiting, caching, and pagination.
+- [typedout](https://github.com/ferinazumaDEV/typedout) — reliable structured output from any LLM: schema-validated JSON with tolerant repair and retries.
+- [webhook-replay](https://github.com/ferinazumaDEV/webhook-replay) — capture a webhook once, then replay it at your local app as many times as you need.
+- Hub & writing: [zentimes.es](https://zentimes.es).
+
+By [ferinazumaDEV](https://github.com/ferinazumaDEV).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built by Fernando ([@ferinazumaDEV](https://github.com/ferinazumaDEV)).

scaffld-0.1.0/README.md

@@ -0,0 +1,189 @@
+# scaffld
+
+![Python](https://img.shields.io/badge/python-3.9%2B-blue)
+![License: MIT](https://img.shields.io/badge/License-MIT-green)
+
+**Scaffold a new, fully-wired Python project in seconds — with a friendly terminal UI.**
+
+`scaffld` generates a clean project skeleton (src layout, tests, typed code, CI,
+pre-commit, license, and an optional virtualenv) from extensible templates. No
+cookiecutter YAML to memorize, no `{% raw %}` gymnastics to keep GitHub Actions
+files intact — just answer a few prompts and start writing code.
+
+```bash
+pip install git+https://github.com/ferinazumaDEV/scaffld
+scaffld new
+```
+
+## Features
+
+- **Interactive TUI** built with [Rich](https://github.com/Textualize/rich) — pick a
+  template from a table, confirm a summary, watch the file tree appear.
+- **Batteries included** — every project ships with `pyproject.toml`, a `src/` layout,
+  `pytest` tests that pass out of the box, a GitHub Actions matrix CI, a
+  `.pre-commit-config.yaml`, a real `LICENSE`, and a sensible `.gitignore`.
+- **Three built-in templates** — `python-lib`, `python-cli`, and `python-api` (FastAPI).
+- **GitHub-Actions-safe templating** — a tiny custom engine leaves `${{ ... }}`
+  expressions untouched, so your workflow files render correctly with zero escaping.
+- **Extensible** — drop your own template folder in `~/.scaffld/templates` and it shows
+  up instantly. Templates are just a `template.toml` plus a `files/` tree.
+- **Scriptable** — `--no-input` makes `scaffld` behave in CI and Makefiles.
+- **Zero-config virtualenv** — optionally creates `.venv` for the new project.
+
+## Install
+
+```bash
+pip install git+https://github.com/ferinazumaDEV/scaffld
+# or, from a clone:
+pip install -e ".[dev]"
+```
+
+Installing from the repository needs `git` on your machine; `scaffld` is not on
+PyPI yet, so `pip install scaffld` will not find it.
+
+Requires Python 3.9+. Runtime dependencies: `typer` and `rich` (plus `tomli` on 3.9/3.10).
+
+## Usage
+
+List the available templates:
+
+```console
+$ scaffld list
+                              Available templates
+┏━━━┳━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ # ┃ Template   ┃ Kind    ┃ Description                                       ┃
+┡━━━╇━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
+│ 1 │ python-api │ api     │ FastAPI service with a health route, typed        │
+│   │            │         │ handlers, and CI.                                 │
+│ 2 │ python-cli │ cli     │ Zero-dependency argparse CLI with a               │
+│   │            │         │ console-script entry point.                       │
+│ 3 │ python-lib │ library │ Importable Python library: src/ layout, typed     │
+│   │            │         │ API, tests, and CI.                               │
+└───┴────────────┴─────────┴───────────────────────────────────────────────────┘
+```
+
+Create a project. Run `scaffld new` with no arguments for the full interactive flow,
+or pass flags to skip the prompts:
+
+```console
+$ scaffld new "Weather Bot" -t python-cli -a "Ada Lovelace" -d "A tiny weather CLI." --no-input --no-venv
+weather-bot/
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── .gitignore
+├── .pre-commit-config.yaml
+├── LICENSE
+├── README.md
+├── pyproject.toml
+├── src/
+│   └── weather_bot/
+│       ├── __init__.py
+│       └── cli.py
+└── tests/
+    └── test_cli.py
+╭──────────────────────────────────── Done ────────────────────────────────────╮
+│ Created 9 files in /tmp/weather-bot                                          │
+╰──────────────────────────────────────────────────────────────────────────────╯
+
+Next steps:
+  cd weather-bot
+  pip install -e ".[dev]"
+  pytest
+```
+
+`scaffld show python-lib` prints the file tree a template would generate, without
+writing anything to disk.
+
+The generated project is real and works immediately:
+
+```console
+$ cd weather-bot && pip install -e ".[dev]" && pytest -q
+...                                                                        [100%]
+3 passed in 0.01s
+
+$ weather-bot Fernando
+Hello, Fernando!
+```
+
+### Useful flags
+
+| Flag | Meaning |
+| --- | --- |
+| `-t, --type` | Template to use (`scaffld list`). |
+| `-a, --author` | Author name (defaults to `SCAFFLD_AUTHOR`, then `git config user.name`, then `$USER`). |
+| `--email` | Author email (defaults to `SCAFFLD_EMAIL`, then `git config user.email`). |
+| `-d, --description` | One-line project description. |
+| `-l, --license` | `MIT`, `BSD-3-Clause`, `ISC`, or `none`. |
+| `-o, --output` | Directory to create the project in (defaults to the current directory). |
+| `--python` | Minimum Python version for the generated project (`3.N` or `3.N.P`). |
+| `--venv` / `--no-venv` | Create a `.venv` in the new project. On by default. |
+| `--no-input` | Never prompt — fail if a required value is missing (great for CI). |
+| `--force` | Write into a non-empty directory. |
+
+`scaffld -V` (or `--version`) prints the version and exits.
+
+## How it works
+
+A template is just a directory:
+
+```
+my-template/
+├── template.toml        # name, kind, description
+└── files/               # the tree that gets rendered
+    ├── pyproject.toml
+    ├── src/{{ package_name }}/__init__.py
+    └── ...
+```
+
+Both **file contents and path segments** are rendered, so a directory literally named
+`{{ package_name }}` becomes `weather_bot/` on disk.
+
+The rendering engine is deliberately small and has one property that matters for real
+projects: **unknown `{{ ... }}` expressions are left untouched.** That means a GitHub
+Actions file can contain `${{ matrix.python-version }}` right next to a scaffld variable
+like `{{ project_name }}`, and only the latter is substituted — no escaping required. It
+also supports filters (`{{ project_name | snake }}`) and nestable conditionals
+(`{% if has_license %}...{% endif %}`).
+
+Derived variables are computed once and kept consistent: give it `"Weather Bot"` and you
+get `package_name = weather_bot`, `project_slug = weather-bot`, a filled-in license, the
+year, and more. Names are transliterated to ASCII first, so `"Café Búho"` yields
+`cafe_buho` rather than a shredded `caf_b_ho`, and a name that collides with a Python
+keyword gets a trailing underscore (`class` → `class_`) so the package stays importable.
+
+## Custom templates
+
+Point `scaffld` at your own templates by dropping them in `~/.scaffld/templates/`
+(or any directory listed in the `SCAFFLD_TEMPLATES` environment variable). A user
+template that shares a name with a built-in one shadows it, so you can override the
+defaults. Available variables include `project_name`, `package_name`, `project_slug`,
+`author`, `author_email`, `description`, `license`, `python_version`, and `year`.
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## Part of the ferinazumaDEV ecosystem
+
+`scaffld` is one of a family of small, focused open-source tools I build and maintain. If it saved you some project-setup time, a few of the sibling projects tackle neighbouring problems in the same practical, batteries-included spirit.
+
+- [The GEO Handbook](https://github.com/ferinazumaDEV/generative-engine-optimization-handbook) — the open reference on getting content cited by AI answer engines (ChatGPT, Perplexity, Google AI Overviews, Gemini, Copilot).
+- [politeclient](https://github.com/ferinazumaDEV/politeclient) — a polite, bulletproof HTTP client for Python: retries with backoff, per-host rate-limiting, caching, and pagination.
+- [typedout](https://github.com/ferinazumaDEV/typedout) — reliable structured output from any LLM: schema-validated JSON with tolerant repair and retries.
+- [webhook-replay](https://github.com/ferinazumaDEV/webhook-replay) — capture a webhook once, then replay it at your local app as many times as you need.
+- Hub & writing: [zentimes.es](https://zentimes.es).
+
+By [ferinazumaDEV](https://github.com/ferinazumaDEV).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built by Fernando ([@ferinazumaDEV](https://github.com/ferinazumaDEV)).

scaffld-0.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "scaffld"
+version = "0.1.0"
+description = "Scaffold new Python projects in seconds with a friendly TUI."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Fernando Aporta Franco" }]
+keywords = [
+    "scaffold",
+    "boilerplate",
+    "project-generator",
+    "cookiecutter",
+    "template",
+    "cli",
+    "tui",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typer>=0.12,<1.0",
+    "rich>=13.7",
+    "tomli>=2.0 ; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0"]
+
+[project.scripts]
+scaffld = "scaffld.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/ferinazumaDEV/scaffld"
+Source = "https://github.com/ferinazumaDEV/scaffld"
+Issues = "https://github.com/ferinazumaDEV/scaffld/issues"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+scaffld = ["builtins/**/*", "builtins/**/.*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 90
+target-version = "py39"

scaffld-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

scaffld-0.1.0/src/scaffld/__init__.py

@@ -0,0 +1,7 @@
+"""scaffld -- scaffold new projects in seconds with a friendly TUI."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

scaffld-0.1.0/src/scaffld/__main__.py

@@ -0,0 +1,8 @@
+"""Enable ``python -m scaffld``."""
+
+from __future__ import annotations
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

scaffld-0.1.0/src/scaffld/builtins/python-api/files/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Test
+        run: pytest -q

scaffld-0.1.0/src/scaffld/builtins/python-api/files/.gitignore

@@ -0,0 +1,25 @@
+# Byte-compiled / optimized
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test & coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

scaffld-0.1.0/src/scaffld/builtins/python-api/files/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: check-yaml
+      - id: check-toml

scaffld-0.1.0/src/scaffld/builtins/python-api/files/LICENSE

@@ -0,0 +1 @@
+{{ license_text }}

scaffld-0.1.0/src/scaffld/builtins/python-api/files/README.md

@@ -0,0 +1,29 @@
+# {{ project_name }}
+
+{{ description }}
+
+## Install
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Run
+
+```bash
+uvicorn {{ package_name }}.app:app --reload
+# GET http://127.0.0.1:8000/health   -> {"status": "ok"}
+# GET http://127.0.0.1:8000/greet/you -> {"message": "Hello, you!"}
+```
+
+## Development
+
+```bash
+pytest
+```
+{% if has_license %}
+## License
+
+{{ license }}. See [LICENSE](LICENSE).
+{% endif %}

scaffld-0.1.0/src/scaffld/builtins/python-api/files/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{ project_slug }}"
+version = "0.1.0"
+description = "{{ description }}"
+readme = "README.md"
+requires-python = ">={{ python_version }}"
+{% if has_license %}license = "{{ license }}"
+license-files = ["LICENSE"]
+{% endif %}authors = [{ name = "{{ author }}"{% if has_email %}, email = "{{ author_email }}"{% endif %} }]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Framework :: FastAPI",
+]
+dependencies = [
+    "fastapi>=0.110",
+    "uvicorn[standard]>=0.29",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "httpx>=0.27"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

scaffld-0.1.0/src/scaffld/builtins/python-api/files/src/{{ package_name }}/__init__.py

@@ -0,0 +1,7 @@
+"""{{ description }}"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]