kindle-pdf-capture 1.4.2__tar.gz

kindle_pdf_capture-1.4.2/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,58 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug. Please fill in as much detail as possible.
+        バグ報告ありがとうございます。できるだけ詳細をご記入ください。
+
+  - type: input
+    id: macos_version
+    attributes:
+      label: macOS version / macOS バージョン
+      placeholder: "e.g. macOS 14.4"
+    validations:
+      required: true
+
+  - type: input
+    id: python_version
+    attributes:
+      label: Python version / Python バージョン
+      placeholder: "e.g. 3.11.9"
+    validations:
+      required: true
+
+  - type: input
+    id: package_version
+    attributes:
+      label: kindle-pdf-capture version
+      placeholder: "e.g. 0.1.0"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description / 説明
+      description: What happened? What did you expect to happen? / 何が起きましたか？どうなることを期待していましたか？
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce / 再現手順
+      placeholder: |
+        1. Run `kpc --out ...`
+        2. ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error output / エラー出力
+      description: Paste the full error output here. Use `--debug` for more detail.
+      render: shell

kindle_pdf_capture-1.4.2/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,29 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement!
+        改善提案ありがとうございます！
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / 課題
+      description: What problem does this feature solve? / この機能はどんな問題を解決しますか？
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution / 提案する解決策
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered / 検討した代替案

kindle_pdf_capture-1.4.2/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Summary / 概要
+
+- EN:
+- JA:
+
+## Changes / 変更点
+
+-
+
+## Test Plan / テスト計画
+
+- [ ]
+
+## Notes / 補足

kindle_pdf_capture-1.4.2/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5

kindle_pdf_capture-1.4.2/.github/workflows/ci.yml

@@ -0,0 +1,132 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint-and-test:
+    name: Lint & Test (Python ${{ matrix.python-version }})
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v9.0.0
+        with:
+          version: "0.11.32"
+          # Sets UV_PYTHON, which outranks .python-version. Without it every
+          # matrix leg silently falls back to the 3.11 pinned in that file.
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          prune-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install
+
+      - name: Sync dev dependencies
+        run: uv sync --locked --extra dev
+
+      # The job name is not evidence. Fail loudly if the interpreter that was
+      # actually resolved is not the one this leg claims to cover.
+      - name: Verify Python matrix version
+        env:
+          EXPECTED_PYTHON: ${{ matrix.python-version }}
+        run: |
+          uv run --locked python - <<'PY'
+          import os
+          import sys
+
+          actual = f"{sys.version_info.major}.{sys.version_info.minor}"
+          expected = os.environ["EXPECTED_PYTHON"]
+
+          if actual != expected:
+              raise SystemExit(f"expected Python {expected}, got {actual}")
+
+          print(f"Python matrix verified: {actual}")
+          PY
+
+      - name: Ruff lint
+        run: uv run --locked ruff check .
+
+      - name: Ruff format check
+        run: uv run --locked ruff format --check .
+
+      - name: Run tests with coverage
+        run: uv run --locked pytest --cov=kindle_pdf_capture --cov-report=term-missing
+
+  package-smoke:
+    name: Package smoke
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v9.0.0
+        with:
+          version: "0.11.32"
+          python-version: "3.12"
+          enable-cache: true
+          prune-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python 3.12
+        run: uv python install
+
+      - name: Sync dev dependencies
+        run: uv sync --locked --extra dev
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Verify distribution metadata
+        run: uv run --locked python scripts/verify_release_artifacts.py dist
+
+      # Installs the wheel outside the project environment, so a package that
+      # only imports because the source tree happens to be on sys.path fails here.
+      - name: Install the wheel into a clean environment
+        run: |
+          uv venv .release-smoke --python 3.12
+          uv pip install --python .release-smoke/bin/python dist/*.whl
+
+      - name: Check the installed package reports its own version
+        run: |
+          .release-smoke/bin/python - <<'PY'
+          from importlib.metadata import version
+
+          import kindle_pdf_capture
+
+          expected = version("kindle-pdf-capture")
+          assert kindle_pdf_capture.__version__ == expected, (
+              f"runtime version {kindle_pdf_capture.__version__} != metadata {expected}"
+          )
+          print(expected)
+          PY
+
+      - name: Check the console script runs
+        run: .release-smoke/bin/kpc --help
+
+      # PyPI serves the sdist too, so it has to be able to produce the wheel.
+      - name: Rebuild the wheel from the sdist
+        run: |
+          mkdir -p dist-from-sdist
+          uv build dist/*.tar.gz --wheel --out-dir dist-from-sdist
+          uv run --locked python scripts/verify_release_artifacts.py dist-from-sdist --wheel-only
+
+      - name: Install the sdist-built wheel into a clean environment
+        run: |
+          uv venv .sdist-smoke --python 3.12
+          uv pip install --python .sdist-smoke/bin/python dist-from-sdist/*.whl
+          .sdist-smoke/bin/kpc --help

kindle_pdf_capture-1.4.2/.github/workflows/release.yml

@@ -0,0 +1,168 @@
+# Publishes to PyPI through Trusted Publishing (OIDC). No API token is stored.
+#
+# The PyPI publisher is registered against this file's name, the `pypi`
+# environment and this repository, so renaming any of the three breaks
+# publishing until the publisher is re-registered.
+#
+# A tag push is the only trigger: there is deliberately no workflow_dispatch and
+# no branch trigger, so publishing cannot be started by hand or by a fork.
+name: Publish release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+# Nothing is granted by default; each job opts in to the minimum it needs.
+permissions: {}
+
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build and verify
+    runs-on: macos-latest
+    permissions:
+      contents: read
+
+    steps:
+      # Full history: the ancestry check below needs real commits, not a shallow clone.
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+
+      # A tag can be pushed to any commit, including one that was never
+      # reviewed or merged. Matching the version string alone does not prove
+      # the code being published is the code on main.
+      - name: Verify the release commit is on main
+        run: |
+          git fetch --no-tags origin main
+
+          if ! git merge-base --is-ancestor "$GITHUB_SHA" "refs/remotes/origin/main"; then
+            echo "::error::Release tag target $GITHUB_SHA is not contained in origin/main"
+            exit 1
+          fi
+
+          echo "Release tag target is contained in origin/main"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          version: "0.11.32"
+          python-version: "3.12"
+          enable-cache: true
+          prune-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python 3.12
+        run: uv python install
+
+      - name: Sync dev dependencies
+        run: uv sync --locked --extra dev
+
+      # Runs before anything is built: a tag that disagrees with the project
+      # version must never reach the publish job.
+      - name: Verify the tag matches the project version
+        env:
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          uv run --locked python - <<'PY'
+          import os
+          import sys
+          import tomllib
+          from pathlib import Path
+
+          tag = os.environ["TAG_NAME"]
+          version = tomllib.loads(Path("pyproject.toml").read_text())["project"]["version"]
+          expected = f"v{version}"
+
+          if tag != expected:
+              sys.exit(f"tag {tag!r} does not match pyproject version {version!r} (expected {expected!r})")
+
+          print(f"{tag} matches pyproject version {version}")
+          PY
+
+      - name: Ruff lint
+        run: uv run --locked ruff check .
+
+      - name: Ruff format check
+        run: uv run --locked ruff format --check .
+
+      - name: Run tests with coverage
+        run: uv run --locked pytest --cov=kindle_pdf_capture --cov-report=term-missing
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Verify distribution metadata
+        run: uv run --locked python scripts/verify_release_artifacts.py dist
+
+      - name: Install the wheel into a clean environment
+        run: |
+          uv venv .release-smoke --python 3.12
+          uv pip install --python .release-smoke/bin/python dist/*.whl
+
+      - name: Check the installed package reports its own version
+        run: |
+          .release-smoke/bin/python - <<'PY'
+          from importlib.metadata import version
+
+          import kindle_pdf_capture
+
+          expected = version("kindle-pdf-capture")
+          assert kindle_pdf_capture.__version__ == expected, (
+              f"runtime version {kindle_pdf_capture.__version__} != metadata {expected}"
+          )
+          print(expected)
+          PY
+
+      - name: Check the console script runs
+        run: .release-smoke/bin/kpc --help
+
+      - name: Rebuild the wheel from the sdist
+        run: |
+          mkdir -p dist-from-sdist
+          uv build dist/*.tar.gz --wheel --out-dir dist-from-sdist
+          uv run --locked python scripts/verify_release_artifacts.py dist-from-sdist --wheel-only
+
+      - name: Install the sdist-built wheel into a clean environment
+        run: |
+          uv venv .sdist-smoke --python 3.12
+          uv pip install --python .sdist-smoke/bin/python dist-from-sdist/*.whl
+          .sdist-smoke/bin/kpc --help
+
+      # Only the artifacts verified above are handed to the publish job.
+      - name: Upload distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: python-dist
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      # Defaults to this workflow run, so nothing from another run can be pulled in.
+      - name: Download distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: python-dist
+          path: dist
+
+      # No python-version: this job runs no project command, only uv publish.
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          version: "0.11.32"
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always dist/*

kindle_pdf_capture-1.4.2/.gitignore

@@ -0,0 +1,78 @@
+# --- local-only agent/context files (never commit) ---
+CLAUDE.md
+.claude/
+.codex/
+AGENTS.md
+.cursor/
+.aider*
+.github/copilot-instructions.md
+
+# --- python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+dist-from-sdist/
+wheels/
+*.egg-info/
+*.egg
+pip-wheel-metadata/
+share/python-wheels/
+MANIFEST
+
+# --- virtual envs ---
+.venv/
+# per-version envs used to reproduce the CI matrix locally; `.venv/` does not
+# match them, and hatchling then tries to pull one into the sdist and fails
+.venv-*/
+venv/
+ENV/
+env/
+# throwaway envs the packaging smoke checks install into; an sdist build fails
+# outright if a virtualenv is left sitting in the project root
+.release-smoke/
+.sdist-smoke/
+
+# --- uv ---
+# uv.lock IS committed; ignore cache only
+.uv-cache/
+
+# --- test/coverage ---
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+
+# --- lint/format ---
+.ruff_cache/
+.mypy_cache/
+.pytype/
+.pyre/
+
+# --- editors ---
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# --- macOS ---
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# --- project output (captures/PDFs are user data, not source) ---
+output/
+*.pdf
+!docs/**/*.pdf
+
+# --- logs ---
+*.log
+logs/

kindle_pdf_capture-1.4.2/.python-version

@@ -0,0 +1 @@
+3.11