Bump version to v13.11

Documentation Improvements (#3029 )
Co-authored-by: Hinrich Mahler <22366557+Bibo-Joshi@users.noreply.github.com> Co-authored-by: Sukka <isukkaw@gmail.com>
2026-06-20 16:15:28 +00:00 · 2022-05-26 15:15:40 +02:00 · 2022-05-26 11:10:45 +02:00 · 2022-05-25 17:40:01 +02:00 · 2022-02-02 21:16:36 +01:00 · 2022-02-02 21:05:46 +01:00
377 changed files with 16335 additions and 2495 deletions
@@ -0,0 +1,20 @@
+version = 1
+
+test_patterns = ["tests/**"]
+
+exclude_patterns = [
+    "tests/**",
+    "docs/**",
+    "telegram/vendor/**",
+    "setup.py",
+    "setup-raw.py"
+]
+
+[[analyzers]]
+name = "python"
+enabled = true
+
+  [analyzers.meta]
+  runtime_version = "3.x.x"
+  max_line_length = 99
+  skip_doc_coverage = ["module", "magic", "init", "nonpublic"]
@@ -0,0 +1,76 @@
+name: Bug Report
+description: Create a report to help us improve
+title: "[BUG]"
+labels: ["bug :bug:"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting issues of python-telegram-bot!
+
+        Use this template to notify us if you found a bug.
+
+        To make it easier for us to help you please enter detailed information below.
+
+        Please note, we only support the latest version of python-telegram-bot and master branch. Please make sure to upgrade & recreate the issue on the latest version prior to opening an issue.
+      
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      value: |
+        1. 
+        2.
+        3.
+    validations:
+      required: true
+        
+  - type: textarea
+    id: expected-behaviour
+    attributes:
+      label: Expected behaviour
+      description: Tell us what should happen
+    validations:
+      required: true
+      
+  - type: textarea
+    id: actual-behaviour
+    attributes:
+      label: Actual behaviour
+      description: Tell us what happens instead
+    validations:
+      required: true
+      
+  - type: markdown
+    attributes:
+      value: "### Configuration"
+
+  - type: input
+    id: operating-system
+    attributes:
+      label: Operating System
+    validations: 
+      required: true
+
+  - type: textarea
+    id: versions
+    attributes:
+      label: Version of Python, python-telegram-bot & dependencies
+      description: Paste the output of `$ python -m telegram` here. This will be automatically formatted into code, so no need for backticks.
+      render: shell
+    validations: 
+      required: true
+      
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Insert logs here (if necessary). This will be automatically formatted into code, so no need for backticks.
+      render: python
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: You may provide any other additional context to the bug here.
@@ -1,43 +0,0 @@
---
-name: Bug report
-about: Create a report to help us improve
-title: "[BUG]"
-labels: 'bug :bug:'
-assignees: ''
-
---
-
-<!--
-Thanks for reporting issues of python-telegram-bot!
-
-Use this template to notify us if you found a bug.
-
-To make it easier for us to help you please enter detailed information below.
-
-Please note, we only support the latest version of python-telegram-bot and
-master branch. Please make sure to upgrade & recreate the issue on the latest
-version prior to opening an issue.
-->
-### Steps to reproduce
-1.
-
-2.
-
-3.
-
-### Expected behaviour
-Tell us what should happen
-
-### Actual behaviour
-Tell us what happens instead
-
-### Configuration
-**Operating System:**
-
-
-**Version of Python, python-telegram-bot & dependencies:**
-
-``$ python -m telegram``
-
-### Logs
-Insert logs here (if necessary)
@@ -3,6 +3,6 @@ contact_links:
  - name: Telegram Group
    url: https://telegram.me/pythontelegrambotgroup
    about: Questions asked on the group usually get answered faster.
-  - name: IRC Channel
-    url: https://webchat.freenode.net/?channels=##python-telegram-bot
-    about: In case you are unable to join our group due to Telegram restrictions, you can use our IRC channel
+  - name: GitHub Discussions
+    url: https://github.com/python-telegram-bot/python-telegram-bot/discussions
+    about: For getting answers to usage on GitHub, Discussions is even better than this bug tracker :)
@@ -0,0 +1,37 @@
+name: Feature Request
+description: Suggest an idea for this project
+title: "[FEATURE]"
+labels: ["enhancement"]
+
+body:
+  - type: textarea
+    id: related-problem
+    attributes:
+      label: "What kind of feature are you missing? Where do you notice a shortcoming of PTB?"
+      description: "A clear and concise description of what the problem is."
+      placeholder: "Example: I want to do X, but there is no way to do it."
+    validations:
+      required: true
+      
+  - type: textarea
+    id: solution
+    attributes:
+      label: "Describe the solution you'd like"
+      description: "A clear and concise description of what you want to happen."
+      placeholder: "Example: I think it would be nice if you would add feature Y so I can do X."
+    validations:
+      required: true
+        
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "Describe alternatives you've considered"
+      description: "A clear and concise description of any alternative solutions or features you've considered."
+      placeholder: "Example: I considered Z to be able to do X, but that didn't work because..."
+      
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: "Additional context"
+      description: "Add any other context or screenshots about the feature request here."
+      placeholder: "Example: Here's a photo of my cat!"
@@ -1,24 +0,0 @@
---
-name: Feature request
-about: Suggest an idea for this project
-title: "[FEATURE]"
-labels: enhancement
-assignees: ''
-
---
-
-#### Is your feature request related to a problem? Please describe.
-A clear and concise description of what the problem is.
-Ex. *I want to do X, but there is no way to do it.*
-
-#### Describe the solution you'd like
-A clear and concise description of what you want to happen.
-Ex. *I think it would be nice if you would add feature Y so it will make it easier.*
-
-#### Describe alternatives you've considered
-A clear and concise description of any alternative solutions or features you've considered.
-Ex. *I considered Z, but that didn't work because...*
-
-#### Additional context
-Add any other context or screenshots about the feature request here.
-Ex. *Here's a photo of my cat!*
@@ -1,29 +0,0 @@
---
-name: Question
-about: Get help with errors or general questions
-title: "[QUESTION]"
-labels: question
-assignees: ''
-
---
-
-<!--
-Hey there, you have a question? We are happy to answer. Please make sure no similar question was opened already.
-
-To make it easier for us to help you, please read this article https://git.io/JURJO and try to follow the template below as closely as possible.
-
-Please mind that there is also a users' Telegram group at https://t.me/pythontelegrambotgroup for questions about the library. Questions asked there might be answered quicker than here. In case you are unable to join our group due to Telegram restrictions, you can use our IRC channel at https://webchat.freenode.net/?channels=##python-telegram-bot to participate in the group.
-->
-
-### Issue I am facing
-Please describe the issue here in as much detail as possible
-
-### Traceback to the issue
-```
-put it here
-```
-
-### Related part of your code
-```python
-put it here
-```
@@ -0,0 +1,68 @@
+name: Question
+description: Get help with errors or general questions
+title: "[QUESTION]"
+labels: ["question"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Hey there, you have a question? We are happy to answer. Please make sure no similar question was opened already.
+
+        To make it easier for us to help you, please read this [article](https://github.com/python-telegram-bot/python-telegram-bot/wiki/Ask-Right).
+
+        Please mind that there is also a users' [Telegram group](https://t.me/pythontelegrambotgroup) for questions about the library. Questions asked there might be answered quicker than here. Moreover, [GitHub Discussions](https://github.com/python-telegram-bot/python-telegram-bot/discussions) offer a slightly better format to discuss usage questions.
+
+  - type: textarea
+    id: issue-faced
+    attributes:
+      label: "Issue I am facing"
+      description: "Please describe the issue here in as much detail as possible"
+    validations:
+      required: true
+      
+  - type: textarea
+    id: traceback
+    attributes:
+      label: "Traceback to the issue"
+      description: "If you are facing a specific error message, please paste the traceback here. This will be automatically formatted into python code, so no need for backticks."
+      placeholder: |
+        Traceback (most recent call last):
+          File "/home/bot.py", line 1, in main
+            foo = bar()
+          ...
+        telegram.error.BadRequest: Traceback not found
+      render: python
+        
+  - type: textarea
+    id: related-code
+    attributes:
+      label: "Related part of your code"
+      description: "This will be automatically formatted into code (python), so no need for backticks."
+      placeholder: |
+        logging.basicConfig(
+            format="%(asctime)s - %(name)s - %(levelname)s - %(message)s", level=logging.INFO
+        )
+
+        logger = logging.getLogger(__name__)
+      render: python
+
+  - type: markdown
+    attributes:
+      value: "### Configuration"
+
+  - type: input
+    id: operating-system
+    attributes:
+      label: Operating System
+    validations: 
+      required: true
+      
+  - type: textarea
+    id: versions
+    attributes:
+      label: Version of Python, python-telegram-bot & dependencies
+      description: Paste the output of `$ python -m telegram` here. This will be automatically formatted into code, so no need for backticks.
+      render: shell
+    validations: 
+      required: true
@@ -7,6 +7,7 @@ Hey! You're PRing? Cool! Please have a look at the below checklist. It's here to
 - [ ] Added `.. versionadded:: version`, `.. versionchanged:: version` or `.. deprecated:: version` to the docstrings for user facing changes (for methods/class descriptions, arguments and attributes)
 - [ ] Created new or adapted existing unit tests
 - [ ] Added myself alphabetically to `AUTHORS.rst` (optional)
+- [ ] Added new classes & modules to the docs


 ### If the PR contains API changes (otherwise, you can delete this passage)
@@ -28,3 +29,4 @@ Hey! You're PRing? Cool! Please have a look at the below checklist. It's here to
    - [ ] Added new filters for new message (sub)types
    - [ ] Added or updated documentation for the changed class(es) and/or method(s)
    - [ ] Updated the Bot API version number in all places: `README.rst` and `README_RAW.rst` (including the badge), as well as `telegram.constants.BOT_API_VERSION`
+    - [ ] Added logic for arbitrary callback data in `tg.ext.Bot` for new methods that either accept a `reply_markup` in some form or have a return type that is/contains `telegram.Message`
@@ -12,7 +12,7 @@ jobs:
      - uses: dessant/lock-threads@v2.0.1
        with:
          github-token: ${{ github.token }}
-          issue-lock-inactive-days: '1'
+          issue-lock-inactive-days: '7'
          issue-lock-reason: ''
-          pr-lock-inactive-days: '1'
+          pr-lock-inactive-days: '7'
          pr-lock-reason: ''
@@ -3,9 +3,11 @@ on:
  pull_request:
    branches:
      - master
+      - v13.x
  push:
    branches: 
      - master
+      - v13.x

 jobs:
  pytest:
@@ -13,7 +15,7 @@ jobs:
    runs-on: ${{matrix.os}}
    strategy:
      matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: [3.7, 3.8, 3.9]
        os: [ubuntu-latest, windows-latest, macos-latest]
      fail-fast: False
    steps:
@@ -60,7 +62,7 @@ jobs:
        shell: bash --noprofile --norc {0}

      - name: Submit coverage
-        uses: codecov/codecov-action@v1.0.13
+        uses: codecov/codecov-action@v1
        with:
          env_vars: OS,PYTHON
          name: ${{ matrix.os }}-${{ matrix.python-version }}
@@ -79,7 +81,7 @@ jobs:
        run:
          git submodule update --init --recursive
      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v1
+        uses: actions/setup-python@v2
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install dependencies
@@ -94,27 +96,3 @@ jobs:
        env:
          TEST_OFFICIAL: "true"
        shell: bash --noprofile --norc {0}
-  test_pre_commit:
-    name: test-pre-commit
-    runs-on: ${{matrix.os}}
-    strategy:
-      matrix:
-        python-version: [3.7]
-        os: [ubuntu-latest]
-      fail-fast: False
-    steps:
-      - uses: actions/checkout@v2
-      - name: Initialize vendored libs
-        run:
-          git submodule update --init --recursive
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v1
-        with:
-          python-version: ${{ matrix.python-version }}
-      - name: Install dependencies
-        run: |
-          python -W ignore -m pip install --upgrade pip
-          python -W ignore -m pip install -r requirements.txt
-          python -W ignore -m pip install -r requirements-dev.txt
-      - name: Run pre-commit tests
-        run: pre-commit run --all-files
@@ -1,20 +1,25 @@
 # Make sure that
 #   * the revs specified here match requirements-dev.txt
 #   * the additional_dependencies here match requirements.txt
+
+ci:
+    # We currently only need this behavior on the v13.x branch were we have the vendored urllib
+    submodules: true
+
 repos:
 -   repo: https://github.com/psf/black
-    rev: 20.8b1
+    rev: 22.3.0
    hooks:
    -   id: black
        args:
        - --diff
        - --check
 -   repo: https://gitlab.com/pycqa/flake8
-    rev: 3.9.1
+    rev: 3.9.2
    hooks:
    -   id: flake8
 -   repo: https://github.com/PyCQA/pylint
-    rev: v2.8.2
+    rev: v2.8.3
    hooks:
    -   id: pylint
        files: ^(telegram|examples)/.*\.py$
@@ -22,8 +27,9 @@ repos:
          - --rcfile=setup.cfg
        additional_dependencies:
          - certifi
-          - tornado>=5.1
+          - tornado>=6.1
          - APScheduler==3.6.3
+          - cachetools==4.2.2
          - . # this basically does `pip install -e .`
 -   repo: https://github.com/pre-commit/mirrors-mypy
    rev: v0.812
@@ -33,8 +39,9 @@ repos:
        files: ^telegram/.*\.py$
        additional_dependencies:
          - certifi
-          - tornado>=5.1
+          - tornado>=6.1
          - APScheduler==3.6.3
+          - cachetools==4.2.2
          - . # this basically does `pip install -e .`
    -   id: mypy
        name: mypy-examples
@@ -44,11 +51,12 @@ repos:
          - --follow-imports=silent
        additional_dependencies:
          - certifi
-          - tornado>=5.1
+          - tornado>=6.1
          - APScheduler==3.6.3
+          - cachetools==4.2.2
          - . # this basically does `pip install -e .`
 -   repo: https://github.com/asottile/pyupgrade
-    rev: v2.13.0
+    rev: v2.19.1
    hooks:
    -   id: pyupgrade
        files: ^(telegram|examples|tests)/.*\.py$
@@ -26,6 +26,7 @@ Contributors

 The following wonderful people contributed directly or indirectly to this project:

+- `Abshar <https://github.com/abxhr>`_
 - `Alateas <https://github.com/alateas>`_
 - `Ales Dokshanin <https://github.com/alesdokshanin>`_
 - `Ambro17 <https://github.com/Ambro17>`_
@@ -39,6 +40,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `daimajia <https://github.com/daimajia>`_
 - `Daniel Reed <https://github.com/nmlorg>`_
 - `D David Livingston <https://github.com/daviddl9>`_
+- `DonalDuck004 <https://github.com/DonalDuck004>`_
 - `Eana Hufwe <https://github.com/blueset>`_
 - `Ehsan Online <https://github.com/ehsanonline>`_
 - `Eli Gao <https://github.com/eligao>`_
@@ -77,12 +79,14 @@ The following wonderful people contributed directly or indirectly to this projec
 - `naveenvhegde <https://github.com/naveenvhegde>`_
 - `neurrone <https://github.com/neurrone>`_
 - `NikitaPirate <https://github.com/NikitaPirate>`_
+- `Nikolai Krivenko <https://github.com/nkrivenko>`_
 - `njittam <https://github.com/njittam>`_
 - `Noam Meltzer <https://github.com/tsnoam>`_
 - `Oleg Shlyazhko <https://github.com/ollmer>`_
 - `Oleg Sushchenko <https://github.com/feuillemorte>`_
 - `Or Bin <https://github.com/OrBin>`_
 - `overquota <https://github.com/overquota>`_
+- `Paradox <https://github.com/paradox70>`_
 - `Patrick Hofmann <https://github.com/PH89>`_
 - `Paul Larsen <https://github.com/PaulSonOfLars>`_
 - `Pieter Schutz <https://github.com/eldinnie>`_
@@ -105,6 +109,7 @@ The following wonderful people contributed directly or indirectly to this projec
 - `Vorobjev Simon <https://github.com/simonvorobjev>`_
 - `Wagner Macedo <https://github.com/wagnerluis1982>`_
 - `wjt <https://github.com/wjt>`_
+- `zeroone2numeral2 <https://github.com/zeroone2numeral2>`_
 - `zeshuaro <https://github.com/zeshuaro>`_

 Please add yourself here alphabetically when you submit your first pull request.
@@ -2,6 +2,191 @@
 Changelog
 =========

+Version 13.12
+=============
+*Released 2022-05-26*
+
+This is the technical changelog for version 13.12. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Major Changes:**
+
+- Full Support for API 6.0 (`#3027`_)
+
+**Minor Changes:**
+
+- Documentation Improvements (`#3029`_)
+
+.. _`#3027`: https://github.com/python-telegram-bot/python-telegram-bot/pull/3027
+.. _`#3029`: https://github.com/python-telegram-bot/python-telegram-bot/pull/3029
+
+Version 13.11
+=============
+*Released 2022-02-02*
+
+This is the technical changelog for version 13.11. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Major Changes:**
+
+- Full Support for Bot API 5.7 (`#2881`_)
+
+.. _`#2881`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2881
+
+Version 13.10
+=============
+*Released 2022-01-03*
+
+This is the technical changelog for version 13.10. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Major Changes:**
+
+- Full Support for API 5.6 (`#2835`_)
+
+**Minor Changes & Doc fixes:**
+
+- Update Copyright to 2022 (`#2836`_)
+- Update Documentation of ``BotCommand`` (`#2820`_)
+
+.. _`#2835`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2835
+.. _`#2836`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2836
+.. _`#2820`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2820
+
+Version 13.9
+============
+*Released 2021-12-11*
+
+This is the technical changelog for version 13.9. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Major Changes:**
+
+- Full Support for Api 5.5 (`#2809`_)
+
+**Minor Changes**
+
+- Adjust Automated Locking of Inactive Issues (`#2775`_)
+
+.. _`#2809`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2809
+.. _`#2775`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2775
+
+Version 13.8.1
+==============
+*Released 2021-11-08*
+
+This is the technical changelog for version 13.8.1. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Doc fixes:**
+
+- Add ``ChatJoinRequest(Handler)`` to Docs (`#2771`_)
+
+.. _`#2771`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2771
+
+Version 13.8
+============
+*Released 2021-11-08*
+
+This is the technical changelog for version 13.8. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Major Changes:**
+
+- Full support for API 5.4 (`#2767`_)
+
+**Minor changes, CI improvements, Doc fixes and Type hinting:**
+
+- Create Issue Template Forms (`#2689`_)
+- Fix ``camelCase`` Functions in ``ExtBot`` (`#2659`_)
+- Fix Empty Captions not Being Passed by ``Bot.copy_message`` (`#2651`_)
+- Fix Setting Thumbs When Uploading A Single File (`#2583`_)
+- Fix Bug in ``BasePersistence.insert``/``replace_bot`` for Objects with ``__dict__`` not in ``__slots__`` (`#2603`_)
+
+.. _`#2767`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2767
+.. _`#2689`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2689
+.. _`#2659`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2659
+.. _`#2651`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2651
+.. _`#2583`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2583
+.. _`#2603`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2603
+
+Version 13.7
+============
+*Released 2021-07-01*
+
+This is the technical changelog for version 13.7. More elaborate release notes can be found in the news channel `@pythontelegrambotchannel <https://t.me/pythontelegrambotchannel>`_.
+
+**Major Changes:**
+
+- Full support for Bot API 5.3 (`#2572`_)
+
+**Bug Fixes:**
+
+- Fix Bug in ``BasePersistence.insert/replace_bot`` for Objects with ``__dict__`` in their slots (`#2561`_)
+- Remove Incorrect Warning About ``Defaults`` and ``ExtBot`` (`#2553`_)
+
+**Minor changes, CI improvements, Doc fixes and Type hinting:**
+
+- Type Hinting Fixes (`#2552`_)
+- Doc Fixes (`#2551`_)
+- Improve Deprecation Warning for ``__slots__`` (`#2574`_)
+- Stabilize CI (`#2575`_)
+- Fix Coverage Configuration (`#2571`_)
+- Better Exception-Handling for ``BasePersistence.replace/insert_bot`` (`#2564`_)
+- Remove Deprecated ``pass_args`` from Deeplinking Example (`#2550`_)
+
+.. _`#2572`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2572
+.. _`#2561`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2561
+.. _`#2553`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2553
+.. _`#2552`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2552
+.. _`#2551`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2551
+.. _`#2574`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2574
+.. _`#2575`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2575
+.. _`#2571`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2571
+.. _`#2564`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2564
+.. _`#2550`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2550
+
+Version 13.6
+============
+*Released 2021-06-06*
+
+New Features:
+
+- Arbitrary ``callback_data`` (`#1844`_)
+- Add ``ContextTypes`` & ``BasePersistence.refresh_user/chat/bot_data`` (`#2262`_)
+- Add ``Filters.attachment`` (`#2528`_)
+- Add ``pattern`` Argument to ``ChosenInlineResultHandler`` (`#2517`_)
+
+Major Changes:
+
+- Add ``slots`` (`#2345`_)
+
+Minor changes, CI improvements, Doc fixes and Type hinting:
+
+- Doc Fixes (`#2495`_, `#2510`_)
+- Add ``max_connections`` Parameter to ``Updater.start_webhook`` (`#2547`_)
+- Fix for ``Promise.done_callback`` (`#2544`_)
+- Improve Code Quality (`#2536`_, `#2454`_)
+- Increase Test Coverage of ``CallbackQueryHandler`` (`#2520`_)
+- Stabilize CI (`#2522`_, `#2537`_, `#2541`_)
+- Fix ``send_phone_number_to_provider`` argument for ``Bot.send_invoice`` (`#2527`_)
+- Handle Classes as Input for ``BasePersistence.replace/insert_bot`` (`#2523`_)
+- Bump Tornado Version and Remove Workaround from `#2067`_ (`#2494`_)
+
+.. _`#1844`: https://github.com/python-telegram-bot/python-telegram-bot/pull/1844
+.. _`#2262`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2262
+.. _`#2528`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2528
+.. _`#2517`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2517
+.. _`#2345`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2345
+.. _`#2495`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2495
+.. _`#2547`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2547
+.. _`#2544`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2544
+.. _`#2536`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2536
+.. _`#2454`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2454
+.. _`#2520`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2520
+.. _`#2522`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2522
+.. _`#2537`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2537
+.. _`#2541`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2541
+.. _`#2527`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2527
+.. _`#2523`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2523
+.. _`#2067`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2067
+.. _`#2494`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2494
+.. _`#2510`: https://github.com/python-telegram-bot/python-telegram-bot/pull/2510
+
 Version 13.5
 ============
 *Released 2021-04-30*
@@ -727,7 +912,7 @@ Expect minor releases soon (mainly complete Bot API 4.4 support)
 - Error Handler now handles all types of exceptions (`#1485`_)
 - Return UTC from from_timestamp() (`#1485`_)

-**See the wiki page at https://git.io/fxJuV for a detailed guide on how to migrate from version 11 to version 12.**
+**See the wiki page at https://github.com/python-telegram-bot/python-telegram-bot/wiki/Transition-guide-to-Version-12.0 for a detailed guide on how to migrate from version 11 to version 12.**

 Context based callbacks (`#1100`_)
 ----------------------------------
@@ -932,7 +1117,7 @@ Non Bot API 4.0 changes:
 .. _`#1172`: https://github.com/python-telegram-bot/python-telegram-bot/pull/1172
 .. _`#1179`: https://github.com/python-telegram-bot/python-telegram-bot/pull/1179
 .. _`#1184`: https://github.com/python-telegram-bot/python-telegram-bot/pull/1184
-.. _`our telegram passport wiki page`: https://git.io/fAvYd
+.. _`our telegram passport wiki page`: https://github.com/python-telegram-bot/python-telegram-bot/wiki/Telegram-Passport

 Version 10.1.0
 ==============
@@ -1,5 +1,5 @@
 ..
-    Make user to apply any changes to this file to README_RAW.rst as well!
+    Make sure to apply any changes to this file to README_RAW.rst as well!

 .. image:: https://github.com/python-telegram-bot/logos/blob/master/logo-text/png/ptb-logo-text_768.png?raw=true
   :align: center
@@ -20,7 +20,7 @@ We have a vibrant community of developers helping each other in our `Telegram gr
   :target: https://pypi.org/project/python-telegram-bot/
   :alt: Supported Python versions

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

@@ -50,19 +50,19 @@ We have a vibrant community of developers helping each other in our `Telegram gr

 .. image:: https://api.codacy.com/project/badge/Grade/99d901eaa09b44b4819aec05c330c968
   :target: https://www.codacy.com/app/python-telegram-bot/python-telegram-bot?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=python-telegram-bot/python-telegram-bot&amp;utm_campaign=Badge_Grade
-   :alt: Code quality
+   :alt: Code quality: Codacy
+
+.. image:: https://deepsource.io/gh/python-telegram-bot/python-telegram-bot.svg/?label=active+issues
+   :target: https://deepsource.io/gh/python-telegram-bot/python-telegram-bot/?ref=repository-badge
+   :alt: Code quality: DeepSource

 .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-    :target: https://github.com/psf/black
+   :target: https://github.com/psf/black

 .. image:: https://img.shields.io/badge/Telegram-Group-blue.svg?logo=telegram
   :target: https://telegram.me/pythontelegrambotgroup
   :alt: Telegram Group

-.. image:: https://img.shields.io/badge/IRC-Channel-blue.svg
-   :target: https://webchat.freenode.net/?channels=##python-telegram-bot
-   :alt: IRC Bridge
-
 =================
 Table of contents
 =================
@@ -87,19 +87,20 @@ Table of contents

 - `License`_

+
 ============
 Introduction
 ============

 This library provides a pure Python interface for the
 `Telegram Bot API <https://core.telegram.org/bots/api>`_.
-It's compatible with Python versions 3.6+. PTB might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.
+It's compatible with Python versions 3.7+. PTB might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.

 In addition to the pure API implementation, this library features a number of high-level classes to
 make the development of bots easy and straightforward. These classes are contained in the
 ``telegram.ext`` submodule.

-A pure API implementation *without* ``telegram.ext`` is available as the standalone package ``python-telegram-bot-raw``.  `See here for details. <https://github.com/python-telegram-bot/python-telegram-bot/blob/master/README_RAW.rst>`_
+A pure API implementation *without* ``telegram.ext`` is available as the standalone package ``python-telegram-bot-raw``.  `See here for details. <https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/README_RAW.rst>`_

 ----
 Note
@@ -111,7 +112,7 @@ Installing both ``python-telegram-bot`` and ``python-telegram-bot-raw`` in conju
 Telegram API support
 ====================

-All types and methods of the Telegram Bot API **5.2** are supported.
+All types and methods of the Telegram Bot API **6.0** are supported.

 ==========
 Installing
@@ -171,7 +172,7 @@ look at ``echobot.py``, it is the de facto base for most of the bots out there.
 the code for these examples are released to the public domain, so you can start by grabbing the
 code and building on top of it.

-Visit `this page <https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/README.md>`_ to discover the official examples or look at the examples on the `wiki <https://github.com/python-telegram-bot/python-telegram-bot/wiki/Examples>`_ to see other bots the community has built.
+Visit `this page <https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/README.md>`_ to discover the official examples or look at the examples on the `wiki <https://github.com/python-telegram-bot/python-telegram-bot/wiki/Examples>`_ to see other bots the community has built.

 -------
 Logging
@@ -215,20 +216,18 @@ You can get help in several ways:

 1. We have a vibrant community of developers helping each other in our `Telegram group <https://telegram.me/pythontelegrambotgroup>`_. Join us!

-2. In case you are unable to join our group due to Telegram restrictions, you can use our `IRC channel <https://webchat.freenode.net/?channels=##python-telegram-bot>`_.
+2. Report bugs, request new features or ask questions by `creating an issue <https://github.com/python-telegram-bot/python-telegram-bot/issues/new/choose>`_ or `a discussion <https://github.com/python-telegram-bot/python-telegram-bot/discussions/new>`_.

-3. Report bugs, request new features or ask questions by `creating an issue <https://github.com/python-telegram-bot/python-telegram-bot/issues/new/choose>`_ or `a discussion <https://github.com/python-telegram-bot/python-telegram-bot/discussions/new>`_.
+3. Our `Wiki pages <https://github.com/python-telegram-bot/python-telegram-bot/wiki/>`_ offer a growing amount of resources.

-4. Our `Wiki pages <https://github.com/python-telegram-bot/python-telegram-bot/wiki/>`_ offer a growing amount of resources.
-
-5. You can even ask for help on Stack Overflow using the `python-telegram-bot tag <https://stackoverflow.com/questions/tagged/python-telegram-bot>`_.
+4. You can even ask for help on Stack Overflow using the `python-telegram-bot tag <https://stackoverflow.com/questions/tagged/python-telegram-bot>`_.


 ============
 Contributing
 ============

-Contributions of all sizes are welcome. Please review our `contribution guidelines <https://github.com/python-telegram-bot/python-telegram-bot/blob/master/.github/CONTRIBUTING.rst>`_ to get started. You can also help by `reporting bugs <https://github.com/python-telegram-bot/python-telegram-bot/issues/new>`_.
+Contributions of all sizes are welcome. Please review our `contribution guidelines <https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/.github/CONTRIBUTING.rst>`_ to get started. You can also help by `reporting bugs <https://github.com/python-telegram-bot/python-telegram-bot/issues/new>`_.

 ========
 Donating
@@ -1,5 +1,5 @@
 ..
-    Make user to apply any changes to this file to README.rst as well!
+    Make sure to apply any changes to this file to README.rst as well!

 .. image:: https://github.com/python-telegram-bot/logos/blob/master/logo-text/png/ptb-raw-logo-text_768.png?raw=true
   :align: center
@@ -20,7 +20,7 @@ We have a vibrant community of developers helping each other in our `Telegram gr
   :target: https://pypi.org/project/python-telegram-bot-raw/
   :alt: Supported Python versions

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

@@ -50,19 +50,19 @@ We have a vibrant community of developers helping each other in our `Telegram gr

 .. image:: https://api.codacy.com/project/badge/Grade/99d901eaa09b44b4819aec05c330c968
   :target: https://www.codacy.com/app/python-telegram-bot/python-telegram-bot?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=python-telegram-bot/python-telegram-bot&amp;utm_campaign=Badge_Grade
-   :alt: Code quality
+   :alt: Code quality: Codacy
+
+.. image:: https://deepsource.io/gh/python-telegram-bot/python-telegram-bot.svg/?label=active+issues
+   :target: https://deepsource.io/gh/python-telegram-bot/python-telegram-bot/?ref=repository-badge
+   :alt: Code quality: DeepSource

 .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-    :target: https://github.com/psf/black
+   :target: https://github.com/psf/black

 .. image:: https://img.shields.io/badge/Telegram-Group-blue.svg?logo=telegram
   :target: https://telegram.me/pythontelegrambotgroup
   :alt: Telegram Group

-.. image:: https://img.shields.io/badge/IRC-Channel-blue.svg
-   :target: https://webchat.freenode.net/?channels=##python-telegram-bot
-   :alt: IRC Bridge
-
 =================
 Table of contents
 =================
@@ -91,7 +91,7 @@ Introduction

 This library provides a pure Python, lightweight interface for the
 `Telegram Bot API <https://core.telegram.org/bots/api>`_.
-It's compatible with Python versions 3.6+. PTB-Raw might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.
+It's compatible with Python versions 3.7+. PTB-Raw might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.

 ``python-telegram-bot-raw`` is part of the `python-telegram-bot <https://python-telegram-bot.org>`_ ecosystem and provides the pure API functionality extracted from PTB. It therefore does *not* have independent release schedules, changelogs or documentation. Please consult the PTB resources.

@@ -105,7 +105,7 @@ Installing both ``python-telegram-bot`` and ``python-telegram-bot-raw`` in conju
 Telegram API support
 ====================

-All types and methods of the Telegram Bot API **5.2** are supported.
+All types and methods of the Telegram Bot API **6.0** are supported.

 ==========
 Installing
@@ -198,19 +198,17 @@ You can get help in several ways:

 1. We have a vibrant community of developers helping each other in our `Telegram group <https://telegram.me/pythontelegrambotgroup>`_. Join us!

-2. In case you are unable to join our group due to Telegram restrictions, you can use our `IRC channel <https://webchat.freenode.net/?channels=##python-telegram-bot>`_.
+2. Report bugs, request new features or ask questions by `creating an issue <https://github.com/python-telegram-bot/python-telegram-bot/issues/new/choose>`_ or `a discussion <https://github.com/python-telegram-bot/python-telegram-bot/discussions/new>`_.

-3. Report bugs, request new features or ask questions by `creating an issue <https://github.com/python-telegram-bot/python-telegram-bot/issues/new/choose>`_ or `a discussion <https://github.com/python-telegram-bot/python-telegram-bot/discussions/new>`_.
+3. Our `Wiki pages <https://github.com/python-telegram-bot/python-telegram-bot/wiki/>`_ offer a growing amount of resources.

-4. Our `Wiki pages <https://github.com/python-telegram-bot/python-telegram-bot/wiki/>`_ offer a growing amount of resources.
-
-5. You can even ask for help on Stack Overflow using the `python-telegram-bot tag <https://stackoverflow.com/questions/tagged/python-telegram-bot>`_.
+4. You can even ask for help on Stack Overflow using the `python-telegram-bot tag <https://stackoverflow.com/questions/tagged/python-telegram-bot>`_.

 ============
 Contributing
 ============

-Contributions of all sizes are welcome. Please review our `contribution guidelines <https://github.com/python-telegram-bot/python-telegram-bot/blob/master/.github/CONTRIBUTING.rst>`_ to get started. You can also help by `reporting bugs <https://github.com/python-telegram-bot/python-telegram-bot/issues/new>`_.
+Contributions of all sizes are welcome. Please review our `contribution guidelines <https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/.github/CONTRIBUTING.rst>`_ to get started. You can also help by `reporting bugs <https://github.com/python-telegram-bot/python-telegram-bot/issues/new>`_.

 ========
 Donating
@@ -2,7 +2,7 @@
    /*
    Generated by https://darkreader.org
    Instructions: Install the extension on a Chromium-based browser
-    Then do this to export the CSS: https://git.io/JOM6t and drop it here
+    Then do this to export the CSS: https://github.com/darkreader/darkreader/issues/604#issuecomment-661107893 and drop it here
    Some color values where manually changed - just search for "/*" in this file and insert them in the new css
    */
    /* User-Agent Style */
@@ -60,9 +60,9 @@ author = u'Leandro Toledo'
 # built documents.
 #
 # The short X.Y version.
-version = '13.5'  # telegram.__version__[:3]
+version = '13.12'  # telegram.__version__[:3]
 # The full version, including alpha/beta/rc tags.
-release = '13.5'  # telegram.__version__
+release = '13.12'  # telegram.__version__

 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScope
+========================
+
+.. autoclass:: telegram.BotCommandScope
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeAllChatAdministrators
+=============================================
+
+.. autoclass:: telegram.BotCommandScopeAllChatAdministrators
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeAllGroupChats
+=======================================
+
+.. autoclass:: telegram.BotCommandScopeAllGroupChats
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeAllPrivateChats
+=======================================
+
+.. autoclass:: telegram.BotCommandScopeAllPrivateChats
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeChat
+============================
+
+.. autoclass:: telegram.BotCommandScopeChat
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeChatAdministrators
+==========================================
+
+.. autoclass:: telegram.BotCommandScopeChatAdministrators
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeChatMember
+==================================
+
+.. autoclass:: telegram.BotCommandScopeChatMember
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/botcommandscope.py
+
+telegram.BotCommandScopeDefault
+===============================
+
+.. autoclass:: telegram.BotCommandScopeDefault
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatadministratorrights.py
+
+telegram.ChatAdministratorRights
+================================
+
+.. autoclass:: telegram.ChatAdministratorRights
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatjoinrequest.py
+
+telegram.ChatJoinRequest
+========================
+
+.. autoclass:: telegram.ChatJoinRequest
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatmember.py
+
+telegram.ChatMemberAdministrator
+================================
+
+.. autoclass:: telegram.ChatMemberAdministrator
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatmember.py
+
+telegram.ChatMemberBanned
+=========================
+
+.. autoclass:: telegram.ChatMemberBanned
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatmember.py
+
+telegram.ChatMemberLeft
+=======================
+
+.. autoclass:: telegram.ChatMemberLeft
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatmember.py
+
+telegram.ChatMemberMember
+=========================
+
+.. autoclass:: telegram.ChatMemberMember
+    :members:
+    :show-inheritance:
@@ -0,0 +1,9 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatmember.py
+
+telegram.ChatMemberOwner
+========================
+
+.. autoclass:: telegram.ChatMemberOwner
+    :members:
+    :show-inheritance:
+
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/chatmember.py
+
+telegram.ChatMemberRestricted
+=============================
+
+.. autoclass:: telegram.ChatMemberRestricted
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/ext/callbackdatacache.py
+
+telegram.ext.CallbackDataCache
+==============================
+
+.. autoclass:: telegram.ext.CallbackDataCache
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/ext/chatjoinrequesthandler.py
+
+telegram.ext.ChatJoinRequestHandler
+===================================
+
+.. autoclass:: telegram.ext.ChatJoinRequestHandler
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/ext/contexttypes.py
+
+telegram.ext.ContextTypes
+=========================
+
+.. autoclass:: telegram.ext.ContextTypes
+    :members:
+    :show-inheritance:
@@ -0,0 +1,9 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/ext/extbot.py
+
+telegram.ext.ExtBot
+===================
+
+.. autoclass:: telegram.ext.ExtBot
+    :show-inheritance:
+
+    .. autofunction:: telegram.ext.ExtBot.insert_callback_data
@@ -5,5 +5,4 @@ telegram.ext.Handler

 .. autoclass:: telegram.ext.Handler
    :members:
-    :undoc-members:
    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/ext/callbackdatacache.py
+
+telegram.ext.InvalidCallbackData
+================================
+
+.. autoclass:: telegram.ext.InvalidCallbackData
+    :members:
+    :show-inheritance:
@@ -3,15 +3,17 @@ telegram.ext package

 .. toctree::

+    telegram.ext.extbot
    telegram.ext.updater
    telegram.ext.dispatcher
    telegram.ext.dispatcherhandlerstop
    telegram.ext.callbackcontext
-    telegram.ext.defaults
    telegram.ext.job
    telegram.ext.jobqueue
    telegram.ext.messagequeue
    telegram.ext.delayqueue
+    telegram.ext.contexttypes
+    telegram.ext.defaults

 Handlers
 --------
@@ -20,8 +22,9 @@ Handlers

    telegram.ext.handler
    telegram.ext.callbackqueryhandler
-    telegram.ext.choseninlineresulthandler
+    telegram.ext.chatjoinrequesthandler
    telegram.ext.chatmemberhandler
+    telegram.ext.choseninlineresulthandler
    telegram.ext.commandhandler
    telegram.ext.conversationhandler
    telegram.ext.inlinequeryhandler
@@ -46,9 +49,18 @@ Persistence
    telegram.ext.picklepersistence
    telegram.ext.dictpersistence

+Arbitrary Callback Data
+-----------------------
+
+.. toctree::
+
+    telegram.ext.callbackdatacache
+    telegram.ext.invalidcallbackdata
+
 utils
 -----

 .. toctree::

-    telegram.ext.utils.promise
+    telegram.ext.utils.promise
+    telegram.ext.utils.types
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/ext/utils/types.py
+
+telegram.ext.utils.types Module
+================================
+
+.. automodule:: telegram.ext.utils.types
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/menubutton.py
+
+telegram.MenuButton
+===================
+
+.. autoclass:: telegram.MenuButton
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/menubutton.py
+
+telegram.MenuButtonCommands
+===========================
+
+.. autoclass:: telegram.MenuButtonCommands
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/menubutton.py
+
+telegram.MenuButtonDefault
+==========================
+
+.. autoclass:: telegram.MenuButtonDefault
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/menubutton.py
+
+telegram.MenuButtonWebApp
+=========================
+
+.. autoclass:: telegram.MenuButtonWebApp
+    :members:
+    :show-inheritance:
@@ -7,12 +7,28 @@ telegram package
    telegram.audio
    telegram.bot
    telegram.botcommand
+    telegram.botcommandscope
+    telegram.botcommandscopedefault
+    telegram.botcommandscopeallprivatechats
+    telegram.botcommandscopeallgroupchats
+    telegram.botcommandscopeallchatadministrators
+    telegram.botcommandscopechat
+    telegram.botcommandscopechatadministrators
+    telegram.botcommandscopechatmember
    telegram.callbackquery
    telegram.chat
+    telegram.chatadministratorrights
    telegram.chataction
    telegram.chatinvitelink
+    telegram.chatjoinrequest
    telegram.chatlocation
    telegram.chatmember
+    telegram.chatmemberowner
+    telegram.chatmemberadministrator
+    telegram.chatmembermember
+    telegram.chatmemberrestricted
+    telegram.chatmemberleft
+    telegram.chatmemberbanned
    telegram.chatmemberupdated
    telegram.chatpermissions
    telegram.chatphoto
@@ -36,6 +52,10 @@ telegram package
    telegram.keyboardbuttonpolltype
    telegram.location
    telegram.loginurl
+    telegram.menubutton
+    telegram.menubuttoncommands
+    telegram.menubuttondefault
+    telegram.menubuttonwebapp
    telegram.message
    telegram.messageautodeletetimerchanged
    telegram.messageid
@@ -49,18 +69,25 @@ telegram package
    telegram.replykeyboardremove
    telegram.replykeyboardmarkup
    telegram.replymarkup
+    telegram.sentwebappmessage
    telegram.telegramobject
    telegram.update
    telegram.user
    telegram.userprofilephotos
    telegram.venue
    telegram.video
+    telegram.videochatended
+    telegram.videochatparticipantsinvited
+    telegram.videochatscheduled
+    telegram.videochatstarted
    telegram.videonote
    telegram.voice
    telegram.voicechatstarted
    telegram.voicechatended
    telegram.voicechatscheduled
    telegram.voicechatparticipantsinvited
+    telegram.webappdata
+    telegram.webappinfo
    telegram.webhookinfo

 Stickers
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/sentwebappmessage.py
+
+telegram.SentWebAppMessage
+==========================
+
+.. autoclass:: telegram.SentWebAppMessage
+    :members:
+    :show-inheritance:
@@ -5,5 +5,4 @@ telegram.Update

 .. autoclass:: telegram.Update
    :members:
-    :undoc-members:
    :show-inheritance:
@@ -5,5 +5,4 @@ telegram.User

 .. autoclass:: telegram.User
    :members:
-    :undoc-members:
    :show-inheritance:
@@ -0,0 +1,9 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/videochatended.py
+
+telegram.VideoChatEnded
+=======================
+
+.. autoclass:: telegram.VideoChatEnded
+    :members:
+    :show-inheritance:
+
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/videochatparticipantsinvited.py
+
+telegram.VideoChatParticipantsInvited
+=====================================
+
+.. autoclass:: telegram.VideoChatParticipantsInvited
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/videochatscheduled.py
+
+telegram.VideoChatScheduled
+===========================
+
+.. autoclass:: telegram.VideoChatScheduled
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/videochatstarted.py
+
+telegram.VideoChatStarted
+=========================
+
+.. autoclass:: telegram.VideoChatStarted
+    :members:
+    :show-inheritance:
@@ -7,3 +7,5 @@ telegram.VoiceChatEnded
    :members:
    :show-inheritance:

+.. versionchanged:: v13.12
+    Since Bot API 6.0, voice chat was renamed to video chat.
@@ -7,3 +7,5 @@ telegram.VoiceChatParticipantsInvited
    :members:
    :show-inheritance:

+.. versionchanged:: v13.12
+    Since Bot API 6.0, voice chat was renamed to video chat.
@@ -7,3 +7,5 @@ telegram.VoiceChatScheduled
    :members:
    :show-inheritance:

+.. versionchanged:: v13.12
+    Since Bot API 6.0, voice chat was renamed to video chat.
@@ -7,3 +7,5 @@ telegram.VoiceChatStarted
    :members:
    :show-inheritance:

+.. versionchanged:: v13.12
+    Since Bot API 6.0, voice chat was renamed to video chat.
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/webappdata.py
+
+telegram.WebAppData
+===================
+
+.. autoclass:: telegram.WebAppData
+    :members:
+    :show-inheritance:
@@ -0,0 +1,8 @@
+:github_url: https://github.com/python-telegram-bot/python-telegram-bot/blob/master/telegram/webappinfo.py
+
+telegram.WebAppInfo
+===================
+
+.. autoclass:: telegram.WebAppInfo
+    :members:
+    :show-inheritance:
@@ -2,52 +2,60 @@

 In this folder are small examples to show what a bot written with `python-telegram-bot` looks like. Some bots focus on one specific aspect of the Telegram Bot API while others focus on one of the mechanics of this library. Except for the [`rawapibot.py`](#pure-api) example, they all use the high-level framework this library provides with the [`telegram.ext`](https://python-telegram-bot.readthedocs.io/en/latest/telegram.ext.html) submodule.

-All examples are licensed under the [CC0 License](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/LICENSE.txt) and are therefore fully dedicated to the public domain. You can use them as the base for your own bots without worrying about copyrights.
+All examples are licensed under the [CC0 License](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/LICENSE.txt) and are therefore fully dedicated to the public domain. You can use them as the base for your own bots without worrying about copyrights.

-### [`echobot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/echobot.py) 
+Do note that we ignore one pythonic convention. Best practice would dictate, in many handler callbacks function signatures, to replace the argument `context` with an underscore, since `context` is an unused local variable in those callbacks. However, since these are examples and not having a name for that argument confuses beginners, we decided to have it present.
+
+### [`echobot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/echobot.py) 
 This is probably the base for most of the bots made with `python-telegram-bot`. It simply replies to each text message with a message that contains the same text.

-### [`timerbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/timerbot.py) 
+### [`timerbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/timerbot.py) 
 This bot uses the [`JobQueue`](https://python-telegram-bot.readthedocs.io/en/latest/telegram.ext.jobqueue.html) class to send timed messages. The user sets a timer by using `/set` command with a specific time, for example `/set 30`. The bot then sets up a job to send a message to that user after 30 seconds. The user can also cancel the timer by sending `/unset`. To learn more about the `JobQueue`, read [this wiki article](https://github.com/python-telegram-bot/python-telegram-bot/wiki/Extensions-%E2%80%93-JobQueue).

-### [`conversationbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/conversationbot.py)
-A common task for a bot is to ask information from the user. In v5.0 of this library, we introduced the [`ConversationHandler`](https://python-telegram-bot.readthedocs.io/en/latest/telegram.ext.conversationhandler.html) for that exact purpose. This example uses it to retrieve user-information in a conversation-like style. To get a better understanding, take a look at the [state diagram](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/conversationbot.png).
+### [`conversationbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/conversationbot.py)
+A common task for a bot is to ask information from the user. In v5.0 of this library, we introduced the [`ConversationHandler`](https://python-telegram-bot.readthedocs.io/en/latest/telegram.ext.conversationhandler.html) for that exact purpose. This example uses it to retrieve user-information in a conversation-like style. To get a better understanding, take a look at the [state diagram](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/conversationbot.png).

-### [`conversationbot2.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/conversationbot2.py)
-A more complex example of a bot that uses the `ConversationHandler`. It is also more confusing. Good thing there is a [fancy state diagram](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/conversationbot2.png) for this one, too!
+### [`conversationbot2.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/conversationbot2.py)
+A more complex example of a bot that uses the `ConversationHandler`. It is also more confusing. Good thing there is a [fancy state diagram](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/conversationbot2.png) for this one, too!

-### [`nestedconversationbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/nestedconversationbot.py)
-A even more complex example of a bot that uses the nested `ConversationHandler`s. While it's certainly not that complex that you couldn't built it without nested `ConversationHanldler`s, it gives a good impression on how to work with them. Of course, there is a [fancy state diagram](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/nestedconversationbot.png) for this example, too!
+### [`nestedconversationbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/nestedconversationbot.py)
+A even more complex example of a bot that uses the nested `ConversationHandler`s. While it's certainly not that complex that you couldn't built it without nested `ConversationHanldler`s, it gives a good impression on how to work with them. Of course, there is a [fancy state diagram](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/nestedconversationbot.png) for this example, too!

-### [`persistentconversationbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/persistentconversationbot.py)
+### [`persistentconversationbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/persistentconversationbot.py)
 A basic example of a bot store conversation state and user_data over multiple restarts.

-### [`inlinekeyboard.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/inlinekeyboard.py)
-This example sheds some light on inline keyboards, callback queries and message editing. A wikipedia site explaining this examples lives at https://git.io/JOmFw.
+### [`inlinekeyboard.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/inlinekeyboard.py)
+This example sheds some light on inline keyboards, callback queries and message editing. A wikipedia site explaining this examples lives at https://github.com/python-telegram-bot/python-telegram-bot/wiki/InlineKeyboard-Example.

-### [`inlinekeyboard2.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/inlinekeyboard2.py)
+### [`inlinekeyboard2.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/inlinekeyboard2.py)
 A more complex example about inline keyboards, callback queries and message editing. This example showcases how an interactive menu could be build using inline keyboards.

-### [`deeplinking.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/deeplinking.py)
+### [`deeplinking.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/deeplinking.py)
 A basic example on how to use deeplinking with inline keyboards.

-### [`inlinebot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/inlinebot.py)
+### [`inlinebot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/inlinebot.py)
 A basic example of an [inline bot](https://core.telegram.org/bots/inline). Don't forget to enable inline mode with [@BotFather](https://telegram.me/BotFather).

-### [`pollbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/pollbot.py)
+### [`pollbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/pollbot.py)
 This example sheds some light on polls, poll answers and the corresponding handlers.

-### [`passportbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/passportbot.py)
-A basic example of a bot that can accept passports. Use in combination with [`passportbot.html`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/passportbot.html). Don't forget to enable and configure payments with [@BotFather](https://telegram.me/BotFather). Check out this [guide](https://git.io/fAvYd) on Telegram passports in PTB.
+### [`passportbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/passportbot.py)
+A basic example of a bot that can accept passports. Use in combination with [`passportbot.html`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/passportbot.html). Don't forget to enable and configure payments with [@BotFather](https://telegram.me/BotFather). Check out this [guide](https://github.com/python-telegram-bot/python-telegram-bot/wiki/Telegram-Passport) on Telegram passports in PTB.

-### [`paymentbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/paymentbot.py)
+### [`paymentbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/paymentbot.py)
 A basic example of a bot that can accept payments. Don't forget to enable and configure payments with [@BotFather](https://telegram.me/BotFather).

-### [`errorhandlerbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/errorhandlerbot.py)
+### [`errorhandlerbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/errorhandlerbot.py)
 A basic example on how to set up a custom error handler.

-### [`chatmemberbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/chatmemberbot.py)
-A basic example on how `(my_)chat_member` updates can be used. 
+### [`chatmemberbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/chatmemberbot.py)
+A basic example on how `(my_)chat_member` updates can be used.
+
+### [`contexttypesbot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/contexttypesbot.py)
+This example showcases how `telegram.ext.ContextTypes` can be used to customize the `context` argument of handler and job callbacks.
+
+### [`arbitrarycallbackdatabot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/arbitrarycallbackdatabot.py)
+This example showcases how PTBs "arbitrary callback data" feature can be used.

 ## Pure API
-The [`rawapibot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/master/examples/rawapibot.py) example uses only the pure, "bare-metal" API wrapper.
+The [`rawapibot.py`](https://github.com/python-telegram-bot/python-telegram-bot/blob/v13.x/examples/rawapibot.py) example uses only the pure, "bare-metal" API wrapper.
@@ -0,0 +1,111 @@
+#!/usr/bin/env python
+# pylint: disable=C0116,W0613
+# This program is dedicated to the public domain under the CC0 license.
+
+"""This example showcases how PTBs "arbitrary callback data" feature can be used.
+
+For detailed info on arbitrary callback data, see the wiki page at
+https://github.com/python-telegram-bot/python-telegram-bot/wiki/Arbitrary-callback_data
+"""
+import logging
+from typing import List, Tuple, cast
+
+from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update
+from telegram.ext import (
+    Updater,
+    CommandHandler,
+    CallbackQueryHandler,
+    CallbackContext,
+    InvalidCallbackData,
+    PicklePersistence,
+)
+
+logging.basicConfig(
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', level=logging.INFO
+)
+logger = logging.getLogger(__name__)
+
+
+def start(update: Update, context: CallbackContext) -> None:
+    """Sends a message with 5 inline buttons attached."""
+    number_list: List[int] = []
+    update.message.reply_text('Please choose:', reply_markup=build_keyboard(number_list))
+
+
+def help_command(update: Update, context: CallbackContext) -> None:
+    """Displays info on how to use the bot."""
+    update.message.reply_text(
+        "Use /start to test this bot. Use /clear to clear the stored data so that you can see "
+        "what happens, if the button data is not available. "
+    )
+
+
+def clear(update: Update, context: CallbackContext) -> None:
+    """Clears the callback data cache"""
+    context.bot.callback_data_cache.clear_callback_data()  # type: ignore[attr-defined]
+    context.bot.callback_data_cache.clear_callback_queries()  # type: ignore[attr-defined]
+    update.effective_message.reply_text('All clear!')
+
+
+def build_keyboard(current_list: List[int]) -> InlineKeyboardMarkup:
+    """Helper function to build the next inline keyboard."""
+    return InlineKeyboardMarkup.from_column(
+        [InlineKeyboardButton(str(i), callback_data=(i, current_list)) for i in range(1, 6)]
+    )
+
+
+def list_button(update: Update, context: CallbackContext) -> None:
+    """Parses the CallbackQuery and updates the message text."""
+    query = update.callback_query
+    query.answer()
+    # Get the data from the callback_data.
+    # If you're using a type checker like MyPy, you'll have to use typing.cast
+    # to make the checker get the expected type of the callback_data
+    number, number_list = cast(Tuple[int, List[int]], query.data)
+    # append the number to the list
+    number_list.append(number)
+
+    query.edit_message_text(
+        text=f"So far you've selected {number_list}. Choose the next item:",
+        reply_markup=build_keyboard(number_list),
+    )
+
+    # we can delete the data stored for the query, because we've replaced the buttons
+    context.drop_callback_data(query)
+
+
+def handle_invalid_button(update: Update, context: CallbackContext) -> None:
+    """Informs the user that the button is no longer available."""
+    update.callback_query.answer()
+    update.effective_message.edit_text(
+        'Sorry, I could not process this button click 😕 Please send /start to get a new keyboard.'
+    )
+
+
+def main() -> None:
+    """Run the bot."""
+    # We use persistence to demonstrate how buttons can still work after the bot was restarted
+    persistence = PicklePersistence(
+        filename='arbitrarycallbackdatabot.pickle', store_callback_data=True
+    )
+    # Create the Updater and pass it your bot's token.
+    updater = Updater("TOKEN", persistence=persistence, arbitrary_callback_data=True)
+
+    updater.dispatcher.add_handler(CommandHandler('start', start))
+    updater.dispatcher.add_handler(CommandHandler('help', help_command))
+    updater.dispatcher.add_handler(CommandHandler('clear', clear))
+    updater.dispatcher.add_handler(
+        CallbackQueryHandler(handle_invalid_button, pattern=InvalidCallbackData)
+    )
+    updater.dispatcher.add_handler(CallbackQueryHandler(list_button))
+
+    # Start the Bot
+    updater.start_polling()
+
+    # Run the bot until the user presses Ctrl-C or the process receives SIGINT,
+    # SIGTERM or SIGABRT
+    updater.idle()
+
+
+if __name__ == '__main__':
+    main()
@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -35,7 +35,8 @@ def extract_status_change(
 ) -> Optional[Tuple[bool, bool]]:
    """Takes a ChatMemberUpdated instance and extracts whether the 'old_chat_member' was a member
    of the chat and whether the 'new_chat_member' is a member of the chat. Returns None, if
-    the status didn't change."""
+    the status didn't change.
+    """
    status_change = chat_member_update.difference().get("status")
    old_is_member, new_is_member = chat_member_update.difference().get("is_member", (None, None))

@@ -43,24 +44,16 @@ def extract_status_change(
        return None

    old_status, new_status = status_change
-    was_member = (
-        old_status
-        in [
-            ChatMember.MEMBER,
-            ChatMember.CREATOR,
-            ChatMember.ADMINISTRATOR,
-        ]
-        or (old_status == ChatMember.RESTRICTED and old_is_member is True)
-    )
-    is_member = (
-        new_status
-        in [
-            ChatMember.MEMBER,
-            ChatMember.CREATOR,
-            ChatMember.ADMINISTRATOR,
-        ]
-        or (new_status == ChatMember.RESTRICTED and new_is_member is True)
-    )
+    was_member = old_status in [
+        ChatMember.MEMBER,
+        ChatMember.CREATOR,
+        ChatMember.ADMINISTRATOR,
+    ] or (old_status == ChatMember.RESTRICTED and old_is_member is True)
+    is_member = new_status in [
+        ChatMember.MEMBER,
+        ChatMember.CREATOR,
+        ChatMember.ADMINISTRATOR,
+    ] or (new_status == ChatMember.RESTRICTED and new_is_member is True)

    return was_member, is_member

@@ -113,7 +106,7 @@ def show_chats(update: Update, context: CallbackContext) -> None:
    update.effective_message.reply_text(text)


-def greet_chat_members(update: Update, _: CallbackContext) -> None:
+def greet_chat_members(update: Update, context: CallbackContext) -> None:
    """Greets new users in chats and announces when someone leaves"""
    result = extract_status_change(update.chat_member)
    if result is None:
@@ -151,11 +144,9 @@ def main() -> None:
    dispatcher.add_handler(ChatMemberHandler(greet_chat_members, ChatMemberHandler.CHAT_MEMBER))

    # Start the Bot
-    # We pass 'allowed_updates' to *only* handle updates with '(my_)chat_member' or 'message'
-    # If you want to handle *all* updates, pass Update.ALL_TYPES
-    updater.start_polling(
-        allowed_updates=[Update.MESSAGE, Update.CHAT_MEMBER, Update.MY_CHAT_MEMBER]
-    )
+    # We pass 'allowed_updates' handle *all* updates including `chat_member` updates
+    # To reset this, simply pass `allowed_updates=[]`
+    updater.start_polling(allowed_updates=Update.ALL_TYPES)

    # Run the bot until you press Ctrl-C or the process receives SIGINT,
    # SIGTERM or SIGABRT. This should be used most of the time, since
@@ -0,0 +1,129 @@
+#!/usr/bin/env python
+# pylint: disable=C0116,W0613
+# This program is dedicated to the public domain under the CC0 license.
+
+"""
+Simple Bot to showcase `telegram.ext.ContextTypes`.
+
+Usage:
+Press Ctrl-C on the command line or send a signal to the process to stop the
+bot.
+"""
+
+from collections import defaultdict
+from typing import DefaultDict, Optional, Set
+
+from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup, ParseMode
+from telegram.ext import (
+    Updater,
+    CommandHandler,
+    CallbackContext,
+    ContextTypes,
+    CallbackQueryHandler,
+    TypeHandler,
+    Dispatcher,
+)
+
+
+class ChatData:
+    """Custom class for chat_data. Here we store data per message."""
+
+    def __init__(self) -> None:
+        self.clicks_per_message: DefaultDict[int, int] = defaultdict(int)
+
+
+# The [dict, ChatData, dict] is for type checkers like mypy
+class CustomContext(CallbackContext[dict, ChatData, dict]):
+    """Custom class for context."""
+
+    def __init__(self, dispatcher: Dispatcher):
+        super().__init__(dispatcher=dispatcher)
+        self._message_id: Optional[int] = None
+
+    @property
+    def bot_user_ids(self) -> Set[int]:
+        """Custom shortcut to access a value stored in the bot_data dict"""
+        return self.bot_data.setdefault('user_ids', set())
+
+    @property
+    def message_clicks(self) -> Optional[int]:
+        """Access the number of clicks for the message this context object was built for."""
+        if self._message_id:
+            return self.chat_data.clicks_per_message[self._message_id]
+        return None
+
+    @message_clicks.setter
+    def message_clicks(self, value: int) -> None:
+        """Allow to change the count"""
+        if not self._message_id:
+            raise RuntimeError('There is no message associated with this context obejct.')
+        self.chat_data.clicks_per_message[self._message_id] = value
+
+    @classmethod
+    def from_update(cls, update: object, dispatcher: 'Dispatcher') -> 'CustomContext':
+        """Override from_update to set _message_id."""
+        # Make sure to call super()
+        context = super().from_update(update, dispatcher)
+
+        if context.chat_data and isinstance(update, Update) and update.effective_message:
+            context._message_id = update.effective_message.message_id  # pylint: disable=W0212
+
+        # Remember to return the object
+        return context
+
+
+def start(update: Update, context: CustomContext) -> None:
+    """Display a message with a button."""
+    update.message.reply_html(
+        'This button was clicked <i>0</i> times.',
+        reply_markup=InlineKeyboardMarkup.from_button(
+            InlineKeyboardButton(text='Click me!', callback_data='button')
+        ),
+    )
+
+
+def count_click(update: Update, context: CustomContext) -> None:
+    """Update the click count for the message."""
+    context.message_clicks += 1
+    update.callback_query.answer()
+    update.effective_message.edit_text(
+        f'This button was clicked <i>{context.message_clicks}</i> times.',
+        reply_markup=InlineKeyboardMarkup.from_button(
+            InlineKeyboardButton(text='Click me!', callback_data='button')
+        ),
+        parse_mode=ParseMode.HTML,
+    )
+
+
+def print_users(update: Update, context: CustomContext) -> None:
+    """Show which users have been using this bot."""
+    update.message.reply_text(
+        'The following user IDs have used this bot: '
+        f'{", ".join(map(str, context.bot_user_ids))}'
+    )
+
+
+def track_users(update: Update, context: CustomContext) -> None:
+    """Store the user id of the incoming update, if any."""
+    if update.effective_user:
+        context.bot_user_ids.add(update.effective_user.id)
+
+
+def main() -> None:
+    """Run the bot."""
+    context_types = ContextTypes(context=CustomContext, chat_data=ChatData)
+    updater = Updater("TOKEN", context_types=context_types)
+
+    dispatcher = updater.dispatcher
+    # run track_users in its own group to not interfere with the user handlers
+    dispatcher.add_handler(TypeHandler(Update, track_users), group=-1)
+    dispatcher.add_handler(CommandHandler("start", start))
+    dispatcher.add_handler(CallbackQueryHandler(count_click))
+    dispatcher.add_handler(CommandHandler("print_users", print_users))
+
+    updater.start_polling()
+    updater.idle()
+
+
+if __name__ == '__main__':
+    main()
@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -36,20 +36,24 @@ logger = logging.getLogger(__name__)
 GENDER, PHOTO, LOCATION, BIO = range(4)


-def start(update: Update, _: CallbackContext) -> int:
+def start(update: Update, context: CallbackContext) -> int:
+    """Starts the conversation and asks the user about their gender."""
    reply_keyboard = [['Boy', 'Girl', 'Other']]

    update.message.reply_text(
        'Hi! My name is Professor Bot. I will hold a conversation with you. '
        'Send /cancel to stop talking to me.\n\n'
        'Are you a boy or a girl?',
-        reply_markup=ReplyKeyboardMarkup(reply_keyboard, one_time_keyboard=True),
+        reply_markup=ReplyKeyboardMarkup(
+            reply_keyboard, one_time_keyboard=True, input_field_placeholder='Boy or Girl?'
+        ),
    )

    return GENDER


-def gender(update: Update, _: CallbackContext) -> int:
+def gender(update: Update, context: CallbackContext) -> int:
+    """Stores the selected gender and asks for a photo."""
    user = update.message.from_user
    logger.info("Gender of %s: %s", user.first_name, update.message.text)
    update.message.reply_text(
@@ -61,7 +65,8 @@ def gender(update: Update, _: CallbackContext) -> int:
    return PHOTO


-def photo(update: Update, _: CallbackContext) -> int:
+def photo(update: Update, context: CallbackContext) -> int:
+    """Stores the photo and asks for a location."""
    user = update.message.from_user
    photo_file = update.message.photo[-1].get_file()
    photo_file.download('user_photo.jpg')
@@ -73,7 +78,8 @@ def photo(update: Update, _: CallbackContext) -> int:
    return LOCATION


-def skip_photo(update: Update, _: CallbackContext) -> int:
+def skip_photo(update: Update, context: CallbackContext) -> int:
+    """Skips the photo and asks for a location."""
    user = update.message.from_user
    logger.info("User %s did not send a photo.", user.first_name)
    update.message.reply_text(
@@ -83,7 +89,8 @@ def skip_photo(update: Update, _: CallbackContext) -> int:
    return LOCATION


-def location(update: Update, _: CallbackContext) -> int:
+def location(update: Update, context: CallbackContext) -> int:
+    """Stores the location and asks for some info about the user."""
    user = update.message.from_user
    user_location = update.message.location
    logger.info(
@@ -96,7 +103,8 @@ def location(update: Update, _: CallbackContext) -> int:
    return BIO


-def skip_location(update: Update, _: CallbackContext) -> int:
+def skip_location(update: Update, context: CallbackContext) -> int:
+    """Skips the location and asks for info about the user."""
    user = update.message.from_user
    logger.info("User %s did not send a location.", user.first_name)
    update.message.reply_text(
@@ -106,7 +114,8 @@ def skip_location(update: Update, _: CallbackContext) -> int:
    return BIO


-def bio(update: Update, _: CallbackContext) -> int:
+def bio(update: Update, context: CallbackContext) -> int:
+    """Stores the info about the user and ends the conversation."""
    user = update.message.from_user
    logger.info("Bio of %s: %s", user.first_name, update.message.text)
    update.message.reply_text('Thank you! I hope we can talk again some day.')
@@ -114,7 +123,8 @@ def bio(update: Update, _: CallbackContext) -> int:
    return ConversationHandler.END


-def cancel(update: Update, _: CallbackContext) -> int:
+def cancel(update: Update, context: CallbackContext) -> int:
+    """Cancels and ends the conversation."""
    user = update.message.from_user
    logger.info("User %s canceled the conversation.", user.first_name)
    update.message.reply_text(
@@ -125,6 +135,7 @@ def cancel(update: Update, _: CallbackContext) -> int:


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -45,15 +45,13 @@ markup = ReplyKeyboardMarkup(reply_keyboard, one_time_keyboard=True)


 def facts_to_str(user_data: Dict[str, str]) -> str:
-    facts = list()
-
-    for key, value in user_data.items():
-        facts.append(f'{key} - {value}')
-
+    """Helper function for formatting the gathered user info."""
+    facts = [f'{key} - {value}' for key, value in user_data.items()]
    return "\n".join(facts).join(['\n', '\n'])


-def start(update: Update, _: CallbackContext) -> int:
+def start(update: Update, context: CallbackContext) -> int:
+    """Start the conversation and ask user for input."""
    update.message.reply_text(
        "Hi! My name is Doctor Botter. I will hold a more complex conversation with you. "
        "Why don't you tell me something about yourself?",
@@ -64,6 +62,7 @@ def start(update: Update, _: CallbackContext) -> int:


 def regular_choice(update: Update, context: CallbackContext) -> int:
+    """Ask the user for info about the selected predefined choice."""
    text = update.message.text
    context.user_data['choice'] = text
    update.message.reply_text(f'Your {text.lower()}? Yes, I would love to hear about that!')
@@ -71,7 +70,8 @@ def regular_choice(update: Update, context: CallbackContext) -> int:
    return TYPING_REPLY


-def custom_choice(update: Update, _: CallbackContext) -> int:
+def custom_choice(update: Update, context: CallbackContext) -> int:
+    """Ask the user for a description of a custom category."""
    update.message.reply_text(
        'Alright, please send me the category first, for example "Most impressive skill"'
    )
@@ -80,6 +80,7 @@ def custom_choice(update: Update, _: CallbackContext) -> int:


 def received_information(update: Update, context: CallbackContext) -> int:
+    """Store info provided by user and ask for the next category."""
    user_data = context.user_data
    text = update.message.text
    category = user_data['choice']
@@ -97,6 +98,7 @@ def received_information(update: Update, context: CallbackContext) -> int:


 def done(update: Update, context: CallbackContext) -> int:
+    """Display the gathered info and end the conversation."""
    user_data = context.user_data
    if 'choice' in user_data:
        del user_data['choice']
@@ -111,6 +113,7 @@ def done(update: Update, context: CallbackContext) -> int:


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """Bot that explains Telegram's "Deep Linking Parameters" functionality.
@@ -78,7 +78,7 @@ def deep_linked_level_2(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(text, parse_mode=ParseMode.MARKDOWN, disable_web_page_preview=True)


-def deep_linked_level_3(update: Update, _: CallbackContext) -> None:
+def deep_linked_level_3(update: Update, context: CallbackContext) -> None:
    """Reached through the USING_ENTITIES payload"""
    update.message.reply_text(
        "It is also possible to make deep-linking using InlineKeyboardButtons.",
@@ -124,7 +124,7 @@ def main() -> None:

    # We can also pass on the deep-linking payload
    dispatcher.add_handler(
-        CommandHandler("start", deep_linked_level_3, Filters.regex(USING_ENTITIES), pass_args=True)
+        CommandHandler("start", deep_linked_level_3, Filters.regex(USING_ENTITIES))
    )

    # Possible with inline keyboard buttons as well
@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -30,7 +30,7 @@ logger = logging.getLogger(__name__)

 # Define a few command handlers. These usually take the two arguments update and
 # context.
-def start(update: Update, _: CallbackContext) -> None:
+def start(update: Update, context: CallbackContext) -> None:
    """Send a message when the command /start is issued."""
    user = update.effective_user
    update.message.reply_markdown_v2(
@@ -39,12 +39,12 @@ def start(update: Update, _: CallbackContext) -> None:
    )


-def help_command(update: Update, _: CallbackContext) -> None:
+def help_command(update: Update, context: CallbackContext) -> None:
    """Send a message when the command /help is issued."""
    update.message.reply_text('Help!')


-def echo(update: Update, _: CallbackContext) -> None:
+def echo(update: Update, context: CallbackContext) -> None:
    """Echo the user message."""
    update.message.reply_text(update.message.text)

@@ -1,10 +1,8 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # 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
-"""
+"""This is a very simple example on how one could implement a custom error handler."""
 import html
 import json
 import logging
@@ -53,12 +51,13 @@ def error_handler(update: object, context: CallbackContext) -> None:
    context.bot.send_message(chat_id=DEVELOPER_CHAT_ID, text=message, parse_mode=ParseMode.HTML)


-def bad_command(_: Update, context: CallbackContext) -> None:
+def bad_command(update: Update, context: CallbackContext) -> None:
    """Raise an error to trigger the error handler."""
    context.bot.wrong_method_name()  # type: ignore[attr-defined]


-def start(update: Update, _: CallbackContext) -> None:
+def start(update: Update, context: CallbackContext) -> None:
+    """Displays info on how to trigger an error."""
    update.effective_message.reply_html(
        'Use /bad_command to cause an error.\n'
        f'Your chat id is <code>{update.effective_chat.id}</code>.'
@@ -66,6 +65,7 @@ def start(update: Update, _: CallbackContext) -> None:


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater(BOT_TOKEN)

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -29,17 +29,17 @@ logger = logging.getLogger(__name__)

 # Define a few command handlers. These usually take the two arguments update and
 # context. Error handlers also receive the raised TelegramError object in error.
-def start(update: Update, _: CallbackContext) -> None:
+def start(update: Update, context: CallbackContext) -> None:
    """Send a message when the command /start is issued."""
    update.message.reply_text('Hi!')


-def help_command(update: Update, _: CallbackContext) -> None:
+def help_command(update: Update, context: CallbackContext) -> None:
    """Send a message when the command /help is issued."""
    update.message.reply_text('Help!')


-def inlinequery(update: Update, _: CallbackContext) -> None:
+def inlinequery(update: Update, context: CallbackContext) -> None:
    """Handle the inline query."""
    query = update.inline_query.query

@@ -72,6 +72,7 @@ def inlinequery(update: Update, _: CallbackContext) -> None:


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,10 +1,10 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
 Basic example for a bot that uses inline keyboards. For an in-depth explanation, check out
- https://git.io/JOmFw.
+ https://github.com/python-telegram-bot/python-telegram-bot/wiki/InlineKeyboard-Example.
 """
 import logging

@@ -17,7 +17,8 @@ logging.basicConfig(
 logger = logging.getLogger(__name__)


-def start(update: Update, _: CallbackContext) -> None:
+def start(update: Update, context: CallbackContext) -> None:
+    """Sends a message with three inline buttons attached."""
    keyboard = [
        [
            InlineKeyboardButton("Option 1", callback_data='1'),
@@ -31,7 +32,8 @@ def start(update: Update, _: CallbackContext) -> None:
    update.message.reply_text('Please choose:', reply_markup=reply_markup)


-def button(update: Update, _: CallbackContext) -> None:
+def button(update: Update, context: CallbackContext) -> None:
+    """Parses the CallbackQuery and updates the message text."""
    query = update.callback_query

    # CallbackQueries need to be answered, even if no notification to the user is needed
@@ -41,11 +43,13 @@ def button(update: Update, _: CallbackContext) -> None:
    query.edit_message_text(text=f"Selected option: {query.data}")


-def help_command(update: Update, _: CallbackContext) -> None:
+def help_command(update: Update, context: CallbackContext) -> None:
+    """Displays info on how to use the bot."""
    update.message.reply_text("Use /start to test this bot.")


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """Simple inline keyboard bot with multiple CallbackQueryHandlers.
@@ -37,7 +37,7 @@ FIRST, SECOND = range(2)
 ONE, TWO, THREE, FOUR = range(4)


-def start(update: Update, _: CallbackContext) -> int:
+def start(update: Update, context: CallbackContext) -> int:
    """Send message on `/start`."""
    # Get user that sent /start and log his name
    user = update.message.from_user
@@ -59,7 +59,7 @@ def start(update: Update, _: CallbackContext) -> int:
    return FIRST


-def start_over(update: Update, _: CallbackContext) -> int:
+def start_over(update: Update, context: CallbackContext) -> int:
    """Prompt same text & keyboard as `start` does but not as new message"""
    # Get CallbackQuery from Update
    query = update.callback_query
@@ -80,7 +80,7 @@ def start_over(update: Update, _: CallbackContext) -> int:
    return FIRST


-def one(update: Update, _: CallbackContext) -> int:
+def one(update: Update, context: CallbackContext) -> int:
    """Show new choice of buttons"""
    query = update.callback_query
    query.answer()
@@ -97,7 +97,7 @@ def one(update: Update, _: CallbackContext) -> int:
    return FIRST


-def two(update: Update, _: CallbackContext) -> int:
+def two(update: Update, context: CallbackContext) -> int:
    """Show new choice of buttons"""
    query = update.callback_query
    query.answer()
@@ -114,7 +114,7 @@ def two(update: Update, _: CallbackContext) -> int:
    return FIRST


-def three(update: Update, _: CallbackContext) -> int:
+def three(update: Update, context: CallbackContext) -> int:
    """Show new choice of buttons"""
    query = update.callback_query
    query.answer()
@@ -132,7 +132,7 @@ def three(update: Update, _: CallbackContext) -> int:
    return SECOND


-def four(update: Update, _: CallbackContext) -> int:
+def four(update: Update, context: CallbackContext) -> int:
    """Show new choice of buttons"""
    query = update.callback_query
    query.answer()
@@ -149,9 +149,10 @@ def four(update: Update, _: CallbackContext) -> int:
    return FIRST


-def end(update: Update, _: CallbackContext) -> int:
+def end(update: Update, context: CallbackContext) -> int:
    """Returns `ConversationHandler.END`, which tells the
-    ConversationHandler that the conversation is over"""
+    ConversationHandler that the conversation is over.
+    """
    query = update.callback_query
    query.answer()
    query.edit_message_text(text="See you next time!")
@@ -159,6 +160,7 @@ def end(update: Update, _: CallbackContext) -> int:


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -152,14 +152,14 @@ def show_data(update: Update, context: CallbackContext) -> str:
    return SHOWING


-def stop(update: Update, _: CallbackContext) -> int:
+def stop(update: Update, context: CallbackContext) -> int:
    """End Conversation by command."""
    update.message.reply_text('Okay, bye.')

    return END


-def end(update: Update, _: CallbackContext) -> int:
+def end(update: Update, context: CallbackContext) -> int:
    """End conversation from InlineKeyboardButton."""
    update.callback_query.answer()

@@ -170,7 +170,7 @@ def end(update: Update, _: CallbackContext) -> int:


 # Second level conversation callbacks
-def select_level(update: Update, _: CallbackContext) -> str:
+def select_level(update: Update, context: CallbackContext) -> str:
    """Choose to add a parent or a child."""
    text = 'You may add a parent or a child. Also you can show the gathered data or go back.'
    buttons = [
@@ -293,7 +293,7 @@ def end_describing(update: Update, context: CallbackContext) -> int:
    return END


-def stop_nested(update: Update, _: CallbackContext) -> str:
+def stop_nested(update: Update, context: CallbackContext) -> str:
    """Completely end conversation from within nested conversation."""
    update.message.reply_text('Okay, bye.')

@@ -301,6 +301,7 @@ def stop_nested(update: Update, _: CallbackContext) -> str:


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -7,7 +7,8 @@ Simple Bot to print/download all incoming passport data

 See https://telegram.org/blog/passport for info about what telegram passport is.

-See https://git.io/fAvYd for how to use Telegram Passport properly with python-telegram-bot.
+See https://github.com/python-telegram-bot/python-telegram-bot/wiki/Telegram-Passport
+for how to use Telegram Passport properly with python-telegram-bot.

 """
 import logging
@@ -23,7 +24,8 @@ logging.basicConfig(
 logger = logging.getLogger(__name__)


-def msg(update: Update, _: CallbackContext) -> None:
+def msg(update: Update, context: CallbackContext) -> None:
+    """Downloads and prints the received passport data."""
    # Retrieve passport data
    passport_data = update.message.passport_data
    # If our nonce doesn't match what we think, this Update did not originate from us
@@ -61,21 +63,24 @@ def msg(update: Update, _: CallbackContext) -> None:
                actual_file = file.get_file()
                print(actual_file)
                actual_file.download()
-        if data.type in ('passport', 'driver_license', 'identity_card', 'internal_passport'):
-            if data.front_side:
-                front_file = data.front_side.get_file()
-                print(data.type, front_file)
-                front_file.download()
-        if data.type in ('driver_license' and 'identity_card'):
-            if data.reverse_side:
-                reverse_file = data.reverse_side.get_file()
-                print(data.type, reverse_file)
-                reverse_file.download()
-        if data.type in ('passport', 'driver_license', 'identity_card', 'internal_passport'):
-            if data.selfie:
-                selfie_file = data.selfie.get_file()
-                print(data.type, selfie_file)
-                selfie_file.download()
+        if (
+            data.type in ('passport', 'driver_license', 'identity_card', 'internal_passport')
+            and data.front_side
+        ):
+            front_file = data.front_side.get_file()
+            print(data.type, front_file)
+            front_file.download()
+        if data.type in ('driver_license' and 'identity_card') and data.reverse_side:
+            reverse_file = data.reverse_side.get_file()
+            print(data.type, reverse_file)
+            reverse_file.download()
+        if (
+            data.type in ('passport', 'driver_license', 'identity_card', 'internal_passport')
+            and data.selfie
+        ):
+            selfie_file = data.selfie.get_file()
+            print(data.type, selfie_file)
+            selfie_file.download()
        if data.type in (
            'passport',
            'driver_license',
@@ -97,7 +102,8 @@ def msg(update: Update, _: CallbackContext) -> None:
 def main() -> None:
    """Start the bot."""
    # Create the Updater and pass it your token and private key
-    updater = Updater("TOKEN", private_key=open('private.key', 'rb').read())
+    with open('private.key', 'rb') as private_key:
+        updater = Updater("TOKEN", private_key=private_key.read())

    # Get the dispatcher to register handlers
    dispatcher = updater.dispatcher
@@ -1,10 +1,8 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

-"""
-Basic example for a bot that can receive payment from user.
-"""
+"""Basic example for a bot that can receive payment from user."""

 import logging

@@ -27,7 +25,8 @@ logging.basicConfig(
 logger = logging.getLogger(__name__)


-def start_callback(update: Update, _: CallbackContext) -> None:
+def start_callback(update: Update, context: CallbackContext) -> None:
+    """Displays info on how to use the bot."""
    msg = (
        "Use /shipping to get an invoice for shipping-payment, or /noshipping for an "
        "invoice without shipping."
@@ -37,6 +36,7 @@ def start_callback(update: Update, _: CallbackContext) -> None:


 def start_with_shipping_callback(update: Update, context: CallbackContext) -> None:
+    """Sends an invoice with shipping-payment."""
    chat_id = update.message.chat_id
    title = "Payment Example"
    description = "Payment Example using python-telegram-bot"
@@ -70,6 +70,7 @@ def start_with_shipping_callback(update: Update, context: CallbackContext) -> No


 def start_without_shipping_callback(update: Update, context: CallbackContext) -> None:
+    """Sends an invoice without shipping-payment."""
    chat_id = update.message.chat_id
    title = "Payment Example"
    description = "Payment Example using python-telegram-bot"
@@ -90,7 +91,8 @@ def start_without_shipping_callback(update: Update, context: CallbackContext) ->
    )


-def shipping_callback(update: Update, _: CallbackContext) -> None:
+def shipping_callback(update: Update, context: CallbackContext) -> None:
+    """Answers the ShippingQuery with ShippingOptions"""
    query = update.shipping_query
    # check the payload, is this from your bot?
    if query.invoice_payload != 'Custom-Payload':
@@ -98,17 +100,17 @@ def shipping_callback(update: Update, _: CallbackContext) -> None:
        query.answer(ok=False, error_message="Something went wrong...")
        return

-    options = list()
-    # a single LabeledPrice
-    options.append(ShippingOption('1', 'Shipping Option A', [LabeledPrice('A', 100)]))
-    # an array of LabeledPrice objects
+    # First option has a single LabeledPrice
+    options = [ShippingOption('1', 'Shipping Option A', [LabeledPrice('A', 100)])]
+    # second option has an array of LabeledPrice objects
    price_list = [LabeledPrice('B1', 150), LabeledPrice('B2', 200)]
    options.append(ShippingOption('2', 'Shipping Option B', price_list))
    query.answer(ok=True, shipping_options=options)


 # after (optional) shipping, it's the pre-checkout
-def precheckout_callback(update: Update, _: CallbackContext) -> None:
+def precheckout_callback(update: Update, context: CallbackContext) -> None:
+    """Answers the PreQecheckoutQuery"""
    query = update.pre_checkout_query
    # check the payload, is this from your bot?
    if query.invoice_payload != 'Custom-Payload':
@@ -119,12 +121,14 @@ def precheckout_callback(update: Update, _: CallbackContext) -> None:


 # finally, after contacting the payment provider...
-def successful_payment_callback(update: Update, _: CallbackContext) -> None:
+def successful_payment_callback(update: Update, context: CallbackContext) -> None:
+    """Confirms the successful payment."""
    # do something after successfully receiving payment?
    update.message.reply_text("Thank you for your payment!")


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -28,7 +28,6 @@ from telegram.ext import (
    CallbackContext,
 )

-
 # Enable logging
 logging.basicConfig(
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', level=logging.INFO
@@ -47,15 +46,13 @@ markup = ReplyKeyboardMarkup(reply_keyboard, one_time_keyboard=True)


 def facts_to_str(user_data: Dict[str, str]) -> str:
-    facts = []
-
-    for key, value in user_data.items():
-        facts.append(f'{key} - {value}')
-
+    """Helper function for formatting the gathered user info."""
+    facts = [f'{key} - {value}' for key, value in user_data.items()]
    return "\n".join(facts).join(['\n', '\n'])


 def start(update: Update, context: CallbackContext) -> int:
+    """Start the conversation, display any stored data and ask user for input."""
    reply_text = "Hi! My name is Doctor Botter."
    if context.user_data:
        reply_text += (
@@ -73,6 +70,7 @@ def start(update: Update, context: CallbackContext) -> int:


 def regular_choice(update: Update, context: CallbackContext) -> int:
+    """Ask the user for info about the selected predefined choice."""
    text = update.message.text.lower()
    context.user_data['choice'] = text
    if context.user_data.get(text):
@@ -86,7 +84,8 @@ def regular_choice(update: Update, context: CallbackContext) -> int:
    return TYPING_REPLY


-def custom_choice(update: Update, _: CallbackContext) -> int:
+def custom_choice(update: Update, context: CallbackContext) -> int:
+    """Ask the user for a description of a custom category."""
    update.message.reply_text(
        'Alright, please send me the category first, for example "Most impressive skill"'
    )
@@ -95,6 +94,7 @@ def custom_choice(update: Update, _: CallbackContext) -> int:


 def received_information(update: Update, context: CallbackContext) -> int:
+    """Store info provided by user and ask for the next category."""
    text = update.message.text
    category = context.user_data['choice']
    context.user_data[category] = text.lower()
@@ -103,8 +103,7 @@ def received_information(update: Update, context: CallbackContext) -> int:
    update.message.reply_text(
        "Neat! Just so you know, this is what you already told me:"
        f"{facts_to_str(context.user_data)}"
-        "You can tell me more, or change your opinion on "
-        "something.",
+        "You can tell me more, or change your opinion on something.",
        reply_markup=markup,
    )

@@ -112,23 +111,26 @@ def received_information(update: Update, context: CallbackContext) -> int:


 def show_data(update: Update, context: CallbackContext) -> None:
+    """Display the gathered info."""
    update.message.reply_text(
        f"This is what you already told me: {facts_to_str(context.user_data)}"
    )


 def done(update: Update, context: CallbackContext) -> int:
+    """Display the gathered info and end the conversation."""
    if 'choice' in context.user_data:
        del context.user_data['choice']

    update.message.reply_text(
-        "I learned these facts about you:" f"{facts_to_str(context.user_data)}Until next time!",
+        f"I learned these facts about you: {facts_to_str(context.user_data)}Until next time!",
        reply_markup=ReplyKeyboardRemove(),
    )
    return ConversationHandler.END


 def main() -> None:
+    """Run the bot."""
    # Create the Updater and pass it your bot's token.
    persistence = PicklePersistence(filename='conversationbot')
    updater = Updater("TOKEN", persistence=persistence)
@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -34,7 +34,7 @@ logging.basicConfig(
 logger = logging.getLogger(__name__)


-def start(update: Update, _: CallbackContext) -> None:
+def start(update: Update, context: CallbackContext) -> None:
    """Inform user about what this bot can do"""
    update.message.reply_text(
        'Please select /poll to get a Poll, /quiz to get a Quiz or /preview'
@@ -120,7 +120,7 @@ def receive_quiz_answer(update: Update, context: CallbackContext) -> None:
        context.bot.stop_poll(quiz_data["chat_id"], quiz_data["message_id"])


-def preview(update: Update, _: CallbackContext) -> None:
+def preview(update: Update, context: CallbackContext) -> None:
    """Ask user to create a poll and display a preview of it"""
    # using this without a type lets the user chooses what he wants (quiz or poll)
    button = [[KeyboardButton("Press me!", request_poll=KeyboardButtonPollType())]]
@@ -131,7 +131,7 @@ def preview(update: Update, _: CallbackContext) -> None:
    )


-def receive_poll(update: Update, _: CallbackContext) -> None:
+def receive_poll(update: Update, context: CallbackContext) -> None:
    """On receiving polls, reply to it by a closed poll copying the received poll"""
    actual_poll = update.effective_message.poll
    # Only need to set the question and options, since all other parameters don't matter for
@@ -145,12 +145,13 @@ def receive_poll(update: Update, _: CallbackContext) -> None:
    )


-def help_handler(update: Update, _: CallbackContext) -> None:
+def help_handler(update: Update, context: CallbackContext) -> None:
    """Display a help message"""
    update.message.reply_text("Use /quiz, /poll or /preview to test this bot.")


 def main() -> None:
+    """Run bot."""
    # Create the Updater and pass it your bot's token.
    updater = Updater("TOKEN")
    dispatcher = updater.dispatcher
@@ -49,10 +49,11 @@ def echo(bot: telegram.Bot) -> None:
    for update in bot.get_updates(offset=UPDATE_ID, timeout=10):
        UPDATE_ID = update.update_id + 1

-        if update.message:  # your bot can receive updates without messages
-            if update.message.text:  # not all messages contain text
-                # Reply to the message
-                update.message.reply_text(update.message.text)
+        # your bot can receive updates without messages
+        # and not all messages contain text
+        if update.message and update.message.text:
+            # Reply to the message
+            update.message.reply_text(update.message.text)


 if __name__ == '__main__':
@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# pylint: disable=C0116
+# pylint: disable=C0116,W0613
 # This program is dedicated to the public domain under the CC0 license.

 """
@@ -33,7 +33,12 @@ logger = logging.getLogger(__name__)

 # Define a few command handlers. These usually take the two arguments update and
 # context. Error handlers also receive the raised TelegramError object in error.
-def start(update: Update, _: CallbackContext) -> None:
+# Best practice would be to replace context with an underscore,
+# since context is an unused local variable.
+# This being an example and not having context present confusing beginners,
+# we decided to have it present as context.
+def start(update: Update, context: CallbackContext) -> None:
+    """Sends explanation on how to use the bot."""
    update.message.reply_text('Hi! Use /set <seconds> to set a timer')


@@ -3,13 +3,13 @@ cryptography!=3.4,!=3.4.1,!=3.4.2,!=3.4.3

 pre-commit
 # Make sure that the versions specified here match the pre-commit settings!
-black==20.8b1
-flake8==3.9.1
-pylint==2.8.2
+black==22.3.0
+flake8==3.9.2
+pylint==2.8.3
 mypy==0.812
-pyupgrade==2.13.0
+pyupgrade==2.19.1

-pytest==6.2.3
+pytest==6.2.4

 flaky
 beautifulsoup4
@@ -2,6 +2,7 @@
 # pre-commit hooks for pylint & mypy
 certifi
 # only telegram.ext: # Keep this line here; used in setup(-raw).py
-tornado>=5.1
+tornado>=6.1
 APScheduler==3.6.3
 pytz>=2018.6
+cachetools==4.2.2
@@ -43,6 +43,8 @@ omit =

 [coverage:report]
 exclude_lines =
+    pragma: no cover
+    @overload
    if TYPE_CHECKING:

 [mypy]
@@ -58,7 +60,7 @@ ignore_errors = True

 # Disable strict optional for telegram objects with class methods
 # We don't want to clutter the code with 'if self.bot is None: raise RuntimeError()'
-[mypy-telegram.callbackquery,telegram.chat,telegram.message,telegram.user,telegram.files.*,telegram.inline.inlinequery,telegram.payment.precheckoutquery,telegram.payment.shippingquery,telegram.passport.passportdata,telegram.passport.credentials,telegram.passport.passportfile,telegram.ext.filters]
+[mypy-telegram.callbackquery,telegram.chat,telegram.message,telegram.user,telegram.files.*,telegram.inline.inlinequery,telegram.payment.precheckoutquery,telegram.payment.shippingquery,telegram.passport.passportdata,telegram.passport.credentials,telegram.passport.passportfile,telegram.ext.filters,telegram.chatjoinrequest]
 strict_optional = False

 # type hinting for asyncio in webhookhandler is a bit tricky because it depends on the OS
@@ -65,7 +65,7 @@ def get_setup_kwargs(raw=False):
            author_email='devs@python-telegram-bot.org',
            license='LGPLv3',
            url='https://python-telegram-bot.org/',
-            # Keywords supported by PyPI can be found at https://git.io/JtLIZ
+            # Keywords supported by PyPI can be found at https://github.com/pypa/warehouse/blob/aafc5185e57e67d43487ce4faa95913dd4573e14/warehouse/templates/packaging/detail.html#L20-L58
            project_urls={
                "Documentation": "https://python-telegram-bot.readthedocs.io",
                "Bug Tracker": "https://github.com/python-telegram-bot/python-telegram-bot/issues",
@@ -98,7 +98,6 @@ def get_setup_kwargs(raw=False):
                'Topic :: Internet',
                'Programming Language :: Python',
                'Programming Language :: Python :: 3',
-                'Programming Language :: Python :: 3.6',
                'Programming Language :: Python :: 3.7',
                'Programming Language :: Python :: 3.8',
                'Programming Language :: Python :: 3.9',
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -20,12 +20,28 @@

 from .base import TelegramObject
 from .botcommand import BotCommand
+from .webappdata import WebAppData
+from .webappinfo import WebAppInfo
+from .sentwebappmessage import SentWebAppMessage
+from .menubutton import MenuButton, MenuButtonCommands, MenuButtonDefault, MenuButtonWebApp
+from .loginurl import LoginUrl
+from .games.callbackgame import CallbackGame
 from .user import User
 from .files.chatphoto import ChatPhoto
 from .chat import Chat
+from .chatadministratorrights import ChatAdministratorRights
 from .chatlocation import ChatLocation
 from .chatinvitelink import ChatInviteLink
-from .chatmember import ChatMember
+from .chatjoinrequest import ChatJoinRequest
+from .chatmember import (
+    ChatMember,
+    ChatMemberOwner,
+    ChatMemberAdministrator,
+    ChatMemberMember,
+    ChatMemberRestricted,
+    ChatMemberLeft,
+    ChatMemberBanned,
+)
 from .chatmemberupdated import ChatMemberUpdated
 from .chatpermissions import ChatPermissions
 from .files.photosize import PhotoSize
@@ -62,9 +78,13 @@ from .voicechat import (
    VoiceChatParticipantsInvited,
    VoiceChatScheduled,
 )
-from .loginurl import LoginUrl
+from .videochat import (
+    VideoChatStarted,
+    VideoChatEnded,
+    VideoChatParticipantsInvited,
+    VideoChatScheduled,
+)
 from .proximityalerttriggered import ProximityAlertTriggered
-from .games.callbackgame import CallbackGame
 from .payment.shippingaddress import ShippingAddress
 from .payment.orderinfo import OrderInfo
 from .payment.successfulpayment import SuccessfulPayment
@@ -153,6 +173,16 @@ from .passport.credentials import (
    FileCredentials,
    TelegramDecryptionError,
 )
+from .botcommandscope import (
+    BotCommandScope,
+    BotCommandScopeDefault,
+    BotCommandScopeAllPrivateChats,
+    BotCommandScopeAllGroupChats,
+    BotCommandScopeAllChatAdministrators,
+    BotCommandScopeChat,
+    BotCommandScopeChatAdministrators,
+    BotCommandScopeChatMember,
+)
 from .bot import Bot
 from .version import __version__, bot_api_version  # noqa: F401

@@ -163,13 +193,29 @@ __all__ = (  # Keep this alphabetically ordered
    'Audio',
    'Bot',
    'BotCommand',
+    'BotCommandScope',
+    'BotCommandScopeAllChatAdministrators',
+    'BotCommandScopeAllGroupChats',
+    'BotCommandScopeAllPrivateChats',
+    'BotCommandScopeChat',
+    'BotCommandScopeChatAdministrators',
+    'BotCommandScopeChatMember',
+    'BotCommandScopeDefault',
    'CallbackGame',
    'CallbackQuery',
    'Chat',
+    'ChatAdministratorRights',
    'ChatAction',
    'ChatInviteLink',
+    'ChatJoinRequest',
    'ChatLocation',
    'ChatMember',
+    'ChatMemberOwner',
+    'ChatMemberAdministrator',
+    'ChatMemberMember',
+    'ChatMemberRestricted',
+    'ChatMemberLeft',
+    'ChatMemberBanned',
    'ChatMemberUpdated',
    'ChatPermissions',
    'ChatPhoto',
@@ -238,6 +284,10 @@ __all__ = (  # Keep this alphabetically ordered
    'MAX_MESSAGES_PER_SECOND_PER_CHAT',
    'MAX_MESSAGE_LENGTH',
    'MaskPosition',
+    'MenuButton',
+    'MenuButtonCommands',
+    'MenuButtonDefault',
+    'MenuButtonWebApp',
    'Message',
    'MessageAutoDeleteTimerChanged',
    'MessageEntity',
@@ -270,6 +320,7 @@ __all__ = (  # Keep this alphabetically ordered
    'SUPPORTED_WEBHOOK_PORTS',
    'SecureData',
    'SecureValue',
+    'SentWebAppMessage',
    'ShippingAddress',
    'ShippingOption',
    'ShippingQuery',
@@ -284,11 +335,17 @@ __all__ = (  # Keep this alphabetically ordered
    'UserProfilePhotos',
    'Venue',
    'Video',
+    'VideoChatEnded',
+    'VideoChatParticipantsInvited',
+    'VideoChatScheduled',
+    'VideoChatStarted',
    'VideoNote',
    'Voice',
    'VoiceChatStarted',
    'VoiceChatEnded',
    'VoiceChatScheduled',
    'VoiceChatParticipantsInvited',
+    'WebAppData',
+    'WebAppInfo',
    'WebhookInfo',
 )
@@ -1,7 +1,7 @@
 # !/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -29,7 +29,7 @@ from .constants import BOT_API_VERSION

 def _git_revision() -> Optional[str]:
    try:
-        output = subprocess.check_output(
+        output = subprocess.check_output(  # skipcq: BAN-B607
            ["git", "describe", "--long", "--tags"], stderr=subprocess.STDOUT
        )
    except (subprocess.SubprocessError, OSError):
@@ -37,7 +37,7 @@ def _git_revision() -> Optional[str]:
    return output.decode().strip()


-def print_ver_info() -> None:
+def print_ver_info() -> None:  # skipcq: PY-D0003
    git_revision = _git_revision()
    print(f'python-telegram-bot {telegram_ver}' + (f' ({git_revision})' if git_revision else ''))
    print(f'Bot API {BOT_API_VERSION}')
@@ -46,7 +46,7 @@ def print_ver_info() -> None:
    print(f'Python {sys_version}')


-def main() -> None:
+def main() -> None:  # skipcq: PY-D0003
    print_ver_info()


@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -26,6 +26,7 @@ import warnings
 from typing import TYPE_CHECKING, List, Optional, Tuple, Type, TypeVar

 from telegram.utils.types import JSONDict
+from telegram.utils.deprecate import set_new_attribute_deprecated

 if TYPE_CHECKING:
    from telegram import Bot
@@ -34,23 +35,41 @@ TO = TypeVar('TO', bound='TelegramObject', covariant=True)


 class TelegramObject:
-    """Base class for most telegram objects."""
+    """Base class for most Telegram objects."""

    _id_attrs: Tuple[object, ...] = ()

+    # Adding slots reduces memory usage & allows for faster attribute access.
+    # Only instance variables should be added to __slots__.
+    # We add __dict__ here for backward compatibility & also to avoid repetition for subclasses.
+    __slots__ = ('__dict__',)
+
    def __str__(self) -> str:
        return str(self.to_dict())

    def __getitem__(self, item: str) -> object:
-        return self.__dict__[item]
+        return getattr(self, item, None)
+
+    def __setattr__(self, key: str, value: object) -> None:
+        set_new_attribute_deprecated(self, key, value)

    @staticmethod
-    def parse_data(data: Optional[JSONDict]) -> Optional[JSONDict]:
+    def _parse_data(data: Optional[JSONDict]) -> Optional[JSONDict]:
        return None if data is None else data.copy()

    @classmethod
    def de_json(cls: Type[TO], data: Optional[JSONDict], bot: 'Bot') -> Optional[TO]:
-        data = cls.parse_data(data)
+        """Converts JSON data to a Telegram object.
+
+        Args:
+            data (Dict[:obj:`str`, ...]): The JSON data.
+            bot (:class:`telegram.Bot`): The bot associated with this object.
+
+        Returns:
+            The Telegram object.
+
+        """
+        data = cls._parse_data(data)

        if data is None:
            return None
@@ -61,28 +80,47 @@ class TelegramObject:

    @classmethod
    def de_list(cls: Type[TO], data: Optional[List[JSONDict]], bot: 'Bot') -> List[Optional[TO]]:
+        """Converts JSON data to a list of Telegram objects.
+
+        Args:
+            data (Dict[:obj:`str`, ...]): The JSON data.
+            bot (:class:`telegram.Bot`): The bot associated with these objects.
+
+        Returns:
+            A list of Telegram objects.
+
+        """
        if not data:
            return []

        return [cls.de_json(d, bot) for d in data]

    def to_json(self) -> str:
-        """
+        """Gives a JSON representation of object.
+
        Returns:
            :obj:`str`
-
        """
-
        return json.dumps(self.to_dict())

    def to_dict(self) -> JSONDict:
+        """Gives representation of object as :obj:`dict`.
+
+        Returns:
+            :obj:`dict`
+        """
        data = {}

-        for key in iter(self.__dict__):
+        # We want to get all attributes for the class, using self.__slots__ only includes the
+        # attributes used by that class itself, and not its superclass(es). Hence we get its MRO
+        # and then get their attributes. The `[:-2]` slice excludes the `object` class & the
+        # TelegramObject class itself.
+        attrs = {attr for cls in self.__class__.__mro__[:-2] for attr in cls.__slots__}
+        for key in attrs:
            if key == 'bot' or key.startswith('_'):
                continue

-            value = self.__dict__[key]
+            value = getattr(self, key, None)
            if value is not None:
                if hasattr(value, 'to_dict'):
                    data[key] = value.to_dict()
@@ -2,7 +2,7 @@
 # pylint: disable=R0903
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -33,7 +33,7 @@ class BotCommand(TelegramObject):
    Args:
        command (:obj:`str`): Text of the command, 1-32 characters. Can contain only lowercase
            English letters, digits and underscores.
-        description (:obj:`str`): Description of the command, 3-256 characters.
+        description (:obj:`str`): Description of the command, 1-256 characters.

    Attributes:
        command (:obj:`str`): Text of the command.
@@ -41,6 +41,8 @@ class BotCommand(TelegramObject):

    """

+    __slots__ = ('description', '_id_attrs', 'command')
+
    def __init__(self, command: str, description: str, **_kwargs: Any):
        self.command = command
        self.description = description
@@ -0,0 +1,263 @@
+#!/usr/bin/env python
+#
+# A library that provides a Python interface to the Telegram Bot API
+# Copyright (C) 2015-2022
+# Leandro Toledo de Souza <devs@python-telegram-bot.org>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+#
+# You should have received a copy of the GNU Lesser Public License
+# along with this program.  If not, see [http://www.gnu.org/licenses/].
+# pylint: disable=W0622
+"""This module contains objects representing Telegram bot command scopes."""
+from typing import Any, Union, Optional, TYPE_CHECKING, Dict, Type
+
+from telegram import TelegramObject, constants
+from telegram.utils.types import JSONDict
+
+if TYPE_CHECKING:
+    from telegram import Bot
+
+
+class BotCommandScope(TelegramObject):
+    """Base class for objects that represent the scope to which bot commands are applied.
+    Currently, the following 7 scopes are supported:
+
+    * :class:`telegram.BotCommandScopeDefault`
+    * :class:`telegram.BotCommandScopeAllPrivateChats`
+    * :class:`telegram.BotCommandScopeAllGroupChats`
+    * :class:`telegram.BotCommandScopeAllChatAdministrators`
+    * :class:`telegram.BotCommandScopeChat`
+    * :class:`telegram.BotCommandScopeChatAdministrators`
+    * :class:`telegram.BotCommandScopeChatMember`
+
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`type` is equal. For subclasses with additional attributes,
+    the notion of equality is overridden.
+
+    Note:
+        Please see the `official docs`_ on how Telegram determines which commands to display.
+
+    .. _`official docs`: https://core.telegram.org/bots/api#determining-list-of-commands
+
+    .. versionadded:: 13.7
+
+    Args:
+        type (:obj:`str`): Scope type.
+
+    Attributes:
+        type (:obj:`str`): Scope type.
+    """
+
+    __slots__ = ('type', '_id_attrs')
+
+    DEFAULT = constants.BOT_COMMAND_SCOPE_DEFAULT
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_DEFAULT`"""
+    ALL_PRIVATE_CHATS = constants.BOT_COMMAND_SCOPE_ALL_PRIVATE_CHATS
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_ALL_PRIVATE_CHATS`"""
+    ALL_GROUP_CHATS = constants.BOT_COMMAND_SCOPE_ALL_GROUP_CHATS
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_ALL_GROUP_CHATS`"""
+    ALL_CHAT_ADMINISTRATORS = constants.BOT_COMMAND_SCOPE_ALL_CHAT_ADMINISTRATORS
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_ALL_CHAT_ADMINISTRATORS`"""
+    CHAT = constants.BOT_COMMAND_SCOPE_CHAT
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_CHAT`"""
+    CHAT_ADMINISTRATORS = constants.BOT_COMMAND_SCOPE_CHAT_ADMINISTRATORS
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_CHAT_ADMINISTRATORS`"""
+    CHAT_MEMBER = constants.BOT_COMMAND_SCOPE_CHAT_MEMBER
+    """:const:`telegram.constants.BOT_COMMAND_SCOPE_CHAT_MEMBER`"""
+
+    def __init__(self, type: str, **_kwargs: Any):
+        self.type = type
+        self._id_attrs = (self.type,)
+
+    @classmethod
+    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['BotCommandScope']:
+        """Converts JSON data to the appropriate :class:`BotCommandScope` object, i.e. takes
+        care of selecting the correct subclass.
+
+        Args:
+            data (Dict[:obj:`str`, ...]): The JSON data.
+            bot (:class:`telegram.Bot`): The bot associated with this object.
+
+        Returns:
+            The Telegram object.
+
+        """
+        data = cls._parse_data(data)
+
+        if not data:
+            return None
+
+        _class_mapping: Dict[str, Type['BotCommandScope']] = {
+            cls.DEFAULT: BotCommandScopeDefault,
+            cls.ALL_PRIVATE_CHATS: BotCommandScopeAllPrivateChats,
+            cls.ALL_GROUP_CHATS: BotCommandScopeAllGroupChats,
+            cls.ALL_CHAT_ADMINISTRATORS: BotCommandScopeAllChatAdministrators,
+            cls.CHAT: BotCommandScopeChat,
+            cls.CHAT_ADMINISTRATORS: BotCommandScopeChatAdministrators,
+            cls.CHAT_MEMBER: BotCommandScopeChatMember,
+        }
+
+        if cls is BotCommandScope:
+            return _class_mapping.get(data['type'], cls)(**data, bot=bot)
+        return cls(**data)
+
+
+class BotCommandScopeDefault(BotCommandScope):
+    """Represents the default scope of bot commands. Default commands are used if no commands with
+    a `narrower scope`_ are specified for the user.
+
+    .. _`narrower scope`: https://core.telegram.org/bots/api#determining-list-of-commands
+
+    .. versionadded:: 13.7
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.DEFAULT`.
+    """
+
+    __slots__ = ()
+
+    def __init__(self, **_kwargs: Any):
+        super().__init__(type=BotCommandScope.DEFAULT)
+
+
+class BotCommandScopeAllPrivateChats(BotCommandScope):
+    """Represents the scope of bot commands, covering all private chats.
+
+    .. versionadded:: 13.7
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.ALL_PRIVATE_CHATS`.
+    """
+
+    __slots__ = ()
+
+    def __init__(self, **_kwargs: Any):
+        super().__init__(type=BotCommandScope.ALL_PRIVATE_CHATS)
+
+
+class BotCommandScopeAllGroupChats(BotCommandScope):
+    """Represents the scope of bot commands, covering all group and supergroup chats.
+
+    .. versionadded:: 13.7
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.ALL_GROUP_CHATS`.
+    """
+
+    __slots__ = ()
+
+    def __init__(self, **_kwargs: Any):
+        super().__init__(type=BotCommandScope.ALL_GROUP_CHATS)
+
+
+class BotCommandScopeAllChatAdministrators(BotCommandScope):
+    """Represents the scope of bot commands, covering all group and supergroup chat administrators.
+
+    .. versionadded:: 13.7
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.ALL_CHAT_ADMINISTRATORS`.
+    """
+
+    __slots__ = ()
+
+    def __init__(self, **_kwargs: Any):
+        super().__init__(type=BotCommandScope.ALL_CHAT_ADMINISTRATORS)
+
+
+class BotCommandScopeChat(BotCommandScope):
+    """Represents the scope of bot commands, covering a specific chat.
+
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`type` and :attr:`chat_id` are equal.
+
+    .. versionadded:: 13.7
+
+    Args:
+        chat_id (:obj:`str` | :obj:`int`): Unique identifier for the target chat or username of the
+            target supergroup (in the format ``@supergroupusername``)
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.CHAT`.
+        chat_id (:obj:`str` | :obj:`int`): Unique identifier for the target chat or username of the
+            target supergroup (in the format ``@supergroupusername``)
+    """
+
+    __slots__ = ('chat_id',)
+
+    def __init__(self, chat_id: Union[str, int], **_kwargs: Any):
+        super().__init__(type=BotCommandScope.CHAT)
+        self.chat_id = (
+            chat_id if isinstance(chat_id, str) and chat_id.startswith('@') else int(chat_id)
+        )
+        self._id_attrs = (self.type, self.chat_id)
+
+
+class BotCommandScopeChatAdministrators(BotCommandScope):
+    """Represents the scope of bot commands, covering all administrators of a specific group or
+    supergroup chat.
+
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`type` and :attr:`chat_id` are equal.
+
+    .. versionadded:: 13.7
+
+    Args:
+        chat_id (:obj:`str` | :obj:`int`): Unique identifier for the target chat or username of the
+            target supergroup (in the format ``@supergroupusername``)
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.CHAT_ADMINISTRATORS`.
+        chat_id (:obj:`str` | :obj:`int`): Unique identifier for the target chat or username of the
+            target supergroup (in the format ``@supergroupusername``)
+    """
+
+    __slots__ = ('chat_id',)
+
+    def __init__(self, chat_id: Union[str, int], **_kwargs: Any):
+        super().__init__(type=BotCommandScope.CHAT_ADMINISTRATORS)
+        self.chat_id = (
+            chat_id if isinstance(chat_id, str) and chat_id.startswith('@') else int(chat_id)
+        )
+        self._id_attrs = (self.type, self.chat_id)
+
+
+class BotCommandScopeChatMember(BotCommandScope):
+    """Represents the scope of bot commands, covering a specific member of a group or supergroup
+    chat.
+
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`type`, :attr:`chat_id` and :attr:`user_id` are equal.
+
+    .. versionadded:: 13.7
+
+    Args:
+        chat_id (:obj:`str` | :obj:`int`): Unique identifier for the target chat or username of the
+            target supergroup (in the format ``@supergroupusername``)
+        user_id (:obj:`int`): Unique identifier of the target user.
+
+    Attributes:
+        type (:obj:`str`): Scope type :attr:`telegram.BotCommandScope.CHAT_MEMBER`.
+        chat_id (:obj:`str` | :obj:`int`): Unique identifier for the target chat or username of the
+            target supergroup (in the format ``@supergroupusername``)
+        user_id (:obj:`int`): Unique identifier of the target user.
+    """
+
+    __slots__ = ('chat_id', 'user_id')
+
+    def __init__(self, chat_id: Union[str, int], user_id: int, **_kwargs: Any):
+        super().__init__(type=BotCommandScope.CHAT_MEMBER)
+        self.chat_id = (
+            chat_id if isinstance(chat_id, str) and chat_id.startswith('@') else int(chat_id)
+        )
+        self.user_id = int(user_id)
+        self._id_attrs = (self.type, self.chat_id, self.user_id)
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -53,6 +53,13 @@ class CallbackQuery(TelegramObject):
          until you call :attr:`answer`. It is, therefore, necessary to react
          by calling :attr:`telegram.Bot.answer_callback_query` even if no notification to the user
          is needed (e.g., without specifying any of the optional parameters).
+        * If you're using :attr:`Bot.arbitrary_callback_data`, :attr:`data` may be an instance
+          of :class:`telegram.ext.InvalidCallbackData`. This will be the case, if the data
+          associated with the button triggering the :class:`telegram.CallbackQuery` was already
+          deleted or if :attr:`data` was manipulated by a malicious client.
+
+          .. versionadded:: 13.6
+

    Args:
        id (:obj:`str`): Unique identifier for this query.
@@ -77,7 +84,7 @@ class CallbackQuery(TelegramObject):
            the message with the callback button was sent.
        message (:class:`telegram.Message`): Optional. Message with the callback button that
            originated the query.
-        data (:obj:`str`): Optional. Data associated with the callback button.
+        data (:obj:`str` | :obj:`object`): Optional. Data associated with the callback button.
        inline_message_id (:obj:`str`): Optional. Identifier of the message sent via the bot in
                inline mode, that originated the query.
        game_short_name (:obj:`str`): Optional. Short name of a Game to be returned.
@@ -85,6 +92,18 @@ class CallbackQuery(TelegramObject):

    """

+    __slots__ = (
+        'bot',
+        'game_short_name',
+        'message',
+        'chat_instance',
+        'id',
+        'from_user',
+        'inline_message_id',
+        'data',
+        '_id_attrs',
+    )
+
    def __init__(
        self,
        id: str,  # pylint: disable=W0622
@@ -113,7 +132,8 @@ class CallbackQuery(TelegramObject):

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['CallbackQuery']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
@@ -173,7 +193,7 @@ class CallbackQuery(TelegramObject):
                                *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.edit_message_text`.
+        :meth:`telegram.Bot.edit_message_text` and :meth:`telegram.Message.edit_text`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -223,7 +243,7 @@ class CallbackQuery(TelegramObject):
                                   *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.edit_message_caption`.
+        :meth:`telegram.Bot.edit_message_caption` and :meth:`telegram.Message.edit_caption`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -275,7 +295,8 @@ class CallbackQuery(TelegramObject):
            )

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.edit_message_reply_markup`.
+        :meth:`telegram.Bot.edit_message_reply_markup` and
+        :meth:`telegram.Message.edit_reply_markup`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -314,7 +335,7 @@ class CallbackQuery(TelegramObject):
                                   *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.edit_message_media`.
+        :meth:`telegram.Bot.edit_message_media` and :meth:`telegram.Message.edit_media`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -362,7 +383,8 @@ class CallbackQuery(TelegramObject):
            )

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.edit_message_live_location`.
+        :meth:`telegram.Bot.edit_message_live_location` and
+        :meth:`telegram.Message.edit_live_location`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -414,7 +436,8 @@ class CallbackQuery(TelegramObject):
            )

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.stop_message_live_location`.
+        :meth:`telegram.Bot.stop_message_live_location` and
+        :meth:`telegram.Message.stop_live_location`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -455,7 +478,7 @@ class CallbackQuery(TelegramObject):
                               *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.set_game_score`.
+        :meth:`telegram.Bot.set_game_score` and :meth:`telegram.Message.set_game_score`.

        Returns:
            :class:`telegram.Message`: On success, if edited message is sent by the bot, the
@@ -499,7 +522,7 @@ class CallbackQuery(TelegramObject):
                                     *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.get_game_high_scores`.
+        :meth:`telegram.Bot.get_game_high_scores` and :meth:`telegram.Message.get_game_high_score`.

        Returns:
            List[:class:`telegram.GameHighScore`]
@@ -530,7 +553,7 @@ class CallbackQuery(TelegramObject):
            update.callback_query.message.delete(*args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.delete_message`.
+        :meth:`telegram.Message.delete`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
@@ -549,13 +572,10 @@ class CallbackQuery(TelegramObject):
    ) -> bool:
        """Shortcut for::

-             bot.pin_chat_message(chat_id=message.chat_id,
-                                  message_id=message.message_id,
-                                  *args,
-                                  **kwargs)
+             update.callback_query.message.pin(*args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.pin_chat_message`.
+        :meth:`telegram.Message.pin`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
@@ -574,13 +594,10 @@ class CallbackQuery(TelegramObject):
    ) -> bool:
        """Shortcut for::

-             bot.unpin_chat_message(chat_id=message.chat_id,
-                                    message_id=message.message_id,
-                                    *args,
-                                    **kwargs)
+             update.callback_query.message.unpin(*args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.unpin_chat_message`.
+        :meth:`telegram.Message.unpin`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
@@ -603,6 +620,7 @@ class CallbackQuery(TelegramObject):
        reply_markup: ReplyMarkup = None,
        timeout: ODVInput[float] = DEFAULT_NONE,
        api_kwargs: JSONDict = None,
+        protect_content: bool = None,
    ) -> 'MessageId':
        """Shortcut for::

@@ -614,7 +632,7 @@ class CallbackQuery(TelegramObject):
                **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.copy_message`.
+        :meth:`telegram.Message.copy`.

        Returns:
            :class:`telegram.MessageId`: On success, returns the MessageId of the sent message.
@@ -631,6 +649,7 @@ class CallbackQuery(TelegramObject):
            reply_markup=reply_markup,
            timeout=timeout,
            api_kwargs=api_kwargs,
+            protect_content=protect_content,
        )

    MAX_ANSWER_TEXT_LENGTH: ClassVar[int] = constants.MAX_ANSWER_CALLBACK_QUERY_TEXT_LENGTH
@@ -2,7 +2,7 @@
 # pylint: disable=W0622
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -18,11 +18,13 @@
 # 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 warnings
 from datetime import datetime
 from typing import TYPE_CHECKING, List, Optional, ClassVar, Union, Tuple, Any

-from telegram import ChatPhoto, TelegramObject, constants
+from telegram import ChatPhoto, TelegramObject, constants, MenuButton
 from telegram.utils.types import JSONDict, FileInput, ODVInput, DVInput
+from telegram.utils.deprecate import TelegramDeprecationWarning

 from .chatpermissions import ChatPermissions
 from .chatlocation import ChatLocation
@@ -79,6 +81,11 @@ class Chat(TelegramObject):
            Returned only in :meth:`telegram.Bot.get_chat`.
        bio (:obj:`str`, optional): Bio of the other party in a private chat. Returned only in
            :meth:`telegram.Bot.get_chat`.
+        has_private_forwards (:obj:`bool`, optional): :obj:`True`, if privacy settings of the other
+            party in the private chat allows to use ``tg://user?id=<user_id>`` links only in chats
+            with the user. Returned only in :meth:`telegram.Bot.get_chat`.
+
+            .. versionadded:: 13.9
        description (:obj:`str`, optional): Description, for groups, supergroups and channel chats.
            Returned only in :meth:`telegram.Bot.get_chat`.
        invite_link (:obj:`str`, optional): Primary invite link, for groups, supergroups and
@@ -95,6 +102,10 @@ class Chat(TelegramObject):
            :meth:`telegram.Bot.get_chat`.

            .. versionadded:: 13.4
+        has_protected_content (:obj:`bool`, optional): :obj:`True`, if messages from the chat can't
+            be forwarded to other chats. Returned only in :meth:`telegram.Bot.get_chat`.
+
+            .. versionadded:: 13.9
        bot (:class:`telegram.Bot`, optional): The Bot to use for instance methods.
        sticker_set_name (:obj:`str`, optional): For supergroups, name of group sticker set.
            Returned only in :meth:`telegram.Bot.get_chat`.
@@ -117,6 +128,11 @@ class Chat(TelegramObject):
        photo (:class:`telegram.ChatPhoto`): Optional. Chat photo.
        bio (:obj:`str`): Optional. Bio of the other party in a private chat. Returned only in
            :meth:`telegram.Bot.get_chat`.
+        has_private_forwards (:obj:`bool`): Optional. :obj:`True`, if privacy settings of the other
+            party in the private chat allows to use ``tg://user?id=<user_id>`` links only in chats
+            with the user.
+
+            .. versionadded:: 13.9
        description (:obj:`str`): Optional. Description, for groups, supergroups and channel chats.
        invite_link (:obj:`str`): Optional. Primary invite link, for groups, supergroups and
            channel. Returned only in :meth:`telegram.Bot.get_chat`.
@@ -132,6 +148,10 @@ class Chat(TelegramObject):
            :meth:`telegram.Bot.get_chat`.

            .. versionadded:: 13.4
+        has_protected_content (:obj:`bool`): Optional. :obj:`True`, if messages from the chat can't
+            be forwarded to other chats.
+
+            .. versionadded:: 13.9
        sticker_set_name (:obj:`str`): Optional. For supergroups, name of Group sticker set.
        can_set_sticker_set (:obj:`bool`): Optional. :obj:`True`, if the bot can change group the
            sticker set.
@@ -143,6 +163,32 @@ class Chat(TelegramObject):

    """

+    __slots__ = (
+        'bio',
+        'id',
+        'type',
+        'last_name',
+        'bot',
+        'sticker_set_name',
+        'slow_mode_delay',
+        'location',
+        'first_name',
+        'permissions',
+        'invite_link',
+        'pinned_message',
+        'description',
+        'can_set_sticker_set',
+        'username',
+        'title',
+        'photo',
+        'linked_chat_id',
+        'all_members_are_administrators',
+        'message_auto_delete_time',
+        'has_protected_content',
+        'has_private_forwards',
+        '_id_attrs',
+    )
+
    SENDER: ClassVar[str] = constants.CHAT_SENDER
    """:const:`telegram.constants.CHAT_SENDER`

@@ -178,6 +224,8 @@ class Chat(TelegramObject):
        linked_chat_id: int = None,
        location: ChatLocation = None,
        message_auto_delete_time: int = None,
+        has_private_forwards: bool = None,
+        has_protected_content: bool = None,
        **_kwargs: Any,
    ):
        # Required
@@ -192,6 +240,7 @@ class Chat(TelegramObject):
        self.all_members_are_administrators = _kwargs.get('all_members_are_administrators')
        self.photo = photo
        self.bio = bio
+        self.has_private_forwards = has_private_forwards
        self.description = description
        self.invite_link = invite_link
        self.pinned_message = pinned_message
@@ -200,6 +249,7 @@ class Chat(TelegramObject):
        self.message_auto_delete_time = (
            int(message_auto_delete_time) if message_auto_delete_time is not None else None
        )
+        self.has_protected_content = has_protected_content
        self.sticker_set_name = sticker_set_name
        self.can_set_sticker_set = can_set_sticker_set
        self.linked_chat_id = linked_chat_id
@@ -229,14 +279,16 @@ class Chat(TelegramObject):
    @property
    def link(self) -> Optional[str]:
        """:obj:`str`: Convenience property. If the chat has a :attr:`username`, returns a t.me
-        link of the chat."""
+        link of the chat.
+        """
        if self.username:
            return f"https://t.me/{self.username}"
        return None

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['Chat']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
@@ -258,7 +310,7 @@ class Chat(TelegramObject):
        For the documentation of the arguments, please see :meth:`telegram.Bot.leave_chat`.

        Returns:
-            :obj:`bool` If the action was sent successfully.
+            :obj:`bool`: On success, :obj:`True` is returned.

        """
        return self.bot.leave_chat(
@@ -292,19 +344,37 @@ class Chat(TelegramObject):

    def get_members_count(
        self, timeout: ODVInput[float] = DEFAULT_NONE, api_kwargs: JSONDict = None
+    ) -> int:
+        """
+        Deprecated, use :func:`~telegram.Chat.get_member_count` instead.
+
+        .. deprecated:: 13.7
+        """
+        warnings.warn(
+            '`Chat.get_members_count` is deprecated. Use `Chat.get_member_count` instead.',
+            TelegramDeprecationWarning,
+            stacklevel=2,
+        )
+
+        return self.get_member_count(
+            timeout=timeout,
+            api_kwargs=api_kwargs,
+        )
+
+    def get_member_count(
+        self, timeout: ODVInput[float] = DEFAULT_NONE, api_kwargs: JSONDict = None
    ) -> int:
        """Shortcut for::

-            bot.get_chat_members_count(update.effective_chat.id, *args, **kwargs)
+            bot.get_chat_member_count(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.get_chat_members_count`.
+        :meth:`telegram.Bot.get_chat_member_count`.

        Returns:
            :obj:`int`
-
        """
-        return self.bot.get_chat_members_count(
+        return self.bot.get_chat_member_count(
            chat_id=self.id,
            timeout=timeout,
            api_kwargs=api_kwargs,
@@ -340,24 +410,45 @@ class Chat(TelegramObject):
        until_date: Union[int, datetime] = None,
        api_kwargs: JSONDict = None,
        revoke_messages: bool = None,
+    ) -> bool:
+        """
+        Deprecated, use :func:`~telegram.Chat.ban_member` instead.
+
+        .. deprecated:: 13.7
+        """
+        warnings.warn(
+            '`Chat.kick_member` is deprecated. Use `Chat.ban_member` instead.',
+            TelegramDeprecationWarning,
+            stacklevel=2,
+        )
+
+        return self.ban_member(
+            user_id=user_id,
+            timeout=timeout,
+            until_date=until_date,
+            api_kwargs=api_kwargs,
+            revoke_messages=revoke_messages,
+        )
+
+    def ban_member(
+        self,
+        user_id: Union[str, int],
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        until_date: Union[int, datetime] = None,
+        api_kwargs: JSONDict = None,
+        revoke_messages: bool = None,
    ) -> bool:
        """Shortcut for::

-            bot.kick_chat_member(update.effective_chat.id, *args, **kwargs)
+            bot.ban_chat_member(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
-        :meth:`telegram.Bot.kick_chat_member`.
+        :meth:`telegram.Bot.ban_chat_member`.

        Returns:
-            :obj:`bool`: If the action was sent successfully.
-
-        Note:
-            This method will only work if the `All Members Are Admins` setting is off in the
-            target group. Otherwise members may only be removed by the group's creator or by the
-            member that added them.
-
+            :obj:`bool`: On success, :obj:`True` is returned.
        """
-        return self.bot.kick_chat_member(
+        return self.bot.ban_chat_member(
            chat_id=self.id,
            user_id=user_id,
            timeout=timeout,
@@ -366,6 +457,98 @@ class Chat(TelegramObject):
            revoke_messages=revoke_messages,
        )

+    def ban_sender_chat(
+        self,
+        sender_chat_id: int,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.ban_chat_sender_chat(chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.ban_chat_sender_chat`.
+
+        .. versionadded:: 13.9
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.ban_chat_sender_chat(
+            chat_id=self.id, sender_chat_id=sender_chat_id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
+    def ban_chat(
+        self,
+        chat_id: Union[str, int],
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.ban_chat_sender_chat(sender_chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.ban_chat_sender_chat`.
+
+        .. versionadded:: 13.9
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.ban_chat_sender_chat(
+            chat_id=chat_id, sender_chat_id=self.id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
+    def unban_sender_chat(
+        self,
+        sender_chat_id: int,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.unban_chat_sender_chat(chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.unban_chat_sender_chat`.
+
+        .. versionadded:: 13.9
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.unban_chat_sender_chat(
+            chat_id=self.id, sender_chat_id=sender_chat_id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
+    def unban_chat(
+        self,
+        chat_id: Union[str, int],
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.unban_chat_sender_chat(sender_chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.unban_chat_sender_chat`.
+
+        .. versionadded:: 13.9
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.unban_chat_sender_chat(
+            chat_id=chat_id, sender_chat_id=self.id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
    def unban_member(
        self,
        user_id: Union[str, int],
@@ -380,7 +563,7 @@ class Chat(TelegramObject):
        For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_member`.

        Returns:
-            :obj:`bool`: If the action was sent successfully.
+            :obj:`bool`: On success, :obj:`True` is returned.

        """
        return self.bot.unban_chat_member(
@@ -407,6 +590,7 @@ class Chat(TelegramObject):
        is_anonymous: bool = None,
        can_manage_chat: bool = None,
        can_manage_voice_chats: bool = None,
+        can_manage_video_chats: bool = None,
    ) -> bool:
        """Shortcut for::

@@ -417,8 +601,11 @@ class Chat(TelegramObject):

        .. versionadded:: 13.2

+        ..versionchanged:: 13.12
+            Since Bot API 6.0, voice chat was renamed to video chat.
+
        Returns:
-            :obj:`bool`: If the action was sent successfully.
+            :obj:`bool`: On success, :obj:`True` is returned.

        """
        return self.bot.promote_chat_member(
@@ -437,6 +624,7 @@ class Chat(TelegramObject):
            is_anonymous=is_anonymous,
            can_manage_chat=can_manage_chat,
            can_manage_voice_chats=can_manage_voice_chats,
+            can_manage_video_chats=can_manage_video_chats,
        )

    def restrict_member(
@@ -457,7 +645,7 @@ class Chat(TelegramObject):
        .. versionadded:: 13.2

        Returns:
-            :obj:`bool`: If the action was sent successfully.
+            :obj:`bool`: On success, :obj:`True` is returned.

        """
        return self.bot.restrict_chat_member(
@@ -483,7 +671,7 @@ class Chat(TelegramObject):
        :meth:`telegram.Bot.set_chat_permissions`.

        Returns:
-            :obj:`bool`: If the action was sent successfully.
+            :obj:`bool`: On success, :obj:`True` is returned.

        """
        return self.bot.set_chat_permissions(
@@ -508,7 +696,7 @@ class Chat(TelegramObject):
        :meth:`telegram.Bot.set_chat_administrator_custom_title`.

        Returns:
-        :obj:`bool`: If the action was sent successfully.
+            :obj:`bool`: On success, :obj:`True` is returned.

        """
        return self.bot.set_chat_administrator_custom_title(
@@ -609,6 +797,7 @@ class Chat(TelegramObject):
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -632,6 +821,7 @@ class Chat(TelegramObject):
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
            entities=entities,
+            protect_content=protect_content,
        )

    def send_media_group(
@@ -644,6 +834,7 @@ class Chat(TelegramObject):
        timeout: DVInput[float] = DEFAULT_20,
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> List['Message']:
        """Shortcut for::

@@ -652,7 +843,7 @@ class Chat(TelegramObject):
        For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.

        Returns:
-            List[:class:`telegram.Message`:] On success, instance representing the message posted.
+            List[:class:`telegram.Message`]: On success, instance representing the message posted.

        """
        return self.bot.send_media_group(
@@ -663,6 +854,7 @@ class Chat(TelegramObject):
            timeout=timeout,
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_chat_action(
@@ -704,6 +896,7 @@ class Chat(TelegramObject):
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        caption_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
        filename: str = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -728,6 +921,7 @@ class Chat(TelegramObject):
            allow_sending_without_reply=allow_sending_without_reply,
            caption_entities=caption_entities,
            filename=filename,
+            protect_content=protect_content,
        )

    def send_contact(
@@ -743,6 +937,7 @@ class Chat(TelegramObject):
        vcard: str = None,
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -767,6 +962,7 @@ class Chat(TelegramObject):
            vcard=vcard,
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_audio(
@@ -786,6 +982,7 @@ class Chat(TelegramObject):
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        caption_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
        filename: str = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -814,6 +1011,7 @@ class Chat(TelegramObject):
            allow_sending_without_reply=allow_sending_without_reply,
            caption_entities=caption_entities,
            filename=filename,
+            protect_content=protect_content,
        )

    def send_document(
@@ -831,6 +1029,7 @@ class Chat(TelegramObject):
        disable_content_type_detection: bool = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        caption_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -857,6 +1056,7 @@ class Chat(TelegramObject):
            disable_content_type_detection=disable_content_type_detection,
            allow_sending_without_reply=allow_sending_without_reply,
            caption_entities=caption_entities,
+            protect_content=protect_content,
        )

    def send_dice(
@@ -868,6 +1068,7 @@ class Chat(TelegramObject):
        emoji: str = None,
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -888,6 +1089,7 @@ class Chat(TelegramObject):
            emoji=emoji,
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_game(
@@ -899,6 +1101,7 @@ class Chat(TelegramObject):
        timeout: ODVInput[float] = DEFAULT_NONE,
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -919,6 +1122,7 @@ class Chat(TelegramObject):
            timeout=timeout,
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_invoice(
@@ -950,6 +1154,7 @@ class Chat(TelegramObject):
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        max_tip_amount: int = None,
        suggested_tip_amounts: List[int] = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -998,6 +1203,7 @@ class Chat(TelegramObject):
            allow_sending_without_reply=allow_sending_without_reply,
            max_tip_amount=max_tip_amount,
            suggested_tip_amounts=suggested_tip_amounts,
+            protect_content=protect_content,
        )

    def send_location(
@@ -1015,6 +1221,7 @@ class Chat(TelegramObject):
        heading: int = None,
        proximity_alert_radius: int = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1041,6 +1248,7 @@ class Chat(TelegramObject):
            heading=heading,
            proximity_alert_radius=proximity_alert_radius,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_animation(
@@ -1060,6 +1268,7 @@ class Chat(TelegramObject):
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        caption_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
        filename: str = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1088,6 +1297,7 @@ class Chat(TelegramObject):
            allow_sending_without_reply=allow_sending_without_reply,
            caption_entities=caption_entities,
            filename=filename,
+            protect_content=protect_content,
        )

    def send_sticker(
@@ -1099,6 +1309,7 @@ class Chat(TelegramObject):
        timeout: DVInput[float] = DEFAULT_20,
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1119,6 +1330,7 @@ class Chat(TelegramObject):
            timeout=timeout,
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_venue(
@@ -1138,6 +1350,7 @@ class Chat(TelegramObject):
        google_place_id: str = None,
        google_place_type: str = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1166,6 +1379,7 @@ class Chat(TelegramObject):
            google_place_id=google_place_id,
            google_place_type=google_place_type,
            allow_sending_without_reply=allow_sending_without_reply,
+            protect_content=protect_content,
        )

    def send_video(
@@ -1186,6 +1400,7 @@ class Chat(TelegramObject):
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        caption_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
        filename: str = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1215,6 +1430,7 @@ class Chat(TelegramObject):
            allow_sending_without_reply=allow_sending_without_reply,
            caption_entities=caption_entities,
            filename=filename,
+            protect_content=protect_content,
        )

    def send_video_note(
@@ -1230,6 +1446,7 @@ class Chat(TelegramObject):
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        filename: str = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1254,6 +1471,7 @@ class Chat(TelegramObject):
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
            filename=filename,
+            protect_content=protect_content,
        )

    def send_voice(
@@ -1270,6 +1488,7 @@ class Chat(TelegramObject):
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        caption_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
        filename: str = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1295,6 +1514,7 @@ class Chat(TelegramObject):
            allow_sending_without_reply=allow_sending_without_reply,
            caption_entities=caption_entities,
            filename=filename,
+            protect_content=protect_content,
        )

    def send_poll(
@@ -1318,6 +1538,7 @@ class Chat(TelegramObject):
        api_kwargs: JSONDict = None,
        allow_sending_without_reply: ODVInput[bool] = DEFAULT_NONE,
        explanation_entities: Union[List['MessageEntity'], Tuple['MessageEntity', ...]] = None,
+        protect_content: bool = None,
    ) -> 'Message':
        """Shortcut for::

@@ -1349,6 +1570,7 @@ class Chat(TelegramObject):
            api_kwargs=api_kwargs,
            allow_sending_without_reply=allow_sending_without_reply,
            explanation_entities=explanation_entities,
+            protect_content=protect_content,
        )

    def send_copy(
@@ -1364,6 +1586,7 @@ class Chat(TelegramObject):
        reply_markup: 'ReplyMarkup' = None,
        timeout: ODVInput[float] = DEFAULT_NONE,
        api_kwargs: JSONDict = None,
+        protect_content: bool = None,
    ) -> 'MessageId':
        """Shortcut for::

@@ -1388,6 +1611,7 @@ class Chat(TelegramObject):
            reply_markup=reply_markup,
            timeout=timeout,
            api_kwargs=api_kwargs,
+            protect_content=protect_content,
        )

    def copy_message(
@@ -1403,6 +1627,7 @@ class Chat(TelegramObject):
        reply_markup: 'ReplyMarkup' = None,
        timeout: ODVInput[float] = DEFAULT_NONE,
        api_kwargs: JSONDict = None,
+        protect_content: bool = None,
    ) -> 'MessageId':
        """Shortcut for::

@@ -1427,6 +1652,7 @@ class Chat(TelegramObject):
            reply_markup=reply_markup,
            timeout=timeout,
            api_kwargs=api_kwargs,
+            protect_content=protect_content,
        )

    def export_invite_link(
@@ -1457,6 +1683,8 @@ class Chat(TelegramObject):
        member_limit: int = None,
        timeout: ODVInput[float] = DEFAULT_NONE,
        api_kwargs: JSONDict = None,
+        name: str = None,
+        creates_join_request: bool = None,
    ) -> 'ChatInviteLink':
        """Shortcut for::

@@ -1467,6 +1695,10 @@ class Chat(TelegramObject):

        .. versionadded:: 13.4

+        .. versionchanged:: 13.8
+           Edited signature according to the changes of
+           :meth:`telegram.Bot.create_chat_invite_link`.
+
        Returns:
            :class:`telegram.ChatInviteLink`

@@ -1477,6 +1709,8 @@ class Chat(TelegramObject):
            member_limit=member_limit,
            timeout=timeout,
            api_kwargs=api_kwargs,
+            name=name,
+            creates_join_request=creates_join_request,
        )

    def edit_invite_link(
@@ -1486,6 +1720,8 @@ class Chat(TelegramObject):
        member_limit: int = None,
        timeout: ODVInput[float] = DEFAULT_NONE,
        api_kwargs: JSONDict = None,
+        name: str = None,
+        creates_join_request: bool = None,
    ) -> 'ChatInviteLink':
        """Shortcut for::

@@ -1496,6 +1732,9 @@ class Chat(TelegramObject):

        .. versionadded:: 13.4

+        .. versionchanged:: 13.8
+           Edited signature according to the changes of :meth:`telegram.Bot.edit_chat_invite_link`.
+
        Returns:
            :class:`telegram.ChatInviteLink`

@@ -1507,6 +1746,8 @@ class Chat(TelegramObject):
            member_limit=member_limit,
            timeout=timeout,
            api_kwargs=api_kwargs,
+            name=name,
+            creates_join_request=creates_join_request,
        )

    def revoke_invite_link(
@@ -1531,3 +1772,107 @@ class Chat(TelegramObject):
        return self.bot.revoke_chat_invite_link(
            chat_id=self.id, invite_link=invite_link, timeout=timeout, api_kwargs=api_kwargs
        )
+
+    def approve_join_request(
+        self,
+        user_id: int,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.approve_chat_join_request(chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.approve_chat_join_request`.
+
+        .. versionadded:: 13.8
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.approve_chat_join_request(
+            chat_id=self.id, user_id=user_id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
+    def decline_join_request(
+        self,
+        user_id: int,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.decline_chat_join_request(chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.decline_chat_join_request`.
+
+        .. versionadded:: 13.8
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.decline_chat_join_request(
+            chat_id=self.id, user_id=user_id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
+    def set_menu_button(
+        self,
+        menu_button: MenuButton = None,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+             bot.set_chat_menu_button(chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.set_chat_menu_button`.
+
+        Caution:
+            Can only work, if the chat is a private chat.
+
+        ..seealso:: :meth:`get_menu_button`
+
+        .. versionadded:: 13.12
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+        """
+        return self.bot.set_chat_menu_button(
+            chat_id=self.id,
+            menu_button=menu_button,
+            timeout=timeout,
+            api_kwargs=api_kwargs,
+        )
+
+    def get_menu_button(
+        self,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> MenuButton:
+        """Shortcut for::
+
+             bot.get_chat_menu_button(chat_id=update.effective_chat.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.set_chat_menu_button`.
+
+        Caution:
+            Can only work, if the chat is a private chat.
+
+        ..seealso:: :meth:`set_menu_button`
+
+        .. versionadded:: 13.12
+
+        Returns:
+            :class:`telegram.MenuButton`: On success, the current menu button is returned.
+        """
+        return self.bot.get_chat_menu_button(
+            chat_id=self.id,
+            timeout=timeout,
+            api_kwargs=api_kwargs,
+        )
@@ -2,7 +2,7 @@
 # pylint: disable=R0903
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -20,19 +20,20 @@
 """This module contains an object that represents a Telegram ChatAction."""
 from typing import ClassVar
 from telegram import constants
+from telegram.utils.deprecate import set_new_attribute_deprecated


 class ChatAction:
    """Helper class to provide constants for different chat actions."""

+    __slots__ = ('__dict__',)  # Adding __dict__ here since it doesn't subclass TGObject
    FIND_LOCATION: ClassVar[str] = constants.CHATACTION_FIND_LOCATION
    """:const:`telegram.constants.CHATACTION_FIND_LOCATION`"""
    RECORD_AUDIO: ClassVar[str] = constants.CHATACTION_RECORD_AUDIO
    """:const:`telegram.constants.CHATACTION_RECORD_AUDIO`

        .. deprecated:: 13.5
-           Deprecated by Telegram. Use :attr:`RECORD_VOICE` instead, as backwards
-           compatibility is not guaranteed by Telegram.
+           Deprecated by Telegram. Use :attr:`RECORD_VOICE` instead.
    """
    RECORD_VOICE: ClassVar[str] = constants.CHATACTION_RECORD_VOICE
    """:const:`telegram.constants.CHATACTION_RECORD_VOICE`
@@ -49,8 +50,7 @@ class ChatAction:
    """:const:`telegram.constants.CHATACTION_UPLOAD_AUDIO`

        .. deprecated:: 13.5
-           Deprecated by Telegram. Use :attr:`UPLOAD_VOICE` instead, as backwards
-           compatibility is not guaranteed by Telegram.
+           Deprecated by Telegram. Use :attr:`UPLOAD_VOICE` instead.
    """
    UPLOAD_VOICE: ClassVar[str] = constants.CHATACTION_UPLOAD_VOICE
    """:const:`telegram.constants.CHATACTION_UPLOAD_VOICE`
@@ -59,9 +59,16 @@ class ChatAction:
    """
    UPLOAD_DOCUMENT: ClassVar[str] = constants.CHATACTION_UPLOAD_DOCUMENT
    """:const:`telegram.constants.CHATACTION_UPLOAD_DOCUMENT`"""
+    CHOOSE_STICKER: ClassVar[str] = constants.CHATACTION_CHOOSE_STICKER
+    """:const:`telegram.constants.CHOOSE_STICKER`
+
+        .. versionadded:: 13.8"""
    UPLOAD_PHOTO: ClassVar[str] = constants.CHATACTION_UPLOAD_PHOTO
    """:const:`telegram.constants.CHATACTION_UPLOAD_PHOTO`"""
    UPLOAD_VIDEO: ClassVar[str] = constants.CHATACTION_UPLOAD_VIDEO
    """:const:`telegram.constants.CHATACTION_UPLOAD_VIDEO`"""
    UPLOAD_VIDEO_NOTE: ClassVar[str] = constants.CHATACTION_UPLOAD_VIDEO_NOTE
    """:const:`telegram.constants.CHATACTION_UPLOAD_VIDEO_NOTE`"""
+
+    def __setattr__(self, key: str, value: object) -> None:
+        set_new_attribute_deprecated(self, key, value)
@@ -0,0 +1,167 @@
+#!/usr/bin/env python
+#
+# A library that provides a Python interface to the Telegram Bot API
+# Copyright (C) 2015-2022
+# Leandro Toledo de Souza <devs@python-telegram-bot.org>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+#
+# 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 Any
+
+from telegram import TelegramObject
+
+
+class ChatAdministratorRights(TelegramObject):
+    """Represents the rights of an administrator in a chat.
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`is_anonymous`, :attr:`can_manage_chat`,
+    :attr:`can_delete_messages`, :attr:`can_manage_video_chats`, :attr:`can_restrict_members`,
+    :attr:`can_promote_members`, :attr:`can_change_info`, :attr:`can_invite_users`,
+    :attr:`can_post_messages`, :attr:`can_edit_messages`, :attr:`can_pin_messages` are equal.
+
+    .. seealso: :meth:`Bot.set_my_default_administrator_rights`,
+        :meth:`Bot.get_my_default_administrator_rights`
+
+    .. versionadded:: 13.12
+
+    Args:
+        is_anonymous (:obj:`bool`): :obj:`True`, if the user's presence in the chat is hidden.
+        can_manage_chat (:obj:`bool`): :obj:`True`, if the administrator can access the chat event
+            log, chat statistics, message statistics in channels, see channel members, see
+            anonymous administrators in supergroups and ignore slow mode. Implied by any other
+            administrator privilege.
+        can_delete_messages (:obj:`bool`): :obj:`True`, if the administrator can delete messages of
+            other users.
+        can_manage_video_chats (:obj:`bool`): :obj:`True`, if the administrator can manage video
+            chats.
+        can_restrict_members (:obj:`bool`): :obj:`True`, if the administrator can restrict, ban or
+            unban chat members.
+        can_promote_members (:obj:`bool`): :obj:`True`, if the administrator can add new
+            administrators with a subset of their own privileges or demote administrators that he
+            has promoted, directly or indirectly (promoted by administrators that were appointed by
+            the user.)
+        can_change_info (:obj:`bool`): :obj:`True`, if the user is allowed to change the chat title
+            , photo and other settings.
+        can_invite_users (:obj:`bool`): :obj:`True`, if the user is allowed to invite new users to
+            the chat.
+        can_post_messages (:obj:`bool`, optional): :obj:`True`, if the administrator can post
+            messages in the channel; channels only.
+        can_edit_messages (:obj:`bool`, optional): :obj:`True`, if the administrator can edit
+            messages of other users.
+        can_pin_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed to pin
+            messages; groups and supergroups only.
+
+    Attributes:
+        is_anonymous (:obj:`bool`): :obj:`True`, if the user's presence in the chat is hidden.
+        can_manage_chat (:obj:`bool`): :obj:`True`, if the administrator can access the chat event
+            log, chat statistics, message statistics in channels, see channel members, see
+            anonymous administrators in supergroups and ignore slow mode. Implied by any other
+            administrator privilege.
+        can_delete_messages (:obj:`bool`): :obj:`True`, if the administrator can delete messages of
+            other users.
+        can_manage_video_chats (:obj:`bool`): :obj:`True`, if the administrator can manage video
+            chats.
+        can_restrict_members (:obj:`bool`): :obj:`True`, if the administrator can restrict, ban or
+            unban chat members.
+        can_promote_members (:obj:`bool`): :obj:`True`, if the administrator can add new
+            administrators with a subset of their own privileges or demote administrators that he
+            has promoted, directly or indirectly (promoted by administrators that were appointed by
+            the user.)
+        can_change_info (:obj:`bool`): :obj:`True`, if the user is allowed to change the chat title
+            ,photo and other settings.
+        can_invite_users (:obj:`bool`): :obj:`True`, if the user is allowed to invite new users to
+            the chat.
+        can_post_messages (:obj:`bool`): Optional. :obj:`True`, if the administrator can post
+            messages in the channel; channels only.
+        can_edit_messages (:obj:`bool`): Optional. :obj:`True`, if the administrator can edit
+            messages of other users.
+        can_pin_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed to pin
+            messages; groups and supergroups only.
+    """
+
+    __slots__ = (
+        'is_anonymous',
+        'can_manage_chat',
+        'can_delete_messages',
+        'can_manage_video_chats',
+        'can_restrict_members',
+        'can_promote_members',
+        'can_change_info',
+        'can_invite_users',
+        'can_post_messages',
+        'can_edit_messages',
+        'can_pin_messages',
+        '_id_attrs',
+    )
+
+    def __init__(
+        self,
+        is_anonymous: bool,
+        can_manage_chat: bool,
+        can_delete_messages: bool,
+        can_manage_video_chats: bool,
+        can_restrict_members: bool,
+        can_promote_members: bool,
+        can_change_info: bool,
+        can_invite_users: bool,
+        can_post_messages: bool = None,
+        can_edit_messages: bool = None,
+        can_pin_messages: bool = None,
+        **_kwargs: Any,
+    ) -> None:
+        # Required
+        self.is_anonymous = is_anonymous
+        self.can_manage_chat = can_manage_chat
+        self.can_delete_messages = can_delete_messages
+        self.can_manage_video_chats = can_manage_video_chats
+        self.can_restrict_members = can_restrict_members
+        self.can_promote_members = can_promote_members
+        self.can_change_info = can_change_info
+        self.can_invite_users = can_invite_users
+        # Optionals
+        self.can_post_messages = can_post_messages
+        self.can_edit_messages = can_edit_messages
+        self.can_pin_messages = can_pin_messages
+
+        self._id_attrs = (
+            self.is_anonymous,
+            self.can_manage_chat,
+            self.can_delete_messages,
+            self.can_manage_video_chats,
+            self.can_restrict_members,
+            self.can_promote_members,
+            self.can_change_info,
+            self.can_invite_users,
+            self.can_post_messages,
+            self.can_edit_messages,
+            self.can_pin_messages,
+        )
+
+    @classmethod
+    def all_rights(cls) -> 'ChatAdministratorRights':
+        """
+        This method returns the :class:`ChatAdministratorRights` object with all attributes set to
+        :obj:`True`. This is e.g. useful when changing the bot's default administrator rights with
+        :meth:`telegram.Bot.set_my_default_administrator_rights`.
+        """
+        return cls(True, True, True, True, True, True, True, True, True, True, True)
+
+    @classmethod
+    def no_rights(cls) -> 'ChatAdministratorRights':
+        """
+        This method returns the :class:`ChatAdministratorRights` object with all attributes set to
+        :obj:`False`.
+        """
+        return cls(False, False, False, False, False, False, False, False, False, False, False)
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -46,6 +46,17 @@ class ChatInviteLink(TelegramObject):
            has been expired.
        member_limit (:obj:`int`, optional): Maximum number of users that can be members of the
            chat simultaneously after joining the chat via this invite link; 1-99999.
+        name (:obj:`str`, optional): Invite link name.
+
+            .. versionadded:: 13.8
+        creates_join_request (:obj:`bool`, optional): :obj:`True`, if users joining the chat via
+            the link need to be approved by chat administrators.
+
+            .. versionadded:: 13.8
+        pending_join_request_count (:obj:`int`, optional): Number of pending join requests
+            created using this link.
+
+            .. versionadded:: 13.8

    Attributes:
        invite_link (:obj:`str`): The invite link. If the link was created by another chat
@@ -57,9 +68,33 @@ class ChatInviteLink(TelegramObject):
            has been expired.
        member_limit (:obj:`int`): Optional. Maximum number of users that can be members
            of the chat simultaneously after joining the chat via this invite link; 1-99999.
+        name (:obj:`str`): Optional. Invite link name.
+
+            .. versionadded:: 13.8
+        creates_join_request (:obj:`bool`): Optional. :obj:`True`, if users joining the chat via
+            the link need to be approved by chat administrators.
+
+            .. versionadded:: 13.8
+        pending_join_request_count (:obj:`int`): Optional. Number of pending join requests
+            created using this link.
+
+            .. versionadded:: 13.8

    """

+    __slots__ = (
+        'invite_link',
+        'creator',
+        'is_primary',
+        'is_revoked',
+        'expire_date',
+        'member_limit',
+        'name',
+        'creates_join_request',
+        'pending_join_request_count',
+        '_id_attrs',
+    )
+
    def __init__(
        self,
        invite_link: str,
@@ -68,6 +103,9 @@ class ChatInviteLink(TelegramObject):
        is_revoked: bool,
        expire_date: datetime.datetime = None,
        member_limit: int = None,
+        name: str = None,
+        creates_join_request: bool = None,
+        pending_join_request_count: int = None,
        **_kwargs: Any,
    ):
        # Required
@@ -79,12 +117,17 @@ class ChatInviteLink(TelegramObject):
        # Optionals
        self.expire_date = expire_date
        self.member_limit = int(member_limit) if member_limit is not None else None
-
+        self.name = name
+        self.creates_join_request = creates_join_request
+        self.pending_join_request_count = (
+            int(pending_join_request_count) if pending_join_request_count is not None else None
+        )
        self._id_attrs = (self.invite_link, self.creator, self.is_primary, self.is_revoked)

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['ChatInviteLink']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
@@ -95,6 +138,7 @@ class ChatInviteLink(TelegramObject):
        return cls(**data)

    def to_dict(self) -> JSONDict:
+        """See :meth:`telegram.TelegramObject.to_dict`."""
        data = super().to_dict()

        data['expire_date'] = to_timestamp(self.expire_date)
@@ -0,0 +1,159 @@
+#!/usr/bin/env python
+#
+# A library that provides a Python interface to the Telegram Bot API
+# Copyright (C) 2015-2022
+# Leandro Toledo de Souza <devs@python-telegram-bot.org>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+#
+# 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
+from typing import TYPE_CHECKING, Any, Optional
+
+from telegram import TelegramObject, User, Chat, ChatInviteLink
+from telegram.utils.helpers import from_timestamp, to_timestamp, DEFAULT_NONE
+from telegram.utils.types import JSONDict, ODVInput
+
+if TYPE_CHECKING:
+    from telegram import Bot
+
+
+class ChatJoinRequest(TelegramObject):
+    """This object represents a join request sent to a chat.
+
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`chat`, :attr:`from_user` and :attr:`date` are equal.
+
+    Note:
+        Since Bot API 5.5, bots are allowed to contact users who sent a join request to a chat
+        where the bot is an administrator with the
+        :attr:`~telegram.ChatMemberAdministrator.can_invite_users` administrator right – even if
+        the user never interacted with the bot before.
+
+    .. versionadded:: 13.8
+
+    Args:
+        chat (:class:`telegram.Chat`): Chat to which the request was sent.
+        from_user (:class:`telegram.User`): User that sent the join request.
+        date (:class:`datetime.datetime`): Date the request was sent.
+        bio (:obj:`str`, optional): Bio of the user.
+        invite_link (:class:`telegram.ChatInviteLink`, optional): Chat invite link that was used
+            by the user to send the join request.
+        bot (:class:`telegram.Bot`, optional): The Bot to use for instance methods.
+
+    Attributes:
+        chat (:class:`telegram.Chat`): Chat to which the request was sent.
+        from_user (:class:`telegram.User`): User that sent the join request.
+        date (:class:`datetime.datetime`): Date the request was sent.
+        bio (:obj:`str`): Optional. Bio of the user.
+        invite_link (:class:`telegram.ChatInviteLink`): Optional. Chat invite link that was used
+            by the user to send the join request.
+
+    """
+
+    __slots__ = (
+        'chat',
+        'from_user',
+        'date',
+        'bio',
+        'invite_link',
+        'bot',
+        '_id_attrs',
+    )
+
+    def __init__(
+        self,
+        chat: Chat,
+        from_user: User,
+        date: datetime.datetime,
+        bio: str = None,
+        invite_link: ChatInviteLink = None,
+        bot: 'Bot' = None,
+        **_kwargs: Any,
+    ):
+        # Required
+        self.chat = chat
+        self.from_user = from_user
+        self.date = date
+
+        # Optionals
+        self.bio = bio
+        self.invite_link = invite_link
+
+        self.bot = bot
+        self._id_attrs = (self.chat, self.from_user, self.date)
+
+    @classmethod
+    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['ChatJoinRequest']:
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)
+
+        if not data:
+            return None
+
+        data['chat'] = Chat.de_json(data.get('chat'), bot)
+        data['from_user'] = User.de_json(data.get('from'), bot)
+        data['date'] = from_timestamp(data.get('date', None))
+        data['invite_link'] = ChatInviteLink.de_json(data.get('invite_link'), bot)
+
+        return cls(bot=bot, **data)
+
+    def to_dict(self) -> JSONDict:
+        """See :meth:`telegram.TelegramObject.to_dict`."""
+        data = super().to_dict()
+
+        data['date'] = to_timestamp(self.date)
+
+        return data
+
+    def approve(
+        self,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.approve_chat_join_request(chat_id=update.effective_chat.id,
+            user_id=update.effective_user.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.approve_chat_join_request`.
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.approve_chat_join_request(
+            chat_id=self.chat.id, user_id=self.from_user.id, timeout=timeout, api_kwargs=api_kwargs
+        )
+
+    def decline(
+        self,
+        timeout: ODVInput[float] = DEFAULT_NONE,
+        api_kwargs: JSONDict = None,
+    ) -> bool:
+        """Shortcut for::
+
+            bot.decline_chat_join_request(chat_id=update.effective_chat.id,
+            user_id=update.effective_user.id, *args, **kwargs)
+
+        For the documentation of the arguments, please see
+        :meth:`telegram.Bot.decline_chat_join_request`.
+
+        Returns:
+            :obj:`bool`: On success, :obj:`True` is returned.
+
+        """
+        return self.bot.decline_chat_join_request(
+            chat_id=self.chat.id, user_id=self.from_user.id, timeout=timeout, api_kwargs=api_kwargs
+        )
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -47,6 +47,8 @@ class ChatLocation(TelegramObject):

    """

+    __slots__ = ('location', '_id_attrs', 'address')
+
    def __init__(
        self,
        location: Location,
@@ -60,7 +62,8 @@ class ChatLocation(TelegramObject):

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['ChatLocation']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -18,7 +18,7 @@
 # along with this program.  If not, see [http://www.gnu.org/licenses/].
 """This module contains an object that represents a Telegram ChatMember."""
 import datetime
-from typing import TYPE_CHECKING, Any, Optional, ClassVar
+from typing import TYPE_CHECKING, Any, Optional, ClassVar, Dict, Type

 from telegram import TelegramObject, User, constants
 from telegram.utils.helpers import from_timestamp, to_timestamp
@@ -29,115 +29,268 @@ if TYPE_CHECKING:


 class ChatMember(TelegramObject):
-    """This object contains information about one member of a chat.
+    """Base class for Telegram ChatMember Objects.
+    Currently, the following 6 types of chat members are supported:
+
+    * :class:`telegram.ChatMemberOwner`
+    * :class:`telegram.ChatMemberAdministrator`
+    * :class:`telegram.ChatMemberMember`
+    * :class:`telegram.ChatMemberRestricted`
+    * :class:`telegram.ChatMemberLeft`
+    * :class:`telegram.ChatMemberBanned`

    Objects of this class are comparable in terms of equality. Two objects of this class are
    considered equal, if their :attr:`user` and :attr:`status` are equal.

+    Note:
+        As of Bot API 5.3, :class:`ChatMember` is nothing but the base class for the subclasses
+        listed above and is no longer returned directly by :meth:`~telegram.Bot.get_chat`.
+        Therefore, most of the arguments and attributes were deprecated and you should no longer
+        use :class:`ChatMember` directly.
+
    Args:
        user (:class:`telegram.User`): Information about the user.
-        status (:obj:`str`): The member's status in the chat. Can be 'creator', 'administrator',
-            'member', 'restricted', 'left' or 'kicked'.
+        status (:obj:`str`): The member's status in the chat. Can be
+            :attr:`~telegram.ChatMember.ADMINISTRATOR`, :attr:`~telegram.ChatMember.CREATOR`,
+            :attr:`~telegram.ChatMember.KICKED`, :attr:`~telegram.ChatMember.LEFT`,
+            :attr:`~telegram.ChatMember.MEMBER` or :attr:`~telegram.ChatMember.RESTRICTED`.
        custom_title (:obj:`str`, optional): Owner and administrators only.
            Custom title for this user.
+
+            .. deprecated:: 13.7
+
        is_anonymous (:obj:`bool`, optional): Owner and administrators only. :obj:`True`, if the
            user's presence in the chat is hidden.
+
+            .. deprecated:: 13.7
+
        until_date (:class:`datetime.datetime`, optional): Restricted and kicked only. Date when
            restrictions will be lifted for this user.
+
+            .. deprecated:: 13.7
+
        can_be_edited (:obj:`bool`, optional): Administrators only. :obj:`True`, if the bot is
            allowed to edit administrator privileges of that user.
+
+            .. deprecated:: 13.7
+
        can_manage_chat (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can access the chat event log, chat statistics, message statistics in
            channels, see channel members, see anonymous administrators in supergroups and ignore
            slow mode. Implied by any other administrator privilege.

            .. versionadded:: 13.4
+            .. deprecated:: 13.7

        can_manage_voice_chats (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can manage voice chats.

            .. versionadded:: 13.4
+            .. deprecated:: 13.7

        can_change_info (:obj:`bool`, optional): Administrators and restricted only. :obj:`True`,
            if the user can change the chat title, photo and other settings.
+
+            .. deprecated:: 13.7
+
        can_post_messages (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can post in the channel, channels only.
+
+            .. deprecated:: 13.7
+
        can_edit_messages (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can edit messages of other users and can pin messages; channels only.
+
+            .. deprecated:: 13.7
+
        can_delete_messages (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can delete messages of other users.
+
+            .. deprecated:: 13.7
+
        can_invite_users (:obj:`bool`, optional): Administrators and restricted only. :obj:`True`,
            if the user can invite new users to the chat.
+
+            .. deprecated:: 13.7
+
        can_restrict_members (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can restrict, ban or unban chat members.
+
+            .. deprecated:: 13.7
+
        can_pin_messages (:obj:`bool`, optional): Administrators and restricted only. :obj:`True`,
            if the user can pin messages, groups and supergroups only.
+
+            .. deprecated:: 13.7
+
        can_promote_members (:obj:`bool`, optional): Administrators only. :obj:`True`, if the
            administrator can add new administrators with a subset of his own privileges or demote
            administrators that he has promoted, directly or indirectly (promoted by administrators
            that were appointed by the user).
+
+            .. deprecated:: 13.7
+
        is_member (:obj:`bool`, optional): Restricted only. :obj:`True`, if the user is a member of
            the chat at the moment of the request.
+
+            .. deprecated:: 13.7
+
        can_send_messages (:obj:`bool`, optional): Restricted only. :obj:`True`, if the user can
            send text messages, contacts, locations and venues.
+
+            .. deprecated:: 13.7
+
        can_send_media_messages (:obj:`bool`, optional): Restricted only. :obj:`True`, if the user
            can send audios, documents, photos, videos, video notes and voice notes.
+
+            .. deprecated:: 13.7
+
        can_send_polls (:obj:`bool`, optional): Restricted only. :obj:`True`, if the user is
            allowed to send polls.
+
+            .. deprecated:: 13.7
+
        can_send_other_messages (:obj:`bool`, optional): Restricted only. :obj:`True`, if the user
            can send animations, games, stickers and use inline bots.
+
+            .. deprecated:: 13.7
+
        can_add_web_page_previews (:obj:`bool`, optional): Restricted only. :obj:`True`, if user
            may add web page previews to his messages.

+            .. deprecated:: 13.7
+
    Attributes:
        user (:class:`telegram.User`): Information about the user.
        status (:obj:`str`): The member's status in the chat.
        custom_title (:obj:`str`): Optional. Custom title for owner and administrators.
+
+            .. deprecated:: 13.7
+
        is_anonymous (:obj:`bool`): Optional. :obj:`True`, if the user's presence in the chat is
            hidden.
+
+            .. deprecated:: 13.7
+
        until_date (:class:`datetime.datetime`): Optional. Date when restrictions will be lifted
            for this user.
+
+            .. deprecated:: 13.7
+
        can_be_edited (:obj:`bool`): Optional. If the bot is allowed to edit administrator
            privileges of that user.
+
+            .. deprecated:: 13.7
+
        can_manage_chat (:obj:`bool`): Optional. If the administrator can access the chat event
            log, chat statistics, message statistics in channels, see channel members, see
            anonymous administrators in supergroups and ignore slow mode.

            .. versionadded:: 13.4
+            .. deprecated:: 13.7

        can_manage_voice_chats (:obj:`bool`): Optional. if the administrator can manage
            voice chats.

            .. versionadded:: 13.4
+            .. deprecated:: 13.7

        can_change_info (:obj:`bool`): Optional. If the user can change the chat title, photo and
            other settings.
+
+            .. deprecated:: 13.7
+
        can_post_messages (:obj:`bool`): Optional. If the administrator can post in the channel.
+
+            .. deprecated:: 13.7
+
        can_edit_messages (:obj:`bool`): Optional. If the administrator can edit messages of other
            users.
+
+            .. deprecated:: 13.7
+
        can_delete_messages (:obj:`bool`): Optional. If the administrator can delete messages of
            other users.
+
+            .. deprecated:: 13.7
+
        can_invite_users (:obj:`bool`): Optional. If the user can invite new users to the chat.
+
+            .. deprecated:: 13.7
+
        can_restrict_members (:obj:`bool`): Optional. If the administrator can restrict, ban or
            unban chat members.
+
+            .. deprecated:: 13.7
+
        can_pin_messages (:obj:`bool`): Optional. If the user can pin messages.
+
+            .. deprecated:: 13.7
+
        can_promote_members (:obj:`bool`): Optional. If the administrator can add new
            administrators.
+
+            .. deprecated:: 13.7
+
        is_member (:obj:`bool`): Optional. Restricted only. :obj:`True`, if the user is a member of
            the chat at the moment of the request.
+
+            .. deprecated:: 13.7
+
        can_send_messages (:obj:`bool`): Optional. If the user can send text messages, contacts,
            locations and venues.
+
+            .. deprecated:: 13.7
+
        can_send_media_messages (:obj:`bool`): Optional. If the user can send media messages,
            implies can_send_messages.
+
+            .. deprecated:: 13.7
+
        can_send_polls (:obj:`bool`): Optional. :obj:`True`, if the user is allowed to
            send polls.
+
+            .. deprecated:: 13.7
+
        can_send_other_messages (:obj:`bool`): Optional. If the user can send animations, games,
            stickers and use inline bots, implies can_send_media_messages.
+
+            .. deprecated:: 13.7
+
        can_add_web_page_previews (:obj:`bool`): Optional. If user may add web page previews to his
            messages, implies can_send_media_messages

+            .. deprecated:: 13.7
+
    """

+    __slots__ = (
+        'is_member',
+        'can_restrict_members',
+        'can_delete_messages',
+        'custom_title',
+        'can_be_edited',
+        'can_post_messages',
+        'can_send_messages',
+        'can_edit_messages',
+        'can_send_media_messages',
+        'is_anonymous',
+        'can_add_web_page_previews',
+        'can_send_other_messages',
+        'can_invite_users',
+        'can_send_polls',
+        'user',
+        'can_promote_members',
+        'status',
+        'can_change_info',
+        'can_pin_messages',
+        'can_manage_chat',
+        'can_manage_voice_chats',
+        'can_manage_video_chats',
+        'until_date',
+        '_id_attrs',
+    )
+
    ADMINISTRATOR: ClassVar[str] = constants.CHATMEMBER_ADMINISTRATOR
    """:const:`telegram.constants.CHATMEMBER_ADMINISTRATOR`"""
    CREATOR: ClassVar[str] = constants.CHATMEMBER_CREATOR
@@ -175,8 +328,18 @@ class ChatMember(TelegramObject):
        is_anonymous: bool = None,
        can_manage_chat: bool = None,
        can_manage_voice_chats: bool = None,
+        can_manage_video_chats: bool = None,
        **_kwargs: Any,
    ):
+        # check before required to not waste resources if the error is raised
+        if can_manage_voice_chats is not None and can_manage_video_chats is not None:
+            # if they are the same it's fine...
+            if can_manage_voice_chats != can_manage_video_chats:
+                raise ValueError(
+                    "Only supply one of `can_manage_video_chats`/`can_manage_voice_chats`,"
+                    " not both."
+                )
+
        # Required
        self.user = user
        self.status = status
@@ -201,13 +364,20 @@ class ChatMember(TelegramObject):
        self.can_add_web_page_previews = can_add_web_page_previews
        self.is_member = is_member
        self.can_manage_chat = can_manage_chat
-        self.can_manage_voice_chats = can_manage_voice_chats
+        temp = (
+            can_manage_video_chats
+            if can_manage_video_chats is not None
+            else can_manage_voice_chats
+        )
+        self.can_manage_voice_chats = temp
+        self.can_manage_video_chats = temp

        self._id_attrs = (self.user, self.status)

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['ChatMember']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
@@ -215,11 +385,366 @@ class ChatMember(TelegramObject):
        data['user'] = User.de_json(data.get('user'), bot)
        data['until_date'] = from_timestamp(data.get('until_date', None))

+        _class_mapping: Dict[str, Type['ChatMember']] = {
+            cls.CREATOR: ChatMemberOwner,
+            cls.ADMINISTRATOR: ChatMemberAdministrator,
+            cls.MEMBER: ChatMemberMember,
+            cls.RESTRICTED: ChatMemberRestricted,
+            cls.LEFT: ChatMemberLeft,
+            cls.KICKED: ChatMemberBanned,
+        }
+
+        if cls is ChatMember:
+            return _class_mapping.get(data['status'], cls)(**data, bot=bot)
        return cls(**data)

    def to_dict(self) -> JSONDict:
+        """See :meth:`telegram.TelegramObject.to_dict`."""
        data = super().to_dict()

        data['until_date'] = to_timestamp(self.until_date)

        return data
+
+
+class ChatMemberOwner(ChatMember):
+    """
+    Represents a chat member that owns the chat
+    and has all administrator privileges.
+
+    .. versionadded:: 13.7
+
+    Args:
+        user (:class:`telegram.User`): Information about the user.
+        custom_title (:obj:`str`, optional): Custom title for this user.
+        is_anonymous (:obj:`bool`, optional): :obj:`True`, if the
+            user's presence in the chat is hidden.
+
+    Attributes:
+        status (:obj:`str`): The member's status in the chat,
+            always :attr:`telegram.ChatMember.CREATOR`.
+        user (:class:`telegram.User`): Information about the user.
+        custom_title (:obj:`str`): Optional. Custom title for
+            this user.
+        is_anonymous (:obj:`bool`): Optional. :obj:`True`, if the user's
+            presence in the chat is hidden.
+    """
+
+    __slots__ = ()
+
+    def __init__(
+        self,
+        user: User,
+        custom_title: str = None,
+        is_anonymous: bool = None,
+        **_kwargs: Any,
+    ):
+        super().__init__(
+            status=ChatMember.CREATOR,
+            user=user,
+            custom_title=custom_title,
+            is_anonymous=is_anonymous,
+        )
+
+
+class ChatMemberAdministrator(ChatMember):
+    """
+    Represents a chat member that has some additional privileges.
+
+    .. versionadded:: 13.7
+
+    .. versionchanged:: 13.12
+        Since Bot API 6.0, voice chat was renamed to video chat.
+
+    Args:
+        user (:class:`telegram.User`): Information about the user.
+        can_be_edited (:obj:`bool`, optional): :obj:`True`, if the bot
+            is allowed to edit administrator privileges of that user.
+        custom_title (:obj:`str`, optional): Custom title for this user.
+        is_anonymous (:obj:`bool`, optional): :obj:`True`, if the  user's
+            presence in the chat is hidden.
+        can_manage_chat (:obj:`bool`, optional): :obj:`True`, if the administrator
+            can access the chat event log, chat statistics, message statistics in
+            channels, see channel members, see anonymous administrators in supergroups
+            and ignore slow mode. Implied by any other administrator privilege.
+        can_post_messages (:obj:`bool`, optional): :obj:`True`, if the
+            administrator can post in the channel, channels only.
+        can_edit_messages (:obj:`bool`, optional): :obj:`True`, if the
+            administrator can edit messages of other users and can pin
+            messages; channels only.
+        can_delete_messages (:obj:`bool`, optional): :obj:`True`, if the
+            administrator can delete messages of other users.
+        can_manage_voice_chats (:obj:`bool`, optional): :obj:`True`, if the
+            administrator can manage voice chats.
+
+            .. deprecated:: 13.12
+        can_manage_video_chats (:obj:`bool`): :obj:`True`, if the
+            administrator can manage video chats.
+
+            .. versionadded:: 13.12
+        can_restrict_members (:obj:`bool`, optional): :obj:`True`, if the
+            administrator can restrict, ban or unban chat members.
+        can_promote_members (:obj:`bool`, optional): :obj:`True`, if the administrator
+            can add new administrators with a subset of his own privileges or demote
+            administrators that he has promoted, directly or indirectly (promoted by
+            administrators that were appointed by the user).
+        can_change_info (:obj:`bool`, optional): :obj:`True`, if the user can change
+            the chat title, photo and other settings.
+        can_invite_users (:obj:`bool`, optional): :obj:`True`, if the user can invite
+            new users to the chat.
+        can_pin_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed
+            to pin messages; groups and supergroups only.
+
+    Attributes:
+        status (:obj:`str`): The member's status in the chat,
+            always :attr:`telegram.ChatMember.ADMINISTRATOR`.
+        user (:class:`telegram.User`): Information about the user.
+        can_be_edited (:obj:`bool`): Optional. :obj:`True`, if the bot
+            is allowed to edit administrator privileges of that user.
+        custom_title (:obj:`str`): Optional. Custom title for this user.
+        is_anonymous (:obj:`bool`): Optional. :obj:`True`, if the  user's
+            presence in the chat is hidden.
+        can_manage_chat (:obj:`bool`): Optional. :obj:`True`, if the administrator
+            can access the chat event log, chat statistics, message statistics in
+            channels, see channel members, see anonymous administrators in supergroups
+            and ignore slow mode. Implied by any other administrator privilege.
+        can_post_messages (:obj:`bool`): Optional. :obj:`True`, if the
+            administrator can post in the channel, channels only.
+        can_edit_messages (:obj:`bool`): Optional. :obj:`True`, if the
+            administrator can edit messages of other users and can pin
+            messages; channels only.
+        can_delete_messages (:obj:`bool`): Optional. :obj:`True`, if the
+            administrator can delete messages of other users.
+        can_manage_voice_chats (:obj:`bool`): Optional. :obj:`True`, if the
+            administrator can manage voice chats.
+
+            .. deprecated:: 13.12 contains the same value as :attr:`can_manage_video_chats`
+                for backwards compatibility.
+        can_manage_video_chats (:obj:`bool`): :obj:`True`, if the
+            administrator can manage video chats.
+
+            .. versionadded:: 13.12
+        can_restrict_members (:obj:`bool`): Optional. :obj:`True`, if the
+            administrator can restrict, ban or unban chat members.
+        can_promote_members (:obj:`bool`): Optional. :obj:`True`, if the administrator
+            can add new administrators with a subset of his own privileges or demote
+            administrators that he has promoted, directly or indirectly (promoted by
+            administrators that were appointed by the user).
+        can_change_info (:obj:`bool`): Optional. :obj:`True`, if the user can change
+            the chat title, photo and other settings.
+        can_invite_users (:obj:`bool`): Optional. :obj:`True`, if the user can invite
+            new users to the chat.
+        can_pin_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed
+            to pin messages; groups and supergroups only.
+    """
+
+    __slots__ = ()
+
+    def __init__(
+        self,
+        user: User,
+        can_be_edited: bool = None,
+        custom_title: str = None,
+        is_anonymous: bool = None,
+        can_manage_chat: bool = None,
+        can_post_messages: bool = None,
+        can_edit_messages: bool = None,
+        can_delete_messages: bool = None,
+        can_manage_voice_chats: bool = None,
+        can_restrict_members: bool = None,
+        can_promote_members: bool = None,
+        can_change_info: bool = None,
+        can_invite_users: bool = None,
+        can_pin_messages: bool = None,
+        can_manage_video_chats: bool = None,
+        **_kwargs: Any,
+    ):
+        super().__init__(
+            status=ChatMember.ADMINISTRATOR,
+            user=user,
+            can_be_edited=can_be_edited,
+            custom_title=custom_title,
+            is_anonymous=is_anonymous,
+            can_manage_chat=can_manage_chat,
+            can_post_messages=can_post_messages,
+            can_edit_messages=can_edit_messages,
+            can_delete_messages=can_delete_messages,
+            can_manage_voice_chats=can_manage_voice_chats,
+            can_restrict_members=can_restrict_members,
+            can_promote_members=can_promote_members,
+            can_change_info=can_change_info,
+            can_invite_users=can_invite_users,
+            can_pin_messages=can_pin_messages,
+            can_manage_video_chats=can_manage_video_chats,
+        )
+
+
+class ChatMemberMember(ChatMember):
+    """
+    Represents a chat member that has no additional
+    privileges or restrictions.
+
+    .. versionadded:: 13.7
+
+    Args:
+        user (:class:`telegram.User`): Information about the user.
+
+    Attributes:
+        status (:obj:`str`): The member's status in the chat,
+            always :attr:`telegram.ChatMember.MEMBER`.
+        user (:class:`telegram.User`): Information about the user.
+
+    """
+
+    __slots__ = ()
+
+    def __init__(self, user: User, **_kwargs: Any):
+        super().__init__(status=ChatMember.MEMBER, user=user)
+
+
+class ChatMemberRestricted(ChatMember):
+    """
+    Represents a chat member that is under certain restrictions
+    in the chat. Supergroups only.
+
+    .. versionadded:: 13.7
+
+    Args:
+        user (:class:`telegram.User`): Information about the user.
+        is_member (:obj:`bool`, optional): :obj:`True`, if the user is a
+            member of the chat at the moment of the request.
+        can_change_info (:obj:`bool`, optional): :obj:`True`, if the user can change
+            the chat title, photo and other settings.
+        can_invite_users (:obj:`bool`, optional): :obj:`True`, if the user can invite
+            new users to the chat.
+        can_pin_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed
+            to pin messages; groups and supergroups only.
+        can_send_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed
+            to send text messages, contacts, locations and venues.
+        can_send_media_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed
+            to send audios, documents, photos, videos, video notes and voice notes.
+        can_send_polls (:obj:`bool`, optional): :obj:`True`, if the user is allowed
+            to send polls.
+        can_send_other_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed
+            to send animations, games, stickers and use inline bots.
+        can_add_web_page_previews (:obj:`bool`, optional): :obj:`True`, if the user is
+           allowed to add web page previews to their messages.
+        until_date (:class:`datetime.datetime`, optional): Date when restrictions
+           will be lifted for this user.
+
+    Attributes:
+        status (:obj:`str`): The member's status in the chat,
+            always :attr:`telegram.ChatMember.RESTRICTED`.
+        user (:class:`telegram.User`): Information about the user.
+        is_member (:obj:`bool`): Optional. :obj:`True`, if the user is a
+            member of the chat at the moment of the request.
+        can_change_info (:obj:`bool`): Optional. :obj:`True`, if the user can change
+            the chat title, photo and other settings.
+        can_invite_users (:obj:`bool`): Optional. :obj:`True`, if the user can invite
+            new users to the chat.
+        can_pin_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed
+            to pin messages; groups and supergroups only.
+        can_send_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed
+            to send text messages, contacts, locations and venues.
+        can_send_media_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed
+            to send audios, documents, photos, videos, video notes and voice notes.
+        can_send_polls (:obj:`bool`): Optional. :obj:`True`, if the user is allowed
+            to send polls.
+        can_send_other_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed
+            to send animations, games, stickers and use inline bots.
+        can_add_web_page_previews (:obj:`bool`): Optional. :obj:`True`, if the user is
+           allowed to add web page previews to their messages.
+        until_date (:class:`datetime.datetime`): Optional. Date when restrictions
+           will be lifted for this user.
+
+    """
+
+    __slots__ = ()
+
+    def __init__(
+        self,
+        user: User,
+        is_member: bool = None,
+        can_change_info: bool = None,
+        can_invite_users: bool = None,
+        can_pin_messages: bool = None,
+        can_send_messages: bool = None,
+        can_send_media_messages: bool = None,
+        can_send_polls: bool = None,
+        can_send_other_messages: bool = None,
+        can_add_web_page_previews: bool = None,
+        until_date: datetime.datetime = None,
+        **_kwargs: Any,
+    ):
+        super().__init__(
+            status=ChatMember.RESTRICTED,
+            user=user,
+            is_member=is_member,
+            can_change_info=can_change_info,
+            can_invite_users=can_invite_users,
+            can_pin_messages=can_pin_messages,
+            can_send_messages=can_send_messages,
+            can_send_media_messages=can_send_media_messages,
+            can_send_polls=can_send_polls,
+            can_send_other_messages=can_send_other_messages,
+            can_add_web_page_previews=can_add_web_page_previews,
+            until_date=until_date,
+        )
+
+
+class ChatMemberLeft(ChatMember):
+    """
+    Represents a chat member that isn't currently a member of the chat,
+    but may join it themselves.
+
+    .. versionadded:: 13.7
+
+    Args:
+        user (:class:`telegram.User`): Information about the user.
+
+    Attributes:
+        status (:obj:`str`): The member's status in the chat,
+            always :attr:`telegram.ChatMember.LEFT`.
+        user (:class:`telegram.User`): Information about the user.
+    """
+
+    __slots__ = ()
+
+    def __init__(self, user: User, **_kwargs: Any):
+        super().__init__(status=ChatMember.LEFT, user=user)
+
+
+class ChatMemberBanned(ChatMember):
+    """
+    Represents a chat member that was banned in the chat and
+    can't return to the chat or view chat messages.
+
+    .. versionadded:: 13.7
+
+    Args:
+        user (:class:`telegram.User`): Information about the user.
+        until_date (:class:`datetime.datetime`, optional): Date when restrictions
+           will be lifted for this user.
+
+    Attributes:
+        status (:obj:`str`): The member's status in the chat,
+            always :attr:`telegram.ChatMember.KICKED`.
+        user (:class:`telegram.User`): Information about the user.
+        until_date (:class:`datetime.datetime`): Optional. Date when restrictions
+           will be lifted for this user.
+
+    """
+
+    __slots__ = ()
+
+    def __init__(
+        self,
+        user: User,
+        until_date: datetime.datetime = None,
+        **_kwargs: Any,
+    ):
+        super().__init__(
+            status=ChatMember.KICKED,
+            user=user,
+            until_date=until_date,
+        )
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -62,6 +62,16 @@ class ChatMemberUpdated(TelegramObject):

    """

+    __slots__ = (
+        'chat',
+        'from_user',
+        'date',
+        'old_chat_member',
+        'new_chat_member',
+        'invite_link',
+        '_id_attrs',
+    )
+
    def __init__(
        self,
        chat: Chat,
@@ -92,7 +102,8 @@ class ChatMemberUpdated(TelegramObject):

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['ChatMemberUpdated']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
@@ -107,6 +118,7 @@ class ChatMemberUpdated(TelegramObject):
        return cls(**data)

    def to_dict(self) -> JSONDict:
+        """See :meth:`telegram.TelegramObject.to_dict`."""
        data = super().to_dict()

        # Required
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -78,6 +78,18 @@ class ChatPermissions(TelegramObject):

    """

+    __slots__ = (
+        'can_send_other_messages',
+        'can_invite_users',
+        'can_send_polls',
+        '_id_attrs',
+        'can_send_messages',
+        'can_send_media_messages',
+        'can_change_info',
+        'can_pin_messages',
+        'can_add_web_page_previews',
+    )
+
    def __init__(
        self,
        can_send_messages: bool = None,
@@ -2,7 +2,7 @@
 # pylint: disable=R0902,R0913
 #
 # A library that provides a Python interface to the Telegram Bot API
-# Copyright (C) 2015-2021
+# Copyright (C) 2015-2022
 # Leandro Toledo de Souza <devs@python-telegram-bot.org>
 #
 # This program is free software: you can redistribute it and/or modify
@@ -61,6 +61,8 @@ class ChosenInlineResult(TelegramObject):

    """

+    __slots__ = ('location', 'result_id', 'from_user', 'inline_message_id', '_id_attrs', 'query')
+
    def __init__(
        self,
        result_id: str,
@@ -82,7 +84,8 @@ class ChosenInlineResult(TelegramObject):

    @classmethod
    def de_json(cls, data: Optional[JSONDict], bot: 'Bot') -> Optional['ChosenInlineResult']:
-        data = cls.parse_data(data)
+        """See :meth:`telegram.TelegramObject.de_json`."""
+        data = cls._parse_data(data)

        if not data:
            return None
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Hinrich Mahler	a769861b32	Bump version to v13.11	2022-05-26 15:15:40 +02:00
Bibo-Joshi	0a00a821cb	Documentation Improvements (#3029 ) Co-authored-by: Hinrich Mahler <22366557+Bibo-Joshi@users.noreply.github.com> Co-authored-by: Sukka <isukkaw@gmail.com>	2022-05-26 11:10:45 +02:00
Poolitzer	ef2a0527fe	API 6.0 (#3027 ) Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com>	2022-05-25 17:40:01 +02:00
Hinrich Mahler	92cb6f3ae8	Bump version to v13.11	2022-02-02 21:16:36 +01:00
Harshil	a35ecf4065	API 5.7 (#2881 )	2022-02-02 21:05:46 +01:00
Hinrich Mahler	ade1529986	Bump version to v13.10	2022-01-03 08:36:27 +01:00
Harshil	e6d9f3d057	Update Copyright to 2022 (#2836 )	2022-01-03 08:15:18 +01:00
Harshil	98bf378c6e	API 5.6 (#2835 )	2022-01-03 08:13:33 +01:00
Poolitzer	c4b413ef9e	Update Documentation of BotCommand (#2820 )	2021-12-17 16:12:34 +01:00
Hinrich Mahler	a9dd2b1746	Bump version to v13.9	2021-12-11 15:44:21 +01:00
Bibo-Joshi	cb95868c4a	Api 5.5 (#2809 ) Co-authored-by: poolitzer <github@poolitzer.eu> Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com>	2021-12-11 15:21:56 +01:00
Bibo-Joshi	2f6c4075c8	Adjust Automated Locking of Inactive Closed Threads (#2775 )	2021-11-10 21:16:59 +01:00
Hinrich Mahler	c53dc7dae4	Bump version to v13.8.1	2021-11-08 20:09:23 +01:00
Bibo-Joshi	8b3ea5ce56	Add ChatJoinRequest(Handler) to Docs (#2771 )	2021-11-08 19:56:57 +01:00
Hinrich Mahler	51a4a6664c	Bump version to v13.8	2021-11-08 19:12:10 +01:00
Bibo-Joshi	e4dc80f41d	API 5.4 (#2767 ) Co-authored-by: poolitzer <25934244+Poolitzer@users.noreply.github.com>	2021-11-08 19:02:20 +01:00
Abshar Mohammed Aslam	bc7c422a11	Create Issue Template Forms (#2689 )	2021-10-03 20:08:04 +02:00
Yan	c3e3bb77e5	Fix camelCase Functions in ExtBot (#2659 ) Co-authored-by: Bibo-Joshi <22366557+Bibo-Joshi@users.noreply.github.com>	2021-09-15 17:07:11 +02:00
DonalDuck004	a25c76e6a3	Fix Empty Captions not Being Passed by Bot.copy_message (#2651 )	2021-09-09 07:50:04 +02:00
Mehdi	0c5085022c	Fix Setting Thumbs When Uploading A Single File (#2583 ) * Update request.py If the media has a thumb, we also need to attach it to the data. * Add test * Editing syntax * Debug test * update request.py * Update test_inputmedia.py * Update test_inputmedia.py * Update test_inputmedia.py Fix test. * Update AUTHORS.rst Adding my name! * Update AUTHORS.rst	2021-08-11 08:34:47 +02:00
Bibo-Joshi	1fdaaac809	Fix Bug in BasePersistence.insert/replace_bot for Objects with __dict__ not in __slots__ (#2603 ) * More special cases with slots * Fix failing tests	2021-07-24 17:17:25 +02:00
Hinrich Mahler	bcec6f03cb	Bump version to v13.7	2021-07-01 18:03:38 +02:00
Bibo-Joshi	ed147813ab	API 5.3 (#2572 ) * BotCommandScopes * pre-commit * typo Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com> * rename kickChatMember & getChatMembersCount method Signed-off-by: starry69 <starry369126@outlook.com> * add `language_code` and `scope` to `get/set_my_commands` and add `delete_my_commands()` * add `input_field_placeholder` to replykeyboardmarkup.py and forcereply.py also improved/fixed docs along the way * showcase `input_field_placeholder` in conversationbot.py * review 1 'i will not go away' has gone away 😢 * deprecate `Bot.commands` and make sure its only used for default scope * review 2 (use constants for scope) * Review Signed-off-by: starry69 <starry369126@outlook.com> * doc updates * New ChatMember classes Signed-off-by: starry69 <starry369126@outlook.com> * Address review Signed-off-by: starry69 <starry369126@outlook.com> * add versionadded tags again Signed-off-by: starry69 <starry369126@outlook.com> * Improve tests & add a deprecation note to ChatMember * test_official * Documentation tweaks * Bump bot api version number * but bot * Rename chat shortcuts Signed-off-by: starry69 <starry369126@outlook.com> * deepsource Signed-off-by: starry69 <starry369126@outlook.com> * add missing slot in botcommandscope & missing slot tests Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com> Co-authored-by: starry69 <starry369126@outlook.com> Co-authored-by: Harshil <ilovebhagwan@gmail.com>	2021-07-01 17:45:19 +02:00
Bibo-Joshi	4315225642	Type Hinting Fixes (#2552 ) * Fixe overload signatures for ContextTypes * more fixing for contexttypes	2021-07-01 17:43:59 +02:00
Bibo-Joshi	a75dffd4a8	Doc Fixes (#2551 ) * Document ExtBot.insert_callbakc_data * fix duplicate object descriptions Fixed by removing `:undoc-members:` in the affected classes. Closes https://github.com/sphinx-doc/sphinx/issues/9294 * fix incorrect shortcut docstrings in user.py * fix object type in forcereply.py * fix discuss bot link in loginurl.py * document that message is None for (my)_chat_member in `effective_message` * numerous persistence rendering fixes * move docstring from property setter to property * Revert "fix object type in forcereply.py" This reverts commit `012663e0c3`. * Document comparison of jobs * Update min python version to 3.6.8 * remove old note from chat.py + some return msg fixes * fix colon placement Co-authored-by: Harshil <ilovebhagwan@gmail.com> Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com>	2021-07-01 17:34:23 +02:00
Harshil	fce2993d21	Improve Deprecation Warning for __slots__ (#2574 ) * add stacklevel to `set_new_attribute_deprecated` * detail warning message and change stacklevel	2021-06-29 18:10:08 +02:00
Harshil	9aec8deec6	Stabilize CI (#2575 ) * attempt 'surely this one' on fixing test_idle and test_depr_warnings * remove unused filterwarnings	2021-06-26 22:19:59 +02:00
Bibo-Joshi	ec3026673b	Fix Coverage Configuration (#2571 ) * remove possibly malicious line from config * exclude overload signatures from coverage	2021-06-25 09:02:46 +02:00
zeroone2numeral2	105f1ccdb5	Better Exception-Handling for BasePersistence.replace/insert_bot (#2564 ) * Catch exceptions raised while copying __dict__/__slots__ in BasePersistence.replace/insert_bot() Also updated the docstrings to reflect the changes in behavior with unexpected errors * Tests: added to CustomClass immutable object that would trigger a setattr() exception * Tests: added new uuid_ property to own CustomClass methods * Updated AUTHORS.rst * Revert "Tests: added new uuid_ property to own CustomClass methods" This reverts commit `9e67463cf7`. * Revert "Tests: added to CustomClass immutable object that would trigger a setattr() exception" This reverts commit `1c258304` * Removed unneeded Exception cast to string f-string will perform the string-ification on their own * Removed another unneeded Exception cast to string * Added test to parse unparsable objects in __dict__ or __slots__ * Applied black and pylint style suggestions All lint tests passed * Fix typo Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com> Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com>	2021-06-20 22:14:05 +02:00
Bibo-Joshi	52ce03929b	Fix Bug in BasePersistence.insert/replace_bot for Objects with __dict__ in their slots (#2561 ) * Handle objects with __dict__ in __slots__ * Rework	2021-06-13 15:07:40 +02:00
Bibo-Joshi	ac4768155f	Remove Incorrect Warning About Defaults and ExtBot (#2553 ) * Don't throw warning when passing defaults to ExtBot * Review	2021-06-10 12:03:44 +02:00
Harshil	d08172b4b0	Remove Deprecated pass_args from Deeplinking Example (#2550 )	2021-06-07 09:05:17 +02:00
Hinrich Mahler	e982a5a567	Bump version to v13.6	2021-06-06 12:28:01 +02:00
Bibo-Joshi	cf4d3cae01	Doc Fixes (#2495 ) Co-authored-by: Poolitzer <25934244+Poolitzer@users.noreply.github.com> Co-authored-by: Bas ten Berge <bas+github@tenberge-ict.nl> Co-authored-by: Harshil <ilovebhagwan@gmail.com>	2021-06-06 12:16:23 +02:00
Bibo-Joshi	8531a7a40c	Arbitrary callback_data (#1844 )	2021-06-06 11:48:48 +02:00
Bibo-Joshi	fce7cc903c	Add ContextTypes & BasePersistence.refresh_user/chat/bot_data (#2262 )	2021-06-06 10:37:53 +02:00
GauthamramRavichandran	5da1dd7ce9	Add max_connections Parameter to Updater.start_webhook (#2547 ) * Include max_connections args * Update docs & add test Co-authored-by: Hinrich Mahler <hinrich.mahler@freenet.de>	2021-06-06 09:27:45 +02:00
Stɑrry Shivɑm	46cdeb495a	Fix for Promise.done_callback (#2544 ) * Don't call done_cb on exceptions Signed-off-by: starry69 <starry369126@outlook.com> * improve docs Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> * revert black Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de>	2021-06-05 17:08:45 +02:00
Bibo-Joshi	653691fafb	Improve Slot Tests (#2541 )	2021-05-30 20:30:26 +02:00
Harshil	92ff6a8e2b	Add __slots__ (#2345 ) Co-authored-by: deepsource-autofix[bot] <62050782+deepsource-autofix[bot]@users.noreply.github.com> Co-authored-by: Hinrich Mahler <hinrich.mahler@freenet.de>	2021-05-29 16:18:16 +02:00
Bibo-Joshi	cc43aef64b	Fix Test Failing Due To Telegram Updates (#2537 ) * Update TestPhoto * try to fix test_idle again... * fix test_send_game due to photo size changes... Co-authored-by: Harshil <ilovebhagwan@gmail.com>	2021-05-28 22:24:43 +02:00
Bibo-Joshi	e2c6d60721	Improve Code Quality (#2536 ) * Start fixing stuff * More docstrings * stabilize test_idle Co-authored-by: Harshil <ilovebhagwan@gmail.com>	2021-05-27 20:34:58 +02:00
Bibo-Joshi	8bf88c3231	Supplement Codacy with DeepSource (#2454 ) * Add deepsource config * Update Badges * Update Badges some more * Stupid change to trigger analysis of all files * Try to get ignore right * Update badges again * Get started on fixing issues * Fix some more issues * Remove more plank lines * Docs for de_json/list & to_dict/json * Some improvements from deepcode.ai * Some more improvements * Some more improvements * More docstrnigs & let's run DS on the tests just for fun * Autofix issues in 10 files Resolved issues in the following files via DeepSource Autofix: 1. tests/conftest.py 2. tests/test_bot.py 3. tests/test_commandhandler.py 4. tests/test_conversationhandler.py 5. tests/test_dispatcher.py 6. tests/test_filters.py 7. tests/test_inputmedia.py 8. tests/test_messagehandler.py 9. tests/test_official.py 10. tests/test_persistence.py * Some more improvements for tests, but that shall be enough * Some more docstrings for functions * Some minor stuff, try to fix tests * Update DS config * Still more docs * Doc fixes * More fixes * Fix: indent docstring * Some fixes * Revert "Stupid change to trigger analysis of all files" This reverts commit `dd46c260` * Review Co-authored-by: deepsource-autofix[bot] <62050782+deepsource-autofix[bot]@users.noreply.github.com> Co-authored-by: Poolitzer <25934244+Poolitzer@users.noreply.github.com>	2021-05-27 09:38:17 +02:00
Poolitzer	1572c61063	Increase Test Coverage of CallbackQueryHandler (#2520 ) * Test: let's see * Test: let's see, now in the correct place * Fix: Explicitly return None in else clause also documented this behaviour clearly in the docstring * add link in doc Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> * Fix: remove unnecessary else statement Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de>	2021-05-27 09:37:37 +02:00
Harshil	5ff3b76e18	Stabilize CI (#2522 ) * asking the test what is wrong with them * fix botscore_not_modified tests for good * xfail game tests due to race conditions * address review (add a comment) * fix xfail marker * address review * simplify expression	2021-05-19 13:33:41 +02:00
Poolitzer	cd69f69b28	Add Filters.attachment (#2528 ) * feat: attachment filter * fix: add versionadded statement * Fix: small doc string changes Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de>	2021-05-19 10:39:10 +02:00
Poolitzer	8b0d2e5f75	Add pattern Argument to ChosenInlineResultHandler (#2517 ) * Feat: add pattern arg to ChosenInlineResultHandler * Fix: remove unnecessary if clause the attribute must be present, since it's not optional. * Fix: wrong type documentation Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> * Fix: Addressing code review small documentation fixes, and moving one test. * Fix: link to matches Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de> * Fix: also link here Co-authored-by: Bibo-Joshi <hinrich.mahler@freenet.de>	2021-05-19 10:32:11 +02:00
Nikolai Krivenko	7d0fb85c8c	Fix send_phone_number_to_provider argument for Bot.send_invoice (#2527 ) * [#2526] set data['send_phone_number_to_provider'] from corresponding variable * [#2526] Add myself to AUTHORS.rst * Add unit test Co-authored-by: Hinrich Mahler <hinrich.mahler@freenet.de>	2021-05-16 20:56:28 +02:00
Bibo-Joshi	08ba7c7793	Handle Classes as Input for BasePersistence.replace/insert_bot (#2523 ) * Ignore classes on replace/insert_bot * Review	2021-05-16 20:02:35 +02:00
Bibo-Joshi	9737b1d3c7	Bump Tornado Version and Remove Workaround from #2067 (#2494 )	2021-05-05 20:59:06 +02:00