onescad 0.1.0__tar.gz

onescad-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,32 @@
+name: Bug report
+description: onescad fails on a model or produces a bundle that renders differently.
+labels: [bug]
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: The command you ran, what you expected, and what you got instead.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: onescad version
+      description: Output of `onescad --version`.
+    validations:
+      required: true
+  - type: input
+    id: openscad
+    attributes:
+      label: OpenSCAD version
+      description: Output of `openscad --version`, if the bug involves rendering or `--verify`.
+    validations:
+      required: false
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal reproduction
+      description: A small .scad model that triggers the bug, if you can share one.
+    validations:
+      required: false

onescad-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

onescad-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,18 @@
+name: Feature request
+description: Propose a change to onescad's behavior or CLI.
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What you are trying to do that onescad does not support today.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed change
+      description: What you would like to see, and why it fits bundling one model into one file.
+    validations:
+      required: true

onescad-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,6 @@
+## Checklist
+
+- [ ] `uv run ruff check` and `uv run ruff format --check` pass
+- [ ] `uv run mypy` and `uv run pytest` pass
+- [ ] A fixture or test covers the behavior this PR changes
+- [ ] `uv run pytest -m oracle --no-cov` passes if the bundle's output could change

onescad-0.1.0/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+
+  - package-ecosystem: gitsubmodule
+    directory: /
+    schedule:
+      interval: weekly

onescad-0.1.0/.github/workflows/check.yml

@@ -0,0 +1,62 @@
+name: check
+on:
+  push:
+  pull_request:
+permissions:
+  contents: read
+jobs:
+  check:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.11', '3.14']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          submodules: true
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+      - run: uv sync --locked --python ${{ matrix.python-version }}
+      - run: uv run ruff check
+      - run: uv run ruff format --check
+      - run: uv run mypy
+      - run: uv run pytest
+
+  oracle:
+    runs-on: ubuntu-latest
+    env:
+      OPENSCAD_VERSION: '2026.09.23'
+      OPENSCAD_SHA256: 033762f4e0b0de7a2c6cf2b5a12febb29d60ba62ede227d57b1c8b675a94710a
+      APPIMAGE_EXTRACT_AND_RUN: '1'
+      QT_QPA_PLATFORM: offscreen
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          submodules: true
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+      - name: Install OpenSCAD
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends libegl1 libopengl0 libgl1 libglu1-mesa libxkbcommon0 libfontconfig1 libdbus-1-3
+          curl -fsSL -o openscad "https://files.openscad.org/snapshots/OpenSCAD-${OPENSCAD_VERSION}-x86_64.AppImage"
+          echo "${OPENSCAD_SHA256}  openscad" | sha256sum -c -
+          chmod +x openscad
+          mkdir -p "$HOME/.local/bin"
+          mv openscad "$HOME/.local/bin/openscad"
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+      - run: openscad --version
+      - run: uv sync --locked
+      - run: uv run pytest -m oracle --no-cov
+
+  release-check:
+    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
+      - run: uv build
+      - run: uvx twine check dist/*
+      - run: uvx zizmor==1.30.1 .github/workflows

onescad-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: publish
+on:
+  release:
+    types: [published]
+permissions:
+  contents: read
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    env:
+      RELEASE_TAG: ${{ github.event.release.tag_name }}
+      RELEASE_NAME: ${{ github.event.release.name }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - run: sh scripts/check-release.sh "$RELEASE_TAG" "$RELEASE_NAME"
+  publish:
+    needs: verify
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    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
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

onescad-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

onescad-0.1.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "tests/corpus/BOSL2"]
+	path = tests/corpus/BOSL2
+	url = https://github.com/BelfrySCAD/BOSL2

onescad-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+First release. `onescad INPUT -o OUTPUT [-L DIR]... [--verify]` bundles an OpenSCAD model and
+everything it includes or uses into one `.scad` file that keeps the Customizer working, copies a
+neighboring presets file, and embeds each contributing license.

onescad-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing
+
+## Setup and checks
+
+```sh
+git submodule update --init
+uv sync --locked
+uv run ruff check
+uv run ruff format --check
+uv run mypy
+uv run pytest
+```
+
+`tests/corpus/BOSL2` is a submodule pinned to the BOSL2 revision the parser tests run against.
+`pytest` fails under 90% coverage.
+
+The oracle tests render the source and the bundle with a real `openscad` and skip without one.
+CI runs them against a pinned OpenSCAD 2026.09.23 AppImage. Locally:
+
+```sh
+uv run pytest -m oracle --no-cov
+```
+
+Each fixture under `tests/fixtures/<case>/` holds a `main.scad` and a golden `expected.scad`,
+or an `error.txt` for a case that must fail. Regenerate goldens with
+`ONESCAD_UPDATE_GOLDEN=1`. A defect found in review is fixed with a fixture or test for its
+class, not only its instance.
+
+CI also runs `uv build`, `twine check`, and `zizmor` over the workflows.
+
+## Releasing
+
+```sh
+sh scripts/release.sh [--dry-run] <version>
+```
+
+`<version>` is bare (`0.1.0`, not `v0.1.0`). Run it on a clean, synced `main` with `gh` and `uv`
+installed. The script runs the same checks CI runs, opens a `release-<version>` PR that sets the
+version in `pyproject.toml`, `src/onescad/__init__.py`, and `uv.lock`, waits for its checks, and
+squash-merges it. GitHub signs the squash commit, so the release shows as Verified. It then
+tags the merged commit and creates the GitHub release from the matching `CHANGELOG.md` section;
+add a `## <version>` heading there first. If the bump is already on `main`, it skips the PR and
+only tags and releases, so a run that stopped after the merge can be repeated. `--dry-run` runs
+every check and prints each mutating command instead of running it.
+
+The release event triggers `publish.yml`, which re-runs `scripts/check-release.sh` (the tag, its
+title, and the `CHANGELOG.md` heading must all agree) before building and publishing to PyPI
+through a trusted publisher.
+
+## Scope
+
+onescad is a single-maintainer project with no runtime dependencies. It bundles one model into
+one file and checks the result. PRs that add a runtime dependency or reach past that are
+declined. Bug reports and fixes are welcome.

onescad-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kamil Jiwa
+
+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.

onescad-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: onescad
+Version: 0.1.0
+Summary: Bundle an OpenSCAD model into one customizer-ready file
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# onescad
+
+Bundle an OpenSCAD model into one self-contained, Customizer-ready `.scad` file.
+
+```sh
+uvx onescad model.scad -o dist/model.scad
+```
+
+The bundle renders identically to the source, keeps the Customizer's parameters, groups, and
+widgets, and carries the license text of every file it takes code from. Python 3.11 or newer;
+no runtime dependencies.
+
+## Usage
+
+```
+onescad INPUT -o OUTPUT [-L DIR]... [--verify] [--version]
+```
+
+| Option | Meaning |
+| --- | --- |
+| `INPUT` | The model's `.scad` file. |
+| `-o`, `--output` | The bundle to write. Parent directories are created. |
+| `-L`, `--library DIR` | A directory to search for `include` and `use`; repeatable. |
+| `--verify` | Render the source and the bundle with `openscad` and compare them. |
+| `--version` | Print the version. |
+
+Warnings print to stderr as `onescad: warning: <message>`. Errors print as `onescad: <message>`.
+
+| Exit code | Meaning |
+| --- | --- |
+| 0 | The bundle was written (and verified, with `--verify`). |
+| 1 | The bundle could not be built or verified. |
+| 2 | Usage error. |
+
+## Search path
+
+`include` and `use` are resolved in this order: the including file's directory, each `-L`
+directory, then each `OPENSCADPATH` entry. OpenSCAD also searches the user and built-in library
+directories; onescad does not, so a bundle is the same on every machine. Put those libraries on
+`-L` or `OPENSCADPATH`. A missing file is an error that lists the directories searched.
+
+## What gets bundled
+
+The output has these parts, in order:
+
+1. A header of `//` comments:
+   - the onescad version, marked as generated;
+   - the source path relative to its git root, the remote as an https URL, and the commit, with
+     `+dirty` when tracked files have uncommitted changes (omitted outside a git work tree with a
+     commit);
+   - the main file's leading comment;
+   - the fonts named by `font=` strings, the files read by `import()` or `surface()`, and a note
+     naming the presets file, when they apply;
+   - for each license file covering code that was kept, its directory and its text verbatim. The
+     license file is the nearest `LICENSE*`, `LICENCE*`, or `COPYING*` in an ancestor directory of
+     each source file.
+2. The Customizer parameters, hoisted to the top.
+3. A `/* [Hidden] */` marker, so nothing after it appears in the Customizer.
+4. Each used file's definitions, dependencies first, each preceded by a `// onescad: <path>` marker
+   and the file's leading comment.
+5. The main file, with its included files spliced in.
+
+The output has no timestamps, so the same input gives byte-identical output.
+
+Definitions that the model never reaches are dropped. A definition is renamed (`name__1`) when
+keeping its name would capture a different reference, as when a library wraps a builtin it later
+overrides.
+
+## Presets
+
+If `model.json` sits next to `model.scad`, onescad copies it verbatim to the output's name with a
+`.json` extension (`dist/model.json` for `-o dist/model.scad`). OpenSCAD loads presets only from a
+`.json` beside the `.scad`, so keep the two together. A warning names each preset key that is not a
+Customizer parameter of the bundle.
+
+## Verification
+
+`--verify` needs `openscad` on `PATH`. It compares the source with the bundle on:
+
+- the CSG of the default parameters and of every preset;
+- the `ECHO` lines, after undoing renames;
+- the Customizer parameter set (`-o x.param`, ignoring `title`).
+
+The bundle renders with `OPENSCADPATH` unset and an empty `HOME`, which proves it is
+self-contained. `text()` fonts are not compared. Verifying needs an OpenSCAD that can export
+`param` (the 2026.09 snapshots do; 2021.01 is untested).
+
+## Limitations
+
+- The Customizer is emulated, not run. A model whose parameter assignment reads a name before
+  that name's first assignment cannot be hoisted; onescad stops with an error.
+- A top-level `$` variable in a used file, conflicting definitions that cannot be renamed, and a
+  rename that would split a call's possible targets are errors.
+- A top-level variable in a used file is evaluated once in the bundle, not on every call as
+  OpenSCAD does; onescad warns.
+- `import()` and `surface()` still read their files at render time; onescad warns and lists them
+  in the header. Relative paths then resolve against wherever the bundle is rendered.
+- Fonts are not embedded; the header lists those that `font=` names.
+- A model's license text appears in the header only when a license file covers its source.
+  onescad warns about each source file with none.
+
+## License
+
+MIT. See `LICENSE`. Bundles carry the licenses of their inputs; check them before redistributing.

onescad-0.1.0/README.md

@@ -0,0 +1,104 @@
+# onescad
+
+Bundle an OpenSCAD model into one self-contained, Customizer-ready `.scad` file.
+
+```sh
+uvx onescad model.scad -o dist/model.scad
+```
+
+The bundle renders identically to the source, keeps the Customizer's parameters, groups, and
+widgets, and carries the license text of every file it takes code from. Python 3.11 or newer;
+no runtime dependencies.
+
+## Usage
+
+```
+onescad INPUT -o OUTPUT [-L DIR]... [--verify] [--version]
+```
+
+| Option | Meaning |
+| --- | --- |
+| `INPUT` | The model's `.scad` file. |
+| `-o`, `--output` | The bundle to write. Parent directories are created. |
+| `-L`, `--library DIR` | A directory to search for `include` and `use`; repeatable. |
+| `--verify` | Render the source and the bundle with `openscad` and compare them. |
+| `--version` | Print the version. |
+
+Warnings print to stderr as `onescad: warning: <message>`. Errors print as `onescad: <message>`.
+
+| Exit code | Meaning |
+| --- | --- |
+| 0 | The bundle was written (and verified, with `--verify`). |
+| 1 | The bundle could not be built or verified. |
+| 2 | Usage error. |
+
+## Search path
+
+`include` and `use` are resolved in this order: the including file's directory, each `-L`
+directory, then each `OPENSCADPATH` entry. OpenSCAD also searches the user and built-in library
+directories; onescad does not, so a bundle is the same on every machine. Put those libraries on
+`-L` or `OPENSCADPATH`. A missing file is an error that lists the directories searched.
+
+## What gets bundled
+
+The output has these parts, in order:
+
+1. A header of `//` comments:
+   - the onescad version, marked as generated;
+   - the source path relative to its git root, the remote as an https URL, and the commit, with
+     `+dirty` when tracked files have uncommitted changes (omitted outside a git work tree with a
+     commit);
+   - the main file's leading comment;
+   - the fonts named by `font=` strings, the files read by `import()` or `surface()`, and a note
+     naming the presets file, when they apply;
+   - for each license file covering code that was kept, its directory and its text verbatim. The
+     license file is the nearest `LICENSE*`, `LICENCE*`, or `COPYING*` in an ancestor directory of
+     each source file.
+2. The Customizer parameters, hoisted to the top.
+3. A `/* [Hidden] */` marker, so nothing after it appears in the Customizer.
+4. Each used file's definitions, dependencies first, each preceded by a `// onescad: <path>` marker
+   and the file's leading comment.
+5. The main file, with its included files spliced in.
+
+The output has no timestamps, so the same input gives byte-identical output.
+
+Definitions that the model never reaches are dropped. A definition is renamed (`name__1`) when
+keeping its name would capture a different reference, as when a library wraps a builtin it later
+overrides.
+
+## Presets
+
+If `model.json` sits next to `model.scad`, onescad copies it verbatim to the output's name with a
+`.json` extension (`dist/model.json` for `-o dist/model.scad`). OpenSCAD loads presets only from a
+`.json` beside the `.scad`, so keep the two together. A warning names each preset key that is not a
+Customizer parameter of the bundle.
+
+## Verification
+
+`--verify` needs `openscad` on `PATH`. It compares the source with the bundle on:
+
+- the CSG of the default parameters and of every preset;
+- the `ECHO` lines, after undoing renames;
+- the Customizer parameter set (`-o x.param`, ignoring `title`).
+
+The bundle renders with `OPENSCADPATH` unset and an empty `HOME`, which proves it is
+self-contained. `text()` fonts are not compared. Verifying needs an OpenSCAD that can export
+`param` (the 2026.09 snapshots do; 2021.01 is untested).
+
+## Limitations
+
+- The Customizer is emulated, not run. A model whose parameter assignment reads a name before
+  that name's first assignment cannot be hoisted; onescad stops with an error.
+- A top-level `$` variable in a used file, conflicting definitions that cannot be renamed, and a
+  rename that would split a call's possible targets are errors.
+- A top-level variable in a used file is evaluated once in the bundle, not on every call as
+  OpenSCAD does; onescad warns.
+- `import()` and `surface()` still read their files at render time; onescad warns and lists them
+  in the header. Relative paths then resolve against wherever the bundle is rendered.
+- Fonts are not embedded; the header lists those that `font=` names.
+- A model's license text appears in the header only when a license file covers its source.
+  onescad warns about each source file with none.
+
+## License
+
+MIT. See `LICENSE`. Bundles carry the licenses of their inputs; check them before redistributing.

onescad-0.1.0/SECURITY.md

@@ -0,0 +1,14 @@
+# Security
+
+onescad reads the `.scad` files that a model includes or uses, the license files beside them,
+and a neighboring presets `.json`. It runs `git` to read the source's remote and commit, and,
+with `--verify`, `openscad`. It writes the bundle and a copy of the presets file. It makes no
+network requests and sends no telemetry. A bundle embeds the remote URL of the repository it
+was built from.
+
+## Reporting a vulnerability
+
+Please use
+[GitHub's private vulnerability reporting](https://github.com/kjiwa/onescad/security/advisories/new)
+for this repository rather than opening a public issue. If that option isn't available yet,
+email kamil.jiwa@gmail.com instead.

onescad-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "onescad"
+version = "0.1.0"
+description = "Bundle an OpenSCAD model into one customizer-ready file"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+dependencies = []
+
+[project.scripts]
+onescad = "onescad.cli:main"
+
+[dependency-groups]
+dev = ["pytest", "pytest-cov", "mypy", "ruff"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/onescad"]
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+extend-exclude = ["tests/corpus"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "S", "SIM", "RUF"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101"]
+
+[tool.mypy]
+strict = true
+files = ["src", "tests"]
+exclude = ["tests/corpus/"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=onescad --cov-report=term-missing"
+markers = ["oracle: compares against a real openscad run"]
+
+[tool.coverage.report]
+fail_under = 90

onescad-0.1.0/scripts/check-release.sh

@@ -0,0 +1,82 @@
+#!/bin/sh
+# Check that a release's tag and title match the version in pyproject.toml
+# and that CHANGELOG.md has a matching heading, so a hand-cut release
+# cannot drift the way v0.1.7 did.
+#
+# Usage: sh scripts/check-release.sh <tag> <title>
+#        sh scripts/check-release.sh --changelog <tag>
+#
+# --changelog checks only the CHANGELOG heading, for use before the version
+# bump has landed in pyproject.toml.
+set -eu
+
+_check_tag_shape() {
+  _check_tag_shape_tag=$1
+  if ! echo "$_check_tag_shape_tag" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
+    echo "check-release: tag '$_check_tag_shape_tag' does not match vX.Y.Z" >&2
+    return 1
+  fi
+}
+
+_check_tag_matches_version() {
+  _check_tag_matches_version_tag=$1
+  _check_tag_matches_version_version=$(sed -n 's/^version = "\(.*\)"$/\1/p' "$PYPROJECT" | head -n1)
+  if [ -z "$_check_tag_matches_version_version" ]; then
+    echo "check-release: could not read version from $PYPROJECT" >&2
+    return 1
+  fi
+  if [ "$_check_tag_matches_version_tag" != "v$_check_tag_matches_version_version" ]; then
+    echo "check-release: tag '$_check_tag_matches_version_tag' does not match pyproject.toml version '$_check_tag_matches_version_version'" >&2
+    return 1
+  fi
+}
+
+_check_title_matches_tag() {
+  _check_title_matches_tag_tag=$1
+  _check_title_matches_tag_title=$2
+  if [ "$_check_title_matches_tag_title" != "$_check_title_matches_tag_tag" ]; then
+    echo "check-release: title '$_check_title_matches_tag_title' does not match tag '$_check_title_matches_tag_tag'" >&2
+    return 1
+  fi
+}
+
+_check_changelog_heading() {
+  _check_changelog_heading_tag=$1
+  _check_changelog_heading_version=${_check_changelog_heading_tag#v}
+  if ! grep -Fxq "## $_check_changelog_heading_version" "$CHANGELOG"; then
+    echo "check-release: CHANGELOG.md has no '## $_check_changelog_heading_version' heading" >&2
+    return 1
+  fi
+}
+
+main() {
+  REPO_ROOT=$(CDPATH='' cd -- "$(dirname -- "$0")/.." && pwd)
+  readonly REPO_ROOT
+  readonly PYPROJECT="$REPO_ROOT/pyproject.toml"
+  readonly CHANGELOG="$REPO_ROOT/CHANGELOG.md"
+
+  if [ $# -eq 2 ] && [ "$1" = "--changelog" ]; then
+    _check_changelog_heading "$2"
+    exit $?
+  fi
+  if [ $# -ne 2 ]; then
+    echo "usage: sh scripts/check-release.sh <tag> <title>" >&2
+    echo "       sh scripts/check-release.sh --changelog <tag>" >&2
+    exit 2
+  fi
+
+  _main_tag=$1
+  _main_title=$2
+  _main_status=0
+
+  _check_tag_shape "$_main_tag" || _main_status=1
+  if [ "$_main_status" -eq 0 ]; then
+    _check_tag_matches_version "$_main_tag" || _main_status=1
+  fi
+  _check_title_matches_tag "$_main_tag" "$_main_title" || _main_status=1
+  _check_changelog_heading "$_main_tag" || _main_status=1
+
+  exit "$_main_status"
+}
+
+main "$@"