add releasing doc (#1174)

Author: vincentsarago

CHANGES.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+## 0.22.3 (2025-06-17)
+
 ### titiler.xarray
 
 * use dimension's `dtype` to cast user *selection*

RELEASING.md

@@ -0,0 +1,22 @@
+# Releasing
+
+This is a checklist for releasing a new version of **titiler**.
+
+1. Determine the next version
+   We currently do not have published versioning guidelines. We usually use `minor` version update when pushing breaking changes and `patch` for every other updates
+2. Create a release branch named `release/vX.Y.Z`, where `X.Y.Z` is the new version
+3. Search and replace all instances of the current version number with the new version
+
+   We recommend to use [`bump-my-version`](https://github.com/callowayproject/bump-my-version) CLI
+   ```
+   bump-my-version bump --new-version 3.1.0
+   ```
+
+4. Manually increase the helm chart `version` in `/deployment/k8s/charts/Chart.yaml (not matching titiler's version)
+5. Update [CHANGES.md](./CHANGES.md) for the new version
+6. Push your release branch, create a PR, and get approval
+7. Once the PR is merged, create a new (annotated, signed) tag on the appropriate commit
+   Name the tag `X.Y.Z`, and include `vX.Y.Z` as its annotation message
+8. Push your tag to Github, which will kick off the publishing workflow
+9. Create a [new release](https://github.com/stac-utils/stac-fastapi/releases/new) targeting the new tag, and use the "Generate release notes" feature to populate the description.
+    Publish the release and mark it as the latest.

deployment/aws/lambda/Dockerfile

@@ -8,7 +8,7 @@ WORKDIR /tmp
 RUN yum install -y gcc-c++
 
 RUN python -m pip install pip -U
-RUN python -m pip install "titiler.application==0.22.2" "mangum>=0.10.0" -t /asset --no-binary pydantic
+RUN python -m pip install "titiler.application==0.22.3" "mangum>=0.10.0" -t /asset --no-binary pydantic
 
 # Reduce package size and remove useless files
 RUN cd /asset && find . -type f -name '*.pyc' | while read f; do n=$(echo $f | sed 's/__pycache__\///' | sed 's/.cpython-[0-9]*//'); cp $f $n; done;

deployment/k8s/charts/Chart.yaml

@@ -1,8 +1,8 @@
 apiVersion: v1
-appVersion: 0.22.2
+appVersion: 0.22.3
 description: A dynamic Web Map tile server
 name: titiler
-version: 1.2.5
+version: 1.2.6
 icon: https://raw.githubusercontent.com/developmentseed/titiler/main/docs/logos/TiTiler_logo_small.png
 maintainers:
   - name: emmanuelmathot  # Emmanuel Mathot

pyproject.toml

@@ -29,13 +29,13 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: GIS",
 ]
-version="0.22.2"
+version="0.22.3"
 dependencies = [
-    "titiler.core==0.22.2",
-    "titiler.xarray==0.22.2",
-    "titiler.extensions==0.22.2",
-    "titiler.mosaic==0.22.2",
-    "titiler.application==0.22.2",
+    "titiler.core==0.22.3",
+    "titiler.xarray==0.22.3",
+    "titiler.extensions==0.22.3",
+    "titiler.mosaic==0.22.3",
+    "titiler.application==0.22.3",
 ]
 
 [project.urls]
@@ -130,11 +130,12 @@ filterwarnings = [
 
 
 
+
 [tool.hatch.build.targets.wheel]
 bypass-selection = true
 
 [tool.bumpversion]
-current_version = "0.22.2"
+current_version = "0.22.3"
 parse = """(?x)
     (?P<major>\\d+)\\.
     (?P<minor>\\d+)\\.

src/titiler/application/pyproject.toml

@@ -31,9 +31,9 @@ classifiers = [
 ]
 dynamic = ["version"]
 dependencies = [
-    "titiler.core==0.22.2",
-    "titiler.extensions[cogeo,stac]==0.22.2",
-    "titiler.mosaic==0.22.2",
+    "titiler.core==0.22.3",
+    "titiler.extensions[cogeo,stac]==0.22.3",
+    "titiler.mosaic==0.22.3",
     "starlette-cramjam>=0.4,<0.5",
     "pydantic-settings~=2.0",
 ]

src/titiler/application/titiler/application/__init__.py

@@ -1,3 +1,3 @@
 """titiler.application"""
 
-__version__ = "0.22.2"
+__version__ = "0.22.3"

src/titiler/core/titiler/core/__init__.py

@@ -1,6 +1,6 @@
 """titiler.core"""
 
-__version__ = "0.22.2"
+__version__ = "0.22.3"
 
 from . import dependencies, errors, factory, routing  # noqa
 from .factory import (  # noqa

src/titiler/extensions/pyproject.toml

@@ -31,7 +31,7 @@ classifiers = [
 ]
 dynamic = ["version"]
 dependencies = [
-    "titiler.core==0.22.2"
+    "titiler.core==0.22.3"
 ]
 
 [project.optional-dependencies]

src/titiler/extensions/titiler/extensions/__init__.py

@@ -1,6 +1,6 @@
 """titiler.extensions"""
 
-__version__ = "0.22.2"
+__version__ = "0.22.3"
 
 from .cogeo import cogValidateExtension  # noqa
 from .render import stacRenderExtension  # noqa