newstack 0.1.0__tar.gz → 0.2.0__tar.gz

{newstack-0.1.0 → newstack-0.2.0}/CHANGELOG.md

@@ -6,6 +6,25 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-11-02
+
+### Added
+
+- Four new stacks, all verified the same way as the original six:
+  - `go-cli` — stdlib `flag` parsing, table tests, vet/test/build gates.
+  - `rust-cli` — std-only parsing, lib+bin split, fmt/clippy/test/release gates.
+  - `django` — Django 6.1, config/core split, SQLite, pytest-django, and a
+    migration-drift step that fails when a model changes without a migration.
+  - `svelte-kit-ts` — SvelteKit 3 with Svelte 5 runes, Vitest, static adapter build.
+- CI runs one job per stack (ten in total), with Go and Rust toolchains installed only
+  for the jobs that need them.
+- Docs drift tests: the README table and the CI matrix must both list every registered
+  stack, and the README may not hardcode a stack count.
+
+### Changed
+
+- Install instructions now point at PyPI (`uvx newstack`, `uv tool install newstack`).
+
 ## [0.1.0] - 2026-11-02
 
 ### Added

{newstack-0.1.0 → newstack-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: newstack
-Version: 0.1.0
+Version: 0.2.0
 Summary: Scaffold a new project on any popular stack — every generated starter is proven green in CI.
 Project-URL: Homepage, https://github.com/DawnofGenX/newstack
 Project-URL: Repository, https://github.com/DawnofGenX/newstack
@@ -25,6 +25,7 @@ Description-Content-Type: text/markdown
 # newstack
 
 [![CI](https://github.com/DawnofGenX/newstack/actions/workflows/ci.yml/badge.svg)](https://github.com/DawnofGenX/newstack/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/newstack)](https://pypi.org/project/newstack/)
 ![python](https://img.shields.io/badge/python-3.10%2B-blue)
 ![dependencies](https://img.shields.io/badge/runtime%20dependencies-0-brightgreen)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
@@ -61,12 +62,10 @@ first day of work.
 
 ## Install
 
-Not on PyPI yet — install straight from the repository:
-
 ```bash
-uv tool install git+https://github.com/DawnofGenX/newstack
-# or, without installing:
-uvx --from git+https://github.com/DawnofGenX/newstack newstack list
+uvx newstack list          # run without installing
+uv tool install newstack   # or put it on your PATH
+pipx install newstack      # any of the usual runners works
 ```
 
 From a clone:
@@ -101,9 +100,13 @@ directory to CI-ready project.
 | `python-lib` | src layout, hatchling build, pytest, ruff, 4-version CI matrix | `uv` |
 | `python-cli` | console entry point on argparse, zero runtime deps, tested CLI | `uv` |
 | `fastapi` | typed JSON API, pydantic models, TestClient tests, Dockerfile | `uv` |
+| `django` | Django 6.1 app: config/core split, SQLite, pytest-django, migration drift check | `uv` |
 | `react-vite-ts` | React 19 + Vite + TS, Vitest + Testing Library, typecheck + build | `node`, `npm` |
 | `node-express-ts` | Express 5 API, typed handlers, supertest tests | `node`, `npm` |
-| `static-site` | HTML/CSS/JS page with a GitHub Pages deploy workflow | `node` |
+| `svelte-kit-ts` | SvelteKit + TS, Svelte 5 runes component, Vitest, static adapter build | `node`, `npm` |
+| `go-cli` | stdlib-only Go CLI: `flag` parsing, table tests, vet/test/build gates | `go` |
+| `rust-cli` | std-only Rust CLI: lib+bin split, fmt/clippy/test/release-build gates | `cargo` |
+| `static-site` | HTML/CSS/JS page, `node:test` suite, GitHub Pages deploy workflow | `node` |
 
 Each generated project ships its own `.github/workflows/` that is ready to run, plus a
 README, an MIT licence and a `.gitignore`.
@@ -115,12 +118,16 @@ verification as a first-class command:
 
 ```console
 $ newstack check --all
-  fastapi          PASS    1.0s  3 step(s)
-  node-express-ts  PASS    2.2s  3 step(s)
+  django           PASS    1.5s  5 step(s)
+  fastapi          PASS    1.4s  3 step(s)
+  go-cli           PASS    0.3s  3 step(s)
+  node-express-ts  PASS    6.1s  3 step(s)
   python-cli       PASS    0.5s  4 step(s)
-  python-lib       PASS    0.4s  3 step(s)
-  react-vite-ts    PASS    3.2s  4 step(s)
+  python-lib       PASS    0.5s  3 step(s)
+  react-vite-ts    PASS    5.5s  4 step(s)
+  rust-cli         PASS    0.5s  4 step(s)
   static-site      PASS    0.1s  3 step(s)
+  svelte-kit-ts    PASS    7.1s  4 step(s)
 ```
 
 (Real timings from a warm package cache — a cold run takes about a minute because
@@ -189,7 +196,7 @@ manifest format, no fork required.
 ## Roadmap
 
 - `newstack update` — re-apply upstream template changes to an existing project.
-- More stacks: Go service, Rust CLI, Django, Vue, SvelteKit.
+- More stacks: Vue, Next.js, Flask.
 - `--license apache-2.0|bsd-3` and other variable choices beyond the current defaults.
 
 ## Licence

{newstack-0.1.0 → newstack-0.2.0}/README.md

@@ -1,6 +1,7 @@
 # newstack
 
 [![CI](https://github.com/DawnofGenX/newstack/actions/workflows/ci.yml/badge.svg)](https://github.com/DawnofGenX/newstack/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/newstack)](https://pypi.org/project/newstack/)
 ![python](https://img.shields.io/badge/python-3.10%2B-blue)
 ![dependencies](https://img.shields.io/badge/runtime%20dependencies-0-brightgreen)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
@@ -37,12 +38,10 @@ first day of work.
 
 ## Install
 
-Not on PyPI yet — install straight from the repository:
-
 ```bash
-uv tool install git+https://github.com/DawnofGenX/newstack
-# or, without installing:
-uvx --from git+https://github.com/DawnofGenX/newstack newstack list
+uvx newstack list          # run without installing
+uv tool install newstack   # or put it on your PATH
+pipx install newstack      # any of the usual runners works
 ```
 
 From a clone:
@@ -77,9 +76,13 @@ directory to CI-ready project.
 | `python-lib` | src layout, hatchling build, pytest, ruff, 4-version CI matrix | `uv` |
 | `python-cli` | console entry point on argparse, zero runtime deps, tested CLI | `uv` |
 | `fastapi` | typed JSON API, pydantic models, TestClient tests, Dockerfile | `uv` |
+| `django` | Django 6.1 app: config/core split, SQLite, pytest-django, migration drift check | `uv` |
 | `react-vite-ts` | React 19 + Vite + TS, Vitest + Testing Library, typecheck + build | `node`, `npm` |
 | `node-express-ts` | Express 5 API, typed handlers, supertest tests | `node`, `npm` |
-| `static-site` | HTML/CSS/JS page with a GitHub Pages deploy workflow | `node` |
+| `svelte-kit-ts` | SvelteKit + TS, Svelte 5 runes component, Vitest, static adapter build | `node`, `npm` |
+| `go-cli` | stdlib-only Go CLI: `flag` parsing, table tests, vet/test/build gates | `go` |
+| `rust-cli` | std-only Rust CLI: lib+bin split, fmt/clippy/test/release-build gates | `cargo` |
+| `static-site` | HTML/CSS/JS page, `node:test` suite, GitHub Pages deploy workflow | `node` |
 
 Each generated project ships its own `.github/workflows/` that is ready to run, plus a
 README, an MIT licence and a `.gitignore`.
@@ -91,12 +94,16 @@ verification as a first-class command:
 
 ```console
 $ newstack check --all
-  fastapi          PASS    1.0s  3 step(s)
-  node-express-ts  PASS    2.2s  3 step(s)
+  django           PASS    1.5s  5 step(s)
+  fastapi          PASS    1.4s  3 step(s)
+  go-cli           PASS    0.3s  3 step(s)
+  node-express-ts  PASS    6.1s  3 step(s)
   python-cli       PASS    0.5s  4 step(s)
-  python-lib       PASS    0.4s  3 step(s)
-  react-vite-ts    PASS    3.2s  4 step(s)
+  python-lib       PASS    0.5s  3 step(s)
+  react-vite-ts    PASS    5.5s  4 step(s)
+  rust-cli         PASS    0.5s  4 step(s)
   static-site      PASS    0.1s  3 step(s)
+  svelte-kit-ts    PASS    7.1s  4 step(s)
 ```
 
 (Real timings from a warm package cache — a cold run takes about a minute because
@@ -165,7 +172,7 @@ manifest format, no fork required.
 ## Roadmap
 
 - `newstack update` — re-apply upstream template changes to an existing project.
-- More stacks: Go service, Rust CLI, Django, Vue, SvelteKit.
+- More stacks: Vue, Next.js, Flask.
 - `--license apache-2.0|bsd-3` and other variable choices beyond the current defaults.
 
 ## Licence

{newstack-0.1.0 → newstack-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "newstack"
-version = "0.1.0"
+version = "0.2.0"
 description = "Scaffold a new project on any popular stack — every generated starter is proven green in CI."
 readme = "README.md"
 requires-python = ">=3.10"

{newstack-0.1.0 → newstack-0.2.0}/src/newstack/__init__.py

@@ -1,4 +1,4 @@
 """newstack — scaffold a new project on any popular stack, proven green in CI."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = ["__version__"]

newstack-0.2.0/src/newstack/data/stacks/django/stack.json

@@ -0,0 +1,59 @@
+{
+  "name": "django",
+  "title": "Django app",
+  "language": "python",
+  "blurb": "Django 6 JSON API: core app, SQLite, pytest-django, ruff, CI matrix",
+  "requires": [
+    "uv",
+    "git"
+  ],
+  "default_description": "A Django web application.",
+  "next_steps": [
+    "cd {path}",
+    "uv sync",
+    "uv run python manage.py migrate",
+    "uv run python manage.py runserver"
+  ],
+  "verify": [
+    {
+      "name": "install",
+      "cmd": "uv venv -q .venv && uv pip install -q --python .venv/bin/python -e . pytest pytest-django ruff",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 900
+    },
+    {
+      "name": "check",
+      "cmd": ".venv/bin/python manage.py check",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    },
+    {
+      "name": "migrations",
+      "cmd": ".venv/bin/python manage.py makemigrations --check --dry-run",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    },
+    {
+      "name": "ruff",
+      "cmd": ".venv/bin/ruff check .",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    },
+    {
+      "name": "pytest",
+      "cmd": ".venv/bin/python -m pytest -q",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 600
+    }
+  ]
+}

newstack-0.2.0/src/newstack/data/stacks/django/template/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.3
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --group dev
+      - name: Lint
+        run: uv run ruff check .
+      - name: Check for missing migrations
+        run: uv run python manage.py makemigrations --check --dry-run
+      - name: Test
+        run: uv run pytest

newstack-0.2.0/src/newstack/data/stacks/django/template/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.venv/
+db.sqlite3
+.pytest_cache/
+.ruff_cache/
+.DS_Store

newstack-0.2.0/src/newstack/data/stacks/django/template/README.md

@@ -0,0 +1,67 @@
+# {{ title }}
+
+{{ description }}
+
+A [Django](https://www.djangoproject.com/) 6 application with a JSON API app (`core`), SQLite
+storage, pytest-django tests and ruff linting.
+
+## Requirements
+
+- Python 3.12+
+- [uv](https://docs.astral.sh/uv/)
+
+## Setup
+
+```bash
+uv sync
+uv run python manage.py migrate
+uv run python manage.py runserver
+```
+
+The server listens on http://127.0.0.1:8000/.
+
+## Endpoints
+
+| Method | Path      | Response                                             |
+| ------ | --------- | ---------------------------------------------------- |
+| GET    | `/health` | `{"status": "ok"}`                                   |
+| GET    | `/items`  | JSON array of `{"id", "name", "created"}` records    |
+| GET    | `/admin/` | Django admin (create a superuser with `createsuperuser`) |
+
+## Configuration
+
+Settings live in `config/settings.py` and read two environment variables:
+
+| Variable            | Default                                | Notes                          |
+| ------------------- | -------------------------------------- | ------------------------------ |
+| `DJANGO_SECRET_KEY` | dev-only insecure key                  | **required** in production     |
+| `DJANGO_DEBUG`      | `1`                                    | set to `0` for production      |
+
+`ALLOWED_HOSTS` is `["*"]` for local development; tighten it before deploying.
+
+## Development
+
+```bash
+uv sync
+uv run python manage.py makemigrations   # after changing core/models.py
+uv run pytest
+uv run ruff check .
+```
+
+## Project layout
+
+```
+config/            settings, root URLconf, WSGI/ASGI entry points
+core/              app: Item model, JSON views, migrations
+tests/             pytest-django tests
+manage.py          Django management entry point
+```
+
+## CI
+
+`.github/workflows/ci.yml` runs lint, a migration-drift check and the test suite on Python 3.12
+and 3.13 for every push to `main` and every pull request.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

newstack-0.2.0/src/newstack/data/stacks/django/template/config/asgi.py

@@ -0,0 +1,9 @@
+"""ASGI config for {{ title }}."""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+
+application = get_asgi_application()

newstack-0.2.0/src/newstack/data/stacks/django/template/config/settings.py

@@ -0,0 +1,82 @@
+"""Django settings for {{ title }}.
+
+Development defaults are used when the environment variables are not set.
+Never ship the fallback SECRET_KEY to production — set DJANGO_SECRET_KEY instead.
+"""
+
+import os
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = os.environ.get(
+    "DJANGO_SECRET_KEY",
+    "django-insecure-dev-only-key-do-not-use-in-production",
+)
+
+DEBUG = os.environ.get("DJANGO_DEBUG", "1") == "1"
+
+ALLOWED_HOSTS = ["*"]
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "core",
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "config.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = "config.wsgi.application"
+ASGI_APPLICATION = "config.asgi.application"
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+AUTH_PASSWORD_VALIDATORS = [
+    {"NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator"},
+    {"NAME": "django.contrib.auth.password_validation.MinimumLengthValidator"},
+    {"NAME": "django.contrib.auth.password_validation.CommonPasswordValidator"},
+    {"NAME": "django.contrib.auth.password_validation.NumericPasswordValidator"},
+]
+
+LANGUAGE_CODE = "en-us"
+TIME_ZONE = "UTC"
+USE_I18N = True
+USE_TZ = True
+
+STATIC_URL = "static/"
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

newstack-0.2.0/src/newstack/data/stacks/django/template/config/urls.py

@@ -0,0 +1,9 @@
+"""URL configuration for {{ title }}."""
+
+from django.contrib import admin
+from django.urls import include, path
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+    path("", include("core.urls")),
+]

newstack-0.2.0/src/newstack/data/stacks/django/template/config/wsgi.py

@@ -0,0 +1,9 @@
+"""WSGI config for {{ title }}."""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+
+application = get_wsgi_application()

newstack-0.2.0/src/newstack/data/stacks/django/template/core/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class CoreConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "core"

newstack-0.2.0/src/newstack/data/stacks/django/template/core/migrations/0001_initial.py

@@ -0,0 +1,32 @@
+# Generated by Django 6.1.2 on 2026-11-02 02:15
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="Item",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("name", models.CharField(max_length=100)),
+                ("created", models.DateTimeField(auto_now_add=True)),
+            ],
+            options={
+                "ordering": ("-created",),
+            },
+        ),
+    ]

newstack-0.2.0/src/newstack/data/stacks/django/template/core/models.py

@@ -0,0 +1,12 @@
+from django.db import models
+
+
+class Item(models.Model):
+    name = models.CharField(max_length=100)
+    created = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        ordering = ("-created",)
+
+    def __str__(self):
+        return self.name

newstack-0.2.0/src/newstack/data/stacks/django/template/core/urls.py

@@ -0,0 +1,8 @@
+from django.urls import path
+
+from . import views
+
+urlpatterns = [
+    path("health", views.health, name="health"),
+    path("items", views.items, name="items"),
+]

newstack-0.2.0/src/newstack/data/stacks/django/template/core/views.py

@@ -0,0 +1,22 @@
+from django.http import JsonResponse
+from django.views.decorators.http import require_GET
+
+from .models import Item
+
+
+@require_GET
+def health(request):
+    return JsonResponse({"status": "ok"})
+
+
+@require_GET
+def items(request):
+    payload = [
+        {
+            "id": item.pk,
+            "name": item.name,
+            "created": item.created.isoformat(),
+        }
+        for item in Item.objects.all()
+    ]
+    return JsonResponse(payload, safe=False)

newstack-0.2.0/src/newstack/data/stacks/django/template/manage.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

newstack-0.2.0/src/newstack/data/stacks/django/template/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "{{ npm_name }}"
+version = "0.1.0"
+description = "{{ description }}"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "{{ author }}", email = "{{ email }}" }]
+dependencies = ["django>=6.1"]
+classifiers = [
+    "Framework :: Django",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-django>=4.14", "ruff>=0.6"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["config", "core"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+DJANGO_SETTINGS_MODULE = "config.settings"
+addopts = "-q"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+# migrations are generated code: their module-level lists trip RUF012
+extend-exclude = ["*/migrations/*"]
+
+[tool.ruff.lint]
+# Pin the rule set: ruff's defaults shift between releases, which makes the same
+# template lint clean in one environment and dirty in another.
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]

newstack-0.2.0/src/newstack/data/stacks/django/template/tests/test_models.py

@@ -0,0 +1,20 @@
+from datetime import timedelta
+
+import pytest
+from django.utils import timezone
+
+from core.models import Item
+
+pytestmark = pytest.mark.django_db
+
+
+def test_str_returns_name():
+    assert str(Item(name="Widget")) == "Widget"
+
+
+def test_default_ordering_is_newest_first():
+    older = Item.objects.create(name="older")
+    Item.objects.create(name="newer")
+    Item.objects.filter(pk=older.pk).update(created=timezone.now() - timedelta(days=1))
+
+    assert [item.name for item in Item.objects.all()] == ["newer", "older"]