Merge branch 'master' into update-readme

Author: bosd

.github/workflows/constraints.txt

@@ -1,4 +1,4 @@
 lockfile<0.13.0,>=0.12.2
 pip==25.0.1
-nox==2025.2.9
-virtualenv==20.29.3
+nox==2025.5.1
+virtualenv==20.33.1

.github/workflows/dependabot_auto_approve.yml

@@ -0,0 +1,29 @@
+name: Dependabot Auto-Approve
+
+on:
+  pull_request_target: # Use pull_request_target to get write permissions for approval
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+permissions:
+  pull-requests: write # Needed to approve PRs
+
+jobs:
+  auto-approve:
+    runs-on: ubuntu-latest
+    # Only run for PRs authored by dependabot[bot]
+    if: github.actor == 'dependabot[bot]' || github.actor == 'dependabot'
+    steps:
+      - name: Checkout code (not strictly necessary for just approval)
+        uses: actions/checkout@v4
+        # no further steps needed for just approval
+
+      - name: Auto-approve Dependabot PR
+        run: |
+          gh pr review --approve "$PR_URL"
+          echo "Approved Dependabot PR: $PR_URL"
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR_URL: ${{ github.event.pull_request.html_url }}

.github/workflows/labeler.yml

@@ -13,6 +13,6 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Run Labeler
-        uses: crazy-max/ghaction-github-labeler@v5.2.0
+        uses: crazy-max/ghaction-github-labeler@v5.3.0
         with:
           skip-delete: true

.github/workflows/release.yml

@@ -1,95 +1,75 @@
-name: Publish Python 🐍 distribution 📦 to PyPI
+name: Release Drafter and Publish Python 🐍 distribution 📦 to PyPI
 
-on: push
+on:
+  push:
+    branches:
+      - master
+  release:
+    types: [published]
 
 jobs:
-  build:
-    name: Build distribution 📦
+  release-drafter:
+    name: Draft Release Notes
     runs-on: ubuntu-latest
-
+    if: github.event_name == 'push'
+    permissions:
+      contents: write
+      pull-requests: write
     steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.x"
-      - name: Install pypa/build
-        run: >-
-          python3 -m
-          pip install
-          build
-          --user
-      - name: Build a binary wheel and a source tarball
-        run: python3 -m build
-      - name: Store the distribution packages
-        uses: actions/upload-artifact@v4
+      - name: Draft Release
+        uses: release-drafter/release-drafter@v6
         with:
-          name: python-package-distributions
-          path: dist/
+          publish: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-  publish-to-pypi:
-    name: >-
-      Publish Python 🐍 distribution 📦 to PyPI
-    if: startsWith(github.ref, 'refs/tags/') # only publish to PyPI on tag pushes
-    needs:
-      - build
+  build-and-publish:
+    name: Build, Sign, and Publish to PyPI 📦
     runs-on: ubuntu-latest
+    if: github.event_name == 'release'
     environment:
       name: pypi
       url: https://pypi.org/p/camelot-py
     permissions:
-      id-token: write # IMPORTANT: mandatory for trusted publishing
-
+      id-token: write
+      contents: write
     steps:
-      - name: Download all the dists
-        uses: actions/download-artifact@v4
+      - name: Checkout repository
+        uses: actions/checkout@v4
         with:
-          name: python-package-distributions
-          path: dist/
-      - name: Publish distribution 📦 to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+          ref: ${{ github.event.release.tag_name }}
+          fetch-depth: 0
 
-  github-release:
-    name: >-
-      Sign the Python 🐍 distribution 📦 with Sigstore
-      and upload them to GitHub Release
-    needs:
-      - publish-to-pypi
-    runs-on: ubuntu-latest
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
 
-    permissions:
-      contents: write # IMPORTANT: mandatory for making GitHub Releases
-      id-token: write # IMPORTANT: mandatory for sigstore
+      - name: Install build dependencies
+        run: python -m pip install build
+
+      - name: Build a binary wheel and a source tarball
+        run: python -m build
 
-    steps:
-      - name: Download all the dists
-        uses: actions/download-artifact@v4
-        with:
-          name: python-package-distributions
-          path: dist/
       - name: Sign the dists with Sigstore
-        uses: sigstore/[email protected].0
+        uses: sigstore/[email protected].1
         with:
           inputs: >-
             ./dist/*.tar.gz
             ./dist/*.whl
-      - name: Create GitHub Release
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-        run: >-
-          gh release create
-          "$GITHUB_REF_NAME"
-          --repo "$GITHUB_REPOSITORY"
-          --notes ""
+
       - name: Upload artifact signatures to GitHub Release
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        # Upload to GitHub Release using the `gh` CLI.
-        # `dist/` contains the built packages, and the
-        # sigstore-produced signatures and certificates.
         run: >-
           gh release upload
-          "$GITHUB_REF_NAME" dist/**
+          "${{ github.event.release.tag_name }}" ./dist/*
           --repo "$GITHUB_REPOSITORY"
+
+      - name: Remove Sigstore files
+        run: rm -f dist/*.sig dist/*.crt dist/*.sigstore.json
+
+      - name: Publish Python 🐍 distribution 📦 to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: "dist"

.github/workflows/tests.yml

@@ -31,7 +31,7 @@ jobs:
           - { python: "3.10", os: "macos-latest", session: "tests" }
           - { python: "3.10", os: "ubuntu-latest", session: "typeguard" }
           - { python: "3.10", os: "ubuntu-latest", session: "xdoctest" }
-          - { python: "3.10", os: "ubuntu-latest", session: "docs-build" }
+          - { python: "3.13", os: "ubuntu-latest", session: "docs-build" }
 
     env:
       NOXSESSION: ${{ matrix.session }}
@@ -62,7 +62,7 @@ jobs:
               print(f"VIRTUALENV_PIP={pip.__version__}", file=io)
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
 
       - name: Install Nox
         run: |
@@ -149,15 +149,15 @@ jobs:
           pip --version
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
 
       - name: Install Nox
         run: |
           pipx install --pip-args=--constraint=${PWD}/.github/workflows/constraints.txt nox
           nox --version
 
       - name: Download coverage data
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           pattern: coverage-data-*
           merge-multiple: true

.readthedocs.yml

@@ -2,7 +2,7 @@ version: 2
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.10"
+    python: "3.13"
 sphinx:
   configuration: docs/conf.py
 formats: all

README.md

@@ -16,7 +16,7 @@
 
 Try it yourself in our interactive quickstart notebook. [![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/camelot-dev/camelot/blob/master/examples/camelot-quickstart-notebook.ipynb)
 
-Or check out a simple example using [this pdf](https://github.com/camelot-dev/camelot/blob/main/docs/_static/pdf/foo.pdf).
+Or check out a simple example using [this pdf](https://github.com/camelot-dev/camelot/blob/master/docs/_static/pdf/foo.pdf).
 
 <pre>
 >>> import camelot
@@ -48,7 +48,7 @@ Or check out a simple example using [this pdf](https://github.com/camelot-dev/ca
 
 Camelot also comes packaged with a [command-line interface](https://camelot-py.readthedocs.io/en/latest/user/cli.html)!
 
-Refer to the [QuickStart Guide](https://github.com/camelot-dev/camelot/blob/main/docs/user/quickstart.rst#quickstart) to quickly get started with Camelot, extract tables from PDFs and explore some basic options.
+Refer to the [QuickStart Guide](https://github.com/camelot-dev/camelot/blob/master/docs/user/quickstart.rst#quickstart) to quickly get started with Camelot, extract tables from PDFs and explore some basic options.
 
 **Tip:** Visit the `parser-comparison-notebook` to get an overview of all the packed parsers and their features. [![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/camelot-dev/camelot/blob/master/examples/parser-comparison-notebook.ipynb)
 
@@ -124,3 +124,4 @@ Camelot uses [Semantic Versioning](https://semver.org/). For the available versi
 This project is licensed under the MIT License, see the [LICENSE](https://github.com/camelot-dev/camelot/blob/master/LICENSE) file for details.
 
 The documentation theme is licensed under a seperate BSD-like License, see the [LICENSE](https://github.com/camelot-dev/camelot/blob/master/docs/_themes/LICENSE) file for details.
+

camelot/__init__.py

@@ -1,10 +1,23 @@
+import importlib.metadata
 import logging
+from typing import Optional
 
-from .__version__ import __version__  # noqa D100, F400
 from .io import read_pdf
 from .plotting import PlotMethods
 
 
+def get_version() -> Optional[str]:
+    """Retrieve the version number from package metadata."""
+    try:
+        return importlib.metadata.version("camelot-py")
+    except importlib.metadata.PackageNotFoundError:
+        # Fallback for development environments
+        return "0.0.0+unknown"
+
+
+__version__ = get_version()
+
+
 # set up logging
 logger = logging.getLogger("camelot")
 

camelot/__version__.py

@@ -12,7 +12,9 @@
 else:
     _HAS_MPL = True
 
-from . import __version__
+import importlib.metadata
+from typing import Optional
+
 from . import plot
 from . import read_pdf
 
@@ -21,6 +23,18 @@
 logger.setLevel(logging.INFO)
 
 
+def get_version() -> Optional[str]:
+    """Get the version information."""
+    try:
+        return importlib.metadata.version("camelot-py")
+    except importlib.metadata.PackageNotFoundError:
+        # Package is not installed in editable mode or in the current environment
+        return None
+
+
+__version__ = get_version() or "0.0.0+unknown"
+
+
 class Config:
     """Class method for creating a new class."""