U g7?@szdZddlZddlmZmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZddlmZeGd d d ZdS) z\This module contains the class Defaults, which allows passing default values to Application.N)AnyDictNoReturnOptionalfinal)LinkPreviewOptions)UTC)ODVInput)warn)PTBDeprecationWarningc @seZdZdZdZddddedddddf eeeeeeeee j eeeeeedeed ddZ e d d d Z eed d dZeeeefd ddZeeed ddZejeedddZeeed ddZejeedddZeeed ddZejeedddZeeed ddZejeedddZeeed ddZejeedd dZeeed d!d"Zejeedd#d"Zeeed d$d%Zejeedd&d%Zeeed d'd(Zejeedd)d(Zeeed d*d+Zejeedd,d+Zee j d d-d.Z e jeedd/d.Z eed d0d1Z e jeedd2d1Z eeed d3d4Z!e!jeedd5d4Z!eedd d6d7Z"eeed d8d9Z#dS):DefaultsaTConvenience Class to gather all parameters with a (user defined) default value .. seealso:: :wiki:`Architecture Overview `, :wiki:`Adding Defaults to Your Bot ` .. versionchanged:: 20.0 Removed the argument and attribute ``timeout``. Specify default timeout behavior for the networking backend directly via :class:`telegram.ext.ApplicationBuilder` instead. Parameters: parse_mode (:obj:`str`, optional): |parse_mode| disable_notification (:obj:`bool`, optional): |disable_notification| disable_web_page_preview (:obj:`bool`, optional): Disables link previews for links in this message. Mutually exclusive with :paramref:`link_preview_options`. .. deprecated:: 20.8 Use :paramref:`link_preview_options` instead. This parameter will be removed in future versions. allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|. Will be used for :attr:`telegram.ReplyParameters.allow_sending_without_reply`. quote (:obj:`bool`, optional): |reply_quote| .. deprecated:: 20.8 Use :paramref:`do_quote` instead. This parameter will be removed in future versions. tzinfo (:class:`datetime.tzinfo`, optional): A timezone to be used for all date(time) inputs appearing throughout PTB, i.e. if a timezone naive date(time) object is passed somewhere, it will be assumed to be in :paramref:`tzinfo`. If the :class:`telegram.ext.JobQueue` is used, this must be a timezone provided by the ``pytz`` module. Defaults to ``pytz.utc``, if available, and :attr:`datetime.timezone.utc` otherwise. block (:obj:`bool`, optional): Default setting for the :paramref:`BaseHandler.block` parameter of handlers and error handlers registered through :meth:`Application.add_handler` and :meth:`Application.add_error_handler`. Defaults to :obj:`True`. protect_content (:obj:`bool`, optional): |protect_content| .. versionadded:: 20.0 link_preview_options (:class:`telegram.LinkPreviewOptions`, optional): Link preview generation options for all outgoing messages. Mutually exclusive with :paramref:`disable_web_page_preview`. This object is used for the corresponding parameter of :meth:`telegram.Bot.send_message`, :meth:`telegram.Bot.edit_message_text`, and :class:`telegram.InputTextMessageContent` if not specified. If a value is specified for the corresponding parameter, only those parameters of :class:`telegram.LinkPreviewOptions` will be overridden that are not explicitly set. Example: .. code-block:: python from telegram import LinkPreviewOptions from telegram.ext import Defaults, ExtBot defaults = Defaults( link_preview_options=LinkPreviewOptions(show_above_text=True) ) chat_id = 123 async def main(): async with ExtBot("Token", defaults=defaults) as bot: # The link preview will be shown above the text. await bot.send_message(chat_id, "https://python-telegram-bot.org") # The link preview will be shown below the text. await bot.send_message( chat_id, "https://python-telegram-bot.org", link_preview_options=LinkPreviewOptions(show_above_text=False) ) # The link preview will be shown above the text, but the preview will # show Telegram. await bot.send_message( chat_id, "https://python-telegram-bot.org", link_preview_options=LinkPreviewOptions(url="https://telegram.org") ) .. versionadded:: 20.8 do_quote(:obj:`bool`, optional): |reply_quote| .. versionadded:: 20.8 ) _allow_sending_without_reply _api_defaults_block_disable_notification _do_quote_link_preview_options _parse_mode_protect_content_tzinfoNTr) parse_modedisable_notificationdisable_web_page_previewquotetzinfoblockallow_sending_without_replyprotect_contentlink_preview_optionsdo_quotec Cs||_||_||_||_||_||_|dk r<| dk rsz"Defaults.__eq__..F) isinstancer all __slots__)r'r1r*r5r+__eq__s zDefaults.__eq__cCs|jSr2)rr/r*r*r+ api_defaultsszDefaults.api_defaultscCs|jS)z:obj:`str`: Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or URLs in your bot's message. rr/r*r*r+rszDefaults.parse_mode)_r-cCs tddS)NzBYou can not assign a new value to parse_mode after initialization.AttributeErrorr'r=r*r*r+rscCs|jS)z:obj:`str`: Optional. Alias for :attr:`parse_mode`, used for the corresponding parameter of :meth:`telegram.Bot.send_poll`. r<r/r*r*r+r#szDefaults.explanation_parse_modecCs tddS)NzNYou can not assign a new value to explanation_parse_mode after initialization.r>r@r*r*r+r#scCs|jS)z:obj:`str`: Optional. Alias for :attr:`parse_mode`, used for the corresponding parameter of :meth:`telegram.ReplyParameters`. r<r/r*r*r+quote_parse_modeszDefaults.quote_parse_modecCs tddS)NzHYou can not assign a new value to quote_parse_mode after initialization.r>r@r*r*r+rA scCs|jS)z:obj:`str`: Optional. Alias for :attr:`parse_mode`, used for the corresponding parameter of :class:`telegram.InputPollOption`. .. versionadded:: 21.2 r<r/r*r*r+text_parse_modeszDefaults.text_parse_modecCs tddS)NzGYou can not assign a new value to text_parse_mode after initialization.r>r@r*r*r+rBscCs|jS)z:obj:`str`: Optional. Alias for :attr:`parse_mode`, used for the corresponding parameter of :meth:`telegram.Bot.send_poll`. .. versionadded:: 21.2 r<r/r*r*r+r$szDefaults.question_parse_modecCs tddS)NzKYou can not assign a new value to question_parse_mode after initialization.r>r@r*r*r+r$'scCs|jS)zt:obj:`bool`: Optional. Sends the message silently. Users will receive a notification with no sound. )rr/r*r*r+r-szDefaults.disable_notificationcCs tddS)NzLYou can not assign a new value to disable_notification after initialization.r>r@r*r*r+r4scCs|jr|jjSdS)z:obj:`bool`: Optional. Disables link previews for links in all outgoing messages. .. deprecated:: 20.8 Use :attr:`link_preview_options` instead. This attribute will be removed in future versions. N)rr"r/r*r*r+r:s z!Defaults.disable_web_page_previewcCs tddS)NzPYou can not assign a new value to disable_web_page_preview after initialization.r>r@r*r*r+rEscCs|jS)z:obj:`bool`: Optional. Pass :obj:`True`, if the message should be sent even if the specified replied-to message is not found. )r r/r*r*r+rKsz$Defaults.allow_sending_without_replycCs tddS)NzSYou can not assign a new value to allow_sending_without_reply after initialization.r>r@r*r*r+rRscCs|jdk r|jSdS)z:obj:`bool`: Optional. |reply_quote| .. deprecated:: 20.8 Use :attr:`do_quote` instead. This attribute will be removed in future versions. Nrr/r*r*r+rXszDefaults.quotecCs tddS)Nz=You can not assign a new value to quote after initialization.r>r@r*r*r+rbscCs|jS)zj:obj:`tzinfo`: A timezone to be used for all date(time) objects appearing throughout PTB. )rr/r*r*r+rfszDefaults.tzinfocCs tddS)Nz>You can not assign a new value to tzinfo after initialization.r>r@r*r*r+rmscCs|jS)z:obj:`bool`: Optional. Default setting for the :paramref:`BaseHandler.block` parameter of handlers and error handlers registered through :meth:`Application.add_handler` and :meth:`Application.add_error_handler`. )rr/r*r*r+rqszDefaults.blockcCs tddS)Nz=You can not assign a new value to block after initialization.r>r@r*r*r+ryscCs|jS)z:obj:`bool`: Optional. Protects the contents of the sent message from forwarding and saving. .. versionadded:: 20.0 )rr/r*r*r+r}szDefaults.protect_contentcCs tddS)NzEYou can't assign a new value to protect_content after initialization.r>r@r*r*r+rscCs|jS)z:class:`telegram.LinkPreviewOptions`: Optional. Link preview generation options for all outgoing messages. .. versionadded:: 20.8 )rr/r*r*r+rszDefaults.link_preview_optionscCs|jS)zM:obj:`bool`: Optional. |reply_quote| .. versionadded:: 20.8 rCr/r*r*r+rszDefaults.do_quote)$__name__ __module__ __qualname____doc__r9rrstrbooldatetimerr,intr0objectr:propertyrrr;rsetterrr#rArBr$rr rrrrrrrr*r*r*r+r sW C   r )rGrJtypingrrrrrZtelegramrZtelegram._utils.datetimerZtelegram._utils.typesr Ztelegram._utils.warningsr Ztelegram.warningsr r r*r*r*r+s