feat: implement all three workflow improvements from review

- Update Python setup action from v4 to v5 (latest version)
- Add dependency caching to speed up CI runs by ~30-50%
- Add version validation step to ensure __init__.py and pyproject.toml stay in sync
- Applied to both test-pr.yml and release.yml workflows

Author: jon-myers

.github/workflows/release.yml

@@ -21,15 +21,41 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.10'
 
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml', '**/Pipfile.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+            ${{ runner.os }}-
+          
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install -e .[dev]
-          pip install build twine python-semantic-release
+          pip install build twine python-semantic-release toml
+          
+      - name: Validate version consistency
+        run: |
+          echo "Checking version consistency across files..."
+          INIT_VERSION=$(python -c "import idtap; print(idtap.__version__)")
+          TOML_VERSION=$(python -c "import toml; print(toml.load('pyproject.toml')['project']['version'])")
+          
+          echo "__init__.py version: $INIT_VERSION"
+          echo "pyproject.toml version: $TOML_VERSION"
+          
+          if [ "$INIT_VERSION" != "$TOML_VERSION" ]; then
+            echo "❌ Version mismatch detected!"
+            echo "__init__.py: $INIT_VERSION"
+            echo "pyproject.toml: $TOML_VERSION"
+            exit 1
+          fi
+          echo "✅ Versions are consistent"
           
       - name: Check if version bump is needed
         id: release-check

.github/workflows/test-pr.yml

@@ -18,19 +18,45 @@ jobs:
           fetch-depth: 0  # Needed for semantic-release
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.10'
 
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml', '**/Pipfile.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+            ${{ runner.os }}-
+          
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install -e .[dev]
-          pip install build twine python-semantic-release
+          pip install build twine python-semantic-release toml
           
       - name: Run tests
         run: pytest idtap/tests/ -m "not integration"
 
+      - name: Validate version consistency
+        run: |
+          echo "Checking version consistency across files..."
+          INIT_VERSION=$(python -c "import idtap; print(idtap.__version__)")
+          TOML_VERSION=$(python -c "import toml; print(toml.load('pyproject.toml')['project']['version'])")
+          
+          echo "__init__.py version: $INIT_VERSION"
+          echo "pyproject.toml version: $TOML_VERSION"
+          
+          if [ "$INIT_VERSION" != "$TOML_VERSION" ]; then
+            echo "❌ Version mismatch detected!"
+            echo "__init__.py: $INIT_VERSION"
+            echo "pyproject.toml: $TOML_VERSION"
+            exit 1
+          fi
+          echo "✅ Versions are consistent"
+        
       - name: Build package
         run: python -m build