feat: integrate abstract-validation-base library

- Add abstract-validation-base as dependency for validation infrastructure
- Replace local validation classes with library imports (BaseValidator, CompositeValidator, ValidatorProtocol, ValidationResult, ProcessLog, ProcessEntry)
- Delete redundant local files: core/validation/*.py, core/process_log.py, core/results.py
- Add new composable validators: Zip5FormatValidator, Zip4FormatValidator
- Update create_default_validators to use ValidatorPipelineBuilder
- Update Python requirement to >=3.12.8 (required by abstract-validation-base)
- Update all workflows to Python 3.12, tests run on 3.12/3.13 only
- Add version-check.yml workflow for automatic tag creation
- Update release.yml with version bump support (patch/minor/major/alpha/beta/rc)
- Simplify Codecov integration to match abstract-validation-base pattern
- Fix ruff linting issues (use Python 3.12+ type parameter syntax)

Author: github-actions

.github/workflows/lint.yml

@@ -24,7 +24,7 @@ jobs:
           cache-dependency-glob: "pyproject.toml"
 
       - name: Set up Python
-        run: uv python install 3.9
+        run: uv python install 3.12
 
       - name: Install dependencies
         run: uv sync --group dev

.github/workflows/release.yml

@@ -1,46 +1,105 @@
 name: Release
 
 on:
-  push:
-    tags:
-      - "v*"
   workflow_dispatch:
+    inputs:
+      bump:
+        description: 'Version bump type'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+          - alpha
+          - beta
+          - rc
+      prerelease:
+        description: 'Mark as pre-release'
+        required: false
+        default: false
+        type: boolean
 
 permissions:
   contents: write
-  packages: write
 
 jobs:
   release:
-    name: Create Release
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Install uv
         uses: astral-sh/setup-uv@v4
         with:
           version: "latest"
-          enable-cache: true
-          cache-dependency-glob: "pyproject.toml"
 
       - name: Set up Python
-        run: uv python install 3.9
+        run: uv python install 3.12
 
-      - name: Install dependencies
-        run: uv sync --group dev
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
 
-      - name: Run tests
-        run: uv run pytest tests/ -v --tb=short
+      - name: Bump version with uv
+        id: bump
+        run: |
+          BUMP_TYPE="${{ inputs.bump }}"
 
-      - name: Build distribution packages
-        run: uv pip install build && uv run python -m build
+          # For alpha/beta/rc, we need to bump minor first if not already a prerelease
+          if [[ "$BUMP_TYPE" =~ ^(alpha|beta|rc)$ ]]; then
+            CURRENT_VERSION=$(uv version --short)
+            if [[ ! "$CURRENT_VERSION" =~ (a|b|rc)[0-9]+ ]]; then
+              # Not a prerelease, bump minor first
+              uv version --bump minor
+            fi
+            uv version --bump "$BUMP_TYPE"
+          else
+            uv version --bump "$BUMP_TYPE"
+          fi
 
-      - name: Publish GitHub release from tag
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # Get the new version
+          NEW_VERSION=$(uv version --short)
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "New version: $NEW_VERSION"
+
+          # Check if it's a prerelease version
+          if [[ "$NEW_VERSION" =~ (a|b|rc)[0-9]+ ]]; then
+            echo "is_prerelease=true" >> $GITHUB_OUTPUT
+          else
+            echo "is_prerelease=${{ inputs.prerelease }}" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Sync version to __init__.py
+        run: |
+          VERSION="${{ steps.bump.outputs.new_version }}"
+          sed -i "s/__version__ = \".*\"/__version__ = \"$VERSION\"/" src/ryandata_address_utils/__init__.py
+          echo "Updated __init__.py to version $VERSION"
+          cat src/ryandata_address_utils/__init__.py | grep __version__
+
+      - name: Commit version bump
+        run: |
+          VERSION="${{ steps.bump.outputs.new_version }}"
+          git add pyproject.toml uv.lock src/ryandata_address_utils/__init__.py
+          git commit -m "chore: bump version to $VERSION"
+
+      - name: Create and push tag
         run: |
-          TAG_NAME="${GITHUB_REF##*/}"
-          gh release create "$TAG_NAME" dist/*.whl dist/*.tar.gz --generate-notes --latest --verify-tag
+          VERSION="${{ steps.bump.outputs.new_version }}"
+          git tag -a "v$VERSION" -m "Release v$VERSION"
+          git push origin main --follow-tags
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.bump.outputs.new_version }}
+          name: Release v${{ steps.bump.outputs.new_version }}
+          generate_release_notes: true
+          prerelease: ${{ steps.bump.outputs.is_prerelease == 'true' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/tests.yml

@@ -2,32 +2,30 @@ name: Tests
 
 on:
   push:
-    branches: [main]
+    branches: [main, master]
   pull_request:
-    branches: [main]
-
-permissions:
-  contents: read
-  pull-requests: write
+    branches: [main, master]
 
 jobs:
   test:
-    name: Pytest - Python ${{ matrix.python-version }}
+    name: Run tests - Python ${{ matrix.python-version }}
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.12", "3.13"]
+
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
 
       - name: Install uv
         uses: astral-sh/setup-uv@v4
         with:
           version: "latest"
-          enable-cache: true
-          cache-dependency-glob: "pyproject.toml"
 
-      - name: Set up Python
+      - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
 
       - name: Cache libpostal
@@ -52,26 +50,22 @@ jobs:
 
       - name: Setup libpostal environment
         run: |
-          # Export paths so subsequent steps can find libpostal
           echo "LIBPOSTAL_DATA_DIR=$HOME/.local/share/libpostal" >> "$GITHUB_ENV"
           echo "LD_LIBRARY_PATH=$HOME/.local/lib:${LD_LIBRARY_PATH:-}" >> "$GITHUB_ENV"
           echo "PKG_CONFIG_PATH=$HOME/.local/lib/pkgconfig:${PKG_CONFIG_PATH:-}" >> "$GITHUB_ENV"
           echo "CPATH=$HOME/.local/include:${CPATH:-}" >> "$GITHUB_ENV"
 
       - name: Install dependencies
-        run: uv sync --group dev --all-extras
+        run: uv sync --all-extras --dev
 
-      - name: Run tests
-        run: uv run pytest tests/ --cov --junitxml=junit.xml -o junit_family=legacy --cov=src/ryandata_address_utils --cov-report=xml --cov-report=term
+      - name: Test with pytest
+        run: |
+          uv run pytest --cov --cov-report=xml --junitxml=junit.xml
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v5
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-          file: ./coverage.xml
-          flags: unittests
-          name: codecov-umbrella
-          fail_ci_if_error: false
 
       - name: Upload test results to Codecov
         if: ${{ !cancelled() }}

.github/workflows/typecheck.yml

@@ -24,7 +24,7 @@ jobs:
           cache-dependency-glob: "pyproject.toml"
 
       - name: Set up Python
-        run: uv python install 3.9
+        run: uv python install 3.12
 
       - name: Install dependencies
         run: uv sync --group dev