CHANGELOG.md

amanobot changelog

2.1.0 (2021-04-22)

• Bot API 5.1
• See all bot API changes in https://core.telegram.org/bots/api#recent-changes.

2.0.1 (2020-12-30)

• Fixed a bug in download_file that prevented it from working

2.0.0 (2020-11-06)

• Bot API 5.0 additions (Some things may be missing or broken, please report)
• Added the api_endpoint parameter to the Bot class to allow setting custom API endpoint
• Initial typing hint support, not yet complete
• Bump aiohttp to 3.7.2 and urllib3 to 1.25.11
• Dropped Python support below 3.5.3 and their compatibility hacks

1.8.1 (2020-04-26)

• Hotfix for a bug that prevented amanobot from working

1.8.0 (2020-04-26)

• Bot API 4.8
• Supported explanations for Quizzes 2.0. Add explanations by specifying the parameters explanation and explanation_parse_mode in the method sendPoll
• Supported the new darts animation for the dice mini-game. Choose between the default dice animation and darts animation by specifying the parameter emoji in the method sendDice
• Added the fields explanation and explanation_entities to the Poll object
• Supported timed polls that automatically close at a certain date and time. Set up by specifying the parameter open_period or close_date in the method sendPoll
• Added the fields open_period and close_date to the Poll object
• Added the missing is_anonymous field to the Poll object

1.7.1 (2020-04-06)

• Updated setup.py to include a Python version check
• Added a deprecation warning for users in Python 2 and <=3.4
• This update has no visible improvments. You can ignore this update if you want

1.7.0 (2020-03-30)

• Bot API 4.7
• Added the method sendDice for sending a dice message, which will have a random value from 1 to 6
• Added the field dice to the Message object
• Added the method getMyCommands for getting the current list of the bot's commands
• Added the method setMyCommands for changing the list of the bot's commands through the Bot API instead of @BotFather
• Added the ability to create animated sticker sets by specifying the parameter tgs_sticker instead of png_sticker in the method createNewStickerSet
• Added the ability to add animated stickers to sets created by the bot by specifying the parameter tgs_sticker instead of png_sticker in the method addStickerToSet
• Added the field thumb to the StickerSet object
• Added the ability to change thumbnails of sticker sets created by the bot using the method setStickerSetThumb

1.6.0 (2020-01-23)

• Bot API 4.6
• Added the ability to send non-anonymous, multiple answer, and quiz-style polls: added the parameters is_anonymous, type, allows_multiple_answers, correct_option_id, is_closed options to the method sendPoll
• Added the object KeyboardButtonPollType and the field request_poll to the object KeyboardButton
• Added the field poll_answer in the Update object
• Added the fields total_voter_count, is_anonymous, type, allows_multiple_answers, correct_option_id to the Poll object
• Bots can now send polls to private chats
• Added the fields can_join_groups, can_read_all_group_messages and supports_inline_queries to the User object
• Added the optional field language to the MessageEntity object

1.5.0 (2019-12-31)

• Bot API 4.5
• Added the setChatAdministratorCustomTitle method
• Added the file_unique_id field to the objects Animation, Audio, Document, PassportFile, PhotoSize, Sticker, Video, VideoNote, Voice and File
• Added the small_file_unique_id and big_file_unique_id fields to the object ChatPhoto
• Added the slow_mode_delay field to the Chat object
• Added the custom_title field to the ChatMember object
• Note: If you want to use the new entity fields (such as underlined and strikethrough text) in markdown, you need to pass MarkdownV2 to the parse_mode parameter

1.4.5 (2019-12-04)

• Add the raise_errors to the Bot class
• Require at least Python 3.5.3 for the asyncio variant (Fixes installation on Python 3.5.2)

1.4.4 (2019-11-13)

• Hotfix for asyncio version failing to start

1.4.3 (2019-11-13) - Removed

• Added support for the thumb parameter in media Senders (sendAudio, sendDocument, etc)
• Added support for media editing using the editMessageMedia method

1.4.2 (2019-11-13)

• Allow raising KeyboardInterrupt on run_forever() (aka blocking loop)

1.4.1 (2019-11-05)

• Add missing permissions to restrictChatMember on the asyncio variant.

1.4.0 (2019-07-29)

• Bot API 4.4
• Added the setChatDescription method.
• Added the fields can_send_polls, can_change_info, can_invite_users, can_pin_messages and permissions to the restrictChatMember method.
• Added the ChatPermissions object.
• Removed the all_members_are_administrators field from the Chat object.
• Added the permissions field tp the Chat object
• Added the is_animated field to the Sticker and StickerSet objects

1.3.0 (2019-06-01)

• Bot API 4.3
• Added missing Passport related methods and objects
• Added the LoginUrl object
• Added the login_url field to the InlineKeyboardButton object

1.2.0 (2019-04-14)

• Bot API 4.2
• Added the sendPoll method
• Added the stopPoll method
• Added the field forward_sender_name and poll to the Message object
• Added the field poll to the Update object
• Added the field is_member to the ChatMember object

1.1.2 (2018-11-04)

• Re-added thumb to sendAudio method
• Some improvments to the code

1.1.0 (2018-09-30)

• Bot API 4.1 (complete)
• Fix InputMediaAnimation
• Add types InputMediaAudio and InputMediaDocument
• Added vcard to the objects Contact, InlineQueryResultContact, InputContactMessageContent and the method sendContact

1.0 (2018-09-20)

• Bot API 4.1 (partial)
• Added method editMessageMedia and sendAnimation
• Added thumb to sendAudio, sendDocument, sendVideo and sendVideoNote methods
• Added foursquare_type to sendVenue method and to objects Venue, InlineQueryResultVenue and InputVenueMessageContent

telepot changelog

12.7 (2018-05-27)

• Await aiohttp.ClientSession.close()
• Upgraded dependency aiohttp>=3.0.0

12.6 (2018-02-24)

• Bot API 3.6
• Added parse_mode to all methods and namedtuples supporting caption
• Added supports_streaming and connected_website to relevant methods and namedtuples
• Fixed downloading through proxy in telepot.aio.api module

12.5 (2017-11-28)

• Bot API 3.5
• Added method sendMediaGroup and namedtuple InputMediaPhoto and InputMediaVideo
• Added parameter provider_data to method sendInvoice
• Better exception handling in telepot.aio.api module

12.4 (2017-10-19)

• Bot API 3.4
• Live location:
  • Added live_period to method sendLocation, and namedtuple InlineQueryResultLocation and InputLocationMessageContent
  • Added method editMessageLiveLocation and stopMessageLiveLocation
• Added method setChatStickerSet and deleteChatStickerSet
• Added sticker_set_name and can_set_sticker_set to namedtuple Chat
• Added caption_entities to namedtuple Message
• Added method editMessageLiveLocation and stopMessageLiveLocation to class Editor
• Added method setChatStickerSet and deleteChatStickerSet to class Administrator
• Allowed supplying initial offset to MessageLoop
• Allowed Bot API access through proxy

12.3 (2017-08-28)

• Bot API 3.3
• Added new fields to namedtuple Chat, Message, and User
• Included aiohttp.ClientResponseError in raising BadHTTPResponse
• Added package telepot.text to help format Markdown and HTML by applying entities

12.2 (2017-08-01)

• Bot API 3.2
• Added methods:
  • getStickerSet()
  • uploadStickerFile()
  • createNewStickerSet()
  • addStickerToSet()
  • setStickerPositionInSet()
  • deleteStickerFromSet()
• Added namedtuple StickerSet, MaskPosition
• Added new fields to Sticker
• Added cancel() to async MessageLoop (no change to traditional counterpart)

12.1 (2017-07-04)

• Bot API 3.1
• Added methods:
  • restrictChatMember()
  • promoteChatMember()
  • exportChatInviteLink()
  • setChatPhoto()
  • deleteChatPhoto()
  • setChatTitle()
  • setChatDescription()
  • pinChatMessage()
  • unpinChatMessage()
• Added parameter until_date to method kickChatMember()
• Added fields to namedtuple Chat and ChatMember
• Added namedtuple ChatPhoto
• Added exception NotEnoughRightsError to capture situations where the bot does not have enough rights to perform operations on channels, groups, or supergroups.
• Changed some internal function names to be more descriptive, e.g. _yell() becomes _invoke(), _delay_yell() becomes _create_invoker().
• Tested on Python 3.6.1

12.0 (2017-05-26)

• Bot API 3.0
• Can receive updates containing ShippingQuery and PreCheckoutQuery
• Added flavors shipping_option and pre_checkout_query
• Added nametuples Invoice, LabeledPrice, ShippingOption, ShippingAddress, OrderInfo, ShippingQuery, PreCheckoutQuery, SuccessfulPayment
• Added method sendInvoice(), answerShippingQuery(), and answerPreCheckoutQuery()
• Added method deleteMessage() and sendVideoNote(). Added namedtuple VideoNote.
• Added new fields to various namedtuples
• Added function per_invoice_payload and class InvoiceHandler

11.0 (2017-05-09)

• Async version compliant with aiohttp2
• Added telepot.loop and telepot.aio.loop module. Method message_loop() deprecated. Use class MessageLoop, OrderedWebhook, or Webhook instead.

10.5 (2017-03-02)

• In message_loop(), delay longer between HTTP 502 responses
• Handled empty JSON responses (async version)
• Added quote_fields parameter to aiohttp hack
• Fixed dependency at aiohttp==1.3

10.4 (2016-12-25)

• Async Bot's scheduler method event_at() was modified to use unix timestamp

10.3 (2016-12-16)

• Added parameter max_connections and allowed_updates to method setWebhook()
• Added parameter allowed_updates to method getUpdates() and message_loop()
• Added method deleteWebhook()

10.2 (2016-11-29)

• Recognized channel_post and edited_channel_post in Update object
• Removed flavor edited_chat. Keep 4 flavors: chat, callback_query, inline_query, and chosen_inline_result. When dealing with chat messages, it is up to the user to differentiate between various kinds, e.g. new/edited, private/group/supergroup/channel, etc.
• setGameScore() has parameter force and disable_edit_message
• answerCallbackQuery() has parameter cache_time
• Message namedtuple has field forward_from_message_id
• Renamed ReplyKeyboardHide to ReplyKeyboardRemove

10.1 (2016-10-25)

• Used the presence of chat_instance to recognize the flavor callback_query

10.0 (2016-10-19)

• Implemented Gaming Platform stuff
• Added game-related methods, e.g. sendGame, setGameScore, etc.
• Added game-related namedtuple, e.g. InlineQueryResultGame, etc.
• telepot.glance() may return content type game
• Added method getWebhookInfo
• Added new parameters to some methods, e.g. caption for sendAudio(), etc.
• Handled EventNotFound in IdleEventCoordinator.refresh()

9.1 (2016-08-26)

• Changed the name pave_callback_query_origin_map() to intercept_callback_query_origin()
• Added include_callback_query_chat_id()

9.0 (2016-08-25)

• I am finally satisfied with callback query handling. Many styles of dealing with callback query are now possible.
• Added a few per_callback_query_*() seeder factories
• Added a few pair producers, e.g. pave_event_space(), pave_callback_query_origin_map()
• Added Bot.Scheduler to schedule internal events
• Invented a standard event format for delegates to create their own events easily
• Improved Mixin framework. Added StandardEventMixin, IdleTerminateMixin, and InterceptCallbackQueryMixin.
• Added CallbackQueryOriginHandler
• Revamped Listener and message capture specifications
• Default retries=3 for urllib3
• Relaxed urllib3>=1.9.1 in setup.py

8.3 (2016-07-17)

• Fixed urllib3==1.9.1 in setup.py

8.2 (2016-07-04)

• Handling of callback query still unsatisfactory, a transitional release
• Changed async version to telepot.aio to avoid collision with async keyword
• Added CallbackQueryCoordinator and CallbackQueryAble to facilitate transparent handling of CallbackQuery
• Added AnswererMixin to give an Answerer instance
• Added Timer to express different timeout behaviors
• Added enable_callback_query parameter to *Handler constructors
• Added default on_timeout method to @openable decorator
• Added IdleTerminate and AbsentCallbackQuery as subclasses of WaitTooLong to distinguish between different timeout situations
• Revamped Listener to handle different timeout requirements
• Added types parameter to per_chat_id()
• By default, per_from_id() and UserHandler reacts to non-callback_query only
• Fixed Bot.download_file()
• Added docstrings for Sphinx generation
• Re-organized examples

8.1 (2016-05-26)

• Added flavor edited_chat and handler function on_edited_chat_message
• New Bot API methods: getChat, leaveChat, getChatAdministrators, getChatMember, and getChatMembersCount
• Added namedtuple ChatMember and other new fields
• No longer dependent on requests. Use urllib3 throughout (traditional version).
• Start adding docstring and using Sphinx to generate documentations.

8.0 (2016-05-13)

• Added HTTP connection pooling (for both traditional and async version). Bot API requests are much speedier.
• Most requests are now done with urllib3, moving away from requests.
• Added module telepot.routing and telepot.async.routing to provide common key functions and routing tables for Router to use.
• Removed method set_key_function and set_routing_table from Router. Access instance variable key_function and routing_table instead.
• Added function telepot.message_identifier to extract message identifier for editing messages.
• Added helper class Editor to ease editing messages.
• ChatHandler, by default, also captures callback_query from the same user.
• Added InlineUserHandler to capture only inline-related messages.
• Async version uses async/await, stops supporting Python 3.4, works on Python 3.5+ from now on.

7.1 (2016-04-24)

• Patched requests and aiohttp to send unicode filenames

7.0 (2016-04-18)

• Bot API 2.0
  • Added new flavor callback_query
  • Added a bunch of namedtuples to reflect new objects in Bot API
  • Added methods:
    • sendVenue(), sendContact()
    • kickChatMember(), unbanChatMember()
    • answerCallbackQuery()
    • editMessageText(), editMessageCaption(), editMessageReplyMarkup()
  • To ChatContext, added a property administrator
• Added telepot.exception.MigratedToSupergroupChatError
• Backward-incompatible name changes
  • Flavor normal → chat
  • Method notifyOnMessage → message_loop
  • Method messageLoop → message_loop
  • Method downloadFile → download_file
  • Function telepot.namedtuple.namedtuple was removed. Create namedtuples using their constructors directly.
  • Function telepot.glance2 was removed. Use telepot.glance.
  • Chat messages' content type returned by telepot.glance:
    • new_chat_participant → new_chat_member
    • left_chat_participant → left_chat_member

6.8 (2016-04-11)

• Added underlying response object to BadHTTPResponse and underlying JSON object to TelegramError
• Added TooManyRequestsError as a subclass to TelegramError

6.7 (2016-04-03)

• Added a few TelegramError subclasses to indicate specific errors
• Override BadHTTPResponse's __unicode__() and __str__() to shorten traceback

6.6 (2016-03-20)

• Changed Answerer interface. Compute function is now passed to method answer(), not to the constructor.
• Added parameter disable_notification to methods sendZZZ()
• Added function telepot.delegate.per_application() and per_message()
• Used data to pass POST parameters to prevent too-long query strings on URL
• Async version support pushed back to Python 3.4.2

6.5 (2016-02-21)

• Supports file-like object and filename when sending files
• Moved all exceptions to module telepot.exception
• Expanded testing to Python 3.5

6.4 (2016-02-16)

• Introduced automatic message routing to Bot.handle() and ZZZHandler.on_message(). Messages are routed to sub-handlers according to flavor, by default.
• As an alternative to implementing Bot.handle(msg), you may implement Bot.on_chat_message(msg), Bot.on_inline_query(msg), and Bot.on_chosen_inline_result(msg) as needed.
• As an alternative to implementing ZZZHandler.on_message(), you may implement ZZZHandler.on_chat_message(msg), ZZZHandler.on_inline_query(msg), and ZZZHandler.on_chosen_inline_result(msg) as needed.
• notifyOnMessage() and messageLoop() accept a dict as callback, routing messages according to flavor.
• Added function telepot.flavor_router(), classes telepot.helper.Router and telepot.helper.DefaultRouterMixin, and their async counterparts to facilitate message routing.
• Many functions in telepot.delegate and telepot.helper now have aliases in their respective async modules, making imports more symmetric.

6.3 (2016-02-06)

• Added Answerer class to better deal with inline queries
• Made telepot.glance() equivalent to telepot.glance2(). Developers are encouraged to use telepot.glance() from now on.
• Added telepot.flance(), a combination of telepot.flavor() and telepot.glance().

6.2 (2016-01-18)

• Handle new field chosen_inline_result in Update object
• telepot.flavor() returns a new flavor chosen_inline_result
• Added telepot.namedtuple.ChosenInlineResult class

6.1 (2016-01-13)

• Changed normal message's flavor to normal

6.0 (2016-01-13)

• Moved all namedtuple-related stuff to a new module telepot.namedtuple. All calls to the function telepot.namedtuple() should be changed to telepot.namedtuple.namedtuple()
• Added a function telepot.flavor() to differentiate between a normal message and an inline query
• Added flavor parameter to telepot.glance2() to extract info according to message flavor
• notifyOnMessage() and messageLoop() can handle inline query as well as normal chat messages
• Added a few per_XXX_id() functions useful for spawning delegates for inline queries
• Added UserHandler
• reply_markup parameter can accept namedtuples ReplyKeyboardMarkup, ReplyKeyboardHide, ForceReply as values

5.0 (2015-12-28)

• Added webhook interface
• Added supergroup_chat_created, migrate_to_chat_id, migrate_from_chat_id, and channel_chat_created fields to Message

4.1 (2015-11-03)

• Added openable() class decorator
• Default on_close() prints out exception
• Async SpeakerBot and DelegatorBot constructor accepts loop parameter

4.0 (2015-10-29)

• Revamped Listener and ChatHandler architecture
• Added create_open()

3.2 (2015-10-13)

• Conforms to latest Telegram Bot API as of October 8, 2015
• Added Chat class, removed GroupChat
• Added glance2()

3.1 (2015-10-08)

• Added per_chat_id_except()
• Added lock to Microphone, make it thread-safe

3.0 (2015-10-05)

• Added listener and delegation mechanism

2.6 (2015-09-22)

• Conforms to latest Telegram Bot API as of September 18, 2015
• Added getFile() and downloadFile() method
• Added File namedtuple
• Removed file_link field from namedtuples

2.51 (2015-09-17)

• In async messageLoop(), a regular handler function would be called directly, whereas a coroutine would be allocated a task, using BaseEventLoop.create_task().
• In messageLoop() and notifyOnMessage(), the relax time default is now 0.1 second.

2.5 (2015-09-15)

• Fixed pip install syntax error
• Having wasted a lot of version numbers, I finally get a better hang of setup.py, pip, and PyPI.

2.0 (2015-09-11)

• Conforms to latest Telegram Bot API as of September 7, 2015
• Added an async version for Python 3.4
• Added a file_link field to some namedtuples, in response to a not-yet-documented change in Bot API
• Better exception handling on receiving invalid JSON responses

1.3 (2015-09-01)

• On receiving unexpected fields, namedtuple() would issue a warning and would not break.

1.2 (2015-08-30)

• Conforms to latest Telegram Bot API as of August 29, 2015
• Added certificate parameters to setWebhook()
• Added telepot.glance() and telepot.namedtuple()
• Consolidated all tests into one script

1.1 (2015-08-21)

• Use MIT license

1.0 (2015-08-20)

• Conforms to latest Telegram Bot API as of August 15, 2015
• Added sendVoice()
• Added caption and duration parameters to sendVideo()
• Added performer and title parameters to sendAudio()
• Test scripts test the module more completely