Fix: handle difference releases alfa vs master

.github/workflows/publish-to-pypi.yml

@@ -21,6 +21,15 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         python -m pip install build
+
+    - name: Set Version Suffix Based on Branch
+      run: |
+        if [ "${GITHUB_REF_NAME}" == "master" ] || [ "${GITHUB_REF_NAME}" == "main" ]; then
+          echo "VERSION_SUFFIX=" >> $GITHUB_ENV
+        else
+          echo "VERSION_SUFFIX=-${GITHUB_REF_NAME}" >> $GITHUB_ENV
+        fi
+
     - name: Build a binary wheel and a source tarball
       run: |
         python -m build --sdist --wheel --outdir dist/

VERSION

@@ -1 +1 @@
-0.9.0
+0.9.0.0

docs/conf.py

@@ -12,7 +12,18 @@
 
 # Path to the VERSION file
 version_file = pathlib.Path(__file__).parent.parent / "VERSION"
-version = version_file.read_text().strip()
+base_version = version_file.read_text().strip()
+# Check if we are on Read the Docs
+on_rtd = os.getenv("READTHEDOCS") == "True"
+# Determine suffix based on the branch
+suffix = ""
+if on_rtd:
+    branch = os.getenv("READTHEDOCS_VERSION", "main")
+    if branch in ["main", "master"]:
+        suffix = ""
+    else:
+        suffix = f"-{branch}"
+version = f'{base_version}{suffix}'
 
 sys.path.insert(0, os.path.abspath('..'))
 

setup.py

@@ -1,10 +1,13 @@
 # Always prefer setuptools over distutils
 from setuptools import setup, find_packages
 import pathlib
+import os
 
 here = pathlib.Path(__file__).parent.resolve()
 long_description = (here / "README.md").read_text(encoding="utf-8")
-version = (here / "VERSION").read_text().strip()
+base_version = (here / "VERSION").read_text().strip()
+suffix = os.getenv("VERSION_SUFFIX", "")
+version = f"{base_version}{suffix}"