Release! PR for 2026-05-05 23:36

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

@@ -8,14 +8,20 @@ on:
       - reopened
     branches:
       - release
+      - main
 
 jobs:
   force-release-pr:
     runs-on: ubuntu-latest
     permissions:
       contents: read
       pull-requests: write
-    if: github.event.pull_request.head.ref == 'main'
+    if: >-
+      github.event_name == 'pull_request' &&
+      !contains(github.event.pull_request.labels.*.name, 'dependencies') && (
+        (github.event.pull_request.base.ref == 'release' && github.event.pull_request.head.ref == 'main') ||
+        (github.event.pull_request.base.ref == 'main' && github.event.pull_request.head.ref != 'release')
+      )
 
     steps:
       - uses: actions/checkout@v6
@@ -27,7 +33,7 @@ jobs:
           pull_request_url: ${{ github.event.pull_request.url }}
           api_token: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Force overwrite PR title and body
+      - name: Update PR description and title
         uses: actions/github-script@v9
         env:
           PR_BODY: ${{ steps.gen.outputs.pull_request_description }}
@@ -36,10 +42,22 @@ jobs:
           script: |
             const now = new Date().toISOString().slice(0,16).replace('T',' ');
             const body = process.env.PR_BODY;
-            await github.rest.pulls.update({
+            const base = context.payload.pull_request.base.ref;
+            const head = context.payload.pull_request.head.ref;
+            const update = {
               owner: context.repo.owner,
               repo: context.repo.repo,
               pull_number: context.payload.pull_request.number,
-              title: `Release PR for ${now}`,
-              body: body
-            });
+              body,
+            };
+
+            // Branch roles come from `.releaserc.cjs`:
+            // - base `release`: stable releases
+            // - base `main`: prereleases ("rc")
+            if (base === 'release') {
+              update.title = `Release! PR for ${now}`;
+            } else if (base === 'main') {
+              update.title = `PR for ${now}`;
+            }
+
+            await github.rest.pulls.update(update);

.github/workflows/lint_and_test.yaml

@@ -15,7 +15,7 @@ jobs:
       contents: read
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
     steps:
       - name: Checkout
         uses: actions/checkout@v6

.github/workflows/semantic.yaml

@@ -5,6 +5,7 @@ name: Semantic
   pull_request:
     branches:
       - main
+      - release
   push:
     branches:
       - main

.markdownlintignore

@@ -0,0 +1 @@
+CHANGELOG.md

.pre-commit-config.yaml

@@ -30,6 +30,12 @@ repos:
         args: [--allow-multiple-documents]
       - id: check-toml
         stages: [pre-commit]
+      - id: check-case-conflict
+        stages: [pre-commit]
+      - id: name-tests-test
+        stages: [pre-commit]
+        args: [--pytest-test-first]
+        exclude: ^(.*/)?tests/helpers\.py$
 
   - repo: https://github.com/igorshubovych/markdownlint-cli
     rev: v0.46.0
@@ -46,13 +52,6 @@ repos:
 
   - repo: local
     hooks:
-      - id: make-format
-        name: make format (pre-commit)
-        stages: [pre-commit]
-        language: system
-        entry: make format
-        pass_filenames: false
-
       - id: make-lint
         name: make lint (pre-commit)
         stages: [pre-commit]

.releaserc.cjs

@@ -10,6 +10,7 @@ module.exports = {
         ["@semantic-release/commit-analyzer", {
             "preset": "conventionalcommits",
             "releaseRules": [
+                { "breaking": true, "release": "major" },
                 { "type": "feat", "release": "minor" },
                 { "type": "fix", "release": "patch" },
                 { "type": "perf", "release": "patch" },

CHANGELOG.md

@@ -1,3 +1,23 @@
+## [1.0.0-rc.1](https://github.com/disafronov/python-logging-objects-with-schema/compare/v0.4.2-rc.2...v1.0.0-rc.1) (2026-05-05)
+
+### ⚠ BREAKING CHANGES
+
+* first stable release, no longer considered experimental
+
+Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
+
+### Features
+
+* promote to stable 1.0.0 ([1fdd2ec](https://github.com/disafronov/python-logging-objects-with-schema/commit/1fdd2ec40dad460c0bddcf65c6961ef5357c878a))
+
+## [0.4.2-rc.2](https://github.com/disafronov/python-logging-objects-with-schema/compare/v0.4.2-rc.1...v0.4.2-rc.2) (2026-05-05)
+
+### Bug Fixes
+
+* enforce non-empty strings for type and source fields ([21ba61d](https://github.com/disafronov/python-logging-objects-with-schema/commit/21ba61dfc7ca32de848c85f42ad39450f4bbb3cc))
+
+## [0.4.2-rc.1](https://github.com/disafronov/python-logging-objects-with-schema/compare/v0.4.1...v0.4.2-rc.1) (2026-05-05)
+
 ## [0.4.1](https://github.com/disafronov/python-logging-objects-with-schema/compare/v0.4.0...v0.4.1) (2026-04-28)
 
 ## [0.4.1-rc.1](https://github.com/disafronov/python-logging-objects-with-schema/compare/v0.4.0...v0.4.1-rc.1) (2026-04-28)

Makefile

@@ -1,3 +1,6 @@
+# Python version is pinned via `.python-version` (used by uv and CI).
+PYTHON_VERSION := $(shell tr -d '[:space:]' < .python-version)
+
 # Variables
 PYTEST_CMD = uv run python -m pytest -v
 COVERAGE_OPTS = --cov --cov-report=term-missing --cov-report=html
@@ -15,7 +18,8 @@ help: ## Show this help message
 # Development
 install: ## Install dependencies
 	@echo "Installing dependencies..."
-	uv sync
+	uv python install $(PYTHON_VERSION)
+	uv sync --python $(PYTHON_VERSION)
 	@echo "Installing pre-commit hooks..."
 	uv run pre-commit install
 
@@ -33,16 +37,12 @@ dead-code: ## Check for dead code using vulture
 	uv run vulture
 
 # Testing
-test: ## Run tests
-	@echo "Running tests..."
-	$(PYTEST_CMD)
-
-test-coverage: ## Run tests with coverage
+test: ## Run tests with coverage
 	@echo "Running tests with coverage..."
 	$(PYTEST_CMD) $(COVERAGE_OPTS)
 
 # Combined operations
-all: format lint test dead-code ## Run format, lint, test, and dead-code check
+all: lint test dead-code ## Run lint, test, and dead-code check
 	@echo "All checks completed successfully!"
 
 # Maintenance

README.md

@@ -28,6 +28,9 @@ systems) can rely on a consistent log structure.
   problem.
 - Any mismatch between runtime values and the declared types (wrong types,
   `None` values, disallowed list elements) is also treated as a data error.
+  Type checks use `type()`, not `isinstance()`: `bool` is **not** accepted
+  where `int` is declared, and `int` is **not** accepted where `float` is
+  declared. There are no implicit type conversions.
 - All validation problems are aggregated and logged as a single ERROR message
   **after** the log record has been emitted, ensuring 100% compatibility with
   standard logger behavior (no exceptions are raised).
@@ -145,7 +148,9 @@ directory until it finds the file or reaches the filesystem root.
 **Important**: If there are any problems with the schema (missing file, broken
 JSON, invalid structure, etc.), the application is terminated after logging
 schema problems to stderr. Schema validation happens when the first logger
-instance is created.
+instance is created. Termination uses `os._exit(1)` — bypassing `atexit`
+handlers and `finally` blocks — to prevent any cleanup code from running
+against a broken logger that was never fully registered.
 
 **Note**: The schema is compiled once per process and cached. Schema changes
 require an application restart to take effect. The library is thread-safe.

pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "uv_build"
 
 [project]
 name = "logging-objects-with-schema"
-version = "0.4.1"
+version = "1.0.0rc1"
 description = "Proxy logging wrapper that validates extra fields against a JSON schema."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [ ]
 license = "Apache-2.0"
 license-files = [ "LICENSE" ]
@@ -20,7 +20,6 @@ keywords = [
 ]
 classifiers = [
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -102,6 +101,7 @@ source = [ "src" ]
 branch = true
 
 [tool.coverage.report]
+fail_under = 100
 exclude_lines = [
   "def __repr__",
   "if self\\.debug",

src/logging_objects_with_schema/__init__.py

@@ -5,8 +5,6 @@
 according to an application-defined JSON schema.
 """
 
-from __future__ import annotations
-
 from .schema_logger import SchemaLogger
 
 __all__ = [

src/logging_objects_with_schema/errors.py

@@ -1,8 +1,8 @@
 """Custom exception types used by logging_objects_with_schema."""
 
-from __future__ import annotations
-
+import json
 from dataclasses import dataclass
+from typing import Any
 
 
 @dataclass
@@ -60,15 +60,12 @@ class _DataProblem:
     - Redundant fields (fields not defined in the schema)
 
     Attributes:
-        message: JSON string containing structured error information. The message
-            is always a valid JSON object with the following structure:
-            ``{"field": "...", "error": "...", "value": "..."}``
-            All values are serialized via ``repr()`` for safety and consistency.
-            Examples:
-            - ``{"field": "'user_id'", "error": "'has type str, expected int'", "value": "'abc-123'"}``
-            - ``{"field": "'request_id'", "error": "'is None'", "value": "None"}``
-            - ``{"field": "'tags'", "error": "'is a list but contains elements with types dict; expected all elements to be of type str'", "value": "[{'key': 'color'}]"}``  # noqa: E501
-            - ``{"field": "'unknown_field'", "error": "'is not defined in schema'", "value": "'some_value'"}``
+        data: Dict containing structured error information with keys
+            ``field``, ``error``, and ``value`` (all via ``repr()``).
     """
 
-    message: str
+    data: dict[str, Any]
+
+    @property
+    def message(self) -> str:
+        return json.dumps(self.data)