May 22, 2025 · May 22, 2025
diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst
      $ pip install -r requirements-dev-all.txt


 5. Install pre-commit hooks:
 5. Install the package in development mode:

   .. code-block:: bash

      $ pip install -e .

   This is necessary because python-telegram-bot uses a src-based layout where the package code is located in the ``src/`` directory.

 6. Install pre-commit hooks:

   .. code-block:: bash

diff --git a/.github/workflows/docs-admonitions.yml b/.github/workflows/docs-admonitions.yml
 on:
  pull_request:
    paths:
      - telegram/**
      -src/telegram/**
      - docs/**
      - .github/workflows/docs-admonitions.yml
  push:
diff --git a/.github/workflows/test_official.yml b/.github/workflows/test_official.yml
 on:
 pull_request:
 paths:
      -telegram/**
      -src/telegram/**
      -tests/**
 push:
 branches:
diff --git a/.github/workflows/type_completeness.yml b/.github/workflows/type_completeness.yml
 on:
  pull_request:
    paths:
      - telegram/**
      -src/telegram/**
      - pyproject.toml
      - .github/workflows/type_completeness.yml
  push:
diff --git a/.github/workflows/unit_tests.yml b/.github/workflows/unit_tests.yml
 on:
  pull_request:
    paths:
      - telegram/**
      -src/telegram/**
      - tests/**
      - .github/workflows/unit_tests.yml
      - pyproject.toml
diff --git a/changes/unreleased/4798.g7G3jRf2ns4ath9LRFEcit.toml b/changes/unreleased/4798.g7G3jRf2ns4ath9LRFEcit.toml
 internal = "Change to `src` Layout"
 [[pull_requests]]
 uid = "4798"
 author_uid = "Bibo-Joshi"
 closes_threads = ["4797"]
diff --git a/pyproject.toml b/pyproject.toml
 [tool.hatch.version]
 # dynamically evaluates the `__version__` variable in that file
 source = "code"
 path = "telegram/_version.py"
 search-paths = ["telegram"]
 path = "src/telegram/_version.py"
 search-paths = ["src"]

 [tool.hatch.build]
 packages = ["telegram"]
 packages = ["src/telegram"]
 package-data = {"telegram" = ["py.typed"]}
 src-layout = true

 # CHANGO
 [tool.chango]
 [tool.ruff.lint.per-file-ignores]
 "tests/*.py" = ["B018"]
 "tests/**.py" = ["RUF012", "ASYNC230", "DTZ", "ARG", "T201", "ASYNC109", "D", "S", "TRY"]
 "telegram/**.py" = ["TRY003"]
 "telegram/ext/_applicationbuilder.py" = ["TRY004"]
 "telegram/ext/filters.py" = ["D102"]
 "src/telegram/**.py" = ["TRY003"]
 "src/telegram/ext/_applicationbuilder.py" = ["TRY004"]
 "src/telegram/ext/filters.py" = ["D102"]
 "docs/**.py" = ["INP001", "ARG", "D", "TRY003", "S"]
 "examples/**.py" = ["ARG", "D", "S105", "TRY003"]

 # PYTEST:
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["src"]
 addopts = "--no-success-flaky-report -rX"
 filterwarnings = [
    "error",
 # COVERAGE:
 [tool.coverage.run]
 branch = true
 source = ["telegram"]
 source = ["src/telegram"]
 parallel = true
 concurrency = ["thread", "multiprocessing"]
 omit = [
    "tests/",
    "telegram/__main__.py"
    "src/telegram/__main__.py"
 ]

 [tool.coverage.report]
diff --git a/telegram/__init__.py → src/telegram/__init__.py b/telegram/__init__.py → src/telegram/__init__.py
diff --git a/telegram/__main__.py → src/telegram/__main__.py b/telegram/__main__.py → src/telegram/__main__.py
diff --git a/telegram/_birthdate.py → src/telegram/_birthdate.py b/telegram/_birthdate.py → src/telegram/_birthdate.py
diff --git a/telegram/_bot.py → src/telegram/_bot.py b/telegram/_bot.py → src/telegram/_bot.py
diff --git a/telegram/_botcommand.py → src/telegram/_botcommand.py b/telegram/_botcommand.py → src/telegram/_botcommand.py
diff --git a/telegram/_botcommandscope.py → src/telegram/_botcommandscope.py b/telegram/_botcommandscope.py → src/telegram/_botcommandscope.py
diff --git a/telegram/_botdescription.py → src/telegram/_botdescription.py b/telegram/_botdescription.py → src/telegram/_botdescription.py
diff --git a/telegram/_botname.py → src/telegram/_botname.py b/telegram/_botname.py → src/telegram/_botname.py
diff --git a/telegram/_business.py → src/telegram/_business.py b/telegram/_business.py → src/telegram/_business.py
diff --git a/telegram/_callbackquery.py → src/telegram/_callbackquery.py b/telegram/_callbackquery.py → src/telegram/_callbackquery.py
diff --git a/telegram/_chat.py → src/telegram/_chat.py b/telegram/_chat.py → src/telegram/_chat.py
diff --git a/telegram/_chatadministratorrights.py → src/telegram/_chatadministratorrights.py b/telegram/_chatadministratorrights.py → src/telegram/_chatadministratorrights.py
diff --git a/telegram/_chatbackground.py → src/telegram/_chatbackground.py b/telegram/_chatbackground.py → src/telegram/_chatbackground.py
diff --git a/telegram/_chatboost.py → src/telegram/_chatboost.py b/telegram/_chatboost.py → src/telegram/_chatboost.py
diff --git a/telegram/_chatfullinfo.py → src/telegram/_chatfullinfo.py b/telegram/_chatfullinfo.py → src/telegram/_chatfullinfo.py
diff --git a/telegram/_chatinvitelink.py → src/telegram/_chatinvitelink.py b/telegram/_chatinvitelink.py → src/telegram/_chatinvitelink.py
diff --git a/telegram/_chatjoinrequest.py → src/telegram/_chatjoinrequest.py b/telegram/_chatjoinrequest.py → src/telegram/_chatjoinrequest.py
diff --git a/telegram/_chatlocation.py → src/telegram/_chatlocation.py b/telegram/_chatlocation.py → src/telegram/_chatlocation.py
diff --git a/telegram/_chatmember.py → src/telegram/_chatmember.py b/telegram/_chatmember.py → src/telegram/_chatmember.py
diff --git a/telegram/_chatmemberupdated.py → src/telegram/_chatmemberupdated.py b/telegram/_chatmemberupdated.py → src/telegram/_chatmemberupdated.py
diff --git a/telegram/_chatpermissions.py → src/telegram/_chatpermissions.py b/telegram/_chatpermissions.py → src/telegram/_chatpermissions.py
diff --git a/telegram/_choseninlineresult.py → src/telegram/_choseninlineresult.py b/telegram/_choseninlineresult.py → src/telegram/_choseninlineresult.py
diff --git a/telegram/_copytextbutton.py → src/telegram/_copytextbutton.py b/telegram/_copytextbutton.py → src/telegram/_copytextbutton.py
diff --git a/telegram/_dice.py → src/telegram/_dice.py b/telegram/_dice.py → src/telegram/_dice.py
diff --git a/telegram/_files/__init__.py → src/telegram/_files/__init__.py b/telegram/_files/__init__.py → src/telegram/_files/__init__.py
diff --git a/telegram/_files/_basemedium.py → src/telegram/_files/_basemedium.py b/telegram/_files/_basemedium.py → src/telegram/_files/_basemedium.py
diff --git a/telegram/_files/_basethumbedmedium.py → src/telegram/_files/_basethumbedmedium.py b/telegram/_files/_basethumbedmedium.py → src/telegram/_files/_basethumbedmedium.py
diff --git a/telegram/_files/_inputstorycontent.py → src/telegram/_files/_inputstorycontent.py b/telegram/_files/_inputstorycontent.py → src/telegram/_files/_inputstorycontent.py
diff --git a/telegram/_files/animation.py → src/telegram/_files/animation.py b/telegram/_files/animation.py → src/telegram/_files/animation.py
diff --git a/telegram/_files/audio.py → src/telegram/_files/audio.py b/telegram/_files/audio.py → src/telegram/_files/audio.py
diff --git a/telegram/_files/chatphoto.py → src/telegram/_files/chatphoto.py b/telegram/_files/chatphoto.py → src/telegram/_files/chatphoto.py
diff --git a/telegram/_files/contact.py → src/telegram/_files/contact.py b/telegram/_files/contact.py → src/telegram/_files/contact.py
diff --git a/telegram/_files/document.py → src/telegram/_files/document.py b/telegram/_files/document.py → src/telegram/_files/document.py
diff --git a/telegram/_files/file.py → src/telegram/_files/file.py b/telegram/_files/file.py → src/telegram/_files/file.py
diff --git a/telegram/_files/inputfile.py → src/telegram/_files/inputfile.py b/telegram/_files/inputfile.py → src/telegram/_files/inputfile.py
diff --git a/telegram/_files/inputmedia.py → src/telegram/_files/inputmedia.py b/telegram/_files/inputmedia.py → src/telegram/_files/inputmedia.py
diff --git a/telegram/_files/inputprofilephoto.py → src/telegram/_files/inputprofilephoto.py b/telegram/_files/inputprofilephoto.py → src/telegram/_files/inputprofilephoto.py
diff --git a/telegram/_files/inputsticker.py → src/telegram/_files/inputsticker.py b/telegram/_files/inputsticker.py → src/telegram/_files/inputsticker.py
diff --git a/telegram/_files/location.py → src/telegram/_files/location.py b/telegram/_files/location.py → src/telegram/_files/location.py
diff --git a/telegram/_files/photosize.py → src/telegram/_files/photosize.py b/telegram/_files/photosize.py → src/telegram/_files/photosize.py
diff --git a/telegram/_files/sticker.py → src/telegram/_files/sticker.py b/telegram/_files/sticker.py → src/telegram/_files/sticker.py
diff --git a/telegram/_files/venue.py → src/telegram/_files/venue.py b/telegram/_files/venue.py → src/telegram/_files/venue.py
diff --git a/telegram/_files/video.py → src/telegram/_files/video.py b/telegram/_files/video.py → src/telegram/_files/video.py
diff --git a/telegram/_files/videonote.py → src/telegram/_files/videonote.py b/telegram/_files/videonote.py → src/telegram/_files/videonote.py
diff --git a/telegram/_files/voice.py → src/telegram/_files/voice.py b/telegram/_files/voice.py → src/telegram/_files/voice.py
diff --git a/telegram/_forcereply.py → src/telegram/_forcereply.py b/telegram/_forcereply.py → src/telegram/_forcereply.py
diff --git a/telegram/_forumtopic.py → src/telegram/_forumtopic.py b/telegram/_forumtopic.py → src/telegram/_forumtopic.py
diff --git a/telegram/_games/__init__.py → src/telegram/_games/__init__.py b/telegram/_games/__init__.py → src/telegram/_games/__init__.py
diff --git a/telegram/_games/callbackgame.py → src/telegram/_games/callbackgame.py b/telegram/_games/callbackgame.py → src/telegram/_games/callbackgame.py
diff --git a/telegram/_games/game.py → src/telegram/_games/game.py b/telegram/_games/game.py → src/telegram/_games/game.py
diff --git a/telegram/_games/gamehighscore.py → src/telegram/_games/gamehighscore.py b/telegram/_games/gamehighscore.py → src/telegram/_games/gamehighscore.py
diff --git a/telegram/_gifts.py → src/telegram/_gifts.py b/telegram/_gifts.py → src/telegram/_gifts.py
diff --git a/telegram/_giveaway.py → src/telegram/_giveaway.py b/telegram/_giveaway.py → src/telegram/_giveaway.py
diff --git a/telegram/_inline/__init__.py → src/telegram/_inline/__init__.py b/telegram/_inline/__init__.py → src/telegram/_inline/__init__.py
diff --git a/telegram/_inline/inlinekeyboardbutton.py → src/telegram/_inline/inlinekeyboardbutton.py b/telegram/_inline/inlinekeyboardbutton.py → src/telegram/_inline/inlinekeyboardbutton.py
diff --git a/telegram/_inline/inlinekeyboardmarkup.py → src/telegram/_inline/inlinekeyboardmarkup.py b/telegram/_inline/inlinekeyboardmarkup.py → src/telegram/_inline/inlinekeyboardmarkup.py
diff --git a/telegram/_inline/inlinequery.py → src/telegram/_inline/inlinequery.py b/telegram/_inline/inlinequery.py → src/telegram/_inline/inlinequery.py
diff --git a/telegram/_inline/inlinequeryresult.py → src/telegram/_inline/inlinequeryresult.py b/telegram/_inline/inlinequeryresult.py → src/telegram/_inline/inlinequeryresult.py
diff --git a/telegram/_inline/inlinequeryresultarticle.py → ...egram/_inline/inlinequeryresultarticle.py b/telegram/_inline/inlinequeryresultarticle.py → ...egram/_inline/inlinequeryresultarticle.py
diff --git a/telegram/_inline/inlinequeryresultaudio.py → ...elegram/_inline/inlinequeryresultaudio.py b/telegram/_inline/inlinequeryresultaudio.py → ...elegram/_inline/inlinequeryresultaudio.py
diff --git a/...m/_inline/inlinequeryresultcachedaudio.py → ...m/_inline/inlinequeryresultcachedaudio.py b/...m/_inline/inlinequeryresultcachedaudio.py → ...m/_inline/inlinequeryresultcachedaudio.py
diff --git a/...inline/inlinequeryresultcacheddocument.py → ...inline/inlinequeryresultcacheddocument.py b/...inline/inlinequeryresultcacheddocument.py → ...inline/inlinequeryresultcacheddocument.py
diff --git a/...ram/_inline/inlinequeryresultcachedgif.py → ...ram/_inline/inlinequeryresultcachedgif.py b/...ram/_inline/inlinequeryresultcachedgif.py → ...ram/_inline/inlinequeryresultcachedgif.py
diff --git a/...inline/inlinequeryresultcachedmpeg4gif.py → ...inline/inlinequeryresultcachedmpeg4gif.py b/...inline/inlinequeryresultcachedmpeg4gif.py → ...inline/inlinequeryresultcachedmpeg4gif.py
diff --git a/...m/_inline/inlinequeryresultcachedphoto.py → ...m/_inline/inlinequeryresultcachedphoto.py b/...m/_inline/inlinequeryresultcachedphoto.py → ...m/_inline/inlinequeryresultcachedphoto.py
diff --git a/..._inline/inlinequeryresultcachedsticker.py → ..._inline/inlinequeryresultcachedsticker.py b/..._inline/inlinequeryresultcachedsticker.py → ..._inline/inlinequeryresultcachedsticker.py
diff --git a/...m/_inline/inlinequeryresultcachedvideo.py → ...m/_inline/inlinequeryresultcachedvideo.py b/...m/_inline/inlinequeryresultcachedvideo.py → ...m/_inline/inlinequeryresultcachedvideo.py
diff --git a/...m/_inline/inlinequeryresultcachedvoice.py → ...m/_inline/inlinequeryresultcachedvoice.py b/...m/_inline/inlinequeryresultcachedvoice.py → ...m/_inline/inlinequeryresultcachedvoice.py
diff --git a/telegram/_inline/inlinequeryresultcontact.py → ...egram/_inline/inlinequeryresultcontact.py b/telegram/_inline/inlinequeryresultcontact.py → ...egram/_inline/inlinequeryresultcontact.py
diff --git a/...gram/_inline/inlinequeryresultdocument.py → ...gram/_inline/inlinequeryresultdocument.py b/...gram/_inline/inlinequeryresultdocument.py → ...gram/_inline/inlinequeryresultdocument.py
diff --git a/telegram/_inline/inlinequeryresultgame.py → ...telegram/_inline/inlinequeryresultgame.py b/telegram/_inline/inlinequeryresultgame.py → ...telegram/_inline/inlinequeryresultgame.py
diff --git a/telegram/_inline/inlinequeryresultgif.py → src/telegram/_inline/inlinequeryresultgif.py b/telegram/_inline/inlinequeryresultgif.py → src/telegram/_inline/inlinequeryresultgif.py
diff --git a/...gram/_inline/inlinequeryresultlocation.py → ...gram/_inline/inlinequeryresultlocation.py b/...gram/_inline/inlinequeryresultlocation.py → ...gram/_inline/inlinequeryresultlocation.py
diff --git a/...gram/_inline/inlinequeryresultmpeg4gif.py → ...gram/_inline/inlinequeryresultmpeg4gif.py b/...gram/_inline/inlinequeryresultmpeg4gif.py → ...gram/_inline/inlinequeryresultmpeg4gif.py
diff --git a/telegram/_inline/inlinequeryresultphoto.py → ...elegram/_inline/inlinequeryresultphoto.py b/telegram/_inline/inlinequeryresultphoto.py → ...elegram/_inline/inlinequeryresultphoto.py
diff --git a/telegram/_inline/inlinequeryresultsbutton.py → ...egram/_inline/inlinequeryresultsbutton.py b/telegram/_inline/inlinequeryresultsbutton.py → ...egram/_inline/inlinequeryresultsbutton.py
diff --git a/telegram/_inline/inlinequeryresultvenue.py → ...elegram/_inline/inlinequeryresultvenue.py b/telegram/_inline/inlinequeryresultvenue.py → ...elegram/_inline/inlinequeryresultvenue.py
diff --git a/telegram/_inline/inlinequeryresultvideo.py → ...elegram/_inline/inlinequeryresultvideo.py b/telegram/_inline/inlinequeryresultvideo.py → ...elegram/_inline/inlinequeryresultvideo.py
diff --git a/telegram/_inline/inlinequeryresultvoice.py → ...elegram/_inline/inlinequeryresultvoice.py b/telegram/_inline/inlinequeryresultvoice.py → ...elegram/_inline/inlinequeryresultvoice.py
diff --git a/...ram/_inline/inputcontactmessagecontent.py → ...ram/_inline/inputcontactmessagecontent.py b/...ram/_inline/inputcontactmessagecontent.py → ...ram/_inline/inputcontactmessagecontent.py
diff --git a/...ram/_inline/inputinvoicemessagecontent.py → ...ram/_inline/inputinvoicemessagecontent.py b/...ram/_inline/inputinvoicemessagecontent.py → ...ram/_inline/inputinvoicemessagecontent.py
diff --git a/...am/_inline/inputlocationmessagecontent.py → ...am/_inline/inputlocationmessagecontent.py b/...am/_inline/inputlocationmessagecontent.py → ...am/_inline/inputlocationmessagecontent.py
diff --git a/telegram/_inline/inputmessagecontent.py → src/telegram/_inline/inputmessagecontent.py b/telegram/_inline/inputmessagecontent.py → src/telegram/_inline/inputmessagecontent.py
diff --git a/telegram/_inline/inputtextmessagecontent.py → ...legram/_inline/inputtextmessagecontent.py b/telegram/_inline/inputtextmessagecontent.py → ...legram/_inline/inputtextmessagecontent.py
diff --git a/telegram/_inline/inputvenuemessagecontent.py → ...egram/_inline/inputvenuemessagecontent.py b/telegram/_inline/inputvenuemessagecontent.py → ...egram/_inline/inputvenuemessagecontent.py
diff --git a/telegram/_inline/preparedinlinemessage.py → ...telegram/_inline/preparedinlinemessage.py b/telegram/_inline/preparedinlinemessage.py → ...telegram/_inline/preparedinlinemessage.py
diff --git a/telegram/_keyboardbutton.py → src/telegram/_keyboardbutton.py b/telegram/_keyboardbutton.py → src/telegram/_keyboardbutton.py
diff --git a/telegram/_keyboardbuttonpolltype.py → src/telegram/_keyboardbuttonpolltype.py b/telegram/_keyboardbuttonpolltype.py → src/telegram/_keyboardbuttonpolltype.py
diff --git a/telegram/_keyboardbuttonrequest.py → src/telegram/_keyboardbuttonrequest.py b/telegram/_keyboardbuttonrequest.py → src/telegram/_keyboardbuttonrequest.py
diff --git a/telegram/_linkpreviewoptions.py → src/telegram/_linkpreviewoptions.py b/telegram/_linkpreviewoptions.py → src/telegram/_linkpreviewoptions.py
diff --git a/telegram/_loginurl.py → src/telegram/_loginurl.py b/telegram/_loginurl.py → src/telegram/_loginurl.py
diff --git a/telegram/_menubutton.py → src/telegram/_menubutton.py b/telegram/_menubutton.py → src/telegram/_menubutton.py
diff --git a/telegram/_message.py → src/telegram/_message.py b/telegram/_message.py → src/telegram/_message.py
diff --git a/telegram/_messageautodeletetimerchanged.py → ...elegram/_messageautodeletetimerchanged.py b/telegram/_messageautodeletetimerchanged.py → ...elegram/_messageautodeletetimerchanged.py
diff --git a/telegram/_messageentity.py → src/telegram/_messageentity.py b/telegram/_messageentity.py → src/telegram/_messageentity.py
diff --git a/telegram/_messageid.py → src/telegram/_messageid.py b/telegram/_messageid.py → src/telegram/_messageid.py
diff --git a/telegram/_messageorigin.py → src/telegram/_messageorigin.py b/telegram/_messageorigin.py → src/telegram/_messageorigin.py
diff --git a/telegram/_messagereactionupdated.py → src/telegram/_messagereactionupdated.py b/telegram/_messagereactionupdated.py → src/telegram/_messagereactionupdated.py
diff --git a/telegram/_ownedgift.py → src/telegram/_ownedgift.py b/telegram/_ownedgift.py → src/telegram/_ownedgift.py
diff --git a/telegram/_paidmedia.py → src/telegram/_paidmedia.py b/telegram/_paidmedia.py → src/telegram/_paidmedia.py
diff --git a/telegram/_paidmessagepricechanged.py → src/telegram/_paidmessagepricechanged.py b/telegram/_paidmessagepricechanged.py → src/telegram/_paidmessagepricechanged.py
diff --git a/telegram/_passport/__init__.py → src/telegram/_passport/__init__.py b/telegram/_passport/__init__.py → src/telegram/_passport/__init__.py
diff --git a/telegram/_passport/credentials.py → src/telegram/_passport/credentials.py b/telegram/_passport/credentials.py → src/telegram/_passport/credentials.py
diff --git a/telegram/_passport/data.py → src/telegram/_passport/data.py b/telegram/_passport/data.py → src/telegram/_passport/data.py
diff --git a/...ram/_passport/encryptedpassportelement.py → ...ram/_passport/encryptedpassportelement.py b/...ram/_passport/encryptedpassportelement.py → ...ram/_passport/encryptedpassportelement.py
diff --git a/telegram/_passport/passportdata.py → src/telegram/_passport/passportdata.py b/telegram/_passport/passportdata.py → src/telegram/_passport/passportdata.py
diff --git a/telegram/_passport/passportelementerrors.py → ...legram/_passport/passportelementerrors.py b/telegram/_passport/passportelementerrors.py → ...legram/_passport/passportelementerrors.py
diff --git a/telegram/_passport/passportfile.py → src/telegram/_passport/passportfile.py b/telegram/_passport/passportfile.py → src/telegram/_passport/passportfile.py
diff --git a/telegram/_payment/__init__.py → src/telegram/_payment/__init__.py b/telegram/_payment/__init__.py → src/telegram/_payment/__init__.py
diff --git a/telegram/_payment/invoice.py → src/telegram/_payment/invoice.py b/telegram/_payment/invoice.py → src/telegram/_payment/invoice.py
diff --git a/telegram/_payment/labeledprice.py → src/telegram/_payment/labeledprice.py b/telegram/_payment/labeledprice.py → src/telegram/_payment/labeledprice.py
diff --git a/telegram/_payment/orderinfo.py → src/telegram/_payment/orderinfo.py b/telegram/_payment/orderinfo.py → src/telegram/_payment/orderinfo.py
diff --git a/telegram/_payment/precheckoutquery.py → src/telegram/_payment/precheckoutquery.py b/telegram/_payment/precheckoutquery.py → src/telegram/_payment/precheckoutquery.py
diff --git a/telegram/_payment/refundedpayment.py → src/telegram/_payment/refundedpayment.py b/telegram/_payment/refundedpayment.py → src/telegram/_payment/refundedpayment.py
diff --git a/telegram/_payment/shippingaddress.py → src/telegram/_payment/shippingaddress.py b/telegram/_payment/shippingaddress.py → src/telegram/_payment/shippingaddress.py
diff --git a/telegram/_payment/shippingoption.py → src/telegram/_payment/shippingoption.py b/telegram/_payment/shippingoption.py → src/telegram/_payment/shippingoption.py
diff --git a/telegram/_payment/shippingquery.py → src/telegram/_payment/shippingquery.py b/telegram/_payment/shippingquery.py → src/telegram/_payment/shippingquery.py
diff --git a/telegram/_payment/stars/__init__.py → src/telegram/_payment/stars/__init__.py b/telegram/_payment/stars/__init__.py → src/telegram/_payment/stars/__init__.py
diff --git a/telegram/_payment/stars/affiliateinfo.py → src/telegram/_payment/stars/affiliateinfo.py b/telegram/_payment/stars/affiliateinfo.py → src/telegram/_payment/stars/affiliateinfo.py
diff --git a/.../_payment/stars/revenuewithdrawalstate.py → .../_payment/stars/revenuewithdrawalstate.py b/.../_payment/stars/revenuewithdrawalstate.py → .../_payment/stars/revenuewithdrawalstate.py
diff --git a/telegram/_payment/stars/staramount.py → src/telegram/_payment/stars/staramount.py b/telegram/_payment/stars/staramount.py → src/telegram/_payment/stars/staramount.py
diff --git a/telegram/_payment/stars/startransactions.py → ...legram/_payment/stars/startransactions.py b/telegram/_payment/stars/startransactions.py → ...legram/_payment/stars/startransactions.py
diff --git a/...gram/_payment/stars/transactionpartner.py → ...gram/_payment/stars/transactionpartner.py b/...gram/_payment/stars/transactionpartner.py → ...gram/_payment/stars/transactionpartner.py
diff --git a/telegram/_payment/successfulpayment.py → src/telegram/_payment/successfulpayment.py b/telegram/_payment/successfulpayment.py → src/telegram/_payment/successfulpayment.py
diff --git a/telegram/_poll.py → src/telegram/_poll.py b/telegram/_poll.py → src/telegram/_poll.py
diff --git a/telegram/_proximityalerttriggered.py → src/telegram/_proximityalerttriggered.py b/telegram/_proximityalerttriggered.py → src/telegram/_proximityalerttriggered.py
diff --git a/telegram/_reaction.py → src/telegram/_reaction.py b/telegram/_reaction.py → src/telegram/_reaction.py
diff --git a/telegram/_reply.py → src/telegram/_reply.py b/telegram/_reply.py → src/telegram/_reply.py
diff --git a/telegram/_replykeyboardmarkup.py → src/telegram/_replykeyboardmarkup.py b/telegram/_replykeyboardmarkup.py → src/telegram/_replykeyboardmarkup.py
diff --git a/telegram/_replykeyboardremove.py → src/telegram/_replykeyboardremove.py b/telegram/_replykeyboardremove.py → src/telegram/_replykeyboardremove.py
diff --git a/telegram/_sentwebappmessage.py → src/telegram/_sentwebappmessage.py b/telegram/_sentwebappmessage.py → src/telegram/_sentwebappmessage.py
diff --git a/telegram/_shared.py → src/telegram/_shared.py b/telegram/_shared.py → src/telegram/_shared.py
diff --git a/telegram/_story.py → src/telegram/_story.py b/telegram/_story.py → src/telegram/_story.py
diff --git a/telegram/_storyarea.py → src/telegram/_storyarea.py b/telegram/_storyarea.py → src/telegram/_storyarea.py
diff --git a/telegram/_switchinlinequerychosenchat.py → src/telegram/_switchinlinequerychosenchat.py b/telegram/_switchinlinequerychosenchat.py → src/telegram/_switchinlinequerychosenchat.py
diff --git a/telegram/_telegramobject.py → src/telegram/_telegramobject.py b/telegram/_telegramobject.py → src/telegram/_telegramobject.py
diff --git a/telegram/_uniquegift.py → src/telegram/_uniquegift.py b/telegram/_uniquegift.py → src/telegram/_uniquegift.py
diff --git a/telegram/_update.py → src/telegram/_update.py b/telegram/_update.py → src/telegram/_update.py
diff --git a/telegram/_user.py → src/telegram/_user.py b/telegram/_user.py → src/telegram/_user.py
diff --git a/telegram/_userprofilephotos.py → src/telegram/_userprofilephotos.py b/telegram/_userprofilephotos.py → src/telegram/_userprofilephotos.py
diff --git a/telegram/_utils/__init__.py → src/telegram/_utils/__init__.py b/telegram/_utils/__init__.py → src/telegram/_utils/__init__.py
diff --git a/telegram/_utils/argumentparsing.py → src/telegram/_utils/argumentparsing.py b/telegram/_utils/argumentparsing.py → src/telegram/_utils/argumentparsing.py
diff --git a/telegram/_utils/datetime.py → src/telegram/_utils/datetime.py b/telegram/_utils/datetime.py → src/telegram/_utils/datetime.py
diff --git a/telegram/_utils/defaultvalue.py → src/telegram/_utils/defaultvalue.py b/telegram/_utils/defaultvalue.py → src/telegram/_utils/defaultvalue.py
diff --git a/telegram/_utils/entities.py → src/telegram/_utils/entities.py b/telegram/_utils/entities.py → src/telegram/_utils/entities.py
diff --git a/telegram/_utils/enum.py → src/telegram/_utils/enum.py b/telegram/_utils/enum.py → src/telegram/_utils/enum.py
diff --git a/telegram/_utils/files.py → src/telegram/_utils/files.py b/telegram/_utils/files.py → src/telegram/_utils/files.py
diff --git a/telegram/_utils/logging.py → src/telegram/_utils/logging.py b/telegram/_utils/logging.py → src/telegram/_utils/logging.py
diff --git a/telegram/_utils/markup.py → src/telegram/_utils/markup.py b/telegram/_utils/markup.py → src/telegram/_utils/markup.py
diff --git a/telegram/_utils/repr.py → src/telegram/_utils/repr.py b/telegram/_utils/repr.py → src/telegram/_utils/repr.py
diff --git a/telegram/_utils/strings.py → src/telegram/_utils/strings.py b/telegram/_utils/strings.py → src/telegram/_utils/strings.py
diff --git a/telegram/_utils/types.py → src/telegram/_utils/types.py b/telegram/_utils/types.py → src/telegram/_utils/types.py
diff --git a/telegram/_utils/warnings.py → src/telegram/_utils/warnings.py b/telegram/_utils/warnings.py → src/telegram/_utils/warnings.py
diff --git a/telegram/_utils/warnings_transition.py → src/telegram/_utils/warnings_transition.py b/telegram/_utils/warnings_transition.py → src/telegram/_utils/warnings_transition.py
diff --git a/telegram/_version.py → src/telegram/_version.py b/telegram/_version.py → src/telegram/_version.py
diff --git a/telegram/_videochat.py → src/telegram/_videochat.py b/telegram/_videochat.py → src/telegram/_videochat.py
diff --git a/telegram/_webappdata.py → src/telegram/_webappdata.py b/telegram/_webappdata.py → src/telegram/_webappdata.py
diff --git a/telegram/_webappinfo.py → src/telegram/_webappinfo.py b/telegram/_webappinfo.py → src/telegram/_webappinfo.py
diff --git a/telegram/_webhookinfo.py → src/telegram/_webhookinfo.py b/telegram/_webhookinfo.py → src/telegram/_webhookinfo.py
diff --git a/telegram/_writeaccessallowed.py → src/telegram/_writeaccessallowed.py b/telegram/_writeaccessallowed.py → src/telegram/_writeaccessallowed.py
diff --git a/telegram/constants.py → src/telegram/constants.py b/telegram/constants.py → src/telegram/constants.py
diff --git a/telegram/error.py → src/telegram/error.py b/telegram/error.py → src/telegram/error.py
diff --git a/telegram/ext/__init__.py → src/telegram/ext/__init__.py b/telegram/ext/__init__.py → src/telegram/ext/__init__.py
diff --git a/telegram/ext/_aioratelimiter.py → src/telegram/ext/_aioratelimiter.py b/telegram/ext/_aioratelimiter.py → src/telegram/ext/_aioratelimiter.py
diff --git a/telegram/ext/_application.py → src/telegram/ext/_application.py b/telegram/ext/_application.py → src/telegram/ext/_application.py
diff --git a/telegram/ext/_applicationbuilder.py → src/telegram/ext/_applicationbuilder.py b/telegram/ext/_applicationbuilder.py → src/telegram/ext/_applicationbuilder.py
diff --git a/telegram/ext/_basepersistence.py → src/telegram/ext/_basepersistence.py b/telegram/ext/_basepersistence.py → src/telegram/ext/_basepersistence.py
diff --git a/telegram/ext/_baseratelimiter.py → src/telegram/ext/_baseratelimiter.py b/telegram/ext/_baseratelimiter.py → src/telegram/ext/_baseratelimiter.py
diff --git a/telegram/ext/_baseupdateprocessor.py → src/telegram/ext/_baseupdateprocessor.py b/telegram/ext/_baseupdateprocessor.py → src/telegram/ext/_baseupdateprocessor.py
diff --git a/telegram/ext/_callbackcontext.py → src/telegram/ext/_callbackcontext.py b/telegram/ext/_callbackcontext.py → src/telegram/ext/_callbackcontext.py
diff --git a/telegram/ext/_callbackdatacache.py → src/telegram/ext/_callbackdatacache.py b/telegram/ext/_callbackdatacache.py → src/telegram/ext/_callbackdatacache.py
diff --git a/telegram/ext/_contexttypes.py → src/telegram/ext/_contexttypes.py b/telegram/ext/_contexttypes.py → src/telegram/ext/_contexttypes.py
diff --git a/telegram/ext/_defaults.py → src/telegram/ext/_defaults.py b/telegram/ext/_defaults.py → src/telegram/ext/_defaults.py
diff --git a/telegram/ext/_dictpersistence.py → src/telegram/ext/_dictpersistence.py b/telegram/ext/_dictpersistence.py → src/telegram/ext/_dictpersistence.py
diff --git a/telegram/ext/_extbot.py → src/telegram/ext/_extbot.py b/telegram/ext/_extbot.py → src/telegram/ext/_extbot.py
diff --git a/telegram/ext/_handlers/__init__.py → src/telegram/ext/_handlers/__init__.py b/telegram/ext/_handlers/__init__.py → src/telegram/ext/_handlers/__init__.py
diff --git a/telegram/ext/_handlers/basehandler.py → src/telegram/ext/_handlers/basehandler.py b/telegram/ext/_handlers/basehandler.py → src/telegram/ext/_handlers/basehandler.py
diff --git a/...xt/_handlers/businessconnectionhandler.py → ...xt/_handlers/businessconnectionhandler.py b/...xt/_handlers/businessconnectionhandler.py → ...xt/_handlers/businessconnectionhandler.py
diff --git a/...andlers/businessmessagesdeletedhandler.py → ...andlers/businessmessagesdeletedhandler.py b/...andlers/businessmessagesdeletedhandler.py → ...andlers/businessmessagesdeletedhandler.py
diff --git a/...ram/ext/_handlers/callbackqueryhandler.py → ...ram/ext/_handlers/callbackqueryhandler.py b/...ram/ext/_handlers/callbackqueryhandler.py → ...ram/ext/_handlers/callbackqueryhandler.py
diff --git a/telegram/ext/_handlers/chatboosthandler.py → ...elegram/ext/_handlers/chatboosthandler.py b/telegram/ext/_handlers/chatboosthandler.py → ...elegram/ext/_handlers/chatboosthandler.py
diff --git a/...m/ext/_handlers/chatjoinrequesthandler.py → ...m/ext/_handlers/chatjoinrequesthandler.py b/...m/ext/_handlers/chatjoinrequesthandler.py → ...m/ext/_handlers/chatjoinrequesthandler.py
diff --git a/telegram/ext/_handlers/chatmemberhandler.py → ...legram/ext/_handlers/chatmemberhandler.py b/telegram/ext/_handlers/chatmemberhandler.py → ...legram/ext/_handlers/chatmemberhandler.py
diff --git a/...xt/_handlers/choseninlineresulthandler.py → ...xt/_handlers/choseninlineresulthandler.py b/...xt/_handlers/choseninlineresulthandler.py → ...xt/_handlers/choseninlineresulthandler.py
diff --git a/telegram/ext/_handlers/commandhandler.py → src/telegram/ext/_handlers/commandhandler.py b/telegram/ext/_handlers/commandhandler.py → src/telegram/ext/_handlers/commandhandler.py
diff --git a/...gram/ext/_handlers/conversationhandler.py → ...gram/ext/_handlers/conversationhandler.py b/...gram/ext/_handlers/conversationhandler.py → ...gram/ext/_handlers/conversationhandler.py
diff --git a/telegram/ext/_handlers/inlinequeryhandler.py → ...egram/ext/_handlers/inlinequeryhandler.py b/telegram/ext/_handlers/inlinequeryhandler.py → ...egram/ext/_handlers/inlinequeryhandler.py
diff --git a/telegram/ext/_handlers/messagehandler.py → src/telegram/ext/_handlers/messagehandler.py b/telegram/ext/_handlers/messagehandler.py → src/telegram/ext/_handlers/messagehandler.py
diff --git a/...m/ext/_handlers/messagereactionhandler.py → ...m/ext/_handlers/messagereactionhandler.py b/...m/ext/_handlers/messagereactionhandler.py → ...m/ext/_handlers/messagereactionhandler.py
diff --git a/...xt/_handlers/paidmediapurchasedhandler.py → ...xt/_handlers/paidmediapurchasedhandler.py b/...xt/_handlers/paidmediapurchasedhandler.py → ...xt/_handlers/paidmediapurchasedhandler.py
diff --git a/telegram/ext/_handlers/pollanswerhandler.py → ...legram/ext/_handlers/pollanswerhandler.py b/telegram/ext/_handlers/pollanswerhandler.py → ...legram/ext/_handlers/pollanswerhandler.py
diff --git a/telegram/ext/_handlers/pollhandler.py → src/telegram/ext/_handlers/pollhandler.py b/telegram/ext/_handlers/pollhandler.py → src/telegram/ext/_handlers/pollhandler.py
diff --git a/.../ext/_handlers/precheckoutqueryhandler.py → .../ext/_handlers/precheckoutqueryhandler.py b/.../ext/_handlers/precheckoutqueryhandler.py → .../ext/_handlers/precheckoutqueryhandler.py
diff --git a/telegram/ext/_handlers/prefixhandler.py → src/telegram/ext/_handlers/prefixhandler.py b/telegram/ext/_handlers/prefixhandler.py → src/telegram/ext/_handlers/prefixhandler.py
diff --git a/...ram/ext/_handlers/shippingqueryhandler.py → ...ram/ext/_handlers/shippingqueryhandler.py b/...ram/ext/_handlers/shippingqueryhandler.py → ...ram/ext/_handlers/shippingqueryhandler.py
diff --git a/...ram/ext/_handlers/stringcommandhandler.py → ...ram/ext/_handlers/stringcommandhandler.py b/...ram/ext/_handlers/stringcommandhandler.py → ...ram/ext/_handlers/stringcommandhandler.py
diff --git a/telegram/ext/_handlers/stringregexhandler.py → ...egram/ext/_handlers/stringregexhandler.py b/telegram/ext/_handlers/stringregexhandler.py → ...egram/ext/_handlers/stringregexhandler.py
diff --git a/telegram/ext/_handlers/typehandler.py → src/telegram/ext/_handlers/typehandler.py b/telegram/ext/_handlers/typehandler.py → src/telegram/ext/_handlers/typehandler.py
diff --git a/telegram/ext/_jobqueue.py → src/telegram/ext/_jobqueue.py b/telegram/ext/_jobqueue.py → src/telegram/ext/_jobqueue.py
diff --git a/telegram/ext/_picklepersistence.py → src/telegram/ext/_picklepersistence.py b/telegram/ext/_picklepersistence.py → src/telegram/ext/_picklepersistence.py
diff --git a/telegram/ext/_updater.py → src/telegram/ext/_updater.py b/telegram/ext/_updater.py → src/telegram/ext/_updater.py
diff --git a/telegram/ext/_utils/__init__.py → src/telegram/ext/_utils/__init__.py b/telegram/ext/_utils/__init__.py → src/telegram/ext/_utils/__init__.py
diff --git a/telegram/ext/_utils/_update_parsing.py → src/telegram/ext/_utils/_update_parsing.py b/telegram/ext/_utils/_update_parsing.py → src/telegram/ext/_utils/_update_parsing.py
diff --git a/telegram/ext/_utils/asyncio.py → src/telegram/ext/_utils/asyncio.py b/telegram/ext/_utils/asyncio.py → src/telegram/ext/_utils/asyncio.py
diff --git a/telegram/ext/_utils/networkloop.py → src/telegram/ext/_utils/networkloop.py b/telegram/ext/_utils/networkloop.py → src/telegram/ext/_utils/networkloop.py
diff --git a/telegram/ext/_utils/stack.py → src/telegram/ext/_utils/stack.py b/telegram/ext/_utils/stack.py → src/telegram/ext/_utils/stack.py
diff --git a/telegram/ext/_utils/trackingdict.py → src/telegram/ext/_utils/trackingdict.py b/telegram/ext/_utils/trackingdict.py → src/telegram/ext/_utils/trackingdict.py
diff --git a/telegram/ext/_utils/types.py → src/telegram/ext/_utils/types.py b/telegram/ext/_utils/types.py → src/telegram/ext/_utils/types.py
diff --git a/telegram/ext/_utils/webhookhandler.py → src/telegram/ext/_utils/webhookhandler.py b/telegram/ext/_utils/webhookhandler.py → src/telegram/ext/_utils/webhookhandler.py
diff --git a/telegram/ext/filters.py → src/telegram/ext/filters.py b/telegram/ext/filters.py → src/telegram/ext/filters.py
diff --git a/telegram/helpers.py → src/telegram/helpers.py b/telegram/helpers.py → src/telegram/helpers.py
diff --git a/telegram/py.typed → src/telegram/py.typed b/telegram/py.typed → src/telegram/py.typed
diff --git a/telegram/request/__init__.py → src/telegram/request/__init__.py b/telegram/request/__init__.py → src/telegram/request/__init__.py
diff --git a/telegram/request/_baserequest.py → src/telegram/request/_baserequest.py b/telegram/request/_baserequest.py → src/telegram/request/_baserequest.py
diff --git a/telegram/request/_httpxrequest.py → src/telegram/request/_httpxrequest.py b/telegram/request/_httpxrequest.py → src/telegram/request/_httpxrequest.py
diff --git a/telegram/request/_requestdata.py → src/telegram/request/_requestdata.py b/telegram/request/_requestdata.py → src/telegram/request/_requestdata.py
diff --git a/telegram/request/_requestparameter.py → src/telegram/request/_requestparameter.py b/telegram/request/_requestparameter.py → src/telegram/request/_requestparameter.py
diff --git a/telegram/warnings.py → src/telegram/warnings.py b/telegram/warnings.py → src/telegram/warnings.py
diff --git a/tests/README.rst b/tests/README.rst
 have pytest installed along with a few other dependencies. You can find the list of dependencies
 in the ``pyproject.toml`` file in the root of the repository.

 Since PTB uses a src-based layout, make sure you have installed the package in development mode before running the tests:

 .. code-block:: bash

   $ pip install -e .

 Running tests
 =============
Original file line number	Diff line number	Diff line change
Expand Up		@@ -29,7 +29,15 @@ Setting things up
		$ pip install -r requirements-dev-all.txt


		5. Install pre-commit hooks:
		5. Install the package in development mode:

		.. code-block:: bash

		$ pip install -e .

		This is necessary because python-telegram-bot uses a src-based layout where the package code is located in the ``src/`` directory.

		6. Install pre-commit hooks:

		.. code-block:: bash

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,7 +2,7 @@ name: Test Admonitions Generation
		on:
		pull_request:
		paths:
		- telegram/**
		-src/telegram/**
		- docs/**
		- .github/workflows/docs-admonitions.yml
		push:
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,7 +2,7 @@ name: Bot API Tests
		on:
		pull_request:
		paths:
		-telegram/**
		-src/telegram/**
		-tests/**
		push:
		branches:
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,7 +2,7 @@ name: Check Type Completeness
		on:
		pull_request:
		paths:
		- telegram/**
		-src/telegram/**
		- pyproject.toml
		- .github/workflows/type_completeness.yml
		push:
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,7 +2,7 @@ name: Unit Tests
		on:
		pull_request:
		paths:
		- telegram/**
		-src/telegram/**
		- tests/**
		- .github/workflows/unit_tests.yml
		- pyproject.toml
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,5 @@
		internal = "Change to `src` Layout"
		[[pull_requests]]
		uid = "4798"
		author_uid = "Bibo-Joshi"
		closes_threads = ["4797"]
Original file line number	Diff line number	Diff line change
Expand Up		@@ -99,11 +99,13 @@ webhooks = [
		[tool.hatch.version]
		# dynamically evaluates the `__version__` variable in that file
		source = "code"
		path = "telegram/_version.py"
		search-paths = ["telegram"]
		path = "src/telegram/_version.py"
		search-paths = ["src"]

		[tool.hatch.build]
		packages = ["telegram"]
		packages = ["src/telegram"]
		package-data = {"telegram" = ["py.typed"]}
		src-layout = true

		# CHANGO
		[tool.chango]
Expand DownExpand Up		@@ -136,9 +138,9 @@ select = ["E", "F", "I", "PL", "UP", "RUF", "PTH", "C4", "B", "PIE", "SIM", "RET
		[tool.ruff.lint.per-file-ignores]
		"tests/*.py" = ["B018"]
		"tests/**.py" = ["RUF012", "ASYNC230", "DTZ", "ARG", "T201", "ASYNC109", "D", "S", "TRY"]
		"telegram/**.py" = ["TRY003"]
		"telegram/ext/_applicationbuilder.py" = ["TRY004"]
		"telegram/ext/filters.py" = ["D102"]
		"src/telegram/**.py" = ["TRY003"]
		"src/telegram/ext/_applicationbuilder.py" = ["TRY004"]
		"src/telegram/ext/filters.py" = ["D102"]
		"docs/**.py" = ["INP001", "ARG", "D", "TRY003", "S"]
		"examples/**.py" = ["ARG", "D", "S105", "TRY003"]

Expand DownExpand Up		@@ -166,6 +168,7 @@ exclude-protected = ["_unfrozen"]
		# PYTEST:
		[tool.pytest.ini_options]
		testpaths = ["tests"]
		pythonpath = ["src"]
		addopts = "--no-success-flaky-report -rX"
		filterwarnings = [
		"error",
Expand DownExpand Up		@@ -230,12 +233,12 @@ ignore_missing_imports = true
		# COVERAGE:
		[tool.coverage.run]
		branch = true
		source = ["telegram"]
		source = ["src/telegram"]
		parallel = true
		concurrency = ["thread", "multiprocessing"]
		omit = [
		"tests/",
		"telegram/__main__.py"
		"src/telegram/__main__.py"
		]

		[tool.coverage.report]
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,12 @@ PTB uses `pytest`_ for testing. To run the tests, you need to
		have pytest installed along with a few other dependencies. You can find the list of dependencies
		in the ``pyproject.toml`` file in the root of the repository.

		Since PTB uses a src-based layout, make sure you have installed the package in development mode before running the tests:

		.. code-block:: bash

		$ pip install -e .

		Running tests
		=============

Expand Down