Release PR for 2025-12-06 00:49

.github/workflows/auto-pr-description.yml

@@ -0,0 +1,45 @@
+name: Force Release PR
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+    branches:
+      - release
+
+jobs:
+  force-release-pr:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    if: github.event.pull_request.head.ref == 'main'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Generate PR description
+        id: gen
+        uses: tanmay-pathak/generate-pull-request-description@v1.0.0
+        with:
+          pull_request_url: ${{ github.event.pull_request.url }}
+          api_token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Force overwrite PR title and body
+        uses: actions/github-script@v7
+        env:
+          PR_BODY: ${{ steps.gen.outputs.pull_request_description }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const now = new Date().toISOString().slice(0,16).replace('T',' ');
+            const body = process.env.PR_BODY;
+            await github.rest.pulls.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number,
+              title: `Release PR for ${now}`,
+              body: body
+            });

.github/workflows/lint_and_test.yaml

@@ -20,7 +20,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
           cache-suffix: ${{ matrix.python-version }}

.github/workflows/publish-stable.yaml

@@ -0,0 +1,52 @@
+---
+name: Publish to PyPI (stable)
+
+"on":
+  push:
+    tags:
+      # Publish final release tags (without -rc suffix).
+      - "v[0-9]+.[0-9]+.[0-9]+"
+
+jobs:
+  publish:
+    name: "Publish to PyPI"
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Verify version matches tag
+        run: |
+          TAG_NAME="${GITHUB_REF#refs/tags/}"
+          # Remove 'v' prefix from tag (v1.2.3 -> 1.2.3)
+          EXPECTED_VERSION=$(echo "$TAG_NAME" | sed 's/^v//')
+          # Extract version from pyproject.toml using tomli (compatible with Python 3.7+)
+          uv pip install tomli
+          ACTUAL_VERSION=$(uv run python -c "import tomli; f=open('pyproject.toml','rb'); data=tomli.load(f); print(data['project']['version'])")
+          if [ "$EXPECTED_VERSION" != "$ACTUAL_VERSION" ]; then
+            echo "Error: Version mismatch!"
+            echo "Tag: $TAG_NAME"
+            echo "Expected version in pyproject.toml: $EXPECTED_VERSION"
+            echo "Actual version in pyproject.toml: $ACTUAL_VERSION"
+            exit 1
+          fi
+          echo "Version verification passed: $ACTUAL_VERSION"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

.github/workflows/publish.yaml

@@ -0,0 +1,53 @@
+---
+name: Publish Release Candidate to Test PyPI
+
+"on":
+  push:
+    tags:
+      # Publish release candidate tags.
+      - "v[0-9]+.[0-9]+.[0-9]+-rc.[0-9]+"
+
+jobs:
+  publish-rc:
+    name: "Publish RC to Test PyPI"
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Verify version matches tag
+        run: |
+          TAG_NAME="${GITHUB_REF#refs/tags/}"
+          # Convert SemVer tag format (v1.2.3-rc.1) to PEP 440 format (1.2.3rc1)
+          EXPECTED_VERSION=$(echo "$TAG_NAME" | sed 's/^v//' | sed 's/-rc\./rc/')
+          # Extract version from pyproject.toml using tomli (compatible with Python 3.7+)
+          uv pip install tomli
+          ACTUAL_VERSION=$(uv run python -c "import tomli; f=open('pyproject.toml','rb'); data=tomli.load(f); print(data['project']['version'])")
+          if [ "$EXPECTED_VERSION" != "$ACTUAL_VERSION" ]; then
+            echo "Error: Version mismatch!"
+            echo "Tag: $TAG_NAME"
+            echo "Expected version in pyproject.toml: $EXPECTED_VERSION"
+            echo "Actual version in pyproject.toml: $ACTUAL_VERSION"
+            exit 1
+          fi
+          echo "Version verification passed: $ACTUAL_VERSION"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          repository-url: https://test.pypi.org/legacy/

.github/workflows/release-stable.yaml

@@ -0,0 +1,34 @@
+---
+name: Release (stable)
+
+"on":
+  push:
+    branches:
+      - release
+
+jobs:
+  release:
+    name: "Release"
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    concurrency:
+      group: semantic-release
+      cancel-in-progress: false
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.SEMANTIC_RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - name: Semantic release
+        run: |
+          docker run --rm \
+            --user 1001 \
+            -v ${{ github.workspace }}:/workspace \
+            -w /workspace \
+            -e GITHUB_TOKEN=${{ secrets.SEMANTIC_RELEASE_TOKEN || secrets.GITHUB_TOKEN }} \
+            -e CI=true \
+            ghcr.io/disafronov/semantic-release:latest

.releaserc.json

@@ -1,30 +1,36 @@
 {
-    "branches": ["main"],
+    "branches": [
+        "release",
+        {
+            "name": "main",
+            "prerelease": "rc"
+        }
+    ],
     "plugins": [
-      ["@semantic-release/commit-analyzer", {
-        "preset": "conventionalcommits",
-        "releaseRules": [
-          { "type": "feat", "release": "minor" },
-          { "type": "fix", "release": "patch" },
-          { "type": "perf", "release": "patch" },
-          { "type": "revert", "release": "patch" },
-          { "type": "refactor", "release": "patch" },
-          { "type": "docs", "release": false },
-          { "type": "style", "release": false },
-          { "type": "test", "release": false },
-          { "type": "build", "release": false },
-          { "type": "ci", "release": false },
-          { "type": "chore", "release": false }
-        ]
-      }],
-      ["@semantic-release/release-notes-generator", { "preset": "conventionalcommits" }],
-      ["@semantic-release/exec", {
-        "prepareCmd": "node -e \"const fs=require('fs'),toml=require('@iarna/toml');const f='pyproject.toml';const data=toml.parse(fs.readFileSync(f,'utf8'));data.project.version='${nextRelease.version}';fs.writeFileSync(f,toml.stringify(data))\""
-      }],
-      ["@semantic-release/git", {
-        "assets": ["pyproject.toml"],
-        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-      }],
-      ["@semantic-release/github", {}]
+        ["@semantic-release/commit-analyzer", {
+            "preset": "conventionalcommits",
+            "releaseRules": [
+            { "type": "feat", "release": "minor" },
+            { "type": "fix", "release": "patch" },
+            { "type": "perf", "release": "patch" },
+            { "type": "revert", "release": "patch" },
+            { "type": "refactor", "release": "patch" },
+            { "type": "docs", "release": false },
+            { "type": "style", "release": false },
+            { "type": "test", "release": false },
+            { "type": "build", "release": false },
+            { "type": "ci", "release": false },
+            { "type": "chore", "release": false }
+            ]
+        }],
+        ["@semantic-release/release-notes-generator", { "preset": "conventionalcommits" }],
+        ["@semantic-release/exec", {
+            "prepareCmd": "node -e \"const fs=require('fs'),toml=require('@iarna/toml');let version='${nextRelease.version}';version=version.replace(/-rc\\\\./g,'rc');const pyprojectFile='pyproject.toml';const pyprojectData=toml.parse(fs.readFileSync(pyprojectFile,'utf8'));const packageName=pyprojectData.project.name;pyprojectData.project.version=version;fs.writeFileSync(pyprojectFile,toml.stringify(pyprojectData));const uvLockFile='uv.lock';const uvLockData=toml.parse(fs.readFileSync(uvLockFile,'utf8'));const packageIndex=uvLockData.package.findIndex(p=>p.name===packageName);if(packageIndex!==-1){uvLockData.package[packageIndex].version=version;fs.writeFileSync(uvLockFile,toml.stringify(uvLockData));}\""
+        }],
+        ["@semantic-release/git", {
+            "assets": ["pyproject.toml", "uv.lock"],
+            "message": "chore(release): ${nextRelease.version}\n\n${nextRelease.notes}"
+        }],
+        ["@semantic-release/github", {}]
     ]
 }

README.md

@@ -144,6 +144,13 @@ except SchemaValidationError as e:
         print(f"  - {problem.message}")
     # Decide whether to abort or continue with default logger
     raise
+except (OSError, ValueError, RuntimeError) as e:
+    # System-level errors (e.g., inaccessible working directory when os.getcwd()
+    # fails, lock failures, path resolution issues) are raised directly, not
+    # wrapped in SchemaValidationError. Note: OSError when reading the schema
+    # file is converted to SchemaValidationError and handled above.
+    print(f"System error during logger initialization: {e}")
+    raise
 
 # When logging, handle DataValidationError
 try:
@@ -323,6 +330,21 @@ consistent type expectations when reusing a `source` field.
 The application decides whether `SchemaValidationError` is a fatal error that
 should abort startup, or whether it should be logged and ignored.
 
+**Note**: In rare cases, system-level errors may be raised directly instead of
+being wrapped in `SchemaValidationError`. Specifically:
+
+- `OSError` when the current working directory is inaccessible or deleted (e.g.,
+  when `os.getcwd()` fails) is propagated as-is to indicate environmental issues.
+  However, `OSError` that occurs when reading the schema file (e.g., permission
+  denied, I/O errors) is converted to `SchemaValidationError` and reported as a
+  schema problem.
+- `ValueError` when path resolution fails due to invalid characters or malformed
+  paths during schema file discovery is propagated as-is.
+- `RuntimeError` when thread lock acquisition fails is propagated as-is.
+
+Applications should handle these exceptions separately if they need to
+distinguish between schema validation failures and system-level errors.
+
 ## Schema caching and thread safety
 
 - The library caches compiled schemas to avoid recompiling the same schema file