unstd 3.0.0__tar.gz → 3.1.0__tar.gz

unstd-3.1.0/.github/workflows/release.yml

@@ -0,0 +1,93 @@
+# Build and verify native wheels before publishing a version tag to PyPI.
+#
+# ONE-TIME SETUP: PyPI Trusted Publishing, no API token in this repo.
+# On PyPI, add a trusted publisher for the `unstd` project pointing at this
+# repository, workflow `release.yml`, environment `pypi`. Before the project
+# exists this is a pending publisher under Your projects -> Publishing.
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  # A tag push used to publish unconditionally — nothing stood between `git tag`
+  # and PyPI, and a release is the one artifact that cannot be taken back. The
+  # full CI gate (lint + type + the 3.12/3.13/3.14 matrix + the base-install
+  # fallback leg) runs first, by reference rather than by copy, so the bar is
+  # the same one every pull request clears.
+  gate:
+    uses: ./.github/workflows/ci.yml
+    permissions:
+      contents: read
+
+  wheels:
+    needs: gate
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-15-intel, macos-14, windows-latest, windows-11-arm]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: false
+          version: "latest-known"
+      - name: Build and test CPython wheels
+        run: uvx --from cibuildwheel==4.3.1 cibuildwheel --output-dir dist
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        with:
+          name: wheels-${{ matrix.os }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  sdist:
+    needs: gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: false
+          version: "latest-known"
+      - run: uv build --sdist
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        with:
+          name: source
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  pypi:
+    needs: [wheels, sdist]
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
+        with:
+          path: dist
+          merge-multiple: true
+      - name: The tag agrees with package metadata
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          python - <<'PY'
+          import os, pathlib, tarfile, tomllib
+          source, = pathlib.Path("dist").glob("*.tar.gz")
+          with tarfile.open(source) as archive:
+              manifest, = (item for item in archive.getmembers() if item.name.endswith("/pyproject.toml"))
+              version = tomllib.loads(archive.extractfile(manifest).read().decode())["project"]["version"]
+          assert os.environ["TAG"] == "v" + version
+          PY
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

{unstd-3.0.0 → unstd-3.1.0}/.gitignore

@@ -2,6 +2,9 @@
 __pycache__/
 *.py[cod]
 *.egg-info/
+*.so
+*.pyd
+build/
 .venv/
 dist/
 .pytest_cache/

{unstd-3.0.0 → unstd-3.1.0}/CHANGELOG.md

@@ -8,7 +8,7 @@ doc_radar:
     - file: .github/workflows/ci.yml
       contains: ['github.sha || github.ref', 'version: "latest-known"', 'uv sync --locked']
     - file: .github/workflows/release.yml
-      contains: ['TAG: ${{ github.ref_name }}', 'uv version --short']
+      contains: ['TAG: ${{ github.ref_name }}', 'Build and test CPython wheels']
     - file: src/unstd/serde/structs.py
       contains: ['Callable[[Decimal], object]', 'decimal_format: _DecimalFormat']
 ---
@@ -17,6 +17,38 @@ doc_radar:
 
 <!-- towncrier release notes start -->
 
+## [3.1.0] - 2026-10-20
+
+### Performance
+
+- JSON encoding can use an optional CPython native guard that checks exact
+  builtin trees and calls orjson while retaining the GIL. Larger text records
+  avoid 3.0.0's Python snapshot budget and stdlib fallback. Compiler-less source
+  builds retain the portable path; release wheels include the guard.
+- Native default spacing preserves punctuation and escaped quotes inside text,
+  avoiding the stdlib fallback for larger string-heavy records.
+- Untyped JSON decoding reuses msgspec's arbitrary-precision integer and correctly
+  rounded float decoder, with a bounded native proof enabling orjson for larger
+  records. CPython 3.14 native dispatch preserves Python function metadata and
+  falls back during instrumentation. Custom options, unsupported inputs and
+  native errors retain stdlib behavior.
+- NDJSON writes use the same guarded encoder's native trailing-newline option,
+  avoiding redundant public dispatch and an extra output copy per record.
+- Whole-blob NDJSON reads batch native parsing over strict physical newline
+  boundaries. Streaming reads, callbacks and error diagnostics keep their
+  existing behavior.
+- Added an output-checked Billy fixture comparison with source and fixture
+  fingerprints, alternating before/after CPU batches, direct-call companions and
+  an optional release-regression gate. The measurement report retains residual
+  costs relative to the permissive 2.1.1 codec; no universal speedup or
+  zero-overhead compatibility claim is made. Public APIs are unchanged.
+
+### Fixed
+
+- Native codec reinitialization keeps earlier helpers' configuration checks and
+  Python fallbacks valid. Module destruction also releases watchers and owned
+  references when garbage collection has not run the clear hook first.
+
 ## [3.0.0] - 2026-10-19
 
 ### Breaking

{unstd-3.0.0 → unstd-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: unstd
-Version: 3.0.0
+Version: 3.1.0
 Summary: stdlib-faithful accelerated replacements behind optional extras
 Project-URL: Homepage, https://github.com/The-Billy-Company/unstd
 Project-URL: Repository, https://github.com/The-Billy-Company/unstd
@@ -83,6 +83,12 @@ python3 -m pip install unstd
 python3 -m pip install 'unstd[serde,ids,crypto]'
 ```
 
+CPython platform wheels include an optional C guard for fast, compatible JSON
+encoding. Source builds use it when a compiler is available and otherwise keep
+the portable fallback. The runtime dependency set and public APIs are unchanged.
+See the [Billy fixture measurements](bench/billy-serde-optimization-results.md)
+for release comparisons, including remaining overhead relative to 2.1.1.
+
 ## Groups
 
 | Group | Extra | Backend / fallback |

{unstd-3.0.0 → unstd-3.1.0}/README.md

@@ -23,6 +23,12 @@ python3 -m pip install unstd
 python3 -m pip install 'unstd[serde,ids,crypto]'
 ```
 
+CPython platform wheels include an optional C guard for fast, compatible JSON
+encoding. Source builds use it when a compiler is available and otherwise keep
+the portable fallback. The runtime dependency set and public APIs are unchanged.
+See the [Billy fixture measurements](bench/billy-serde-optimization-results.md)
+for release comparisons, including remaining overhead relative to 2.1.1.
+
 ## Groups
 
 | Group | Extra | Backend / fallback |