python-telegram-bot · Bibo-Joshi · May 25, 2025 · May 22, 2025 · May 22, 2025 · May 23, 2025
diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst
@@ -22,12 +22,14 @@ Setting things up
 
       $ git remote add upstream https://github.com/python-telegram-bot/python-telegram-bot
 
-4. Install dependencies:
+4. Install the package in development mode as well as optional dependencies and development dependencies.
+   Note that the `--group` argument requires `pip` 25.1 or later.
 
    .. code-block:: bash
 
-      $ pip install .[all] --group all
+      $ pip install -e .[all] --group all
 
+   Installing the package itself is necessary because python-telegram-bot uses a src-based layout where the package code is located in the ``src/`` directory.
 
 5. Install pre-commit hooks:
 

diff --git a/.github/workflows/docs-admonitions.yml b/.github/workflows/docs-admonitions.yml
@@ -2,7 +2,7 @@ name: Test Admonitions Generation
 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
@@ -2,7 +2,7 @@ name: Bot API Tests
 on:
   pull_request:
     paths:
-      - telegram/**
+      - src/telegram/**
       - tests/**
   push:
     branches:

diff --git a/.github/workflows/type_completeness.yml b/.github/workflows/type_completeness.yml
@@ -2,7 +2,7 @@ name: Check Type Completeness
 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
@@ -2,7 +2,7 @@ name: Unit Tests
 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
@@ -0,0 +1,5 @@
+internal = "Rework Repository to `src` Layout"
+[[pull_requests]]
+uid = "4798"
+author_uid = "Bibo-Joshi"
+closes_threads = ["4797"]
diff --git a/pyproject.toml b/pyproject.toml
@@ -130,11 +130,15 @@ all = ["pre-commit", { include-group = "tests" }, { include-group = "docs" }]
 [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"
 
-[tool.hatch.build]
-packages = ["telegram"]
+# See also https://github.com/pypa/hatch/issues/1230 for discussion
+# the source distribution will include most of the files in the root directory
+[tool.hatch.build.targets.sdist]
+exclude = [".venv*", "venv*", ".github"]
+# the wheel will only include the src/telegram package
+[tool.hatch.build.targets.wheel]
+packages = ["src/telegram"]
 
 # CHANGO
 [tool.chango]
@@ -167,9 +171,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"]
 
@@ -197,6 +201,7 @@ exclude-protected = ["_unfrozen"]
 # PYTEST:
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+pythonpath = ["src"]
 addopts = "--no-success-flaky-report -rX"
 filterwarnings = [
     "error",
@@ -219,6 +224,7 @@ log_cli_format = "%(funcName)s - Line %(lineno)d - %(message)s"
 
 # MYPY:
 [tool.mypy]
+mypy_path = "src"
 warn_unused_ignores = true
 warn_unused_configs = true
 disallow_untyped_defs = true
@@ -261,12 +267,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]

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
@@ -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
 =============
 

diff --git a/tests/auxil/files.py b/tests/auxil/files.py
@@ -19,6 +19,7 @@
 from pathlib import Path
 
 PROJECT_ROOT_PATH = Path(__file__).parent.parent.parent.resolve()
+SOURCE_ROOT_PATH = PROJECT_ROOT_PATH / "src" / "telegram"
 TEST_DATA_PATH = PROJECT_ROOT_PATH / "tests" / "data"
 
 

diff --git a/tests/ext/test_application.py b/tests/ext/test_application.py
@@ -58,7 +58,7 @@
 from telegram.warnings import PTBDeprecationWarning, PTBUserWarning
 from tests.auxil.asyncio_helpers import call_after
 from tests.auxil.build_messages import make_message_update
-from tests.auxil.files import PROJECT_ROOT_PATH
+from tests.auxil.files import SOURCE_ROOT_PATH
 from tests.auxil.monkeypatch import empty_get_updates, return_true
 from tests.auxil.networking import send_webhook_message
 from tests.auxil.pytest_classes import PytestApplication, PytestUpdater, make_bot
@@ -1006,7 +1006,7 @@ async def callback(update, context):
             == "ApplicationHandlerStop is not supported with handlers running non-blocking."
         )
         assert (
-            Path(recwarn[0].filename) == PROJECT_ROOT_PATH / "telegram" / "ext" / "_application.py"
+            Path(recwarn[0].filename) == SOURCE_ROOT_PATH / "ext" / "_application.py"
         ), "incorrect stacklevel!"
 
     async def test_non_blocking_no_error_handler(self, app, caplog):
@@ -1079,7 +1079,7 @@ async def error_handler(update, context):
             == "ApplicationHandlerStop is not supported with handlers running non-blocking."
         )
         assert (
-            Path(recwarn[0].filename) == PROJECT_ROOT_PATH / "telegram" / "ext" / "_application.py"
+            Path(recwarn[0].filename) == SOURCE_ROOT_PATH / "ext" / "_application.py"
         ), "incorrect stacklevel!"
 
     @pytest.mark.parametrize(("block", "expected_output"), [(False, 0), (True, 5)])

diff --git a/tests/ext/test_conversationhandler.py b/tests/ext/test_conversationhandler.py
@@ -60,7 +60,7 @@
 )
 from telegram.warnings import PTBUserWarning
 from tests.auxil.build_messages import make_command_message
-from tests.auxil.files import PROJECT_ROOT_PATH
+from tests.auxil.files import SOURCE_ROOT_PATH
 from tests.auxil.pytest_classes import PytestBot, make_bot
 from tests.auxil.slots import mro_slots
 
@@ -725,7 +725,7 @@ async def callback(_, __):
             assert recwarn[0].category is PTBUserWarning
             assert (
                 Path(recwarn[0].filename)
-                == PROJECT_ROOT_PATH / "telegram" / "ext" / "_handlers" / "conversationhandler.py"
+                == SOURCE_ROOT_PATH / "ext" / "_handlers" / "conversationhandler.py"
             ), "wrong stacklevel!"
             assert (
                 str(recwarn[0].message)
@@ -1105,11 +1105,7 @@ async def test_no_running_job_queue_warning(self, app, bot, user1, recwarn, jq):
                 assert warning.category is PTBUserWarning
                 assert (
                     Path(warning.filename)
-                    == PROJECT_ROOT_PATH
-                    / "telegram"
-                    / "ext"
-                    / "_handlers"
-                    / "conversationhandler.py"
+                    == SOURCE_ROOT_PATH / "ext" / "_handlers" / "conversationhandler.py"
                 ), "wrong stacklevel!"
             # now set app.job_queue back to it's original value
 
@@ -1428,8 +1424,7 @@ def timeout(*args, **kwargs):
             assert str(recwarn[0].message).startswith("ApplicationHandlerStop in TIMEOUT")
             assert recwarn[0].category is PTBUserWarning
             assert (
-                Path(recwarn[0].filename)
-                == PROJECT_ROOT_PATH / "telegram" / "ext" / "_jobqueue.py"
+                Path(recwarn[0].filename) == SOURCE_ROOT_PATH / "ext" / "_jobqueue.py"
             ), "wrong stacklevel!"
 
             await app.stop()

diff --git a/tests/ext/test_picklepersistence.py b/tests/ext/test_picklepersistence.py
@@ -28,7 +28,7 @@
 from telegram import Chat, Message, TelegramObject, Update, User
 from telegram.ext import ContextTypes, PersistenceInput, PicklePersistence
 from telegram.warnings import PTBUserWarning
-from tests.auxil.files import PROJECT_ROOT_PATH
+from tests.auxil.files import SOURCE_ROOT_PATH
 from tests.auxil.pytest_classes import make_bot
 from tests.auxil.slots import mro_slots
 
@@ -899,8 +899,7 @@ async def test_custom_pickler_unpickler_simple(
         assert recwarn[-1].category is PTBUserWarning
         assert str(recwarn[-1].message).startswith("Unknown bot instance found.")
         assert (
-            Path(recwarn[-1].filename)
-            == PROJECT_ROOT_PATH / "telegram" / "ext" / "_picklepersistence.py"
+            Path(recwarn[-1].filename) == SOURCE_ROOT_PATH / "ext" / "_picklepersistence.py"
         ), "wrong stacklevel!"
         pp = PicklePersistence("pickletest", single_file=False, on_flush=False)
         pp.set_bot(bot)

diff --git a/tests/test_modules.py b/tests/test_modules.py
@@ -23,9 +23,11 @@
 import os
 from pathlib import Path
 
+from tests.auxil.files import SOURCE_ROOT_PATH
+
 
 def test_public_submodules_dunder_all():
-    modules_to_search = list(Path("telegram").rglob("*.py"))
+    modules_to_search = list(SOURCE_ROOT_PATH.rglob("*.py"))
 
     if not modules_to_search:
         raise AssertionError("No modules found to search through, please modify this test.")
@@ -52,6 +54,7 @@ def test_public_submodules_dunder_all():
 
 
 def load_module(path: Path):
+    path = path.relative_to(SOURCE_ROOT_PATH.parent)
     if path.name == "__init__.py":
         mod_name = str(path.parent).replace(os.sep, ".")  # telegram(.ext) format
     else:

diff --git a/tests/test_warnings.py b/tests/test_warnings.py
@@ -23,7 +23,7 @@
 
 from telegram._utils.warnings import warn
 from telegram.warnings import PTBDeprecationWarning, PTBRuntimeWarning, PTBUserWarning
-from tests.auxil.files import PROJECT_ROOT_PATH
+from tests.auxil.files import SOURCE_ROOT_PATH
 from tests.auxil.slots import mro_slots
 
 
@@ -66,7 +66,7 @@ def make_assertion(cls):
         make_assertion(PTBUserWarning)
 
     def test_warn(self, recwarn):
-        expected_file = PROJECT_ROOT_PATH / "telegram" / "_utils" / "warnings.py"
+        expected_file = SOURCE_ROOT_PATH / "_utils" / "warnings.py"
 
         warn("test message")
         assert len(recwarn) == 1