Release 0.2.0

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,38 @@
+name: Bug report
+description: Something behaves differently from what the documentation says.
+labels: [bug]
+body:
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened?
+      description: What you did, what you expected, and what you got instead.
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal reproduction
+      description: The smallest code that shows the problem, including the decorator and how it is called (sync, async, method).
+      render: python
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: python-wrap version
+      description: "Run: python -c 'import python_wrap; print(python_wrap.__version__)'"
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version and operating system
+      placeholder: "3.13.1 on Windows 11"
+    validations:
+      required: true
+  - type: textarea
+    id: traceback
+    attributes:
+      label: Traceback or log output
+      render: text

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/LitePy/PythonWrap/security/advisories/new
+    about: Please report security issues privately, not in a public issue.
+  - name: Documentation
+    url: https://python-wrap.readthedocs.io
+    about: Check the docs first; most questions are answered there.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,27 @@
+name: Feature request
+description: Suggest a new decorator or an option on an existing one.
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem are you trying to solve?
+      description: The situation first, not the solution.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: What would you like to write?
+      description: A sketch of the API as you would want to call it.
+      render: python
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other libraries or hand-written code you tried, and why they fall short.
+  - type: markdown
+    attributes:
+      value: |
+        python-wrap has no runtime dependencies and supports sync and async code,
+        so proposals are weighed against both.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+## What and why
+
+<!-- What does this change, and what motivated it? Link the issue if there is one. -->
+
+## Checklist
+
+- [ ] Tests added or updated (sync and async paths; use `fake_clock` rather than real sleeps)
+- [ ] `uv run pytest` passes
+- [ ] `uv run ruff check src tests` and `uv run ruff format --check src tests` pass
+- [ ] `uv run mypy` passes
+- [ ] Public functions have Google-style docstrings
+- [ ] `CHANGELOG.md` updated under `Unreleased`

.github/dependabot.yml

@@ -0,0 +1,26 @@
+# Keeps the pinned GitHub Actions and the lockfile moving, in as few pull requests as
+# possible. Grouped, weekly: they are reviewed together and it keeps the queue readable.
+version: 2
+
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      actions:
+        patterns: ["*"]
+    commit-message:
+      prefix: "ci"
+
+  # Refreshes uv.lock, which pins the dev and docs tooling (the package itself has no
+  # runtime dependencies).
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      dev-tooling:
+        patterns: ["*"]
+    commit-message:
+      prefix: "deps"

.github/workflows/ci.yml

@@ -0,0 +1,147 @@
+# Continuous integration.
+#
+# Four jobs: lint (seconds), the test matrix, mypy, and a packaging check.
+#
+# python-wrap is pure Python with no dependencies, so the matrix is wide rather than
+# deep: every interpreter the classifiers name, on all three operating systems. Time and
+# threading behave differently on Windows (coarser clocks) and macOS (spawn, not fork),
+# and a decorator library that schedules, throttles and times things is exactly where
+# that shows up.
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+# A force-push should not leave the previous run burning minutes on a dead commit.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  lint:
+    name: ruff
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.13"
+
+      - run: uv sync --group dev --frozen
+
+      - name: ruff check
+        run: uv run --no-sync ruff check src tests
+
+      - name: ruff format
+        run: uv run --no-sync ruff format --check --diff src tests
+
+  test:
+    name: py${{ matrix.python-version }} · ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      # One red cell should not hide the other fourteen.
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: ${{ matrix.python-version }}
+
+      - run: uv sync --group dev --frozen
+
+      - name: pytest
+        run: uv run --no-sync pytest --cov --cov-report=term-missing --cov-report=xml
+
+      # One coverage report is enough; it is the same code on every cell. Keeping it as an
+      # artifact (rather than a third-party upload) needs no token and cannot fail the
+      # build for a reason unrelated to the code.
+      - name: Upload the coverage report
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage
+          path: coverage.xml
+          if-no-files-found: warn
+
+  typecheck:
+    name: mypy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.13"
+
+      - run: uv sync --group dev --frozen
+
+      # Strict mode, configured in pyproject.toml; `files` already points at src/.
+      - name: mypy
+        run: uv run --no-sync mypy
+
+  build:
+    name: build & wheel contents
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.13"
+
+      - name: Build the sdist and wheel
+        run: uv build
+
+      - name: twine check
+        run: uvx twine check --strict dist/*
+
+      # The package ships `py.typed` so that type checkers use its annotations. A wheel
+      # that drops it still imports and still passes twine, and silently turns every
+      # downstream user's types into `Any`.
+      - name: The wheel ships py.typed
+        run: |
+          python3 -m zipfile -l dist/*.whl | tee wheel-listing.txt
+          grep -q 'python_wrap/py.typed' wheel-listing.txt
+
+      # Install the built wheel, not the source tree, into an empty venv and run from a
+      # scratch directory so `src/` cannot stand in for anything the wheel left out.
+      - name: Install the wheel into a clean environment
+        run: |
+          uv venv "$RUNNER_TEMP/smoke" --python 3.13
+          uv pip install --python "$RUNNER_TEMP/smoke" dist/*.whl
+          cd "$RUNNER_TEMP"
+          "$RUNNER_TEMP/smoke/bin/python" -c "import python_wrap; print(python_wrap.__version__)"
+
+      - name: Upload the distributions
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+# Build check for the documentation site.
+#
+# Read the Docs does the hosting (see .readthedocs.yaml). This workflow only catches
+# breakage before it gets there: `--strict` turns a broken link, a page missing from the
+# nav or a docstring mkdocstrings cannot render into a failed check on the pull request.
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  build:
+    name: mkdocs build --strict
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.13"
+
+      # The package itself is installed too, because mkdocstrings reads the docstrings
+      # from it. The dev group is included because some examples are pytest tests.
+      - run: uv sync --frozen --no-default-groups --group docs --group dev
+
+      - name: Build the site
+        run: uv run --no-sync mkdocs build --strict
+        env:
+          NO_MKDOCS_2_WARNING: "1"
+
+      # Every ```python block in docs/ is executed, so an example that drifts from the
+      # real API fails review instead of misleading a reader.
+      - name: Run the documentation examples
+        run: uv run --no-sync python scripts/check_docs_examples.py