typekit2 1.0.0__tar.gz

typekit2-1.0.0/.env.example

@@ -0,0 +1,3 @@
+# this_file: .env.example
+TYPEKIT_API_KEY=replace-with-your-adobe-fonts-api-token
+

typekit2-1.0.0/.gitignore

@@ -0,0 +1,61 @@
+# this_file: .gitignore
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+.DS_Store
+.env
+.venv/
+.codegraph/
+typekit2/__version__.py
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+bin/
+build/
+develop-eggs/
+dist/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+.pytest_cache/
+.ruff_cache/
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Rope
+.ropeproject
+
+# Django stuff:
+*.log
+*.pot
+
+# Sphinx documentation
+docs/_build/

typekit2-1.0.0/CHANGELOG.md

@@ -0,0 +1,29 @@
+---
+this_file: CHANGELOG.md
+---
+
+# Changelog
+
+## Unreleased
+
+### Changed
+
+- Renamed the distribution and import package from `typekit` to `typekit2`.
+- Replaced `setup.py` with standards-based `pyproject.toml` packaging.
+- Migrated the client from Python 2 to typed Python 3.10+.
+- Switched authentication from URL query parameters to the documented HTTPS `X-Typekit-Token` header.
+- Reworked kit writes to use current parameter shapes and preserve omitted update fields.
+
+### Added
+
+- `TYPEKIT_API_KEY` and `.env` configuration through `python-dotenv`.
+- Fire CLI via `python -m typekit2` and the `typekit2` console command.
+- Adobe Fonts API mapping and usage documentation.
+- Offline tests for authentication, transport, payloads, errors, parsing, and CLI behavior.
+- Tag-derived semantic versions using `hatch-vcs`.
+- `publish.sh` workflow using `uvx gitnextver`, `uv build`, and `uv publish`.
+
+### Removed
+
+- Python 2-only code, live destructive tests, `setup.py`, and generated distutils manifest.
+

typekit2-1.0.0/DEPENDENCIES.md

@@ -0,0 +1,24 @@
+---
+this_file: DEPENDENCIES.md
+---
+
+# Dependencies
+
+## Runtime
+
+- `requests`: HTTP transport with sessions, TLS verification, timeouts, and explicit status handling.
+- `python-dotenv`: loads `TYPEKIT_API_KEY` from `.env` while preserving environment precedence.
+- `fire`: generates the requested CLI from the small `TypekitCLI` command object.
+
+## Build and release
+
+- `hatchling`: PEP 517 build backend configured in `pyproject.toml`.
+- `hatch-vcs`: derives PEP 440 versions from semantic Git tags and writes the packaged `__version__.py`.
+- `gitnextver` (run with `uvx`): creates the next semantic version commit/tag and pushes it during releases.
+- `uv`: resolves dependencies, runs checks, builds wheel/sdist, and publishes distributions.
+
+## Development
+
+- `pytest` and `pytest-cov`: offline contract tests and coverage enforcement.
+- `ruff`: formatting and static lint checks.
+

typekit2-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Suchan Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

typekit2-1.0.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.5
+Name: typekit2
+Version: 1.0.0
+Summary: Modern Python client and CLI for the Adobe Fonts (Typekit) API
+Project-URL: Documentation, https://fonts.adobe.com/docs/api
+Project-URL: Repository, https://github.com/fontlaborg/typekit-python
+Author-email: Suchan Lee <lee.suchan@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: adobe-fonts,api,cli,typekit
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.10
+Requires-Dist: fire>=0.7.1
+Requires-Dist: python-dotenv>=1.2.3
+Requires-Dist: requests>=2.32.5
+Description-Content-Type: text/markdown
+
+---
+this_file: README.md
+---
+
+# typekit2
+
+`typekit2` is a modern Python client and Fire CLI for the Adobe Fonts API formerly known as the Typekit API.
+
+It replaces the abandoned `typekit` package’s Python 2 code and `setup.py` packaging with Python 3.10+, `pyproject.toml`, HTTPS header authentication, `.env` support, offline tests, and Git-tag-derived versions.
+
+## Install
+
+```bash
+uv add typekit2
+```
+
+For local development:
+
+```bash
+uv sync
+```
+
+Create `.env` from the supplied example, or export the key directly:
+
+```bash
+cp .env.example .env
+export TYPEKIT_API_KEY='your-token'
+```
+
+`python-dotenv` loads `.env` without overriding an existing environment variable. Never commit `.env`; it is ignored.
+
+## Python API
+
+```python
+from typekit2 import Typekit
+
+client = Typekit()  # reads TYPEKIT_API_KEY
+
+kits = client.list_kits()
+family = client.get_font_family("pcpv")
+variations = client.get_font_variations("pcpv")
+library = client.get_library("full", page=1, per_page=50)
+```
+
+An explicit key is also supported:
+
+```python
+client = Typekit(api_key="...")
+```
+
+The compatibility keyword `api_token=` is accepted, but new code should use `api_key=` or `TYPEKIT_API_KEY`.
+
+### Kit workflow
+
+```python
+created = client.create_kit(
+    "Example",
+    ["example.com", "www.example.com"],
+    [{"id": "pcpv", "subset": "all", "variations": ["n4", "i4"]}],
+)
+kit_id = created["kit"]["id"]
+
+client.update_kit(kit_id, name="Example renamed")
+client.add_font(kit_id, "gkmg", variations=["n4", "n7"])
+client.publish_kit(kit_id)
+```
+
+Publishing is asynchronous. Adobe documents that CDN propagation may take several minutes.
+
+## CLI
+
+The installed `typekit2` command and `python -m typekit2` expose the same Fire CLI. Results are stable JSON.
+
+```bash
+typekit2 doctor
+typekit2 kits
+typekit2 kit abc123
+typekit2 kit abc123 --published=true
+typekit2 family pcpv
+typekit2 variations pcpv
+typekit2 libraries
+typekit2 library full --page=1 --per-page=50
+```
+
+Mutating commands are explicit:
+
+```bash
+typekit2 create-kit Example --domains=example.com,www.example.com
+typekit2 add-font abc123 pcpv --variations=n4,i4 --subset=all
+typekit2 update-kit abc123 --name='Renamed kit'
+typekit2 publish-kit abc123
+typekit2 remove-font abc123 pcpv
+typekit2 remove-kit abc123
+```
+
+For `--families`, pass a JSON list:
+
+```bash
+typekit2 create-kit Example \
+  --domains=example.com \
+  --families='[{"id":"pcpv","subset":"all","variations":["n4","i4"]}]'
+```
+
+Run `typekit2 --help` or `python -m typekit2 --help` for generated Fire help.
+
+## API behavior
+
+- Requests use `https://typekit.com/api/v1/json`.
+- Authentication uses the documented `X-Typekit-Token` header; keys never enter URLs or CLI output.
+- Kit writes use URL-encoded Rails-style nested parameters.
+- A 30-second timeout is applied by default and can be changed with `Typekit(timeout=...)`.
+- HTTP, JSON, and documented API errors raise `TypekitAPIError`.
+- `update_kit` sends only supplied fields; omitted fields are not replaced accidentally.
+
+See [docs/API.md](docs/API.md) for the method-to-endpoint map and links to Adobe’s authoritative documentation.
+
+## Development
+
+```bash
+./test.sh
+```
+
+The suite is offline: it uses request doubles and never creates, publishes, or deletes a real kit.
+
+## Releases
+
+Versions come from Git tags through `hatch-vcs`; generated `typekit2/__version__.py` is explicitly ignored. To validate, commit/tag/push the next semantic version, build fresh distributions, and publish with `uv`:
+
+```bash
+./publish.sh
+```
+
+Set `PUBLISH_SKIP_UPLOAD=1` to exercise the Git release and artifact verification flow without uploading to PyPI. `UV_PUBLISH_TOKEN` supplies a PyPI token when Trusted Publishing is unavailable.
+
+## License and provenance
+
+MIT. The project began as `typekit-python` by Suchan Lee; `typekit2` is its Python 3 modernization.

typekit2-1.0.0/PLAN.md

@@ -0,0 +1,24 @@
+---
+this_file: PLAN.md
+---
+
+# Plan
+
+The modernization target is a maintained Python 3 package whose library, CLI, documentation, and release artifacts agree with the current Adobe Fonts API contract.
+
+## Completed scope
+
+- Rename both distribution and imports to `typekit2`.
+- Replace legacy setup metadata with `pyproject.toml` and `hatch-vcs` versions.
+- Modernize the HTTP client, HTTPS authentication, errors, typing, and API payloads.
+- Load `TYPEKIT_API_KEY` from the environment or `.env`.
+- Add a Fire CLI for reads and explicit kit mutations.
+- Replace live account-mutating tests with deterministic request-level tests.
+- Document Adobe endpoints, parameter semantics, installation, API, CLI, and releases.
+- Add a guarded `gitnextver` and `uv publish` release workflow.
+
+## Future work
+
+- Add opt-in live read-only smoke tests when a dedicated Adobe Fonts test account is available.
+- Add API resources only when they appear in Adobe’s authoritative reference.
+

typekit2-1.0.0/README.md

@@ -0,0 +1,137 @@
+---
+this_file: README.md
+---
+
+# typekit2
+
+`typekit2` is a modern Python client and Fire CLI for the Adobe Fonts API formerly known as the Typekit API.
+
+It replaces the abandoned `typekit` package’s Python 2 code and `setup.py` packaging with Python 3.10+, `pyproject.toml`, HTTPS header authentication, `.env` support, offline tests, and Git-tag-derived versions.
+
+## Install
+
+```bash
+uv add typekit2
+```
+
+For local development:
+
+```bash
+uv sync
+```
+
+Create `.env` from the supplied example, or export the key directly:
+
+```bash
+cp .env.example .env
+export TYPEKIT_API_KEY='your-token'
+```
+
+`python-dotenv` loads `.env` without overriding an existing environment variable. Never commit `.env`; it is ignored.
+
+## Python API
+
+```python
+from typekit2 import Typekit
+
+client = Typekit()  # reads TYPEKIT_API_KEY
+
+kits = client.list_kits()
+family = client.get_font_family("pcpv")
+variations = client.get_font_variations("pcpv")
+library = client.get_library("full", page=1, per_page=50)
+```
+
+An explicit key is also supported:
+
+```python
+client = Typekit(api_key="...")
+```
+
+The compatibility keyword `api_token=` is accepted, but new code should use `api_key=` or `TYPEKIT_API_KEY`.
+
+### Kit workflow
+
+```python
+created = client.create_kit(
+    "Example",
+    ["example.com", "www.example.com"],
+    [{"id": "pcpv", "subset": "all", "variations": ["n4", "i4"]}],
+)
+kit_id = created["kit"]["id"]
+
+client.update_kit(kit_id, name="Example renamed")
+client.add_font(kit_id, "gkmg", variations=["n4", "n7"])
+client.publish_kit(kit_id)
+```
+
+Publishing is asynchronous. Adobe documents that CDN propagation may take several minutes.
+
+## CLI
+
+The installed `typekit2` command and `python -m typekit2` expose the same Fire CLI. Results are stable JSON.
+
+```bash
+typekit2 doctor
+typekit2 kits
+typekit2 kit abc123
+typekit2 kit abc123 --published=true
+typekit2 family pcpv
+typekit2 variations pcpv
+typekit2 libraries
+typekit2 library full --page=1 --per-page=50
+```
+
+Mutating commands are explicit:
+
+```bash
+typekit2 create-kit Example --domains=example.com,www.example.com
+typekit2 add-font abc123 pcpv --variations=n4,i4 --subset=all
+typekit2 update-kit abc123 --name='Renamed kit'
+typekit2 publish-kit abc123
+typekit2 remove-font abc123 pcpv
+typekit2 remove-kit abc123
+```
+
+For `--families`, pass a JSON list:
+
+```bash
+typekit2 create-kit Example \
+  --domains=example.com \
+  --families='[{"id":"pcpv","subset":"all","variations":["n4","i4"]}]'
+```
+
+Run `typekit2 --help` or `python -m typekit2 --help` for generated Fire help.
+
+## API behavior
+
+- Requests use `https://typekit.com/api/v1/json`.
+- Authentication uses the documented `X-Typekit-Token` header; keys never enter URLs or CLI output.
+- Kit writes use URL-encoded Rails-style nested parameters.
+- A 30-second timeout is applied by default and can be changed with `Typekit(timeout=...)`.
+- HTTP, JSON, and documented API errors raise `TypekitAPIError`.
+- `update_kit` sends only supplied fields; omitted fields are not replaced accidentally.
+
+See [docs/API.md](docs/API.md) for the method-to-endpoint map and links to Adobe’s authoritative documentation.
+
+## Development
+
+```bash
+./test.sh
+```
+
+The suite is offline: it uses request doubles and never creates, publishes, or deletes a real kit.
+
+## Releases
+
+Versions come from Git tags through `hatch-vcs`; generated `typekit2/__version__.py` is explicitly ignored. To validate, commit/tag/push the next semantic version, build fresh distributions, and publish with `uv`:
+
+```bash
+./publish.sh
+```
+
+Set `PUBLISH_SKIP_UPLOAD=1` to exercise the Git release and artifact verification flow without uploading to PyPI. `UV_PUBLISH_TOKEN` supplies a PyPI token when Trusted Publishing is unavailable.
+
+## License and provenance
+
+MIT. The project began as `typekit-python` by Suchan Lee; `typekit2` is its Python 3 modernization.

typekit2-1.0.0/TODO.md

@@ -0,0 +1,9 @@
+---
+this_file: TODO.md
+---
+
+# TODO
+
+- [ ] Add opt-in live read-only smoke tests with dedicated test credentials.
+- [ ] Track future changes to the Adobe Fonts API reference.
+

typekit2-1.0.0/WORK.md

@@ -0,0 +1,22 @@
+---
+this_file: WORK.md
+---
+
+# Work log
+
+## 2026-09-20
+
+- Audited the Python 2 package, destructive live tests, and setup metadata.
+- Checked current Adobe Fonts authentication, request, parameter, kit, family, and library documentation.
+- Checked current Python Fire, python-dotenv, hatch-vcs, and uv packaging guidance.
+- Renamed the package to `typekit2` and implemented the modern client and CLI.
+- Added offline contract tests before implementation.
+- Added tag-derived versioning and a guarded publish workflow.
+
+### Verification
+
+- `ruff format --check` and `ruff check`: passed.
+- Offline suite: 31 tests passed with 95.67% branch-aware coverage.
+- Fresh `uv build --no-sources`: wheel and sdist built successfully; metadata names `typekit2`, the wheel contains `typekit2/__main__.py` and generated `typekit2/__version__.py`, and no legacy `typekit/` package is present.
+- Installed-artifact smoke test from `/tmp`: both `typekit2 doctor` and `python -m typekit2 doctor` returned redacted JSON.
+- Disposable release rehearsal: `publish.sh` advanced a local test repository from `v0.1.0` to `v0.1.1`, pushed matching branch/tag refs to a local bare remote, built matching artifacts, and skipped only PyPI upload under `PUBLISH_SKIP_UPLOAD=1`.

typekit2-1.0.0/docs/API.md

@@ -0,0 +1,45 @@
+---
+this_file: docs/API.md
+---
+
+# Adobe Fonts API map
+
+The service and URL paths retain the Typekit name even though the product is now Adobe Fonts. The authoritative documentation is the [Adobe Fonts Typekit API reference](https://fonts.adobe.com/docs/api).
+
+## Authentication and transport
+
+Adobe requires authenticated requests to use HTTPS. `typekit2` sends `TYPEKIT_API_KEY` as `X-Typekit-Token`, following the [authentication reference](https://fonts.adobe.com/docs/api/auth). It deliberately avoids the documented query-string fallback because URLs are commonly retained in logs and traces.
+
+Form bodies follow Adobe’s [parameter encoding](https://fonts.adobe.com/docs/api/parameters): repeated values use `name[]`, while family objects use keys such as `families[0][id]`.
+
+## Client methods
+
+| Python method | HTTP endpoint | Notes |
+|---|---|---|
+| `list_kits()` | `GET kits` | Authenticated user’s kits |
+| `get_kit(id)` | `GET kits/:kit` | Current draft |
+| `get_published_kit(id)` | `GET kits/:kit/published` | CDN-published version |
+| `create_kit(...)` | `POST kits` | Creates a draft |
+| `update_kit(...)` | `POST kits/:kit` | Supplied fields replace their current values |
+| `remove_kit(id)` | `DELETE kits/:kit` | Permanent deletion |
+| `publish_kit(id)` | `POST kits/:kit/publish` | Asynchronous publish |
+| `add_font(...)` | `POST kits/:kit/families/:family` | Adds or replaces one family |
+| `remove_font(...)` | `DELETE kits/:kit/families/:family` | Removes one family |
+| `get_font_family(id)` | `GET families/:family` | IDs and slugs are accepted by Adobe |
+| `get_font_variations(id)` | `GET families/:family` | Extracts FVD codes from the response |
+| `list_libraries()` | `GET libraries` | Available font libraries |
+| `get_library(...)` | `GET libraries/:library` | Supports `page` and `per_page` |
+
+Reference pages: [kit manipulation](https://fonts.adobe.com/docs/api/kits), [font families](https://fonts.adobe.com/docs/api/v1/:format/families/:family), [libraries](https://fonts.adobe.com/docs/api/v1/:format/libraries), and [errors](https://fonts.adobe.com/docs/api/errors).
+
+## Important semantics
+
+- Draft changes are not live until `publish_kit` is called.
+- Publishing returns before CDN propagation finishes.
+- When an update parameter is supplied, Adobe replaces that parameter’s existing value.
+- Font variations use Font Variation Description codes such as `n4` and `i7`.
+- `subset` is either `default` or `all`.
+- The legacy analytics option is deprecated by Adobe and is intentionally not exposed.
+
+The upstream documentation is old in vocabulary but remains live and dated © 2026. `typekit2` documents only behavior supported by those current pages.
+

typekit2-1.0.0/publish.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# this_file: publish.sh
+set -euo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")"
+
+die() { printf '%s\n' "$*" >&2; exit 1; }
+command -v uv >/dev/null || die 'uv is required.'
+command -v uvx >/dev/null || die 'uvx is required.'
+[[ "$(git rev-parse --show-prefix)" == "" ]] || die 'Run from the package Git root.'
+git symbolic-ref --quiet HEAD >/dev/null || die 'Release from a branch, not detached HEAD.'
+
+version_file=typekit2/__version__.py
+git check-ignore --no-index -q "$version_file" || die "$version_file must be gitignored."
+
+# Keep source changes for gitnextver to commit; remove only generated version dirt.
+git rm --cached --ignore-unmatch -- "$version_file"
+git clean -fX -- "$version_file" .DS_Store
+uv sync --frozen --all-groups --reinstall-package typekit2
+UV_FROZEN=1 ./test.sh
+git clean -fX -- "$version_file" .DS_Store
+
+# gitnextver stages source changes, creates the next SemVer commit/tag, and pushes.
+uvx gitnextver --directory "$PWD"
+[[ -z "$(git status --porcelain --untracked-files=all)" ]] || die 'gitnextver left uncommitted changes.'
+release_tag=$(git describe --exact-match --tags --match 'v[0-9]*' HEAD) ||
+    die 'gitnextver did not create a release tag.'
+[[ "$release_tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]] || die "Not a SemVer release tag: $release_tag"
+
+# Revalidate because gitnextver may integrate upstream changes before tagging.
+uv sync --frozen --all-groups --reinstall-package typekit2
+UV_FROZEN=1 ./test.sh
+[[ -z "$(git status --porcelain --untracked-files=all)" ]] || die 'Validation dirtied the release tree.'
+
+# Prove branch and tag reached the remote instead of trusting a success banner.
+remote=$(git remote | head -n 1)
+if git remote get-url origin >/dev/null 2>&1; then remote=origin; fi
+if [[ -n "$remote" ]]; then
+    branch=$(git symbolic-ref --short HEAD)
+    git push "$remote" "HEAD:refs/heads/$branch" "refs/tags/$release_tag"
+    remote_head=$(git ls-remote "$remote" "refs/heads/$branch" | cut -f1)
+    remote_tag=$(git ls-remote "$remote" "refs/tags/$release_tag" | cut -f1)
+    [[ "$remote_head" == "$(git rev-parse HEAD)" ]] || die 'Remote branch does not match HEAD.'
+    [[ "$remote_tag" == "$(git rev-parse "refs/tags/$release_tag")" ]] || die 'Remote tag mismatch.'
+fi
+
+# A fresh directory prevents stale dist artifacts from being uploaded.
+release_dist=$(mktemp -d "${TMPDIR:-/tmp}/typekit2-release.XXXXXX")
+trap 'rm -rf -- "$release_dist"' EXIT
+uv build --no-sources --out-dir "$release_dist"
+uv run --frozen python - "$release_tag" "$release_dist" <<'PY'
+import email
+from pathlib import Path
+import sys
+import tarfile
+import zipfile
+
+expected, folder = sys.argv[1].removeprefix("v"), Path(sys.argv[2])
+wheels, sdists = list(folder.glob("*.whl")), list(folder.glob("*.tar.gz"))
+assert len(wheels) == len(sdists) == 1, "Expected one wheel and one sdist"
+with zipfile.ZipFile(wheels[0]) as wheel:
+    metadata_name = next(name for name in wheel.namelist() if name.endswith(".dist-info/METADATA"))
+    assert email.message_from_bytes(wheel.read(metadata_name))["Version"] == expected
+    generated = {}
+    exec(wheel.read("typekit2/__version__.py"), generated)
+    assert generated["__version__"] == expected
+with tarfile.open(sdists[0]) as sdist:
+    metadata_name = next(member for member in sdist.getmembers() if member.name.endswith("/PKG-INFO"))
+    assert email.message_from_bytes(sdist.extractfile(metadata_name).read())["Version"] == expected
+print(f"Verified wheel, sdist, and generated version: {expected}")
+PY
+[[ -z "$(git status --porcelain --untracked-files=all)" ]] || die 'Build dirtied the release tree.'
+mkdir -p dist
+cp "$release_dist"/*.whl "$release_dist"/*.tar.gz dist/
+if [[ "${PUBLISH_SKIP_UPLOAD:-0}" == 1 ]]; then
+    printf 'Validated %s; PUBLISH_SKIP_UPLOAD=1 skips only the package upload.\n' "$release_tag"
+else
+    uv publish "$release_dist"/*.whl "$release_dist"/*.tar.gz "$@"
+    printf 'Published %s.\n' "$release_tag"
+fi
+