chore(releaser): onboard release-please (#185)

Author: mxmehl

.github/release.yml

@@ -0,0 +1,29 @@
+# SPDX-FileCopyrightText: 2026 DB Systel GmbH
+#
+# SPDX-License-Identifier: Apache-2.0
+
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/create-github-app-token@1b10c78c7865c340bc4f6099eb2f838309f1e8c3 # v3.1.1
+        id: app-token
+        with:
+          client-id: ${{ secrets.RELEASER_CLIENT_ID }}
+          private-key: ${{ secrets.RELEASER_PRIVATE_KEY }}
+
+      - uses: googleapis/release-please-action@5c625bfb5d1ff62eadeeb3772007f7f66fdcf071 # v4.4.1
+        with:
+          token: ${{ steps.app-token.outputs.token }}

.github/workflows/release-please.yaml

@@ -0,0 +1,3 @@
+{
+  ".": "0.7.7"
+}

.release-please-manifest.json

@@ -15,5 +15,23 @@ Starting development is as easy as installing [uv](https://docs.astral.sh/uv/) a
 
 In order to run the project in the new virtual environment, run `uv run gh-org-mgr`.
 
+## Commit Messages
+
+This project follows the [**Conventional Commits**](https://www.conventionalcommits.org/) specification for commit messages. This is critical to support proper automation of the release process and changelog generation.
+
+## Pull Requests
+
+When contributing to this project, please open a pull request with a clear description of the changes you have made. The **title of your pull request** should follow the conventional commit format (e.g., `feat: add new feature`, `fix: correct a bug`, etc.).
+
+Ensure to use the **Squash and merge** option when merging your pull request.
+
+Both the PR title and merge method are required for a proper release process (see below).
+
+## Release Process
+
+This project uses [release-please](https://github.com/googleapis/release-please) and its respective GitHub Action to automate the release process. This automatically creates a pull request with the version bump and changelog updates whenever a commit is pushed to the default branch. The version bump is determined by the [conventional commit messages](https://www.conventionalcommits.org/) in the commit history since the last release. Once the release pull request is merged, a new release will be published on GitHub.
+
+The relevant configuration for release-please can be found in the `.github/workflows/release-please.yaml` file and the `release-please-config.json` file. Ensure that the branch and project names are correctly set up in the workflow file and configuration file to match your repository's structure.
+
 ---
 Based on [GitHub's Minimum Viable Governance (MVG)](https://github.com/github/MVG). Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).

CONTRIBUTING.md

@@ -0,0 +1,6 @@
+version = 1
+
+[[annotations]]
+path = ["release-please-config.json", ".release-please-manifest.json", "CHANGELOG.md"]
+SPDX-FileCopyrightText = "2026 OpenRail Association AISBL"
+SPDX-License-Identifier = "CC0-1.0"

REUSE.toml

@@ -48,7 +48,6 @@ gh-org-mgr = "gh_org_mgr.manage:main"
 dev = [
     "ruff>=0.15.10",
     "ty>=0.0.29",
-    "bump-my-version>=1.2.3,<2",
 ]
 
 [tool.uv]
@@ -87,30 +86,3 @@ convention = "google"
 # TY settings
 [tool.ty.src]
 include = ["gh_org_mgr"]
-
-# Bump-My-Version
-[tool.bumpversion]
-commit = true
-tag = true
-sign_tags = true
-allow_dirty = false
-tag_name = "v{new_version}"
-
-[[tool.bumpversion.files]]
-filename = "pyproject.toml"
-regex = true
-search = "^version = \"{current_version}\""
-replace = "version = \"{new_version}\""
-
-[[tool.bumpversion.files]]
-filename = "uv.lock"
-search = """
-[[package]]
-name = "github-org-manager"
-version = "{current_version}"
-"""
-replace = """
-[[package]]
-name = "github-org-manager"
-version = "{new_version}"
-"""

pyproject.toml

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "release-type": "python",
+  "packages": {
+    ".": {
+      "extra-files": [
+        {
+          "path": "uv.lock",
+          "type": "toml",
+          "jsonpath": "$.package[?(@.name.value=='github-org-manager')].version"
+        }
+      ]
+    }
+  },
+  "pull-request-header": ":robot: New Release",
+  "changelog-sections": [
+    { "type": "feat", "section": "🚀 New Features", "hidden": false },
+    { "type": "fix", "section": "🔥 Bug Fixes", "hidden": false },
+    { "type": "perf", "section": "🏃 Performance Improvements", "hidden": false },
+    { "type": "revert", "section": "↩️ Reverts", "hidden": true },
+    { "type": "docs", "section": "📚 Documentation", "hidden": false },
+    { "type": "refactor", "section": "⌨️ Code Refactoring", "hidden": false },
+    { "type": "test", "section": "🧪 Automated Testing", "hidden": false },
+    { "type": "build", "section": "🛠️ Build System", "hidden": false },
+    { "type": "ci", "section": "📦 CI Improvements", "hidden": false },
+    { "type": "chore", "section": "⚙️ Chores", "hidden": false }
+  ]
+}