feat: justfile

Author: Anders Brams

README.md

@@ -172,17 +172,3 @@ client = Client(
 )
 book = client.get("/books/{book_id}")(params={"book_id": 1})
 ```
-
-## Releases
-
-Releases are published from the protected `releases` branch. The package version is set manually in `pyproject.toml`, and pushing a release commit to `releases` triggers the GitHub Actions release workflow. The workflow creates the matching `vX.Y.Z` tag after checks pass.
-
-Release steps:
-
-```bash
-# 1. Update project.version in pyproject.toml, then commit that change.
-uv run python scripts/release.py --version 0.1.0
-
-# 2. If checks pass, push the current commit to the releases branch.
-uv run python scripts/release.py --version 0.1.0 --push-release-branch
-```

justfile

@@ -0,0 +1,33 @@
+set shell := ["bash", "-eu", "-o", "pipefail", "-c"]
+
+default:
+    @just --list
+
+sync:
+    uv sync --locked --all-packages
+
+format:
+    uv run ruff check --select I --fix .
+    uv run ruff format .
+
+format-check:
+    uv run ruff check --select I .
+    uv run ruff format --check .
+
+typecheck:
+    uv run ty check .
+
+test *args:
+    uv run pytest -n auto {{args}}
+
+check: format-check typecheck test
+
+build:
+    uv build
+
+release version="":
+    if [ -n "{{version}}" ]; then \
+        uv run python scripts/release.py --version "{{version}}"; \
+    else \
+        uv run python scripts/release.py; \
+    fi

scripts/release.py

@@ -73,17 +73,12 @@ def require_tag_available(tag: str) -> None:
 
 def main() -> None:
     parser = argparse.ArgumentParser(
-        description="Prepare and optionally publish from the releases branch."
+        description="Run local checks and build distributions before releasing."
     )
     parser.add_argument(
         "--version",
         help="Expected version. Defaults to the version in pyproject.toml.",
     )
-    parser.add_argument(
-        "--push-release-branch",
-        action="store_true",
-        help="Push the current commit to origin/releases after release checks pass.",
-    )
     args = parser.parse_args()
 
     version = project_version()
@@ -109,13 +104,8 @@ def main() -> None:
     run(["uv", "run", "pytest", "-n", "auto"])
     run(["uv", "build"])
 
-    if args.push_release_branch:
-        run(["git", "push", "origin", "HEAD:releases"])
-        print("Pushed current commit to origin/releases.")
-        print("GitHub Actions will create the release tag and publish after approval.")
-    else:
-        print(f"Release checks passed for {tag}.")
-        print("Publish with: git push origin HEAD:releases")
+    print(f"Release checks passed for {tag}.")
+    print("Publish with: git push origin HEAD:releases")
 
 
 if __name__ == "__main__":