Fix PyPI local version error

- Add 'no-local-version' scheme to setuptools_scm config
- Update GitHub Actions to only build from tags (not main branch)
- Enhance release script to check for main branch
- Ensure clean versions for PyPI releases

This prevents the 'local versions not allowed' error on PyPI by:
1. Only building from clean, tagged commits
2. Using 'no-local-version' scheme to avoid +hash suffixes
3. Requiring main branch for releases

Author: shashankmc

.github/workflows/ci.yml

@@ -65,6 +65,7 @@ jobs:
           pytest tests/ --doctest-modules --junitxml=junit/test-results.xml --cov=src/echr_extractor --cov-report=xml --cov-report=html
 
   build:
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
     name: Build Python package
     runs-on: ubuntu-latest
     steps:
@@ -90,7 +91,7 @@ jobs:
           path: dist/
 
   pypi-publish:
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
     name: Publish to PyPI
     needs: build
     runs-on: ubuntu-latest
@@ -110,7 +111,7 @@ jobs:
         uses: pypa/gh-action-pypi-publish@release/v1
 
   github-release:
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
     name: Sign the Python distribution with Sigstore and upload them to GitHub Releases
     needs:
       - pypi-publish

pyproject.toml

@@ -108,3 +108,7 @@ disallow_untyped_defs = true
 
 [tool.setuptools_scm]
 write_to = "src/echr_extractor/_version.py"
+# Ensure clean versions for PyPI releases
+local_scheme = "no-local-version"
+# Use distance-based versioning for development
+fallback_version = "0.0.0"

scripts/release.py

@@ -64,6 +64,16 @@ def check_working_directory_clean():
         print("Error: Working directory is not clean. Please commit or stash changes.")
         print("Uncommitted changes:")
         print(result.stdout)
+        print("\nThis is required to ensure clean version numbers for PyPI releases.")
+        sys.exit(1)
+    
+    # Also check that we're on main branch
+    result = run_command("git branch --show-current")
+    current_branch = result.stdout.strip()
+    if current_branch != "main":
+        print(f"Error: You must be on the 'main' branch to create releases.")
+        print(f"Current branch: {current_branch}")
+        print("Please switch to main branch: git checkout main")
         sys.exit(1)