v20.0a2

Version 20.0a2

Released 2022-06-27

This is the technical changelog for version 20.0a2. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Major Changes

• Full Support for API 6.1 (#3112)

New Features

• Add Additional Shortcut Methods to Chat (#3115)
• Mermaid-based Example State Diagrams (#3090)

Minor Changes, Documentation Improvements and CI

• Documentation Improvements (#3103, #3121, #3098)
• Stabilize CI (#3119)
• Bump pyupgrade from 2.32.1 to 2.34.0 (#3096)
• Bump furo from 2022.6.4 to 2022.6.4.1 (#3095)
• Bump mypy from 0.960 to 0.961 (#3093)

v20.0a1

Version 20.0a1

Released 2022-06-09

This is the technical changelog for version 20.0a1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Major Changes:

• Drop Support for ujson and instead BaseRequest.parse_json_payload (#3037, #3072)
• Drop InputFile.is_image (#3053)
• Drop Explicit Type conversions in __init__ s (#3056)
• Handle List-Valued Attributes More Consistently (#3057)
• Split {Command, Prefix}Handler And Make Attributes Immutable (#3045)
• Align Behavior Of JobQueue.run_daily With cron (#3046)
• Make PTB Specific Keyword-Only Arguments for PTB Specific in Bot methods (#3035)
• Adjust Equality Comparisons to Fit Bot API 6.0 (#3033)
• Add Tuple Based Version Info (#3030)- Improve Type Annotations for CallbackContext and Move Default Type Alias to ContextTypes.DEFAULT_TYPE (#3017, #3023)
• Rename Job.context to Job.data (#3028)
• Rename Handler to BaseHandler (#3019)

New Features:

• Add Application.post_init (#3078)
• Add Arguments chat/user_idtoCallbackContext` And Example On Custom Webhook Setups (#3059)
• Add Convenience Property Message.id (#3077)
• Add Example for WebApp (#3052)
• Rename telegram.bot_api_version to telegram.__bot_api_version__ (#3030)

Bug Fixes:

• Fix Non-Blocking Entry Point in ConversationHandler (#3068)
• Escape Backslashes in escape_markdown (#3055)

Dependencies:

• Update httpx requirement from ~=0.22.0 to ~=0.23.0 (#3069)
• Update cachetools requirement from ~=5.0.0 to ~=5.2.0 (#3058, #3080)

Minor Changes, Documentation Improvements and CI:

• Move Examples To Documentation (#3089)
• Documentation Improvements and Update Dependencies (#3010, #3007, #3012, #3067, #3081, #3082)
• Improve Some Unit Tests (#3026)
• Update Code Quality dependencies (#3070, #3032,#2998, #2999)
• Don't Set Signal Handlers On Windows By Default (#3065)
• Split {Command, Prefix}Handler And Make Attributes Immutable (#3045)
• Apply isort and Update pre-commit.ci Configuration (#3049)
• Adjust pre-commit Settings for isort (#3043)
• Add Version Check to Examples (#3036)
• Use Collection Instead of List and Tuple (#3025)
• Remove Client-Side Parameter Validation (#3024)
• Don't Pass Default Values of Optional Parameters to Telegram (#2978)
• Stabilize Application.run_* on Python 3.7 (#3009)
• Ignore Code Style Commits in git blame (#3003)
• Adjust Tests to Changed API Behavior (#3002)

v13.12

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.

Major Changes:

• Full Support for API 6.0 (#3027)

Minor Changes:

• Documentation Improvements (#3029)

v20.0a0

Version 20.0a0

Released 2022-05-06

This is the technical changelog for version 20.0a0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Major Changes:

• Refactor Initialization of Persistence Classes (#2604)
• Drop Non-CallbackContext API (#2617)
• Remove __dict__ from __slots__ and drop Python 3.6 (#2619, #2636)
• Move and Rename TelegramDecryptionError to telegram.error.PassportDecryptionError (#2621)
• Make BasePersistence Methods Abstract (#2624)
• Remove day_is_strict argument of JobQueue.run_monthly (#2634 by @iota-008)
• Move Defaults to telegram.ext (#2648)
• Remove Deprecated Functionality (#2644, #2740, #2745)
• Overhaul of Filters (#2759, #2922)
• Switch to asyncio and Refactor PTBs Architecture (#2731)
• Improve Job.__getattr__ (#2832)
• Remove telegram.ReplyMarkup (#2870)
• Persistence of Bots: Refactor Automatic Replacement and Integration with TelegramObject (#2893)

New Features:

• Introduce Builder Pattern (#2646)
• Add Filters.update.edited (#2705 by @PhilippFr)
• Introduce Enums for telegram.constants (#2708)
• Accept File Paths for private_key (#2724)
• Associate Jobs with chat/user_id (#2731)
• Convenience Functionality for ChatInviteLinks (#2782)
• Add Dispatcher.add_handlers (#2823)
• Improve Error Messages in CommandHandler.__init__ (#2837)
• Defaults.protect_content (#2840)
• Add Dispatcher.migrate_chat_data (#2848 by @DonalDuck004)
• Add Method drop_chat/user_data to Dispatcher and Persistence (#2852)
• Add methods ChatPermissions.{all, no}_permissions (#2948)
• Full Support for API 6.0 (#2956)
• Add Python 3.10 to Test Suite (#2968)

Bug Fixes & Minor Changes:

• Improve Type Hinting for CallbackContext (#2587 by @revolter)
• Fix Signatures and Improve test_official (#2643)
• Refine Dispatcher.dispatch_error (#2660)
• Make InlineQuery.answer Raise ValueError (#2675)
• Improve Signature Inspection for Bot Methods (#2686)
• Introduce TelegramObject.set/get_bot (#2712 by @zpavloudis)
• Improve Subscription of TelegramObject (#2719 by @SimonDamberg)
• Use Enums for Dynamic Types & Rename Two Attributes in ChatMember (#2817)
• Return Plain Dicts from BasePersistence.get_*_data (#2873)
• Fix a Bug in ChatMemberUpdated.difference (#2947)
• Update Dependency Policy (#2958)

Internal Restructurings & Improvements:

• Add User Friendly Type Check For Init Of {Inline, Reply}KeyboardMarkup (#2657)
• Warnings Overhaul (#2662)
• Clear Up Import Policy (#2671)
• Mark Internal Modules As Private (#2687 by @kencx)
• Handle Filepaths via the pathlib Module (#2688 by @eldbud)
• Refactor MRO of InputMedia* and Some File-Like Classes (#2717 by @eldbud)
• Update Exceptions for Immutable Attributes (#2749)
• Refactor Warnings in ConversationHandler (#2755, #2784)
• Use __all__ Consistently (#2805)

CI, Code Quality & Test Suite Improvements:

• Add Custom pytest Marker to Ease Development (#2628)
• Pass Failing Jobs to Error Handlers (#2692)
• Update Notification Workflows (#2695)
• Use Error Messages for pylint Instead of Codes (#2700 by @Piraty)
• Make Tests Agnostic of the CWD (#2727 by @eldbud)
• Update Code Quality Dependencies (#2748)
• Improve Code Quality (#2783)
• Update pre-commit Settings & Improve a Test (#2796)
• Improve Code Quality & Test Suite (#2843)
• Fix failing animation tests (#2865)
• Update and Expand Tests & pre-commit Settings and Improve Code Quality (#2925)
• Extend Code Formatting With Black (#2972)
• Update Workflow Permissions (#2984)
• Adapt Tests to Changed Bot.get_file Behavior (#2995)

Documentation Improvements:

• Doc Fixes (#2597)
• Add Code Comment Guidelines to Contribution Guide (#2612)
• Add Cross-References to External Libraries & Other Documentation Improvements (#2693, #2691 by @joesinghh, #2739 by @eldbud)
• Use Furo Theme, Make Parameters Referenceable, Add Documentation Building to CI, Improve Links to Source Code & Other Improvements (#2856, #2798, #2854, #2841)
• Documentation Fixes & Improvements (#2822)
• Replace git.io Links (#2872 by @murugu-21)
• Overhaul Readmes, Update RTD Startpage & Other Improvements (#2969)

v13.11

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.

Major Changes:

• Full Support for Bot API 5.7 (#2881)

v13.10

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.

Major Changes:

• Full Support for API 5.6 (#2835)

Minor Changes & Doc fixes:

• Update Copyright to 2022 (#2836)
• Update Documentation of BotCommand (#2820)

v13.9

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.

Major Changes:

• Full Support for Api 5.5 (#2809)

Minor Changes

• Adjust Automated Locking of Inactive Issues (#2775)

v13.8.1

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.

Doc fixes:

• Add ChatJoinRequest(Handler) to Docs (#2771)

v13.8

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.

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)

v13.7

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.

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)