Rename import

Remove de_json depr test
Merge master and fix conflicts, and remove de_json's
2026-06-19 15:45:13 +00:00 · 2026-06-09 22:43:24 -04:00 · 2026-06-09 21:35:28 -04:00 · 2026-06-09 21:28:38 -04:00 · 2026-06-09 11:49:15 -04:00 · 2026-06-01 04:01:27 +00:00
705 changed files with 21483 additions and 10456 deletions
@@ -37,7 +37,7 @@ Setting things up

   .. code-block:: bash

-      $ pre-commit install
+      $ prek install -f

 Finding something to do
 =======================
@@ -100,7 +100,7 @@ Here's how to make a one-off code change.

     .. code-block:: bash

-        $ pre-commit run -a
+        $ prek run -a

   - To actually make the commit (this will trigger tests style & type checks automatically):

@@ -32,7 +32,7 @@ The repository follows a standard structure for Python projects. Here are some k
 - Read the stability guide mentioned at docs/source/stability_policy.rst to understand if your changes
  are breaking or incompatible.
 - Try to make sure your code is asyncio-friendly and thread-safe.
- Run `uv run pre-commit` to run pre-commit hooks before committing your changes, but after `git add`ing them.
+- Run `uv run prek` to run pre-commit hooks before committing your changes, but after `git add`ing them.
 - Make sure you always test your changes. Either update or write new tests in the `tests/` directory.

 ### Pull Requests:
@@ -1,9 +0,0 @@
-# Config file for workflows/labelling.yml
-
-version: 1
-
-labels:
- label: "⚙️ dependencies"
-  authors: ["dependabot[bot]", "pre-commit-ci[bot]"]
- label: "🛠 code-quality"
-  authors: ["pre-commit-ci[bot]"]
@@ -26,6 +26,9 @@
  // Enable automerge globally:
  "automerge": true,

+  // Only upgrade packages if 7 days have passed:
+  "minimumReleaseAge": "7 days",
+
  // Group package updates together:
  "packageRules": [
    // Linting dependencies in pyproject.toml in sync with the pre-commit-config hooks:
@@ -62,6 +65,17 @@
    {
      "matchDepTypes": ["project.optional-dependencies", "project.dependencies"],
      "labels": ["⚙️ dependencies"]
+    },
+
+    // Workflow and dev-dependencies update once a month
+    // https://docs.renovatebot.com/presets-schedule/#schedulemonthly
+    {
+      "matchFileNames": [".github/workflows/**"],
+      "schedule": ["* 0-3 1 * *"]
+    },
+    {
+      "matchDepTypes": ["dependency-groups"],
+      "schedule": ["* 0-3 1 * *"]
    }
  ],

@@ -72,6 +86,6 @@
  "ignoreDeps": ["pytest-asyncio"],

  // schedule to allow PR's from Renovate:
-  "schedule": ["* * * * 0,6"]  // Every weekend
+  "schedule": ["* * * * 0"]  // Every Sunday

 }
@@ -20,7 +20,7 @@ jobs:
      IS_RELEASE_PR: ${{ steps.check_title.outputs.IS_RELEASE_PR }}

    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          # needed for commit and push step at the end
          persist-credentials: true
@@ -36,8 +36,11 @@ jobs:
          fi

      # Create the new fragment
-      - uses: Bibo-Joshi/chango@212fc662da1b1026f335e110270d75690df05758 # 0.5.0
+      - uses: Bibo-Joshi/chango@bc58df46ef3ba8f15b8d744929998b7ae8a222d4 # 0.6.1
        with:
+          # passing this custom token has two purposes
+          # 1. it allows us to fetch info about issue types
+          # 2. it ensures that the push will also re-trigger workflows
          github-token: ${{ secrets.CHANGO_PAT }}
          query-issue-types: true
          commit-and-push: ${{ steps.check_title.outputs.COMMIT_AND_PUSH }}
@@ -45,7 +48,7 @@ jobs:
      # Run `chango release` if applicable - needs some additional setup.
      - name: Set up Python
        if: steps.check_title.outputs.IS_RELEASE_PR == 'true'
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: "3.x"

@@ -60,7 +63,7 @@ jobs:

      - name: Commit & Push
        if: steps.check_title.outputs.IS_RELEASE_PR == 'true'
-        uses: stefanzweifel/git-auto-commit-action@778341af668090896ca464160c2def5d1d1a3eb0 # v6.0.1
+        uses: stefanzweifel/git-auto-commit-action@04702edda442b2e678b25b537cec683a1493fcb9 # v7.1.0
        with:
          commit_message: "Do chango Release"
          repository: ./target-repo
@@ -26,15 +26,15 @@ jobs:
    # If you do not check out your code, Copilot will do this for you.
    steps:
      - name: Checkout code
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false

      - name: Install uv
-        uses: astral-sh/setup-uv@b75a909f75acd358c2196fb9a5f1299a9a8868a4 # v6.7.0
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7.6.0
        with:
          # Install a specific version of uv.
-          version: "0.8.22"
+          version: "0.11.16"
          # Install 3.13:
          python-version: 3.13

@@ -1,6 +1,7 @@
 name: Test Admonitions Generation
 on:
  pull_request:
+    types: [synchronize, reopened, ready_for_review]
    paths:
      - src/telegram/**
      - docs/**
@@ -24,11 +25,11 @@ jobs:
        os: [ubuntu-latest]
      fail-fast: False
    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: ${{ matrix.python-version }}
          cache: 'pip'
@@ -19,11 +19,11 @@ jobs:
        os: [ubuntu-latest]
      fail-fast: False
    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install dependencies
@@ -35,7 +35,7 @@ jobs:
      - name: Upload linkcheck output
        # Run also if the previous steps failed
        if: always()
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
        with:
          name: linkcheck-output
          path: docs/build/html/output.*
@@ -17,17 +17,17 @@ jobs:
      security-events: write
    steps:
      - name: Checkout repository
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@b75a909f75acd358c2196fb9a5f1299a9a8868a4 # v6.7.0
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7.6.0
      - name: Run zizmor
        run: uvx zizmor --persona=pedantic --format sarif . > results.sarif
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Upload SARIF file
-        uses: github/codeql-action/upload-sarif@3599b3baa15b485a2e49ef411a7a4bb2452e7f93 # v3.30.5
+        uses: github/codeql-action/upload-sarif@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4.36.0
        with:
          sarif_file: results.sarif
          category: zizmor
@@ -1,19 +0,0 @@
-name: PR Labeler
-
-on:
-  pull_request:
-    types: [opened]
-
-permissions: {}
-
-jobs:
-  pre-commit-ci:
-    permissions:
-      contents: read # for srvaroa/labeler to read config file
-      pull-requests: write # for srvaroa/labeler to add labels in PR
-    runs-on: ubuntu-latest
-    steps:
-    - uses: srvaroa/labeler@0a20eccb8c94a1ee0bed5f16859aece1c45c3e55 # v1.13.0
-      # Config file at .github/labeler.yml
-      env:
-        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
@@ -0,0 +1,26 @@
+name: Prek checks
+permissions:
+  contents: read  # Needed to see what files to run pre-commit on
+
+on:
+  pull_request:
+    branches:
+      - '**'  # Matches all branch names, for PRs
+  push:
+    branches:
+      - 'master'  # Run tests on master branch
+
+# Cancel any in-progress runs of this workflow for the same PR or branch when a new commit is pushed.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  prek:
+    name: prek
+    runs-on: ubuntu-slim
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: j178/prek-action@0bb87d7f00b0c99306c8bcb8b8beba1eb581c037 # v1.1.1
@@ -17,11 +17,11 @@ jobs:
      actions: write

    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Set up Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: "3.x"
      - name: Install pypa/build
@@ -30,7 +30,7 @@ jobs:
      - name: Build a binary wheel and a source tarball
        run: python3 -m build
      - name: Store the distribution packages
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
        with:
          name: python-package-distributions
          path: dist/
@@ -55,12 +55,12 @@ jobs:

    steps:
      - name: Download all the dists
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
        with:
          name: python-package-distributions
          path: dist/
      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0

  compute-signatures:
    name: Compute SHA1 Sums and Sign with Sigstore
@@ -74,7 +74,7 @@ jobs:

    steps:
      - name: Download all the dists
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
        with:
          name: python-package-distributions
          path: dist/
@@ -86,13 +86,13 @@ jobs:
              sha1sum $file > $file.sha1
          done
      - name: Sign the dists with Sigstore
-        uses: sigstore/gh-action-sigstore-python@f7ad0af51a5648d09a20d00370f0a91c3bdf8f84 # v3.0.1
+        uses: sigstore/gh-action-sigstore-python@a5caf349bc536fbef3668a10ed7f5cd309a4b53d # v3.2.0
        with:
          inputs: >-
            ./dist/*.tar.gz
            ./dist/*.whl
      - name: Store the distribution packages and signatures
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
        with:
          name: python-package-distributions-and-signatures
          path: dist/
@@ -110,11 +110,11 @@ jobs:
      actions: read  # for downloading artifacts

    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Download all the dists
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
        with:
          name: python-package-distributions-and-signatures
          path: dist/
@@ -155,7 +155,7 @@ jobs:
    permissions: {}

    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Publish to Telegram Channel
@@ -17,11 +17,11 @@ jobs:
      actions: write

    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Set up Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: "3.x"
      - name: Install pypa/build
@@ -30,7 +30,7 @@ jobs:
      - name: Build a binary wheel and a source tarball
        run: python3 -m build
      - name: Store the distribution packages
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
        with:
          name: python-package-distributions
          path: dist/
@@ -55,12 +55,12 @@ jobs:

    steps:
      - name: Download all the dists
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
        with:
          name: python-package-distributions
          path: dist/
      - name: Publish to Test PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
        with:
          repository-url: https://test.pypi.org/legacy/

@@ -76,7 +76,7 @@ jobs:

    steps:
      - name: Download all the dists
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
        with:
          name: python-package-distributions
          path: dist/
@@ -88,13 +88,13 @@ jobs:
              sha1sum $file > $file.sha1
          done
      - name: Sign the dists with Sigstore
-        uses: sigstore/gh-action-sigstore-python@f7ad0af51a5648d09a20d00370f0a91c3bdf8f84 # v3.0.1
+        uses: sigstore/gh-action-sigstore-python@a5caf349bc536fbef3668a10ed7f5cd309a4b53d # v3.2.0
        with:
          inputs: >-
            ./dist/*.tar.gz
            ./dist/*.whl
      - name: Store the distribution packages and signatures
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
        with:
          name: python-package-distributions-and-signatures
          path: dist/
@@ -112,11 +112,11 @@ jobs:
      actions: read  # for downloading artifacts

    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Download all the dists
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
        with:
          name: python-package-distributions-and-signatures
          path: dist/
@@ -12,13 +12,13 @@ jobs:
      # For adding labels and closing
      issues: write
    steps:
-      - uses: actions/stale@3a9db7e6a41a89f618792c92c0e97cc736e1b13f # v10.0.0
+      - uses: actions/stale@eb5cf3af3ac0a1aa4c9c45633dd1ae542a27a899 # v10.3.0
        with:
          # PRs never get stale
          days-before-stale: 3
          days-before-close: 2
          days-before-pr-stale: -1
          stale-issue-label: '📋 stale'
-          only-labels: 'question'
+          only-issue-types: '❔ question'
          stale-issue-message: ''
          close-issue-message: 'This issue has been automatically closed due to inactivity. Feel free to comment in order to reopen or ask again in our Telegram support group at https://t.me/pythontelegrambotgroup.'
@@ -1,6 +1,7 @@
 name: Bot API Tests
 on:
  pull_request:
+    types: [synchronize, reopened, ready_for_review]
    paths:
      - src/telegram/**
      - tests/**
@@ -23,11 +24,11 @@ jobs:
        os: [ubuntu-latest]
      fail-fast: False
    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install dependencies
@@ -1,6 +1,7 @@
 name: Check Type Completeness
 on:
  pull_request:
+    types: [synchronize, reopened, ready_for_review]
    paths:
      - src/telegram/**
      - pyproject.toml
@@ -18,7 +18,7 @@ jobs:
          python-version: 3.12
          pyright-version: ~=1.1.367
      - name: Check Output
-        uses: jannekem/run-python-script-action@bbfca66c612a28f3eeca0ae40e1f810265e2ea68 # v1.7
+        uses: jannekem/run-python-script-action@9d8e2e0878d575fb6073277f38ce3f10ebf4f059 # v1.8
        env:
          TYPE_COMPLETENESS: ${{ steps.pyright-type-completeness.outputs.base-completeness-score }}
        with:
@@ -1,6 +1,7 @@
 name: Unit Tests
 on:
  pull_request:
+    types: [synchronize, reopened, ready_for_review]
    paths:
      - src/telegram/**
      - tests/**
@@ -18,15 +19,18 @@ jobs:
    runs-on: ${{matrix.os}}
    strategy:
      matrix:
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14.0-beta.3']
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - python-version: '3.14t'
+            os: ubuntu-latest
      fail-fast: False
    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
        with:
          python-version: ${{ matrix.python-version }}
          cache: 'pip'
@@ -83,15 +87,16 @@ jobs:
            .test_report_optionals_junit.xml

      - name: Submit coverage
-        uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7  # v5.5.1
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f  # v7.0.0
        with:
          env_vars: OS,PYTHON
          name: ${{ matrix.os }}-${{ matrix.python-version }}
          fail_ci_if_error: true
          token: ${{ secrets.CODECOV_TOKEN }}
      - name: Upload test results to Codecov
-        uses: codecov/test-results-action@47f89e9acb64b76debcd5ea40642d25a4adced9f # v1.1.1
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f  # v7.0.0
        if: ${{ !cancelled() }}
        with:
          files: .test_report_no_optionals_junit.xml,.test_report_optionals_junit.xml
          token: ${{ secrets.CODECOV_TOKEN }}
+          report_type: test_results
@@ -1,14 +1,6 @@
-ci:
-    autofix_prs: false
-    # We use Renovate to update this file now, but we can't disable automatic pre-commit updates
-    # when using the `pre-commit` GitHub Action, so we set the schedule to quarterly to avoid
-    # frequent updates.
-    autoupdate_schedule: quarterly
-    autoupdate_commit_msg: 'Bump `pre-commit` Hooks to Latest Versions'
-
 repos:
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.13.2'
+    rev: 'v0.15.15'
    hooks:
    # Run the linter:
    -   id: ruff-check
@@ -17,7 +9,7 @@ repos:
    -   id: ruff-format
        name: ruff format
 -   repo: https://github.com/PyCQA/pylint
-    rev: v3.3.8
+    rev: v4.0.5
    hooks:
    -   id: pylint
        files: ^(?!(tests|docs)).*\.py$
@@ -26,11 +18,12 @@ repos:
          - httpx~=0.27
          - tornado~=6.4
          - APScheduler>=3.10.4,<3.12.0
-          - cachetools>=5.3.3,<6.3.0
+          - cachetools>=7.0.0,<8.0.0
          - aiolimiter~=1.1,<1.3
          - . # this basically does `pip install -e .`
+        priority: 10
 -   repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.18.2
+    rev: v1.20.2
    hooks:
    -   id: mypy
        name: mypy-ptb
@@ -43,9 +36,10 @@ repos:
          - httpx~=0.27
          - tornado~=6.4
          - APScheduler>=3.10.4,<3.12.0
-          - cachetools>=5.3.3,<6.3.0
+          - cachetools>=7.0.0,<8.0.0
          - aiolimiter~=1.1,<1.3
          - . # this basically does `pip install -e .`
+        priority: 10
    - id: mypy
      name: mypy-examples
      files: ^examples/.*\.py$
@@ -56,5 +50,6 @@ repos:
      additional_dependencies:
        - tornado~=6.4
        - APScheduler>=3.10.4,<3.12.0
-        - cachetools>=5.3.3,<6.3.0
+        - cachetools>=7.0.0,<8.0.0
        - . # this basically does `pip install -e .`
+      priority: 10
@@ -20,7 +20,7 @@ python:
      path: .

 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
  tools:
    python: "3"  # latest stable cpython version
  jobs:
@@ -5,13 +5,12 @@ Credits
 `Leandro Toledo <https://github.com/leandrotoledo>`_.
 The current development team includes

- `Hinrich Mahler <https://github.com/Bibo-Joshi>`_ (maintainer)
- `Poolitzer <https://github.com/Poolitzer>`_ (community liaison)
- `Harshil <https://github.com/harshil21>`_
+- `Poolitzer <https://github.com/Poolitzer>`_ (maintainer)
+- `Harshil <https://github.com/harshil21>`_ (maintainer)
 - `Abdelrahman <https://github.com/aelkheir>`_

 Emeritus maintainers include
-`Jannes Höke <https://github.com/jh0ker>`_ (`@jh0ker <https://t.me/jh0ker>`_ on Telegram),
+`Hinrich Mahler <https://github.com/Bibo-Joshi>`_, `Jannes Höke <https://github.com/jh0ker>`_ (`@jh0ker <https://t.me/jh0ker>`_ on Telegram),
 `Noam Meltzer <https://github.com/tsnoam>`_, `Pieter Schutz <https://github.com/eldinnie>`_ and `Jasmin Bom <https://github.com/jsmnbom>`_.

 Contributors
@@ -58,6 +57,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `gamgi <https://github.com/gamgi>`_
 - `Gauthamram Ravichandran <https://github.com/GauthamramRavichandran>`_
 - `Harshil <https://github.com/harshil21>`_
+- `Henok Tesfamikael <https://github.com/hethon>`
 - `Henry Galue <https://github.com/henryg311>`
 - `Hugo Damer <https://github.com/HakimusGIT>`_
 - `ihoru <https://github.com/ihoru>`_
@@ -75,10 +75,12 @@ The following wonderful people contributed directly or indirectly to this projec
 - `jossalgon <https://github.com/jossalgon>`_
 - `JRoot3D <https://github.com/JRoot3D>`_
 - `Juan Cuevas <https://github.com/cuevasrja>`
+- `karin0 <https://github.com/karin0>`_
 - `kenjitagawa <https://github.com/kenjitagawa>`_
 - `kennethcheo <https://github.com/kennethcheo>`_
 - `Kirill Vasin <https://github.com/vasinkd>`_
 - `Kjwon15 <https://github.com/kjwon15>`_
+- `Krishna Chaitanya Balusu <https://github.com/Krishnachaitanyakc>`_
 - `Li-aung Yip <https://github.com/LiaungYip>`_
 - `locobott <https://github.com/locobott>`_
 - `Loo Zheng Yuan <https://github.com/loozhengyuan>`_
@@ -104,6 +106,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `Oleg Shlyazhko <https://github.com/ollmer>`_
 - `Oleg Sushchenko <https://github.com/feuillemorte>`_
 - `Or Bin <https://github.com/OrBin>`_
+- `OuYoung <https://github.com/ouyooung>`_
 - `overquota <https://github.com/overquota>`_
 - `Pablo Martinez <https://github.com/elpekenin>`_
 - `Paradox <https://github.com/paradox70>`_
@@ -11,7 +11,7 @@
   :target: https://pypi.org/project/python-telegram-bot/
   :alt: Supported Python versions

-.. image:: https://img.shields.io/badge/Bot%20API-9.2-blue?logo=telegram
+.. image:: https://img.shields.io/badge/Bot%20API-10.0-blue?logo=telegram
   :target: https://core.telegram.org/bots/api-changelog
   :alt: Supported Bot API version

@@ -43,10 +43,6 @@
   :target: https://app.codacy.com/gh/python-telegram-bot/python-telegram-bot/dashboard
   :alt: Code quality: Codacy

-.. image:: https://results.pre-commit.ci/badge/github/python-telegram-bot/python-telegram-bot/master.svg
-   :target: https://results.pre-commit.ci/latest/github/python-telegram-bot/python-telegram-bot/master
-   :alt: pre-commit.ci status
-
 .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black
   :alt: Code Style: Black
@@ -70,7 +66,7 @@ Introduction

 This library provides a pure Python, asynchronous interface for the
 `Telegram Bot API <https://core.telegram.org/bots/api>`_.
-It's compatible with Python versions **3.9+**.
+It's compatible with Python versions **3.10+**.

 In addition to the pure API implementation, this library features several convenience methods and shortcuts as well as a number of high-level classes to
 make the development of bots easy and straightforward. These classes are contained in the
@@ -81,7 +77,7 @@ After installing_ the library, be sure to check out the section on `working with
 Telegram API support
 ~~~~~~~~~~~~~~~~~~~~

-All types and methods of the Telegram Bot API **9.2** are natively supported by this library.
+All types and methods of the Telegram Bot API **10.0** are natively supported by this library.
 In addition, Bot API functionality not yet natively included can still be used as described `in our wiki <https://github.com/python-telegram-bot/python-telegram-bot/wiki/Bot-API-Forward-Compatibility>`_.

 Notable Features
@@ -215,6 +211,12 @@ Noteworthy parts of ``python-telegram-bots`` API that are likely to cause issues
 * ``telegram.ext.BasePersistence``
 * all classes in the ``telegram.ext.filters`` module that allow to add/remove allowed users/chats at runtime

+Free threading
+~~~~~~~~~~~~~~
+
+While ``python-telegram-bot`` is tested to work with Python 3.14 free threading, we do not guarantee that
+PTB is thread-safe for all use cases. Please see issue `#4873 <https://github.com/python-telegram-bot/python-telegram-bot/issues/4873>`_ for more information.
+
 Contributing
 ------------

@@ -2,7 +2,7 @@ bugfixes = """
 Fixed a bug where calling ``Application.remove/add_handler`` during update handling can cause a ``RuntimeError`` in ``Application.process_update``.

 .. hint::
-    Calling ``Application.add/remove_handler`` now has no influence on calls to :meth:`process_update` that are
+    Calling ``Application.add/remove_handler`` now has no influence on calls to ``process_update`` that are
    already in progress. The same holds for ``Application.add/remove_error_handler`` and ``Application.process_error``, respectively.

    .. warning::
@@ -1,5 +1,5 @@
 internal = "Use Renovate to Keep Dependencies Up-To-Date"
 [[pull_requests]]
 uid = "4887"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 dependencies = "Update cachetools requirement from <6.2.0,>=5.3.3 to >=5.3.3,<6.3.0"
 [[pull_requests]]
 uid = "4923"
-author_uid = "dependabot[bot]"
+author_uid = "dependabot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Lock file maintenance"
 [[pull_requests]]
 uid = "4938"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update astral-sh/setup-uv digest to b75a909"
 [[pull_requests]]
 uid = "4943"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update codecov/codecov-action action to v5.5.1"
 [[pull_requests]]
 uid = "4944"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update dependency astral-sh/uv to v0.8.17"
 [[pull_requests]]
 uid = "4945"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update github/codeql-action action to v3.30.3"
 [[pull_requests]]
 uid = "4946"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update Pylint to v3.3.8"
 [[pull_requests]]
 uid = "4947"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update Chango to v0.5.0"
 [[pull_requests]]
 uid = "4948"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update Mypy to v1.18.1"
 [[pull_requests]]
 uid = "4949"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Align pre-commit hook APScheduler to with ``pyproject.toml``"
 [[pull_requests]]
 uid = "4950"
-author_uids = ["renovate[bot]", "Bibo-Joshi"]
+author_uids = ["renovatebot", "Bibo-Joshi"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Align pre-commit hook cachetools to with ``pyproject.toml``"
 [[pull_requests]]
 uid = "4951"
-author_uids = ["renovate[bot]", "Bibo-Joshi"]
+author_uids = ["renovatebot", "Bibo-Joshi"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update pypa/gh-action-pypi-publish action to v1.13.0"
 [[pull_requests]]
 uid = "4952"
-author_uid = "renovate[bot]"
+author_uid = "renovatebot"
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Lock file maintenance"
 [[pull_requests]]
 uid = "4954"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Lock file maintenance"
 [[pull_requests]]
 uid = "4955"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update astral-sh/setup-uv digest to 208b0c0"
 [[pull_requests]]
 uid = "4958"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update dependency astral-sh/uv to v0.8.19"
 [[pull_requests]]
 uid = "4959"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update Mypy to v1.18.2"
 [[pull_requests]]
 uid = "4960"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update astral-sh/setup-uv action to v6.7.0"
 [[pull_requests]]
 uid = "4961"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update Ruff to v0.13.1"
 [[pull_requests]]
 uid = "4962"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update actions/stale action to v10"
 [[pull_requests]]
 uid = "4964"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Lock file maintenance"
 [[pull_requests]]
 uid = "4967"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update dependency astral-sh/uv to v0.8.22"
 [[pull_requests]]
 uid = "4975"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update github/codeql-action action to v3.30.5"
 [[pull_requests]]
 uid = "4976"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update Ruff to v0.13.2"
 [[pull_requests]]
 uid = "4977"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -1,5 +1,5 @@
 internal = "Update dependency furo to v2025.9.25"
 [[pull_requests]]
 uid = "4978"
-author_uids = ["renovate[bot]"]
+author_uids = ["renovatebot"]
 closes_threads = []
@@ -0,0 +1,5 @@
+other = "Remove Support for Python 3.9"
+[[pull_requests]]
+uid = "4827"
+author_uid = "harshil21"
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Lock file maintenance"
+[[pull_requests]]
+uid = "4980"
+author_uid = "renovatebot"
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update github/codeql-action action to v3.30.6"
+[[pull_requests]]
+uid = "4984"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.13.3"
+[[pull_requests]]
+uid = "4985"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update actions/stale action to v10.1.0"
+[[pull_requests]]
+uid = "4986"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update astral-sh/setup-uv action to v6.8.0"
+[[pull_requests]]
+uid = "4987"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+documentation = "Documentation Improvements. Among others, fix dead links."
+
+[[pull_requests]]
+uid = "4988"
+author_uids = ["Bibo-Joshi"]
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.8.23"
+[[pull_requests]]
+uid = "4989"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update configuration of actions/stale to use issue types instead of labels"
+
+[[pull_requests]]
+uid = "4990"
+author_uids = ["Bibo-Joshi"]
@@ -0,0 +1,5 @@
+internal = "Update github/codeql-action action to v3.30.8"
+[[pull_requests]]
+uid = "4994"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Pylint to v3.3.9"
+[[pull_requests]]
+uid = "4995"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.9.2"
+[[pull_requests]]
+uid = "4996"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.0"
+[[pull_requests]]
+uid = "4997"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update astral-sh/setup-uv action to v7"
+[[pull_requests]]
+uid = "4998"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update github/codeql-action action to v4"
+[[pull_requests]]
+uid = "4999"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Pylint to v4 (major)"
+[[pull_requests]]
+uid = "5000"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update stefanzweifel/git-auto-commit-action action to v7"
+[[pull_requests]]
+uid = "5001"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update astral-sh/setup-uv action to v7.1.0"
+[[pull_requests]]
+uid = "5002"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Use Python 3.14 Final in the Test Suite"
+[[pull_requests]]
+uid = "5004"
+author_uids = ["harshil21"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Add Freethreaded Python 3.14 to the Test Suite"
+[[pull_requests]]
+uid = "5006"
+author_uids = ["harshil21"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Make ``chango`` Commit Re-Trigger Workflows"
+[[pull_requests]]
+uid = "5007"
+author_uids = ["Bibo-Joshi"]
+closes_threads = []
@@ -0,0 +1,4 @@
+internal = "Temporarily disable ``actions/stale`` due to a bug with ``only-issue-types``."
+[[pull_requests]]
+uid = "5008"
+author_uids = ["Bibo-Joshi"]
@@ -0,0 +1,4 @@
+internal = "Re-Enable ``actions/stale`` Workflow"
+[[pull_requests]]
+uid = "5009"
+author_uids = ["Bibo-Joshi"]
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.9.3"
+[[pull_requests]]
+uid = "5011"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update github/codeql-action action to v4.30.9"
+[[pull_requests]]
+uid = "5012"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.1"
+[[pull_requests]]
+uid = "5013"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update dependency chango to ~=0.6.0"
+[[pull_requests]]
+uid = "5014"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.9.4"
+[[pull_requests]]
+uid = "5015"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update astral-sh/setup-uv action to v7.1.1"
+[[pull_requests]]
+uid = "5016"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.9.5"
+[[pull_requests]]
+uid = "5022"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Pylint to v4.0.2"
+[[pull_requests]]
+uid = "5023"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.2"
+[[pull_requests]]
+uid = "5024"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update github/codeql-action action to v4.31.0"
+[[pull_requests]]
+uid = "5025"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update sigstore/gh-action-sigstore-python action to v3.1.0"
+[[pull_requests]]
+uid = "5026"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update GitHub Artifact Actions (major)"
+[[pull_requests]]
+uid = "5027"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update astral-sh/setup-uv action to v7.1.2"
+[[pull_requests]]
+uid = "5029"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+bugfixes = "Fix a Bug in Initialization Logic of ``Bot``"
+[[pull_requests]]
+uid = "5030"
+author_uids = ["codomposer"]
+closes_threads = ["5021"]
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.9.7"
+[[pull_requests]]
+uid = "5032"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update github/codeql-action action to v4.31.2"
+[[pull_requests]]
+uid = "5033"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.3"
+[[pull_requests]]
+uid = "5034"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Lock file maintenance"
+[[pull_requests]]
+uid = "5035"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update dependency astral-sh/uv to v0.9.8"
+[[pull_requests]]
+uid = "5040"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.4"
+[[pull_requests]]
+uid = "5041"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update dependency pytest to v9"
+[[pull_requests]]
+uid = "5042"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,4 @@
+internal = "Reduce Frequence of Renovate Updates for Development Dependencies"
+[[pull_requests]]
+uid = "5044"
+author_uids = ["Bibo-Joshi"]
@@ -0,0 +1,5 @@
+internal = "Update Pylint to v4.0.3"
+[[pull_requests]]
+uid = "5048"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.5"
+[[pull_requests]]
+uid = "5049"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,4 @@
+internal = "Stabilize some unit tests"
+[[pull_requests]]
+uid = "5050"
+author_uids = ["Bibo-Joshi"]
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.6"
+[[pull_requests]]
+uid = "5055"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Ruff to v0.14.7"
+[[pull_requests]]
+uid = "5056"
+author_uids = ["renovatebot"]
+closes_threads = []
@@ -0,0 +1,5 @@
+internal = "Update Pylint to v4.0.4"
+[[pull_requests]]
+uid = "5057"
+author_uids = ["renovatebot"]
+closes_threads = []
--- a/Show More
+++ b/Show More