constutil 1.0.0__tar.gz → 1.2.0__tar.gz

{constutil-1.0.0 → constutil-1.2.0}/.github/workflows/ci.yml

@@ -11,27 +11,27 @@ permissions:
 
 jobs:
   tests:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       fail-fast: false
       matrix:
-        python: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        python: ['3.12', '3.13', '3.14']
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
           python-version: ${{ matrix.python }}
       - run: uv sync --locked
       - run: uv run pytest --cov=constutil --cov-report=term-missing --cov-fail-under=95
   quality:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
-          python-version: '3.10'
+          python-version: '3.12'
       - run: uv sync --locked
       - run: uv run ruff check .
       - run: uv run ruff format --check .

{constutil-1.0.0 → constutil-1.2.0}/.github/workflows/pages.yml

@@ -14,22 +14,23 @@ concurrency:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.1.0
         with:
           enable-cache: true
           python-version: '3.14'
       - run: uv sync --locked
       - run: uv run python scripts/build_docs.py
-      - uses: actions/configure-pages@v5
-      - uses: actions/upload-pages-artifact@v3
+      - uses: actions/configure-pages@v6.0.0
+      - uses: actions/upload-pages-artifact@v5.0.0
         with:
           path: site/
+          include-hidden-files: true
   deploy:
     needs: build
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     permissions:
       pages: write
       id-token: write
@@ -39,4 +40,4 @@ jobs:
     steps:
       - name: Deploy
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5.0.1

constutil-1.2.0/.github/workflows/prepare_release.yml

@@ -0,0 +1,69 @@
+name: Prepare GitHub release
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Release tag matching project.version (for example v1.0.1)
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: prepare-release-${{ inputs.tag }}
+  cancel-in-progress: false
+
+jobs:
+  test:
+    uses: ./.github/workflows/ci.yml
+  prepare:
+    needs: test
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          ref: ${{ github.sha }}
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          python-version: '3.14'
+      - run: uv sync --locked
+      - name: Verify tag and version
+        env:
+          RELEASE_TAG: ${{ inputs.tag }}
+        run: |
+          uv run python - <<'PY'
+          import os
+          import tomllib
+          from pathlib import Path
+          version = tomllib.loads(Path('pyproject.toml').read_text())['project']['version']
+          if os.environ['RELEASE_TAG'] != f'v{version}':
+              raise SystemExit(f'Release tag must be v{version}')
+          PY
+      - run: uv build
+      - run: uv run twine check dist/*
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error
+      - name: Create tag at the tested commit
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ inputs.tag }}
+          RELEASE_SHA: ${{ github.sha }}
+        run: |
+          gh api "repos/$GH_REPO/git/refs" --method POST \
+            -f "ref=refs/tags/$RELEASE_TAG" -f "sha=$RELEASE_SHA"
+      - name: Create draft with package downloads
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ inputs.tag }}
+        run: |
+          gh release create "$RELEASE_TAG" dist/* --draft --verify-tag \
+            --title "constutil $RELEASE_TAG" --generate-notes

{constutil-1.0.0 → constutil-1.2.0}/.github/workflows/pypi_publish.yml

@@ -12,10 +12,10 @@ jobs:
     uses: ./.github/workflows/ci.yml
   build:
     needs: test
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.1.0
         with:
           python-version: '3.14'
       - run: uv sync --locked
@@ -31,41 +31,32 @@ jobs:
           if os.environ['RELEASE_TAG'] != f'v{version}':
               raise SystemExit(f'Release tag must be v{version}')
           PY
-      - run: uv build
+      - name: Download the immutable release distributions
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          gh release download "$RELEASE_TAG" --pattern '*.whl' --dir dist
+          gh release download "$RELEASE_TAG" --pattern '*.tar.gz' --dir dist
       - run: uv run twine check dist/*
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v7.0.1
         with:
           name: distributions
           path: dist/
           if-no-files-found: error
   publish:
     needs: build
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     environment:
       name: pypi
       url: https://pypi.org/project/constutil/
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v8.0.1
         with:
           name: distributions
           path: dist/
       - name: Publish with Trusted Publishing
         uses: pypa/gh-action-pypi-publish@release/v1
-  release-assets:
-    needs: build
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/download-artifact@v4
-        with:
-          name: distributions
-          path: dist/
-      - name: Attach distributions to the GitHub release
-        env:
-          GH_TOKEN: ${{ github.token }}
-          GH_REPO: ${{ github.repository }}
-          RELEASE_TAG: ${{ github.event.release.tag_name }}
-        run: gh release upload "$RELEASE_TAG" dist/* --clobber

{constutil-1.0.0 → constutil-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: constutil
-Version: 1.0.0
+Version: 1.2.0
 Summary: Typed constant definitions and groups for Python
 Project-URL: Homepage, https://github.com/patchfork/constutil
 Project-URL: Documentation, https://constutil.patchfork.dev/
@@ -13,13 +13,11 @@ Keywords: constants,dataclasses,enum,typing
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 
 # constutil
@@ -32,13 +30,13 @@ choices or richer records without requiring Python's `enum.Enum`.
 
 ## Installation
 
-Requires **Python 3.10 or newer**.
+Requires **Python 3.12 or newer**.
 
 ```sh
 pip install constutil
 ```
 
-Until the first PyPI release, install directly from GitHub:
+To use changes not yet published to PyPI, install directly from GitHub:
 
 ```sh
 pip install git+https://github.com/patchfork/constutil.git
@@ -121,6 +119,12 @@ class Season(StrConstGroup):
 
 
 assert Season.get_value("Spring") == "spring"
+assert Season.get_value_map() == {
+    "SPRING": "spring",
+    "SUMMER": "summer",
+    "AUTUMN": "autumn",
+    "WINTER": "winter",
+}
 assert Season.is_valid_value("SPRING") is False
 ```
 
@@ -194,6 +198,7 @@ returned as-is and is not required to belong to the group; absent defaults are
 | `get_default()` | Configured member or `None` |
 | `get_all()` | Tuple of members |
 | `get_all_map()` | Fresh attribute-name → member dictionary |
+| `get_value_map()` | Fresh attribute-name → stored-value dictionary, in declaration order |
 | `get_all_values()` | Tuple of stored values |
 | `get_all_names()` | Tuple of display names |
 | `get_all_constant_names()` | Tuple of Python attribute names |
@@ -224,7 +229,7 @@ arguments at runtime.
 
 ## Python compatibility
 
-The minimum is **Python 3.10**, determined by the features actually used:
+The minimum is **Python 3.12**, determined by the features actually used:
 
 | Feature | Introduced |
 | --- | --- |
@@ -234,6 +239,7 @@ The minimum is **Python 3.10**, determined by the features actually used:
 | Built-in collection annotations such as `tuple[str, ...]` | Python 3.9 |
 | Union annotations such as `MemberT | None` | Python 3.10 |
 | `@dataclass(slots=True)` in optional metadata subclasses | Python 3.10 |
+| `types.get_original_bases()` | Python 3.12 |
 
 The generic base deliberately omits `slots=True`: older Python versions raise a
 `TypeError` when instantiating a frozen, slotted generic alias because `typing`
@@ -241,12 +247,13 @@ tries to assign `__orig_class__`. Frozen definitions without slots work across t
 supported versions. A subclass may use slots, but still inherits the base instance
 dictionary.
 
-Generic discovery uses `__orig_bases__`; it does not need Python 3.12's
-`types.get_original_bases` or PEP 695 type-parameter syntax. The package includes
-`py.typed`. CI tests Python 3.10–3.14. See the official
-[dataclass documentation](https://docs.python.org/3.10/library/dataclasses.html),
-[typing documentation](https://docs.python.org/3.10/library/typing.html), and
-[Python 3.10 changes](https://docs.python.org/3.10/whatsnew/3.10.html).
+Generic discovery uses the public `types.get_original_bases()` API, introduced in
+Python 3.12, to inspect generic bases before type erasure. This sets the minimum
+Python version; no fallback to direct `__orig_bases__` access is needed. The
+package includes `py.typed`, and CI tests Python 3.12–3.14. See the official
+[generic base introspection documentation](https://docs.python.org/3.12/library/types.html#types.get_original_bases).
+
+Version 1.0.0 supports Python 3.10–3.14; version 1.1.0 requires Python 3.12+.
 
 ## Adopt the coding skill (Codex and Claude Code)
 
@@ -256,6 +263,35 @@ It directs an agent to use `constutil` for related constant values, usually in a
 `constants/` package, and explains naming, access, lookup, and existence checks.
 Installing the Python dependency alone does **not** install the skill.
 
+### Quick installer
+
+From your project's root, download and run the installer:
+
+```sh
+curl -fsSLo install-skills.sh https://constutil.patchfork.dev/install-skills.sh
+sh install-skills.sh both       # Codex and Claude Code
+# Or: sh install-skills.sh codex
+# Or: sh install-skills.sh claude
+```
+
+From a checkout of this repository, run `sh scripts/install-skills.sh both`.
+The installer uses the checkout's skill files when available; the downloaded
+script fetches them from this site. It installs into `.agents/skills/constutil`
+and/or `.claude/skills/constutil` in the current directory. Use `--global` for
+`~/.agents/skills/constutil` and/or `~/.claude/skills/constutil`. Existing skill
+folders are preserved unless you pass `--force` to update the supplied files.
+
+```sh
+sh install-skills.sh both --global
+sh install-skills.sh both --force
+```
+
+The script requires `sh` and standard Unix tools, plus `curl` when downloading.
+It does not change `AGENTS.md` or `CLAUDE.md`; add the project convention below
+if you want the skill's guidance to apply consistently.
+
+### Manual installation
+
 For one project, copy the complete `skills/constutil/` directory from this
 repository to `<your-project>/.agents/skills/constutil/` and commit it. From that
 project's root, with this repository cloned alongside it:
@@ -352,10 +388,10 @@ and website share one source.
 ### PyPI
 
 The `pypi_publish.yml` workflow runs on a published GitHub release, tests the package
-on Python 3.10–3.14, checks types and formatting, verifies that the release tag
-matches the package version, builds a wheel and source distribution, checks their
-metadata, attaches the same wheel and source distribution to the GitHub release,
-and publishes via PyPI Trusted Publishing. It does not require an API token.
+on Python 3.12–3.14, checks types and formatting, verifies that the release tag
+matches the package version, downloads the wheel and source distribution already
+attached to that release, checks their metadata, and publishes those exact files
+via PyPI Trusted Publishing. It does not require an API token.
 
 One-time setup:
 
@@ -363,8 +399,49 @@ One-time setup:
 2. On PyPI, configure a pending publisher for `constutil` (or a trusted publisher
    if you already own the project): owner `patchfork`, repository `constutil`,
    workflow filename `pypi_publish.yml`, environment `pypi`.
-3. Update `project.version` in `pyproject.toml`, run `uv lock`, and commit the changes.
-4. Publish a GitHub release with a matching tag, for example `v1.0.0`.
+
+#### Trigger a release
+
+First bump the package version from the repository root:
+
+```sh
+sh scripts/bump-version.sh --dry-run patch  # Preview the next patch version
+sh scripts/bump-version.sh patch           # Or: minor, major, or an explicit 1.2.0
+```
+
+The script requires `uv` with the `uv version` command and updates
+`project.version` in `pyproject.toml` and the package entry in `uv.lock`, without
+syncing the environment. Review and commit those changes, then push them to `main`.
+It does not create a commit, tag, or release. Historical version references in
+documentation are left unchanged; review release-specific prose when preparing a
+release.
+
+Then prepare the release:
+
+1. Open [Prepare GitHub release](https://github.com/patchfork/constutil/actions/workflows/prepare_release.yml).
+2. Click **Run workflow**, select the `main` branch, enter the package version
+   prefixed with `v` as the tag (for example, **`v1.2.0`**), and start the workflow.
+3. Wait for the workflow to pass CI and create a **draft release** with the wheel
+   and source archive attached.
+4. Open [Releases](https://github.com/patchfork/constutil/releases), review the
+   draft's notes and downloads, and click **Publish release**.
+5. Publishing automatically triggers
+   [Publish to PyPI](https://github.com/patchfork/constutil/actions/workflows/pypi_publish.yml)
+   to upload those exact packages. Check that workflow for the publishing result.
+
+The preparation workflow deliberately leaves publication to the user: events
+created using `GITHUB_TOKEN` do not automatically trigger other workflows.
+
+GitHub releases are immutable after publication. Uploads must happen while the
+release is still a draft; the publish workflow never adds or replaces release
+assets. A preparation attempt for an existing tag fails rather than moving the tag
+or overwriting a release. If a draft's upload failed, attach the checked build
+artifacts to that draft before publishing it.
+
+The original `v1.0.0` release was published without binary attachments and cannot
+be retrofitted. Its packages are available from PyPI; subsequent releases use the
+draft-first process above. Rerunning the historical workflow uses the old workflow
+stored at its tag and cannot apply this fix retroactively.
 
 PyPI project-name availability is decided by PyPI when registering or publishing.
 See [PyPI's Trusted Publishing guide](https://docs.pypi.org/trusted-publishers/).

{constutil-1.0.0 → constutil-1.2.0}/README.md

@@ -8,13 +8,13 @@ choices or richer records without requiring Python's `enum.Enum`.
 
 ## Installation
 
-Requires **Python 3.10 or newer**.
+Requires **Python 3.12 or newer**.
 
 ```sh
 pip install constutil
 ```
 
-Until the first PyPI release, install directly from GitHub:
+To use changes not yet published to PyPI, install directly from GitHub:
 
 ```sh
 pip install git+https://github.com/patchfork/constutil.git
@@ -97,6 +97,12 @@ class Season(StrConstGroup):
 
 
 assert Season.get_value("Spring") == "spring"
+assert Season.get_value_map() == {
+    "SPRING": "spring",
+    "SUMMER": "summer",
+    "AUTUMN": "autumn",
+    "WINTER": "winter",
+}
 assert Season.is_valid_value("SPRING") is False
 ```
 
@@ -170,6 +176,7 @@ returned as-is and is not required to belong to the group; absent defaults are
 | `get_default()` | Configured member or `None` |
 | `get_all()` | Tuple of members |
 | `get_all_map()` | Fresh attribute-name → member dictionary |
+| `get_value_map()` | Fresh attribute-name → stored-value dictionary, in declaration order |
 | `get_all_values()` | Tuple of stored values |
 | `get_all_names()` | Tuple of display names |
 | `get_all_constant_names()` | Tuple of Python attribute names |
@@ -200,7 +207,7 @@ arguments at runtime.
 
 ## Python compatibility
 
-The minimum is **Python 3.10**, determined by the features actually used:
+The minimum is **Python 3.12**, determined by the features actually used:
 
 | Feature | Introduced |
 | --- | --- |
@@ -210,6 +217,7 @@ The minimum is **Python 3.10**, determined by the features actually used:
 | Built-in collection annotations such as `tuple[str, ...]` | Python 3.9 |
 | Union annotations such as `MemberT | None` | Python 3.10 |
 | `@dataclass(slots=True)` in optional metadata subclasses | Python 3.10 |
+| `types.get_original_bases()` | Python 3.12 |
 
 The generic base deliberately omits `slots=True`: older Python versions raise a
 `TypeError` when instantiating a frozen, slotted generic alias because `typing`
@@ -217,12 +225,13 @@ tries to assign `__orig_class__`. Frozen definitions without slots work across t
 supported versions. A subclass may use slots, but still inherits the base instance
 dictionary.
 
-Generic discovery uses `__orig_bases__`; it does not need Python 3.12's
-`types.get_original_bases` or PEP 695 type-parameter syntax. The package includes
-`py.typed`. CI tests Python 3.10–3.14. See the official
-[dataclass documentation](https://docs.python.org/3.10/library/dataclasses.html),
-[typing documentation](https://docs.python.org/3.10/library/typing.html), and
-[Python 3.10 changes](https://docs.python.org/3.10/whatsnew/3.10.html).
+Generic discovery uses the public `types.get_original_bases()` API, introduced in
+Python 3.12, to inspect generic bases before type erasure. This sets the minimum
+Python version; no fallback to direct `__orig_bases__` access is needed. The
+package includes `py.typed`, and CI tests Python 3.12–3.14. See the official
+[generic base introspection documentation](https://docs.python.org/3.12/library/types.html#types.get_original_bases).
+
+Version 1.0.0 supports Python 3.10–3.14; version 1.1.0 requires Python 3.12+.
 
 ## Adopt the coding skill (Codex and Claude Code)
 
@@ -232,6 +241,35 @@ It directs an agent to use `constutil` for related constant values, usually in a
 `constants/` package, and explains naming, access, lookup, and existence checks.
 Installing the Python dependency alone does **not** install the skill.
 
+### Quick installer
+
+From your project's root, download and run the installer:
+
+```sh
+curl -fsSLo install-skills.sh https://constutil.patchfork.dev/install-skills.sh
+sh install-skills.sh both       # Codex and Claude Code
+# Or: sh install-skills.sh codex
+# Or: sh install-skills.sh claude
+```
+
+From a checkout of this repository, run `sh scripts/install-skills.sh both`.
+The installer uses the checkout's skill files when available; the downloaded
+script fetches them from this site. It installs into `.agents/skills/constutil`
+and/or `.claude/skills/constutil` in the current directory. Use `--global` for
+`~/.agents/skills/constutil` and/or `~/.claude/skills/constutil`. Existing skill
+folders are preserved unless you pass `--force` to update the supplied files.
+
+```sh
+sh install-skills.sh both --global
+sh install-skills.sh both --force
+```
+
+The script requires `sh` and standard Unix tools, plus `curl` when downloading.
+It does not change `AGENTS.md` or `CLAUDE.md`; add the project convention below
+if you want the skill's guidance to apply consistently.
+
+### Manual installation
+
 For one project, copy the complete `skills/constutil/` directory from this
 repository to `<your-project>/.agents/skills/constutil/` and commit it. From that
 project's root, with this repository cloned alongside it:
@@ -328,10 +366,10 @@ and website share one source.
 ### PyPI
 
 The `pypi_publish.yml` workflow runs on a published GitHub release, tests the package
-on Python 3.10–3.14, checks types and formatting, verifies that the release tag
-matches the package version, builds a wheel and source distribution, checks their
-metadata, attaches the same wheel and source distribution to the GitHub release,
-and publishes via PyPI Trusted Publishing. It does not require an API token.
+on Python 3.12–3.14, checks types and formatting, verifies that the release tag
+matches the package version, downloads the wheel and source distribution already
+attached to that release, checks their metadata, and publishes those exact files
+via PyPI Trusted Publishing. It does not require an API token.
 
 One-time setup:
 
@@ -339,8 +377,49 @@ One-time setup:
 2. On PyPI, configure a pending publisher for `constutil` (or a trusted publisher
    if you already own the project): owner `patchfork`, repository `constutil`,
    workflow filename `pypi_publish.yml`, environment `pypi`.
-3. Update `project.version` in `pyproject.toml`, run `uv lock`, and commit the changes.
-4. Publish a GitHub release with a matching tag, for example `v1.0.0`.
+
+#### Trigger a release
+
+First bump the package version from the repository root:
+
+```sh
+sh scripts/bump-version.sh --dry-run patch  # Preview the next patch version
+sh scripts/bump-version.sh patch           # Or: minor, major, or an explicit 1.2.0
+```
+
+The script requires `uv` with the `uv version` command and updates
+`project.version` in `pyproject.toml` and the package entry in `uv.lock`, without
+syncing the environment. Review and commit those changes, then push them to `main`.
+It does not create a commit, tag, or release. Historical version references in
+documentation are left unchanged; review release-specific prose when preparing a
+release.
+
+Then prepare the release:
+
+1. Open [Prepare GitHub release](https://github.com/patchfork/constutil/actions/workflows/prepare_release.yml).
+2. Click **Run workflow**, select the `main` branch, enter the package version
+   prefixed with `v` as the tag (for example, **`v1.2.0`**), and start the workflow.
+3. Wait for the workflow to pass CI and create a **draft release** with the wheel
+   and source archive attached.
+4. Open [Releases](https://github.com/patchfork/constutil/releases), review the
+   draft's notes and downloads, and click **Publish release**.
+5. Publishing automatically triggers
+   [Publish to PyPI](https://github.com/patchfork/constutil/actions/workflows/pypi_publish.yml)
+   to upload those exact packages. Check that workflow for the publishing result.
+
+The preparation workflow deliberately leaves publication to the user: events
+created using `GITHUB_TOKEN` do not automatically trigger other workflows.
+
+GitHub releases are immutable after publication. Uploads must happen while the
+release is still a draft; the publish workflow never adds or replaces release
+assets. A preparation attempt for an existing tag fails rather than moving the tag
+or overwriting a release. If a draft's upload failed, attach the checked build
+artifacts to that draft before publishing it.
+
+The original `v1.0.0` release was published without binary attachments and cannot
+be retrofitted. Its packages are available from PyPI; subsequent releases use the
+draft-first process above. Rerunning the historical workflow uses the old workflow
+stored at its tag and cannot apply this fix retroactively.
 
 PyPI project-name availability is decided by PyPI when registering or publishing.
 See [PyPI's Trusted Publishing guide](https://docs.pypi.org/trusted-publishers/).

{constutil-1.0.0 → constutil-1.2.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "constutil"
-version = "1.0.0"
+version = "1.2.0"
 description = "Typed constant definitions and groups for Python"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{name = "Patchfork", email = "pypi@patchfork.dev"}]
@@ -16,8 +16,6 @@ classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
@@ -42,12 +40,17 @@ addopts = "-ra"
 
 [tool.ruff]
 line-length = 100
-target-version = "py310"
+target-version = "py312"
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP"]
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.12"
 strict = true
 files = ["src/constutil"]
+
+[tool.ruff.lint.per-file-ignores]
+# Retain the existing Generic/TypeVar API while changing base introspection.
+"src/constutil/constdef.py" = ["UP046"]
+"src/constutil/constgroup.py" = ["UP046"]

{constutil-1.0.0 → constutil-1.2.0}/scripts/build_docs.py

@@ -1,7 +1,7 @@
 """Build the GitHub Pages site from the package README."""
 
 from pathlib import Path
-from shutil import copytree, make_archive
+from shutil import copyfile, copytree, make_archive
 
 import markdown
 
@@ -14,6 +14,7 @@ def main() -> None:
     destination = ROOT / "site"
     destination.mkdir(exist_ok=True)
     (destination / ".nojekyll").touch()
+    copyfile(ROOT / "scripts" / "install-skills.sh", destination / "install-skills.sh")
     (destination / "index.md").write_text(readme, encoding="utf-8")
     copytree(
         ROOT / "skills" / "constutil", destination / "skills" / "constutil", dirs_exist_ok=True
@@ -37,7 +38,7 @@ def main() -> None:
     (destination / "llms.txt").write_text(
         """# constutil
 
-> Typed constant definitions and groups for Python 3.10+, with no runtime dependencies.
+> Typed constant definitions and groups for Python 3.12+, with no runtime dependencies.
 
 ConstDef stores a scalar value and display name; ConstGroup provides ordered
 lookup and enumeration. Comparisons use Python equality without coercion or case
@@ -53,6 +54,9 @@ populated groups. The optional skill recommends a constants package layout.
 
 ## Skills
 
+- [Installer](https://constutil.patchfork.dev/install-skills.sh):
+  install the shared skill for Codex, Claude Code, or both.
+
 - [constutil skill](https://constutil.patchfork.dev/skills/constutil/SKILL.md):
   shared Codex and Claude Code conventions, lookup, and existence checks.
 - [Codex metadata](https://constutil.patchfork.dev/skills/constutil/agents/openai.yaml):