sqlmodel-ext 0.5.2__tar.gz → 0.5.4__tar.gz

{sqlmodel_ext-0.5.2 → sqlmodel_ext-0.5.4}/.github/workflows/ci.yml

@@ -1,146 +1,148 @@
-name: CI
-
-on:
-  push:
-    branches: [master]
-  pull_request:
-    branches: [master]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ci-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  # -------------------------------------------------------------------
-  # Job 1: source-tree tests across supported Python versions.
-  # Uses uv sync so the lockfile is honoured and runs are reproducible.
-  # -------------------------------------------------------------------
-  test:
-    name: test (py${{ matrix.python-version }})
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.12", "3.13", "3.14"]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-        with:
-          enable-cache: true
-          cache-dependency-glob: "uv.lock"
-
-      - name: Set up Python ${{ matrix.python-version }}
-        run: uv python install ${{ matrix.python-version }}
-
-      - name: Create venv and install project with dev extras
-        # Dev extras: pytest, pytest-asyncio, aiosqlite, ruff. Editable install
-        # keeps the wheel build separate for the consumer-integration job.
-        run: |
-          uv venv --python ${{ matrix.python-version }} .venv
-          uv pip install --python .venv/bin/python -e ".[dev]"
-
-      - name: Run pytest
-        run: .venv/bin/python -m pytest tests/ -v
-
-  # -------------------------------------------------------------------
-  # Job 1b: static type check. basedpyright reads pyrightconfig.json from
-  # the repository root (src only, pythonVersion 3.12 = lowest supported).
-  # The gate is 0 errors and 0 warnings: pyrightconfig.json sets failOnWarnings,
-  # so any warning makes basedpyright exit non-zero and fails the job.
-  # The alembic extra is installed so the optional-import module
-  # `mixins/migration_cache_invalidation.py` resolves its imports.
-  # "0 errors" is also what an empty scan prints, so the job additionally
-  # fails when the verbose log does not report a non-zero source-file count.
-  # -------------------------------------------------------------------
-  typecheck:
-    name: basedpyright (py3.12)
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-        with:
-          enable-cache: true
-          cache-dependency-glob: "uv.lock"
-
-      - name: Set up Python 3.12
-        run: uv python install 3.12
-
-      - name: Create venv and install project with dev extras
-        run: |
-          uv venv --python 3.12 .venv
-          uv pip install --python .venv/bin/python -e ".[dev,alembic]"
-
-      - name: Run basedpyright
-        # Activate the venv so basedpyright resolves imports against it.
-        run: |
-          source .venv/bin/activate
-          status=0
-          basedpyright --verbose > basedpyright.log 2>&1 || status=$?
-          grep -E " - (error|warning)" basedpyright.log || true
-          grep -E "^[0-9]+ errors?, [0-9]+ warnings?" basedpyright.log
-          grep -E "^Found [0-9]+ source files" basedpyright.log
-          if ! grep -qE "^Found [1-9][0-9]* source files" basedpyright.log; then
-            echo "::error::basedpyright scanned no source files (check pyrightconfig.json include/exclude)"
-            exit 1
-          fi
-          exit $status
-
-  # -------------------------------------------------------------------
-  # Job 2: build wheel + sdist, then install the wheel into a clean
-  # virtualenv with zero dev deps and run the consumer integration
-  # script. This simulates an external PyPI consumer.
-  # -------------------------------------------------------------------
-  consumer-integration:
-    name: consumer integration (py${{ matrix.python-version }})
-    runs-on: ubuntu-latest
-    needs: test
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.12", "3.13", "3.14"]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-        with:
-          enable-cache: true
-
-      - name: Set up Python ${{ matrix.python-version }}
-        run: uv python install ${{ matrix.python-version }}
-
-      - name: Build wheel and sdist
-        run: uv tool run --from build python -m build
-
-      - name: Create isolated consumer venv
-        run: uv venv --python ${{ matrix.python-version }} /tmp/consumer-env
-
-      - name: Install built wheel (no dev deps, only the wheel + aiosqlite driver)
-        run: uv pip install --python /tmp/consumer-env/bin/python dist/*.whl aiosqlite
-
-      - name: Confirm installed version matches wheel
-        run: |
-          /tmp/consumer-env/bin/python -c "import sqlmodel_ext; print('installed:', sqlmodel_ext.__version__ if hasattr(sqlmodel_ext, '__version__') else '(no __version__)')"
-
-      - name: Run consumer integration scenario
-        run: /tmp/consumer-env/bin/python examples/consumer_integration/run.py
-
-      - name: Upload distribution artifacts
-        if: matrix.python-version == '3.12'
-        uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: dist/
-          if-no-files-found: error
-          retention-days: 14
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+  # Called by release.yml so a tag is published only after the same checks pass.
+  workflow_call:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # -------------------------------------------------------------------
+  # Job 1: source-tree tests across supported Python versions.
+  # Uses uv sync so the lockfile is honoured and runs are reproducible.
+  # -------------------------------------------------------------------
+  test:
+    name: test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Create venv and install project with dev extras
+        # Dev extras: pytest, pytest-asyncio, aiosqlite, ruff. Editable install
+        # keeps the wheel build separate for the consumer-integration job.
+        run: |
+          uv venv --python ${{ matrix.python-version }} .venv
+          uv pip install --python .venv/bin/python -e ".[dev]"
+
+      - name: Run pytest
+        run: .venv/bin/python -m pytest tests/ -v
+
+  # -------------------------------------------------------------------
+  # Job 1b: static type check. basedpyright reads pyrightconfig.json from
+  # the repository root (src only, pythonVersion 3.12 = lowest supported).
+  # The gate is 0 errors and 0 warnings: pyrightconfig.json sets failOnWarnings,
+  # so any warning makes basedpyright exit non-zero and fails the job.
+  # The alembic extra is installed so the optional-import module
+  # `mixins/migration_cache_invalidation.py` resolves its imports.
+  # "0 errors" is also what an empty scan prints, so the job additionally
+  # fails when the verbose log does not report a non-zero source-file count.
+  # -------------------------------------------------------------------
+  typecheck:
+    name: basedpyright (py3.12)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Create venv and install project with dev extras
+        run: |
+          uv venv --python 3.12 .venv
+          uv pip install --python .venv/bin/python -e ".[dev,alembic]"
+
+      - name: Run basedpyright
+        # Activate the venv so basedpyright resolves imports against it.
+        run: |
+          source .venv/bin/activate
+          status=0
+          basedpyright --verbose > basedpyright.log 2>&1 || status=$?
+          grep -E " - (error|warning)" basedpyright.log || true
+          grep -E "^[0-9]+ errors?, [0-9]+ warnings?" basedpyright.log
+          grep -E "^Found [0-9]+ source files" basedpyright.log
+          if ! grep -qE "^Found [1-9][0-9]* source files" basedpyright.log; then
+            echo "::error::basedpyright scanned no source files (check pyrightconfig.json include/exclude)"
+            exit 1
+          fi
+          exit $status
+
+  # -------------------------------------------------------------------
+  # Job 2: build wheel + sdist, then install the wheel into a clean
+  # virtualenv with zero dev deps and run the consumer integration
+  # script. This simulates an external PyPI consumer.
+  # -------------------------------------------------------------------
+  consumer-integration:
+    name: consumer integration (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    needs: test
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Build wheel and sdist
+        run: uv tool run --from build python -m build
+
+      - name: Create isolated consumer venv
+        run: uv venv --python ${{ matrix.python-version }} /tmp/consumer-env
+
+      - name: Install built wheel (no dev deps, only the wheel + aiosqlite driver)
+        run: uv pip install --python /tmp/consumer-env/bin/python dist/*.whl aiosqlite
+
+      - name: Confirm installed version matches wheel
+        run: |
+          /tmp/consumer-env/bin/python -c "import sqlmodel_ext; print('installed:', sqlmodel_ext.__version__ if hasattr(sqlmodel_ext, '__version__') else '(no __version__)')"
+
+      - name: Run consumer integration scenario
+        run: /tmp/consumer-env/bin/python examples/consumer_integration/run.py
+
+      - name: Upload distribution artifacts
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+          retention-days: 14

sqlmodel_ext-0.5.4/.github/workflows/release.yml

@@ -0,0 +1,90 @@
+name: Release
+
+# Publishes to PyPI when a version tag (v1.2.3) is pushed.
+#
+# Authentication is PyPI Trusted Publishing (OIDC): no API token is stored in this
+# repository. The PyPI project must list this workflow as a trusted publisher
+# (owner Foxerine, repository sqlmodel-ext, workflow release.yml, environment pypi).
+#
+# Release steps:
+#   1. Bump `version` in pyproject.toml and `__version__` in src/sqlmodel_ext/__init__.py,
+#      and turn the CHANGELOG "[Unreleased]" heading into the new version.
+#   2. Commit to master, then: git tag -a vX.Y.Z -m "sqlmodel-ext X.Y.Z" && git push origin vX.Y.Z
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  # The full CI suite (tests on all supported Pythons, basedpyright, consumer
+  # integration) must pass on the tagged commit before anything is published.
+  ci:
+    uses: ./.github/workflows/ci.yml
+
+  # The tag, pyproject.toml and __version__ must name the same version; a mismatch
+  # would publish a package whose metadata disagrees with the tag.
+  verify-version:
+    name: verify tag matches package version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Compare tag, pyproject.toml and __version__
+        run: |
+          python3 - <<'PY'
+          import os, re, sys, tomllib
+          tag = os.environ["GITHUB_REF_NAME"].removeprefix("v")
+          with open("pyproject.toml", "rb") as f:
+              project = tomllib.load(f)["project"]["version"]
+          init = open("src/sqlmodel_ext/__init__.py", encoding="utf-8").read()
+          match = re.search(r'^__version__ = "([^"]+)"', init, re.M)
+          module = match.group(1) if match else None
+          print(f"tag={tag} pyproject={project} __version__={module}")
+          if not (tag == project == module):
+              print("::error::tag, pyproject.toml version and __version__ differ")
+              sys.exit(1)
+          PY
+
+  build:
+    name: build sdist and wheel
+    runs-on: ubuntu-latest
+    needs: [ci, verify-version]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/project/sqlmodel-ext/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

{sqlmodel_ext-0.5.2 → sqlmodel_ext-0.5.4}/.gitignore

@@ -1,36 +1,36 @@
-# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-
-# Distribution / packaging
-dist/
-build/
-*.egg-info/
-*.egg
-
-# Virtual environments
-.venv/
-venv/
-ENV/
-node_modules/
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Testing
-.pytest_cache/
-.coverage
-htmlcov/
-
-# VitePress
-docs/.vitepress/cache/
-docs/.vitepress/dist/
-
-# OS
-.DS_Store
-Thumbs.db
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+node_modules/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# VitePress
+docs/.vitepress/cache/
+docs/.vitepress/dist/
+
+# OS
+.DS_Store
+Thumbs.db