stoopid 0.1.0__tar.gz

stoopid-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simon Harvey
+
+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.

stoopid-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: stoopid
+Version: 0.1.0
+Summary: A deliberately meaningless package used to exercise a fully automated release pipeline.
+Author: Simon Harvey
+Author-email: Simon Harvey <simon.harvey.86@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+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: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/mighty-muffin/stoopid
+Project-URL: Changelog, https://github.com/mighty-muffin/stoopid/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/mighty-muffin/stoopid/issues
+Description-Content-Type: text/markdown
+
+# stoopid
+
+[![CI](https://github.com/mighty-muffin/stoopid/actions/workflows/ci.yml/badge.svg)](https://github.com/mighty-muffin/stoopid/actions/workflows/ci.yml)
+[![Release](https://github.com/mighty-muffin/stoopid/actions/workflows/release.yml/badge.svg)](https://github.com/mighty-muffin/stoopid/actions/workflows/release.yml)
+[![PyPI](https://img.shields.io/pypi/v/stoopid)](https://pypi.org/project/stoopid/)
+[![Python](https://img.shields.io/pypi/pyversions/stoopid)](https://pypi.org/project/stoopid/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+A deliberately meaningless Python package. The code does nothing useful; it
+exists so the **release pipeline around it** can be tested end to end. See
+[`specs/0001-stoopid-design.md`](specs/0001-stoopid-design.md) for the full design.
+
+## Install
+
+```sh
+pip install stoopid                      # latest release (PyPI)
+pip install --pre --no-deps \
+  --index-url https://test.pypi.org/simple/ stoopid   # latest dev build (TestPyPI)
+```
+
+## Usage
+
+```console
+$ stoopid add 1 2
+3
+$ stoopid mul 3 4
+12
+$ stoopid fib 10
+55
+```
+
+```python
+>>> import stoopid
+>>> stoopid.fibonacci(10)
+55
+```
+
+## Development
+
+```sh
+uv sync                 # create .venv with dev tools
+prek install            # git hooks (ruff, ty, uv lock check, …)
+uv run pytest           # tests, 100 % coverage enforced
+prek run --all-files    # every check CI runs
+```
+
+## How releasing works
+
+1. Every PR title must follow [Conventional Commits](https://www.conventionalcommits.org/)
+   (`feat: …`, `fix: …`, `feat!: …`, `chore: …`). PRs are squash-merged, so the
+   title becomes the commit on `main`.
+2. On each push to `main`, [release-please](https://github.com/googleapis/release-please)
+   keeps a **release PR** open with the next version and the `CHANGELOG.md` entry.
+   Until 1.0: `feat!` → minor, `feat`/`fix` → patch.
+3. The same push publishes a dev build `X.Y.(Z+1).devN` to TestPyPI.
+4. **Merging the release PR** tags `vX.Y.Z`, creates the GitHub Release, builds
+   once, publishes to TestPyPI, smoke-tests the install, then publishes to PyPI
+   (Trusted Publishing + PEP 740 attestations, no API tokens).
+5. To force a version (e.g. 1.0.0), add `"release-as": "1.0.0"` to the package in
+   `release-please-config.json` through a PR, then remove it after the release.
+
+Dependencies, Actions and hooks are updated weekly by Renovate; non-major
+updates merge themselves when CI is green.
+
+One-time setup (PyPI publishers, release GitHub App, Renovate):
+`scripts/setup-wizard.sh`.

stoopid-0.1.0/README.md

@@ -0,0 +1,66 @@
+# stoopid
+
+[![CI](https://github.com/mighty-muffin/stoopid/actions/workflows/ci.yml/badge.svg)](https://github.com/mighty-muffin/stoopid/actions/workflows/ci.yml)
+[![Release](https://github.com/mighty-muffin/stoopid/actions/workflows/release.yml/badge.svg)](https://github.com/mighty-muffin/stoopid/actions/workflows/release.yml)
+[![PyPI](https://img.shields.io/pypi/v/stoopid)](https://pypi.org/project/stoopid/)
+[![Python](https://img.shields.io/pypi/pyversions/stoopid)](https://pypi.org/project/stoopid/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+A deliberately meaningless Python package. The code does nothing useful; it
+exists so the **release pipeline around it** can be tested end to end. See
+[`specs/0001-stoopid-design.md`](specs/0001-stoopid-design.md) for the full design.
+
+## Install
+
+```sh
+pip install stoopid                      # latest release (PyPI)
+pip install --pre --no-deps \
+  --index-url https://test.pypi.org/simple/ stoopid   # latest dev build (TestPyPI)
+```
+
+## Usage
+
+```console
+$ stoopid add 1 2
+3
+$ stoopid mul 3 4
+12
+$ stoopid fib 10
+55
+```
+
+```python
+>>> import stoopid
+>>> stoopid.fibonacci(10)
+55
+```
+
+## Development
+
+```sh
+uv sync                 # create .venv with dev tools
+prek install            # git hooks (ruff, ty, uv lock check, …)
+uv run pytest           # tests, 100 % coverage enforced
+prek run --all-files    # every check CI runs
+```
+
+## How releasing works
+
+1. Every PR title must follow [Conventional Commits](https://www.conventionalcommits.org/)
+   (`feat: …`, `fix: …`, `feat!: …`, `chore: …`). PRs are squash-merged, so the
+   title becomes the commit on `main`.
+2. On each push to `main`, [release-please](https://github.com/googleapis/release-please)
+   keeps a **release PR** open with the next version and the `CHANGELOG.md` entry.
+   Until 1.0: `feat!` → minor, `feat`/`fix` → patch.
+3. The same push publishes a dev build `X.Y.(Z+1).devN` to TestPyPI.
+4. **Merging the release PR** tags `vX.Y.Z`, creates the GitHub Release, builds
+   once, publishes to TestPyPI, smoke-tests the install, then publishes to PyPI
+   (Trusted Publishing + PEP 740 attestations, no API tokens).
+5. To force a version (e.g. 1.0.0), add `"release-as": "1.0.0"` to the package in
+   `release-please-config.json` through a PR, then remove it after the release.
+
+Dependencies, Actions and hooks are updated weekly by Renovate; non-major
+updates merge themselves when CI is green.
+
+One-time setup (PyPI publishers, release GitHub App, Renovate):
+`scripts/setup-wizard.sh`.

stoopid-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[project]
+name = "stoopid"
+version = "0.1.0"
+description = "A deliberately meaningless package used to exercise a fully automated release pipeline."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+dependencies = []
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+
+[[project.authors]]
+name = "Simon Harvey"
+email = "simon.harvey.86@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/mighty-muffin/stoopid"
+Changelog = "https://github.com/mighty-muffin/stoopid/blob/main/CHANGELOG.md"
+Issues = "https://github.com/mighty-muffin/stoopid/issues"
+
+[project.scripts]
+stoopid = "stoopid.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.3",
+    "ty>=0.0.97",
+]
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "B",
+    "UP",
+    "SIM",
+    "RUF",
+    "PT",
+]
+
+[tool.ty.environment]
+python-version = "3.10"
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --cov=stoopid --cov-report=term-missing --cov-fail-under=100"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["stoopid"]

stoopid-0.1.0/pyproject.toml.orig

@@ -0,0 +1,59 @@
+[project]
+name = "stoopid"
+version = "0.1.0"
+description = "A deliberately meaningless package used to exercise a fully automated release pipeline."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Simon Harvey", email = "simon.harvey.86@gmail.com" }]
+requires-python = ">=3.10"
+dependencies = []
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/mighty-muffin/stoopid"
+Changelog = "https://github.com/mighty-muffin/stoopid/blob/main/CHANGELOG.md"
+Issues = "https://github.com/mighty-muffin/stoopid/issues"
+
+[project.scripts]
+stoopid = "stoopid.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.3",
+    "ty>=0.0.97",
+]
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "B", "UP", "SIM", "RUF", "PT"]
+
+[tool.ty.environment]
+python-version = "3.10"
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --cov=stoopid --cov-report=term-missing --cov-fail-under=100"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["stoopid"]

stoopid-0.1.0/src/stoopid/__init__.py

@@ -0,0 +1,9 @@
+"""stoopid: a deliberately meaningless package for testing release automation."""
+
+from importlib.metadata import version
+
+from stoopid.core import add, fibonacci, multiply
+
+__all__ = ["__version__", "add", "fibonacci", "multiply"]
+
+__version__ = version("stoopid")

stoopid-0.1.0/src/stoopid/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from stoopid.cli import main
+
+sys.exit(main())

stoopid-0.1.0/src/stoopid/cli.py

@@ -0,0 +1,39 @@
+"""Command-line interface: ``stoopid add 1 2``."""
+
+from __future__ import annotations
+
+import argparse
+from collections.abc import Sequence
+
+from stoopid import __version__
+from stoopid.core import add, fibonacci, multiply
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="stoopid", description=__doc__)
+    parser.add_argument("--version", action="version", version=__version__)
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    for name, help_text in (("add", "add two integers"), ("mul", "multiply two integers")):
+        cmd = sub.add_parser(name, help=help_text)
+        cmd.add_argument("a", type=int)
+        cmd.add_argument("b", type=int)
+
+    fib = sub.add_parser("fib", help="n-th Fibonacci number")
+    fib.add_argument("n", type=int)
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.command == "add":
+        result = add(args.a, args.b)
+    elif args.command == "mul":
+        result = multiply(args.a, args.b)
+    else:
+        try:
+            result = fibonacci(args.n)
+        except ValueError as exc:
+            build_parser().error(str(exc))
+    print(result)
+    return 0

stoopid-0.1.0/src/stoopid/core.py

@@ -0,0 +1,25 @@
+"""Arithmetic nobody needed."""
+
+
+def add(a: int, b: int) -> int:
+    """Return the sum of ``a`` and ``b``."""
+    return a + b
+
+
+def multiply(a: int, b: int) -> int:
+    """Return the product of ``a`` and ``b``."""
+    return a * b
+
+
+def fibonacci(n: int) -> int:
+    """Return the ``n``-th Fibonacci number (``fibonacci(0) == 0``).
+
+    Raises:
+        ValueError: if ``n`` is negative.
+    """
+    if n < 0:
+        raise ValueError("n must be non-negative")
+    a, b = 0, 1
+    for _ in range(n):
+        a, b = b, a + b
+    return a