fix: implement complete git-tag-based versioning system (#21)

fix: implement complete git-tag-based versioning system

- Remove version dependency from pyproject.toml configuration
- Configure commitizen to use SCM (git tags) as version provider
- Update GitHub Actions workflow to create only git tags, no file modifications
- Implement dynamic version detection from git tags in package code
- Streamline changelog generation using unreleased-version parameter
- Ensure complete git-tag-driven version management without manual updates

Resolves version calculation issues and enables fully automated releases
Based on git tags as single source of truth for version management

Author: yfge

.github/workflows/release.yml

@@ -65,27 +65,25 @@ jobs:
       - name: Bump version automatically
         id: bump-version
         run: |
-          # Check if we need to bump version based on conventional commits
+          # Git-tag-based versioning: Version is determined entirely by git tags
+          # No pyproject.toml version updates needed - everything is tag-driven
           if cz bump --dry-run 2>/dev/null; then
             echo "bump_needed=true" >> $GITHUB_OUTPUT
 
-            # Get the new version that would be created
+            # Get the new version that commitizen would create based on conventional commits
             NEW_VERSION=$(cz bump --dry-run | grep "bump: version" | sed 's/.*→ //')
             echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
 
-            # Update only the commitizen version configuration before bumping
-            sed -i.bak "/^\[tool\.commitizen\]/,/^\[/ s/^version = \"[^\"]*\"/version = \"$NEW_VERSION\"/" pyproject.toml
-            rm -f pyproject.toml.bak
-
-            # Now run cz bump which will create a single commit with all changes
-            cz bump --yes
-
-            # Generate changelog content for release (without creating file)
-            CHANGELOG_CONTENT=$(cz changelog --dry-run)
+            # Generate changelog content from last tag to current commits
+            CHANGELOG_CONTENT=$(cz changelog --unreleased-version=$NEW_VERSION --dry-run)
             echo "changelog_content<<EOF" >> $GITHUB_OUTPUT
             echo "$CHANGELOG_CONTENT" >> $GITHUB_OUTPUT
             echo "EOF" >> $GITHUB_OUTPUT
 
+            # Create ONLY git tag - no file modifications needed
+            # All version info comes from git tags via dynamic version detection
+            cz bump --yes
+
             # Push based on branch protection status
             if [ "${{ steps.branch-protection.outputs.can_push_directly }}" = "true" ]; then
               echo "Pushing directly to main branch..."

markdown_flow/__init__.py

@@ -81,5 +81,35 @@
     "replace_variables_in_text",
 ]
 
-# Version information
-__version__ = "0.2.0"
+
+# Version information - dynamically retrieved from git tags
+def _get_version():
+    """Get version from git tags or package metadata."""
+    try:
+        # First try to get from git tags (for development)
+        import subprocess
+
+        result = subprocess.run(
+            ["git", "describe", "--tags", "--abbrev=0"],
+            capture_output=True,
+            text=True,
+            cwd=__file__.rsplit("/", 2)[0],  # Go to project root
+        )
+        if result.returncode == 0:
+            return result.stdout.strip().lstrip("v")
+    except Exception:
+        pass
+
+    try:
+        # Fallback to package metadata (for installed packages)
+        from importlib.metadata import version
+
+        return version("markdown-flow")
+    except Exception:
+        pass
+
+    # Final fallback
+    return "0.0.0-dev"
+
+
+__version__ = _get_version()

pyproject.toml

@@ -144,15 +144,13 @@ disallow_incomplete_defs = false
 # =============================================================================
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.3.0"
 tag_format = "v$major.$minor.$patch"
 update_changelog_on_bump = true
 annotated_tag = true
 gpg_sign = false
-version_files = [
-    "markdown_flow/__init__.py:__version__"
-]
+# Version is completely determined by git tags - no version_files needed
 bump_message = "bump: version $current_version → $new_version"
+version_provider = "scm"
 style = [
     ["qmark", "fg:#ff9d00 bold"],
     ["question", "bold"],