chore(release): replace bump2version with bump-my-version

Made-with: Cursor

Author: Andreas-Garcia

.bumpversion.cfg

@@ -139,7 +139,7 @@ Documentation changes should be grouped under the **Documentation** category, no
 
 ## Release Process
 
-Follow **CONTRIBUTING.md §7 (Releasing for maintainers)** (Git Flow: `release/*` branch). Maintainers **must run** **`python3 scripts/prepare_release_bump.py`** `patch`|`minor`|`major` before creating/pushing a `release/*` branch. The script applies the `## [Unreleased]  <!-- release -->` marker (see `.bumpversion.cfg`), runs **bump2version**, **`scripts/fix_changelog_after_bump.py`**, and inserts an empty `## [Unreleased]` for the next cycle. Contributors use plain `## [Unreleased]` until the maintainer runs the script.
+Follow **CONTRIBUTING.md §7 (Releasing for maintainers)** (Git Flow: `release/*` branch). Maintainers **must run** **`python3 scripts/prepare_release_bump.py`** `patch`|`minor`|`major` before creating/pushing a `release/*` branch. The script applies the `## [Unreleased]  <!-- release -->` marker (see `[tool.bumpversion]` in `pyproject.toml`), runs **bump-my-version**, **`scripts/fix_changelog_after_bump.py`**, and inserts an empty `## [Unreleased]` for the next cycle. Contributors use plain `## [Unreleased]` until the maintainer runs the script.
 
 During releases, maintainers also:
 1. Review and consolidate entries moved under the new version

.cursor/rules/changelog-best-practices.mdc

@@ -3,7 +3,6 @@
 # =============================================================================
 *.pyc
 .venv/
-.venv-release/
 venv/
 .mypy_cache/
 .ruff_cache/

.gitignore

@@ -76,7 +76,7 @@ All contributors (including maintainers) should update `CHANGELOG.md` when creat
 
 - **Linting (audiometa-python baseline)**: [`.pre-commit-config.yaml`](.pre-commit-config.yaml) matches the audiometa-python hook stack (tool version check, YAML/JSON/TOML, shellcheck, `no-assert`, ruff-format, ruff, mypy + django-stubs, pydocstringformatter, long-comment fixer, Prettier, optional PSScriptAnalyzer) plus **`prefer-strenum`** (pre-commit no longer runs **isort**; org **v4.3+** verifier forbids it alongside **ruff format**). Configuration lives in [`pyproject.toml`](pyproject.toml); linter and test dependencies are pinned under `[project.optional-dependencies] dev`. Ruff **select** matches audiometa; extra **ignores** document Django/DRF cleanup debt. Mypy is plugin-aligned but **gradual** (`ignore_missing_imports`, non-strict) until typing can match audiometa strictness.
 
-- **Packaging (PEP 621, audiometa-style)**: Runtime and dev dependencies are declared in `pyproject.toml` (`[project]` / `[project.optional-dependencies] dev`) with setuptools as the build backend. Local and CI use `pip install -e ".[dev]"`; production Docker builds use `pip install .`. There is no `requirements.txt`; `pyproject.toml` is the only dependency manifest. Release bumps now update `pyproject.toml` `[project] version` via bump2version. `fake-samples-loader` is pinned to `1.0.13`; `django-dynamic-fixture` is a dev extra (tests only).
+- **Packaging (PEP 621, audiometa-style)**: Runtime and dev dependencies are declared in `pyproject.toml` (`[project]` / `[project.optional-dependencies] dev`) with setuptools as the build backend. Local and CI use `pip install -e ".[dev]"`; production Docker builds use `pip install .`. There is no `requirements.txt`; `pyproject.toml` is the only dependency manifest. Release bumps update `pyproject.toml` `[project] version` via **bump-my-version** (`[tool.bumpversion]`). `fake-samples-loader` is pinned to `1.0.13`; `django-dynamic-fixture` is a dev extra (tests only).
 
 - **[`.pre-commit-hooks/`](.pre-commit-hooks/)**: Shell wrappers copied from audiometa-python (`tool-wrapper`, `check-tool-versions`, shellcheck, `no-assert`, etc.).
 
@@ -116,7 +116,7 @@ All contributors (including maintainers) should update `CHANGELOG.md` when creat
 
 - **Library path env contract**: Removed runtime usage of `LIBRARIES_DIR_NAME`; settings and user library path generation now rely on `LIBRARIES_DIR` only. Updated Compose defaults, test workflow env, and dev env example accordingly.
 
-- **Release tooling**: [`scripts/prepare_release_bump.py`](scripts/prepare_release_bump.py) no longer requires an activated project virtualenv; maintainers only need `bump2version` on `PATH` (same pin as dev deps). [CONTRIBUTING.md](CONTRIBUTING.md) §7 documents `pipx`, dev installs, or Compose `api` as options. [`.gitignore`](.gitignore) adds `.venv-release/` for optional local one-off venvs.
+- **Release tooling**: Replaced deprecated **bump2version** with **[bump-my-version](https://github.com/callowayproject/bump-my-version)** (`bump-my-version==1.3.0`); bump rules live under `[tool.bumpversion]` in [`pyproject.toml`](pyproject.toml) (`.bumpversion.cfg` removed). [`scripts/prepare_release_bump.py`](scripts/prepare_release_bump.py) runs `bump-my-version bump patch|minor|major`; maintainers only need the CLI on `PATH` (pipx, pyenv-backed install, or Compose `api` with dev extras). [CONTRIBUTING.md](CONTRIBUTING.md) §7 updated accordingly. Runtime **Click** is bumped from `7.0` to `8.3.3` (`click<8.4` required by bump-my-version) so dev installs can run the bump CLI in the same environment.
 
 ### CI
 

CHANGELOG.md

@@ -832,15 +832,15 @@ Quick release process:
 
 3. **On the release branch, prepare the release:**
 
-   - **Automated (recommended):** from the repo root, with `bump2version` on `PATH` (same pin as dev deps in [`pyproject.toml`](pyproject.toml), currently `bump2version==1.0.1` — e.g. `pipx install bump2version==1.0.1`, or run bump steps inside the Compose `api` dev image where dev extras are installed). No project `.venv` is required.
+   - **Automated (recommended):** from the repo root, with `bump-my-version` on `PATH` (same pin as dev deps in [`pyproject.toml`](pyproject.toml), currently `bump-my-version==1.3.0` — e.g. `pipx install bump-my-version==1.3.0`, a pyenv (or other) Python where `pip install -e ".[dev]"` is allowed, or run bump steps inside the Compose `api` dev image where dev extras are installed). No project `.venv` is required.
 
      ```bash
      python3 scripts/prepare_release_bump.py patch   # or: minor | major
      ```
 
-     This sets the live `## [Unreleased]  <!-- release -->` marker (only the heading **after** the maintainer Note—not the fenced example), runs [bump2version](https://github.com/c4urself/bump2version), runs `python scripts/fix_changelog_after_bump.py`, and adds an empty `## [Unreleased]` above the new version section. By default it passes `--allow-dirty` to bump2version so you can commit once at the end; use `--no-allow-dirty` if you need a clean tree.
+     This sets the live `## [Unreleased]  <!-- release -->` marker (only the heading **after** the maintainer Note—not the fenced example), runs [bump-my-version](https://github.com/callowayproject/bump-my-version), runs `python scripts/fix_changelog_after_bump.py`, and adds an empty `## [Unreleased]` above the new version section. By default it passes `--allow-dirty` so you can commit once at the end; use `--no-allow-dirty` if you need a clean tree.
 
-   - **Manual sequence** (same end state): set the live heading after the Note to `## [Unreleased]  <!-- release -->`, then `bump2version patch` (or minor/major; add `--allow-dirty` if needed), then `python scripts/fix_changelog_after_bump.py`, then ensure an empty `## [Unreleased]` sits above `## [vX.Y.Z] - …`. `.bumpversion.cfg` only replaces that one changelog line; everything below it until the next `## [` belongs to that release.
+   - **Manual sequence** (same end state): set the live heading after the Note to `## [Unreleased]  <!-- release -->`, then `bump-my-version bump patch` (or `bump minor` / `bump major`; add `--allow-dirty` if needed), then `python scripts/fix_changelog_after_bump.py`, then ensure an empty `## [Unreleased]` sits above `## [vX.Y.Z] - …`. Release bump file rules live under `[tool.bumpversion]` in [`pyproject.toml`](pyproject.toml); the changelog rule only replaces that one heading line — everything below it until the next `## [` belongs to that release.
 
    - Review and finalize `CHANGELOG.md`:
 
@@ -876,7 +876,7 @@ Quick release process:
    ./scripts/remove_prerelease_tags.sh
    ```
 
-   The script uses the version from the `VERSION` file (same as after `bump2version`). You can also pass a version explicitly: `./scripts/remove_prerelease_tags.sh 0.2.1`.
+   The script uses the version from the `VERSION` file (same as after a release bump). You can also pass a version explicitly: `./scripts/remove_prerelease_tags.sh 0.2.1`.
 
    **Note:** Pre-release tags are temporary and should be cleaned up after the release is published to keep the repository clean.
 

CONTRIBUTING.md

@@ -155,7 +155,7 @@ The workflow extracts the version from the ref, uses it for the Docker image tag
 
 ### Creating a Release
 
-**Source of truth:** full Git Flow (release branch, `python3 scripts/prepare_release_bump.py` or `bump2version` by hand, `CHANGELOG.md`, PR to `main`, tag with `v` prefix, merge back to `develop`, delete release branch) is documented in [CONTRIBUTING.md](../CONTRIBUTING.md#7-releasing-for-maintainers) §7. The steps below are a short tag/publish reminder only.
+**Source of truth:** full Git Flow (release branch, `python3 scripts/prepare_release_bump.py` or `bump-my-version bump …` by hand, `CHANGELOG.md`, PR to `main`, tag with `v` prefix, merge back to `develop`, delete release branch) is documented in [CONTRIBUTING.md](../CONTRIBUTING.md#7-releasing-for-maintainers) §7. The steps below are a short tag/publish reminder only.
 
 ```bash
 # After VERSION and CHANGELOG on main match the release (see CONTRIBUTING.md §7):

docs/versioning.md

@@ -10,7 +10,7 @@ Requires-Dist: bcrypt==3.1.7
 Requires-Dist: blinker==1.4
 Requires-Dist: certifi==2019.11.28
 Requires-Dist: chardet==3.0.4
-Requires-Dist: Click==7.0
+Requires-Dist: Click==8.3.3
 Requires-Dist: colorama==0.4.3
 Requires-Dist: Django==5.2.8
 Requires-Dist: django-cors-headers==4.3.1
@@ -42,14 +42,15 @@ Requires-Dist: python-dateutil==2.7.3
 Requires-Dist: python-dotenv==1.0.1
 Requires-Dist: python-magic==0.4.27
 Requires-Dist: requests==2.32.3
+Requires-Dist: setuptools==75.2.0
 Requires-Dist: shortuuid==1.0.9
 Requires-Dist: simplejson==3.16.0
 Requires-Dist: spotipy==2.23.0
 Requires-Dist: tinytag==1.10.1
 Requires-Dist: uvicorn==0.20.0
 Requires-Dist: werkzeug==2.2.2
 Provides-Extra: dev
-Requires-Dist: bump2version==1.0.1; extra == "dev"
+Requires-Dist: bump-my-version==1.3.0; extra == "dev"
 Requires-Dist: coverage==6.5.0; extra == "dev"
 Requires-Dist: django-dynamic-fixture==4.0.1; extra == "dev"
 Requires-Dist: django-stubs==5.2.1; extra == "dev"

hear_the_music_tree_api.egg-info/PKG-INFO

@@ -224,7 +224,6 @@ api/serializer/audio_metadata/AudioMetadataRequestFile.py
 api/serializer/audio_metadata/AudioMetadataRequestUrl.py
 api/serializer/audio_metadata/AudioMetadataSessionDownload.py
 api/serializer/audio_metadata/Fields.py
-api/serializer/audio_metadata/WritableMetadataFieldsMixin.py
 api/serializer/field/AppBooleanField.py
 api/serializer/field/AppCharField.py
 api/serializer/field/AppDictField.py
@@ -406,7 +405,6 @@ api/test/tests/integration/artist/list/filter/test_not_existing.py
 api/test/tests/integration/artist/retrieve/__init__.py
 api/test/tests/integration/artist/retrieve/test_lib_tracks.py
 api/test/tests/integration/audio_metadata/AudioMetadataTestCase.py
-api/test/tests/integration/audio_metadata/__init__.py
 api/test/tests/integration/audio_metadata/test_full.py
 api/test/tests/integration/audio_metadata/test_metadata_session.py
 api/test/tests/integration/audio_metadata/test_musicbrainz_analysis.py
@@ -746,11 +744,11 @@ api/test/tests/integration/uploaded_track/input/save/test_extra_field.py
 api/test/tests/integration/uploaded_track/input/save/test_language.py
 api/test/tests/integration/uploaded_track/input/save/test_rating.py
 api/test/tests/integration/uploaded_track/input/save/test_title.py
-api/test/tests/integration/uploaded_track/input/save/album attributes/__init__.py
-api/test/tests/integration/uploaded_track/input/save/album attributes/test_album.py
-api/test/tests/integration/uploaded_track/input/save/album attributes/test_album_and_album_artists.py
-api/test/tests/integration/uploaded_track/input/save/album attributes/test_album_artists.py
-api/test/tests/integration/uploaded_track/input/save/album attributes/test_track_number.py
+api/test/tests/integration/uploaded_track/input/save/album_attributes/__init__.py
+api/test/tests/integration/uploaded_track/input/save/album_attributes/test_album.py
+api/test/tests/integration/uploaded_track/input/save/album_attributes/test_album_and_album_artists.py
+api/test/tests/integration/uploaded_track/input/save/album_attributes/test_album_artists.py
+api/test/tests/integration/uploaded_track/input/save/album_attributes/test_track_number.py
 api/test/tests/integration/uploaded_track/input/save/genre/__init__.py
 api/test/tests/integration/uploaded_track/input/save/genre/test_genre_name.py
 api/test/tests/integration/uploaded_track/input/save/genre/test_genre_uuid.py
@@ -832,14 +830,12 @@ api/test/tests/unit/serializer/test_model_serializer_inheritance.py
 api/test/tests/unit/serializer/field/__init__.py
 api/test/tests/unit/serializer/field/test_app_boolean_field.py
 api/test/tests/unit/serializer/field/test_field_inheritance.py
-api/test/tests/unit/utils/audio_file_metadata/test_metadata_session_app_metadata.py
 api/test/tests/unit/utils/audio_fingerprinter/test_analysis.py
 api/test/tests/unit/utils/audiometa_adapter/__init__.py
 api/test/tests/unit/utils/audiometa_adapter/test_audiometa_adapter.py
 api/test/tests/unit/utils/decorators/test_spotify_user_required_decorator.py
 api/test/tests/unit/utils/file_path_utils/__init__.py
 api/test/tests/unit/utils/file_path_utils/test_file_path_utils.py
-api/test/tests/unit/utils/metadata_session/test_service.py
 api/test/tests/unit/utils/musicbrainz/__init__.py
 api/test/tests/unit/utils/musicbrainz/test_create_or_update.py
 api/test/tests/unit/utils/musicbrainz/test_recording_analysis.py

hear_the_music_tree_api.egg-info/SOURCES.txt

@@ -4,7 +4,7 @@ bcrypt==3.1.7
 blinker==1.4
 certifi==2019.11.28
 chardet==3.0.4
-Click==7.0
+Click==8.3.3
 colorama==0.4.3
 Django==5.2.8
 django-cors-headers==4.3.1
@@ -45,7 +45,7 @@ uvicorn==0.20.0
 werkzeug==2.2.2
 
 [dev]
-bump2version==1.0.1
+bump-my-version==1.3.0
 coverage==6.5.0
 django-dynamic-fixture==4.0.1
 django-stubs==5.2.1

hear_the_music_tree_api.egg-info/requires.txt

@@ -17,7 +17,7 @@ dependencies = [
     "blinker==1.4",
     "certifi==2019.11.28",
     "chardet==3.0.4",
-    "Click==7.0",
+    "Click==8.3.3",
     "colorama==0.4.3",
     "Django==5.2.8",
     "django-cors-headers==4.3.1",
@@ -60,7 +60,7 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
-    "bump2version==1.0.1",
+    "bump-my-version==1.3.0",
     "coverage==6.5.0",
     "django-dynamic-fixture==4.0.1",
     "django-stubs==5.2.1",
@@ -139,3 +139,35 @@ ignore_errors = true
 [[tool.mypy.overrides]]
 module = "pytest"
 ignore_missing_imports = true
+
+# Release bumps (maintainers): `bump-my-version bump patch|minor|major` or `scripts/prepare_release_bump.py`.
+# https://github.com/callowayproject/bump-my-version
+[tool.bumpversion]
+current_version = "2.2.3"
+commit = false
+tag = false
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+
+[[tool.bumpversion.files]]
+filename = "VERSION"
+
+[[tool.bumpversion.files]]
+filename = "package.json"
+search = "\"version\": \"{current_version}\""
+replace = "\"version\": \"{new_version}\""
+
+[[tool.bumpversion.files]]
+filename = "schema.yml"
+search = "version: {current_version}"
+replace = "version: {new_version}"
+
+[[tool.bumpversion.files]]
+filename = "CHANGELOG.md"
+search = "## [Unreleased]  <!-- release -->"
+replace = "## [v{new_version}] - YYYY-MM-DD"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = "version = \"{current_version}\""
+replace = "version = \"{new_version}\""