implement release-please (#4)

Author: Hoeze

.github/workflows/release-please.yml

@@ -0,0 +1,23 @@
+name: Release Please
+
+on:
+  push:
+    branches: [master]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    name: Release Please
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

.release-please-manifest.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/manifest.json",
+  ".": "2.0.0"
+}

CONTRIBUTING.md

@@ -0,0 +1,70 @@
+# Contributing to `snakemk_util`
+
+## Development environment
+
+The project uses [`uv`](https://docs.astral.sh/uv/) for dependency management.
+
+### Initial setup
+
+```bash
+# Create the conda env (provides Python + uv)
+micromamba env create -f environment-dev.yml
+micromamba activate snakemk_util
+
+# Install all dependency groups (runtime + dev + test + lint) into a uv-managed venv
+uv sync --all-groups --all-extras
+```
+
+All subsequent commands assume the env is activated and `uv` is on `PATH`.
+
+## Running tasks
+
+The project standardises tasks through [`tox`](https://tox.wiki/) with the `tox-uv` runner. Run any environment with:
+
+```bash
+uv run tox -e <env>
+```
+
+Available environments (defined in `pyproject.toml`):
+
+| Env             | Purpose                                  |
+|-----------------|------------------------------------------|
+| `format-check`  | `ruff format --check .`                  |
+| `lints`         | `ruff check .`                           |
+| `typecheck`     | `mypy snakemk_util`                      |
+| `py3.11`        | Run pytest under Python 3.11             |
+| `py3.14`        | Run pytest under Python 3.14             |
+
+Run the full matrix CI runs with:
+
+```bash
+uv run tox
+```
+
+### Quick commands
+
+```bash
+# Format code
+uv run ruff format .
+
+# Lint with autofix
+uv run ruff check --fix .
+
+# Run tests directly (single Python)
+uv run pytest
+
+# Run a single test
+uv run pytest tests/test_rule_args.py::test_name -x
+```
+
+## Releases
+
+Versioning and tagging are automated by [release-please](https://github.com/googleapis/release-please) (`.github/workflows/release-please.yml`). Publishing is handled by `.github/workflows/publish.yml`:
+
+- release-please watches commits on `master` and opens/maintains a release PR that bumps `pyproject.toml` and updates `CHANGELOG.md`.
+- Merging the release PR cuts a `vX.Y.Z` tag and a GitHub release.
+- The tag triggers `publish.yml`, which builds sdist + wheel and uploads to PyPI via trusted publishing (OIDC).
+- `__version__` is sourced at runtime from package metadata (`importlib.metadata.version("snakemk_util")`).
+
+Use [Conventional Commits](https://www.conventionalcommits.org/) on `master` so release-please can pick the next version (`fix:` → patch, `feat:` → minor, `feat!:` / `BREAKING CHANGE:` → major).
+

environment-dev.yml

@@ -0,0 +1,9 @@
+name: snakemk_util
+channels:
+  - conda-forge
+  - bioconda
+  - nodefaults
+dependencies:
+  # common
+  - python >=3.13
+  - uv =0.11

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "snakemk_util"
-dynamic = ["version"]
+version = "2.0.0"
 description = "utility functions for snakemake"
 authors = [
     { name = "Florian R. Hölzlwimmer", email = "git.ich@frhoelzlwimmer.de" }
@@ -24,7 +24,6 @@ snakemk_util = "snakemk_util.main:main"
 
 [dependency-groups]
 dev = [
-    "bumpversion",
     "tox>=4",
     "tox-uv",
 ]
@@ -42,9 +41,6 @@ lint = [
 [tool.setuptools]
 packages = ["snakemk_util"]
 
-[tool.setuptools.dynamic]
-version = { attr = "snakemk_util.__version__" }
-
 [tool.ruff]
 target-version = "py311"
 line-length = 120

release-please-config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "packages": {
+    ".": {
+      "release-type": "python",
+      "package-name": "snakemk_util",
+      "include-component-in-tag": false,
+      "include-v-in-tag": true
+    }
+  }
+}

snakemk_util/__init__.py

@@ -1,4 +1,6 @@
-__version__ = "2.0.1-dev"
+from importlib.metadata import version
+
+__version__ = version("snakemk_util")
 
 from .formatting import recursive_format
 from .rule_args import (