add explicit bump procedure for stac-model package

Author: fmigneault

CONTRIBUTING.md

@@ -88,13 +88,13 @@ git push -u origin your-branch
 ### Building a new version of `stac-model`
 
 - Apply any relevant changes and `CHANGELOG.md` entries in a PR that modifies `stac-model`.
-- Bump the version with `bumpversion bump <version>`.
+- Bump the version with `bump-my-version bump --verbose <version-level> --config-file stac-model.bump.toml`.
   - You can pass the new version explicitly, or a rule such as `major`, `minor`, or `patch`. <br>
     For more details, refer to the [Semantic Versions][semver] standard;
 - Once CI validation succeeded, merge the corresponding PR branch.
-- Checkout to `main` branch that contais the freshly created merge commit.
+- Checkout to `main` branch that contains the freshly created merge commit.
 - Push the tag `stac-model-v{MAJOR}.{MINOR}.{PATCH}`. The CI should auto-publish it to PyPI.
-- Create a `GitHub release`
+- Create a `GitHub release` (if not automatically drafted by the CI).
 
 <!-- lint disable no-undefined-references -->
 

pyproject.toml

@@ -24,6 +24,7 @@ dependencies = [
     "jsonschema<5.0.0,>=4.21.1",
     "pip>=25.0.0",
 ]
+# important: leave the name and version together for bump resolution
 name = "stac-model"
 version = "0.2.0"
 description = "A PydanticV2 validation and serialization libary for the STAC ML Model Extension"
@@ -86,7 +87,7 @@ stac-model = "stac_model.__main__:app"
 # NOTE:
 #   Although these definitions are provided in this 'stac-model' project file,
 #   they are actually intented for versioning the MLM specification itself.
-#   To version 'stac-model', use the 'bump-my-version bump' operation.
+#   To version 'stac-model', use the 'bump-my-version bump' operation using the 'stac-model.bump.toml' file.
 #   See also https://github.com/stac-extensions/mlm/blob/main/CONTRIBUTING.md#building-and-releasing
 current_version = "1.4.0"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"

stac-model.bump.toml

@@ -0,0 +1,47 @@
+
+[tool.bumpversion]
+# NOTE:
+#   This is the bump definition for the 'stac-model' package.
+#   For the MLM specification, refer to the main 'pyproject.toml'.
+#   they are actually intented for versioning the MLM specification itself.
+#   To version 'stac-model', use the 'bump-my-version bump' operation with this file.
+#   See also https://github.com/stac-extensions/mlm/blob/main/CONTRIBUTING.md#building-and-releasing
+current_version = "0.2.0"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+search = "{current_version}"
+replace = "{new_version}"
+regex = false
+ignore_missing_version = true
+ignore_missing_files = false
+tag = true
+sign_tags = false
+tag_name = "stac-model-v{new_version}"
+tag_message = "Bump version: stac-model {current_version} → {new_version}"
+allow_dirty = false
+commit = true
+commit_args = "--no-verify"
+message = "Bump version: stac-model {current_version} → {new_version}"
+
+[[tool.bumpversion.files]]
+filename = "uv.lock"
+search = """
+name = "stac-model"
+version = "{current_version}"
+"""
+replace = """
+name = "stac-model"
+version = "{new_version}"
+"""
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = """
+name = "stac-model"
+version = "{current_version}"
+"""
+replace = """
+name = "stac-model"
+version = "{new_version}"
+"""
+