newstack 0.1.0__py3-none-any.whl

newstack/data/stacks/node-express-ts/stack.json

@@ -0,0 +1,14 @@
+{
+  "name": "node-express-ts",
+  "title": "Express + TypeScript API",
+  "language": "node",
+  "blurb": "HTTP API: Express 5, typed handlers, supertest tests, CI",
+  "requires": ["node", "npm", "git"],
+  "default_description": "An Express API.",
+  "next_steps": ["cd {path}", "npm install", "npm run dev"],
+  "verify": [
+    {"name": "install", "cmd": "npm install --no-audit --no-fund --silent", "tools": ["npm"], "timeout": 900},
+    {"name": "typecheck", "cmd": "npm run typecheck", "tools": ["npm"], "timeout": 300},
+    {"name": "test", "cmd": "npm test", "tools": ["npm"], "timeout": 300}
+  ]
+}

newstack/data/stacks/node-express-ts/template/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: ["22", "24"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      # no lockfile is shipped yet: run `npm install` once locally and commit
+      # package-lock.json, then switch this to `npm ci` for reproducible installs
+      - run: npm install --no-audit --no-fund
+      - run: npm run typecheck
+      - run: npm test

newstack/data/stacks/node-express-ts/template/.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+coverage/
+*.local
+.env
+.DS_Store

newstack/data/stacks/node-express-ts/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{ year }} {{ author }}
+
+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.

newstack/data/stacks/node-express-ts/template/README.md

@@ -0,0 +1,24 @@
+# {{ title }}
+
+{{ description }}
+
+Express 5 on TypeScript: `GET /health`, `GET /items`, `POST /items`.
+
+## Develop
+
+```bash
+npm install
+npm run dev     # http://localhost:3000
+```
+
+## Check
+
+```bash
+npm run typecheck
+npm test
+```
+
+After the first `npm install`, commit `package-lock.json` and switch CI's install step
+to `npm ci` for reproducible installs.
+
+Generated with [newstack](https://github.com/DawnofGenX/newstack).

newstack/data/stacks/node-express-ts/template/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "{{ npm_name }}",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "description": "{{ description }}",
+  "main": "src/server.ts",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "start": "tsx src/server.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "express": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.6.6",
+    "@types/supertest": "^7.2.1",
+    "supertest": "^7.3.1",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  }
+}

newstack/data/stacks/node-express-ts/template/src/app.ts

@@ -0,0 +1,35 @@
+import express, { type Request, type Response } from "express";
+
+export interface Item {
+  id: number;
+  name: string;
+}
+
+export function createApp() {
+  const app = express();
+  app.use(express.json());
+
+  const items: Item[] = [];
+  let nextId = 1;
+
+  app.get("/health", (_req: Request, res: Response) => {
+    res.json({ status: "ok" });
+  });
+
+  app.get("/items", (_req: Request, res: Response) => {
+    res.json(items);
+  });
+
+  app.post("/items", (req: Request, res: Response) => {
+    const name = typeof req.body?.name === "string" ? req.body.name.trim() : "";
+    if (!name) {
+      res.status(400).json({ error: "name is required" });
+      return;
+    }
+    const item: Item = { id: nextId++, name };
+    items.push(item);
+    res.status(201).json(item);
+  });
+
+  return app;
+}

newstack/data/stacks/node-express-ts/template/src/server.ts

@@ -0,0 +1,7 @@
+import { createApp } from "./app";
+
+const port = Number(process.env.PORT ?? 3000);
+
+createApp().listen(port, () => {
+  console.log(`listening on http://localhost:${port}`);
+});

newstack/data/stacks/node-express-ts/template/tests/app.test.ts

@@ -0,0 +1,32 @@
+import request from "supertest";
+import { describe, expect, it } from "vitest";
+
+import { createApp } from "../src/app";
+
+describe("api", () => {
+  it("answers the health check", async () => {
+    const response = await request(createApp()).get("/health");
+    expect(response.status).toBe(200);
+    expect(response.body).toEqual({ status: "ok" });
+  });
+
+  it("starts with no items", async () => {
+    const response = await request(createApp()).get("/items");
+    expect(response.body).toEqual([]);
+  });
+
+  it("creates an item and lists it", async () => {
+    const app = createApp();
+    const created = await request(app).post("/items").send({ name: "pen" });
+    expect(created.status).toBe(201);
+    expect(created.body).toEqual({ id: 1, name: "pen" });
+
+    const listed = await request(app).get("/items");
+    expect(listed.body).toHaveLength(1);
+  });
+
+  it("rejects an item without a name", async () => {
+    const response = await request(createApp()).post("/items").send({});
+    expect(response.status).toBe(400);
+  });
+});

newstack/data/stacks/node-express-ts/template/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "types": ["node"]
+  },
+  "include": ["src", "tests"]
+}

newstack/data/stacks/python-cli/stack.json

@@ -0,0 +1,50 @@
+{
+  "name": "python-cli",
+  "title": "Python CLI",
+  "language": "python",
+  "blurb": "Console command on argparse: zero runtime deps, tested entry point",
+  "requires": [
+    "uv",
+    "git"
+  ],
+  "default_description": "A command line tool.",
+  "next_steps": [
+    "cd {path}",
+    "uv sync",
+    "uv run {npm_name} greet --name you"
+  ],
+  "verify": [
+    {
+      "name": "install",
+      "cmd": "uv venv -q .venv && uv pip install -q --python .venv/bin/python -e . pytest ruff",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 900
+    },
+    {
+      "name": "ruff",
+      "cmd": ".venv/bin/ruff check .",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    },
+    {
+      "name": "pytest",
+      "cmd": ".venv/bin/python -m pytest -q",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    },
+    {
+      "name": "run",
+      "cmd": ".venv/bin/{{ npm_name }} greet --name newstack",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 120
+    }
+  ]
+}

newstack/data/stacks/python-cli/template/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+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.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.3
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install
+        run: uv sync --group dev
+      - name: Lint
+        run: uv run ruff check .
+      - name: Test
+        run: uv run pytest
+      - name: Smoke test the CLI
+        run: uv run {{ npm_name }} greet --name CI

newstack/data/stacks/python-cli/template/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.DS_Store

newstack/data/stacks/python-cli/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{ year }} {{ author }}
+
+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.

newstack/data/stacks/python-cli/template/README.md

@@ -0,0 +1,35 @@
+# {{ title }}
+
+{{ description }}
+
+A single-command CLI built on the standard library — no runtime dependencies.
+
+## Install
+
+```bash
+uv sync
+uv run {{ npm_name }} --help
+```
+
+Or install it on your PATH:
+
+```bash
+uv tool install .
+{{ npm_name }} greet --name world
+```
+
+## Commands
+
+```text
+{{ npm_name }} greet --name <name>   print a greeting
+{{ npm_name }} --version             print the version
+```
+
+## Develop
+
+```bash
+uv run pytest
+uv run ruff check .
+```
+
+Generated with [newstack](https://github.com/DawnofGenX/newstack).

newstack/data/stacks/python-cli/template/pyproject.toml

@@ -0,0 +1,32 @@
+[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.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "{{ author }}", email = "{{ email }}" }]
+dependencies = []
+classifiers = ["Environment :: Console", "Programming Language :: Python :: 3"]
+
+[project.scripts]
+{{ npm_name }} = "{{ package_name }}.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=8.0", "ruff>=0.6"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/{{ package_name }}"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

newstack/data/stacks/python-cli/template/src/{{package_name}}/__init__.py

@@ -0,0 +1,4 @@
+"""{{ title }} — {{ description }}"""
+
+__version__ = "0.1.0"
+__all__ = ["__version__"]

newstack/data/stacks/python-cli/template/src/{{package_name}}/__main__.py

@@ -0,0 +1,6 @@
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

newstack/data/stacks/python-cli/template/src/{{package_name}}/cli.py

@@ -0,0 +1,30 @@
+"""Command line entry point for {{ title }}."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from collections.abc import Sequence
+
+from . import __version__
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="{{ npm_name }}", description="{{ description }}")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    greet = sub.add_parser("greet", help="print a greeting")
+    greet.add_argument("--name", default="world", help="who to greet")
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.command == "greet":
+        print(f"Hello, {args.name}!")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

newstack/data/stacks/python-cli/template/tests/test_cli.py

@@ -0,0 +1,20 @@
+from {{ package_name }}.cli import main
+
+
+def test_greet_uses_default_name(capsys) -> None:
+    assert main(["greet"]) == 0
+    assert capsys.readouterr().out.strip() == "Hello, world!"
+
+
+def test_greet_uses_given_name(capsys) -> None:
+    assert main(["greet", "--name", "Ada"]) == 0
+    assert "Ada" in capsys.readouterr().out
+
+
+def test_version_prints_and_exits(capsys) -> None:
+    import pytest
+
+    with pytest.raises(SystemExit) as excinfo:
+        main(["--version"])
+    assert excinfo.value.code == 0
+    assert "0.1.0" in capsys.readouterr().out

newstack/data/stacks/python-lib/stack.json

@@ -0,0 +1,42 @@
+{
+  "name": "python-lib",
+  "title": "Python library",
+  "language": "python",
+  "blurb": "Installable package: src layout, pytest, ruff, 4-version CI matrix",
+  "requires": [
+    "uv",
+    "git"
+  ],
+  "default_description": "A Python library.",
+  "next_steps": [
+    "cd {path}",
+    "uv sync",
+    "uv run pytest"
+  ],
+  "verify": [
+    {
+      "name": "install",
+      "cmd": "uv venv -q .venv && uv pip install -q --python .venv/bin/python -e . pytest ruff",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 900
+    },
+    {
+      "name": "ruff",
+      "cmd": ".venv/bin/ruff check .",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    },
+    {
+      "name": "pytest",
+      "cmd": ".venv/bin/python -m pytest -q",
+      "tools": [
+        "uv"
+      ],
+      "timeout": 300
+    }
+  ]
+}

newstack/data/stacks/python-lib/template/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+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.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.3
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install
+        run: uv sync --group dev
+      - name: Lint
+        run: uv run ruff check .
+      - name: Test
+        run: uv run pytest
+      - name: Build
+        run: uv build

newstack/data/stacks/python-lib/template/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.DS_Store

newstack/data/stacks/python-lib/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{ year }} {{ author }}
+
+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.

newstack/data/stacks/python-lib/template/README.md

@@ -0,0 +1,28 @@
+# {{ title }}
+
+{{ description }}
+
+## Install
+
+```bash
+uv sync
+```
+
+## Use
+
+```python
+from {{ package_name }} import truncate, word_count
+
+word_count("hello world")   # 2
+truncate("hello world", 8)  # "hello w…"
+```
+
+## Develop
+
+```bash
+uv run pytest        # tests
+uv run ruff check .  # lint
+uv build             # sdist + wheel
+```
+
+Generated with [newstack](https://github.com/DawnofGenX/newstack).

newstack/data/stacks/python-lib/template/pyproject.toml

@@ -0,0 +1,34 @@
+[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.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "{{ author }}", email = "{{ email }}" }]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+[dependency-groups]
+dev = ["pytest>=8.0", "ruff>=0.6"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/{{ package_name }}"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

newstack/data/stacks/python-lib/template/src/{{package_name}}/__init__.py

@@ -0,0 +1,6 @@
+"""{{ title }} — {{ description }}"""
+
+from .core import truncate, word_count
+
+__version__ = "0.1.0"
+__all__ = ["__version__", "truncate", "word_count"]