Dependency Installer

.github/workflows/commit_version_tag.yml

@@ -0,0 +1,46 @@
+name: Commit Version Tag
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+      - feat/*
+      - fix/*
+
+jobs:
+  test-build:
+    uses: ./.github/workflows/test_build.yml
+    with:
+      branch: ${{ github.ref_name }}
+    permissions:
+      contents: write
+
+  commit-version-tag:
+    needs: test-build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Download VERSION files
+      uses: actions/download-artifact@v4
+      with:
+        name: version-files
+
+    - name: Commit updated VERSION files
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git add VERSION VERSION.meta
+        git diff --staged --quiet || git commit -m "Update VERSION files in \`${{ github.ref_name }}\` to ${{ needs.test-build.outputs.version }}"
+        git push
+
+    - name: Create lightweight tag
+      run: |
+        git tag -a "${{ needs.test-build.outputs.version }}" -m "Release ${{ needs.test-build.outputs.version }}"
+        git push origin "${{ needs.test-build.outputs.version }}"

.github/workflows/tag-cleanup.yml

@@ -0,0 +1,50 @@
+name: Tag Cleanup
+
+on:
+  # We will run this workflow only manually to check behaviors for a while.
+  # Later we will enable it to run on a schedule that is yet to be determined (below weekly is only an example).
+  #schedule:
+    # Run weekly on Sundays at 2:00 AM UTC
+    #- cron: '0 2 * * 0'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run (show what would be deleted without actually deleting)'
+        required: false
+        default: 'true'
+        type: choice
+        options:
+          - 'true'
+          - 'false'
+
+env:
+  PYTHON_VERSION: '3.12'
+
+jobs:
+  cleanup-tags:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Run tag cleanup
+      run: |
+        DRY_RUN="${{ github.event.inputs.dry_run || 'true' }}"
+        python scripts/tag_cleanup.py "$DRY_RUN"
+
+    - name: Summary
+      run: |
+        if [ "${{ github.event.inputs.dry_run || 'true' }}" = "true" ]; then
+          echo "Tag cleanup completed in dry-run mode. No tags were actually deleted."
+        else
+          echo "Tag cleanup completed. Old build and dev tags have been removed."
+        fi

.github/workflows/tag-release.yml

@@ -0,0 +1,45 @@
+name: Tagged Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+      - 'v[0-9]+.[0-9]+.[0-9]+.dev[0-9]+'
+
+jobs:
+  releasing:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create Pre-Release
+        if: ${{ contains(github.ref_name, '.dev') }}
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: Pre-Release ${{ github.ref_name }}
+          body: |
+              Pre-release ${{ github.ref_name }}
+
+              ## Changes
+              - See commit history for detailed changes
+
+              ⚠️ **This is a pre-release version**
+
+          draft: false
+          prerelease: true
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create Release
+        if: ${{ !contains(github.ref_name, '.dev') }}
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: Release ${{ github.ref_name }}
+          body: |
+              Release ${{ github.ref_name }}
+
+              ## Changes
+              - See commit history for detailed changes
+
+          draft: false
+          prerelease: false
+          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test_build.yml

@@ -0,0 +1,72 @@
+name: Update VERSION and test build
+
+on:
+  workflow_call:
+    inputs:
+      python-version:
+        required: false
+        type: string
+        default: '3.12'
+      branch:
+        required: false
+        type: string
+        default: 'main'
+    outputs:
+      version:
+        description: The version of the package built
+        value: ${{ jobs.test-build.outputs.version }}
+
+jobs:
+  test-build:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version-extract.outputs.version }}
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Update VERSION file for branch
+        run: |
+            echo "Updating VERSION file for branch: ${{ inputs.branch }}"
+            python versioning/version_manager.py --update-for-branch ${{ inputs.branch }}
+
+      - name: Get version info
+        id: version-extract
+        run: |
+            VERSION=$(python versioning/version_manager.py --get)
+            echo "version=$VERSION" >> $GITHUB_OUTPUT
+            echo "Updated to version: $VERSION"
+
+      - name: Prepare version for build
+        run: |
+          python versioning/prepare_version.py
+
+      - name: Build package
+        run: |
+          python -m build
+
+      - name: Test package installation
+        run: |
+          pip install dist/*.whl
+
+      - name: Upload VERSION files
+        uses: actions/upload-artifact@v4
+        with:
+          name: version-files
+          path: |
+            VERSION
+            VERSION.meta

VERSION

@@ -0,0 +1 @@
+0.4.0.dev1

VERSION.meta

@@ -0,0 +1,10 @@
+# Structured version file for human readability and CI/CD
+# This file maintains detailed version component information
+# The companion VERSION file contains the simple format for setuptools
+
+MAJOR=0
+MINOR=4
+PATCH=0
+DEV_NUMBER=1
+BUILD_NUMBER=
+BRANCH=dev