python-telegram-bot · Bibo-Joshi · Jul 31, 2025 · Jul 29, 2025 · Jul 29, 2025 · Jul 29, 2025
diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst
@@ -87,7 +87,7 @@ Here's how to make a one-off code change.
 
      - Documenting types of global variables and complex types of class members can be done using the Sphinx docstring convention.
 
-   -  In addition, PTB uses some formatting/styling and linting tools in the pre-commit setup. Some of those tools also have command line tools that can help to run these tools outside of the pre-commit step. If you'd like to leverage that, please have a look at the `pre-commit config file`_ for an overview of which tools (and which versions of them) are used. For example, we use `Black`_ for code formatting. Plugins for Black exist for some `popular editors`_. You can use those instead of manually formatting everything.
+   -  In addition, PTB uses some formatting/styling and linting tools in the pre-commit setup. Some of those tools also have command line tools that can help to run these tools outside of the pre-commit step. If you'd like to leverage that, please have a look at the `pre-commit config file`_ for an overview of which tools (and which versions of them) are used. For example, we use `Ruff`_ for linting and formatting.
 
    - Please ensure that the code you write is well-tested and that all automated tests still pass. We
      have dedicated an `testing page`_ to help you with that.
@@ -288,8 +288,7 @@ to add new required arguments. It's also more explicit and easier to read.
 .. _`MyPy`: https://mypy.readthedocs.io/en/stable/index.html
 .. _`here`: https://mypy.readthedocs.io/en/stable/cheat_sheet_py3.html
 .. _`pre-commit config file`: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/.pre-commit-config.yaml
-.. _`Black`: https://black.readthedocs.io/en/stable/index.html
-.. _`popular editors`: https://black.readthedocs.io/en/stable/integrations/editors.html
+.. _`Ruff`: https://docs.astral.sh/ruff/
 .. _`RTD`: https://docs.python-telegram-bot.org/
 .. _`RTD build`: https://docs.python-telegram-bot.org/en/doc-fixes
 .. _`CSI`: https://standards.mousepawmedia.com/en/stable/csi.html

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -7,27 +7,13 @@ ci:
 
 repos:
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.12.2'
+    rev: 'v0.12.7'
     hooks:
-    -   id: ruff
+    # Run the linter:
+    -   id: ruff-check
         name: ruff
-        additional_dependencies:
-          - httpx~=0.27
-          - tornado~=6.4
-          - APScheduler~=3.10.4
-          - cachetools>=5.3.3,<5.5.0
-          - aiolimiter~=1.1,<1.3
--   repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.1.0
-    hooks:
-    -   id: black
-        args:
-        - --diff
-        - --check
--   repo: https://github.com/PyCQA/flake8
-    rev: 7.3.0
-    hooks:
-    -   id: flake8
+    # Run the formatter:
+    -   id: ruff-format
 -   repo: https://github.com/PyCQA/pylint
     rev: v3.3.7
     hooks:
@@ -66,18 +52,4 @@ repos:
         - tornado~=6.4
         - APScheduler~=3.10.4
         - cachetools>=5.3.3,<5.5.0
-        - . # this basically does `pip install -e .`
--   repo: https://github.com/asottile/pyupgrade
-    rev: v3.20.0
-    hooks:
-    -   id: pyupgrade
-        args:
-          - --py39-plus
--   repo: https://github.com/pycqa/isort
-    rev: 6.0.1
-    hooks:
-    -   id: isort
-        name: isort
-        args:
-        - --diff
-        - --check
+        - . # this basically does `pip install -e .`
diff --git a/changes/unreleased/4886.XSHPk83uhDQdYzurbb4xx9.toml b/changes/unreleased/4886.XSHPk83uhDQdYzurbb4xx9.toml
@@ -0,0 +1,5 @@
+internal = "Remove ``black``, ``isort``, ``flake8``, and ``pyupgrade`` in favor of ``ruff``"
+[[pull_requests]]
+uid = "4886"
+author_uid = "harshil21"
+closes_threads = []
diff --git a/docs/auxil/link_code.py b/docs/auxil/link_code.py
@@ -19,6 +19,7 @@
 to link to the correct files & lines on github. Can be simplified once
 https://github.com/sphinx-doc/sphinx/issues/1556 is closed
 """
+
 import subprocess
 from pathlib import Path
 

diff --git a/examples/arbitrarycallbackdatabot.py b/examples/arbitrarycallbackdatabot.py
@@ -11,6 +11,7 @@
 To use arbitrary callback data, you must install PTB via
 `pip install "python-telegram-bot[callback-data]"`
 """
+
 import logging
 from typing import cast
 

diff --git a/examples/customwebhookbot/djangobot.py b/examples/customwebhookbot/djangobot.py
@@ -13,6 +13,7 @@
 You may also need to change the `listen` value in the uvicorn configuration to match your setup.
 Press Ctrl-C on the command line or send a signal to the process to stop the bot.
 """
+
 import asyncio
 import html
 import json

diff --git a/examples/customwebhookbot/flaskbot.py b/examples/customwebhookbot/flaskbot.py
@@ -13,6 +13,7 @@
 You may also need to change the `listen` value in the uvicorn configuration to match your setup.
 Press Ctrl-C on the command line or send a signal to the process to stop the bot.
 """
+
 import asyncio
 import html
 import logging

diff --git a/examples/customwebhookbot/quartbot.py b/examples/customwebhookbot/quartbot.py
@@ -13,6 +13,7 @@
 You may also need to change the `listen` value in the uvicorn configuration to match your setup.
 Press Ctrl-C on the command line or send a signal to the process to stop the bot.
 """
+
 import asyncio
 import html
 import logging

diff --git a/examples/customwebhookbot/starlettebot.py b/examples/customwebhookbot/starlettebot.py
@@ -13,6 +13,7 @@
 You may also need to change the `listen` value in the uvicorn configuration to match your setup.
 Press Ctrl-C on the command line or send a signal to the process to stop the bot.
 """
+
 import asyncio
 import html
 import logging

diff --git a/examples/errorhandlerbot.py b/examples/errorhandlerbot.py
@@ -3,6 +3,7 @@
 # This program is dedicated to the public domain under the CC0 license.
 
 """This is a very simple example on how one could implement a custom error handler."""
+
 import html
 import json
 import logging

diff --git a/examples/inlinebot.py b/examples/inlinebot.py
@@ -14,6 +14,7 @@
 Press Ctrl-C on the command line or send a signal to the process to stop the
 bot.
 """
+
 import logging
 from html import escape
 from uuid import uuid4

diff --git a/examples/inlinekeyboard.py b/examples/inlinekeyboard.py
@@ -6,6 +6,7 @@
 Basic example for a bot that uses inline keyboards. For an in-depth explanation, check out
  https://github.com/python-telegram-bot/python-telegram-bot/wiki/InlineKeyboard-Example.
 """
+
 import logging
 
 from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update

diff --git a/examples/inlinekeyboard2.py b/examples/inlinekeyboard2.py
@@ -14,6 +14,7 @@
 Send /start to initiate the conversation.
 Press Ctrl-C on the command line to stop the bot.
 """
+
 import logging
 
 from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update

diff --git a/examples/passportbot.py b/examples/passportbot.py
@@ -14,6 +14,7 @@
 To use Telegram Passport, you must install PTB via
 `pip install "python-telegram-bot[passport]"`
 """
+
 import logging
 from pathlib import Path
 

diff --git a/examples/pollbot.py b/examples/pollbot.py
@@ -7,6 +7,7 @@
 poll/quiz the bot generates. The preview command generates a closed poll/quiz, exactly like the
 one the user sends the bot
 """
+
 import logging
 
 from telegram import (

diff --git a/examples/rawapibot.py b/examples/rawapibot.py
@@ -5,6 +5,7 @@
 on the telegram.ext bot framework.
 This program is dedicated to the public domain under the CC0 license.
 """
+
 import asyncio
 import contextlib
 import datetime as dtm

diff --git a/examples/webappbot.py b/examples/webappbot.py
@@ -8,6 +8,7 @@
 Currently only showcases starting the WebApp via a KeyboardButton, as all other methods would
 require a bot token.
 """
+
 import json
 import logging
 

diff --git a/pyproject.toml b/pyproject.toml
@@ -156,15 +156,6 @@ packages = ["src/telegram"]
 sys_path = "changes"
 chango_instance = { name= "chango_instance", module = "config" }
 
-# BLACK:
-[tool.black]
-line-length = 99
-
-# ISORT:
-[tool.isort]  # black config
-profile = "black"
-line_length = 99
-
 # RUFF:
 [tool.ruff]
 line-length = 99

diff --git a/setup.cfg b/setup.cfg
diff --git a/src/telegram/_birthdate.py b/src/telegram/_birthdate.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram Birthday."""
+
 import datetime as dtm
 from typing import Optional
 

diff --git a/src/telegram/_bot.py b/src/telegram/_bot.py
@@ -3620,8 +3620,7 @@ def _effective_inline_results(
                 next_offset_int = current_offset_int + 1
                 next_offset = str(next_offset_int)
                 effective_results = results[
-                    current_offset_int
-                    * InlineQueryLimit.RESULTS : next_offset_int
+                    current_offset_int * InlineQueryLimit.RESULTS : next_offset_int
                     * InlineQueryLimit.RESULTS
                 ]
             else:

diff --git a/src/telegram/_botcommandscope.py b/src/telegram/_botcommandscope.py
@@ -18,6 +18,7 @@
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 # pylint: disable=redefined-builtin
 """This module contains objects representing Telegram bot command scopes."""
+
 from typing import TYPE_CHECKING, Final, Optional, Union
 
 from telegram import constants

diff --git a/src/telegram/_botdescription.py b/src/telegram/_botdescription.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains two objects that represent a Telegram bots (short) description."""
+
 from typing import Optional
 
 from telegram._telegramobject import TelegramObject

diff --git a/src/telegram/_botname.py b/src/telegram/_botname.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represent a Telegram bots name."""
+
 from typing import Final, Optional
 
 from telegram import constants

diff --git a/src/telegram/_business.py b/src/telegram/_business.py
@@ -18,6 +18,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/]
 """This module contains the Telegram Business related classes."""
+
 import datetime as dtm
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, Optional

diff --git a/src/telegram/_callbackquery.py b/src/telegram/_callbackquery.py
@@ -18,6 +18,7 @@
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 # pylint: disable=redefined-builtin
 """This module contains an object that represents a Telegram CallbackQuery"""
+
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, Final, Optional, Union
 

diff --git a/src/telegram/_chat.py b/src/telegram/_chat.py
@@ -18,6 +18,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram Chat."""
+
 import datetime as dtm
 from collections.abc import Sequence
 from html import escape

diff --git a/src/telegram/_chatadministratorrights.py b/src/telegram/_chatadministratorrights.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains the class which represents a Telegram ChatAdministratorRights."""
+
 from typing import Optional
 
 from telegram._telegramobject import TelegramObject

diff --git a/src/telegram/_chatbackground.py b/src/telegram/_chatbackground.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains objects related to chat backgrounds."""
+
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, Final, Optional
 

diff --git a/src/telegram/_chatboost.py b/src/telegram/_chatboost.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains the classes that represent Telegram ChatBoosts."""
+
 import datetime as dtm
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, Final, Optional

diff --git a/src/telegram/_chatfullinfo.py b/src/telegram/_chatfullinfo.py
@@ -18,6 +18,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatFullInfo."""
+
 import datetime as dtm
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, Optional, Union

diff --git a/src/telegram/_chatinvitelink.py b/src/telegram/_chatinvitelink.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents an invite link for a chat."""
+
 import datetime as dtm
 from typing import TYPE_CHECKING, Optional, Union
 

diff --git a/src/telegram/_chatjoinrequest.py b/src/telegram/_chatjoinrequest.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatJoinRequest."""
+
 import datetime as dtm
 from typing import TYPE_CHECKING, Optional
 

diff --git a/src/telegram/_chatmemberupdated.py b/src/telegram/_chatmemberupdated.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatMemberUpdated."""
+
 import datetime as dtm
 from typing import TYPE_CHECKING, Optional, Union
 

diff --git a/src/telegram/_chatpermissions.py b/src/telegram/_chatpermissions.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatPermission."""
+
 from typing import TYPE_CHECKING, Optional
 
 from telegram._telegramobject import TelegramObject

diff --git a/src/telegram/_checklists.py b/src/telegram/_checklists.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an objects related to Telegram checklists."""
+
 import datetime as dtm
 from collections.abc import Sequence
 from typing import TYPE_CHECKING, Optional

diff --git a/src/telegram/_copytextbutton.py b/src/telegram/_copytextbutton.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram CopyTextButton."""
+
 from typing import Optional
 
 from telegram._telegramobject import TelegramObject

diff --git a/src/telegram/_dice.py b/src/telegram/_dice.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram Dice."""
+
 from typing import Final, Optional
 
 from telegram import constants

diff --git a/src/telegram/_directmessagepricechanged.py b/src/telegram/_directmessagepricechanged.py
@@ -18,7 +18,6 @@
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Direct Message Price."""
 
-
 from typing import Optional
 
 from telegram._telegramobject import TelegramObject

diff --git a/src/telegram/_files/_basemedium.py b/src/telegram/_files/_basemedium.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """Common base class for media objects"""
+
 from typing import TYPE_CHECKING, Optional
 
 from telegram._telegramobject import TelegramObject

diff --git a/src/telegram/_files/_basethumbedmedium.py b/src/telegram/_files/_basethumbedmedium.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """Common base class for media objects with thumbnails"""
+
 from typing import TYPE_CHECKING, Optional, TypeVar
 
 from telegram._files._basemedium import _BaseMedium

diff --git a/src/telegram/_files/animation.py b/src/telegram/_files/animation.py
@@ -17,6 +17,7 @@
 # You should have received a copy of the GNU Lesser Public License
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram Animation."""
+
 import datetime as dtm
 from typing import Optional, Union