o f>hab@s@dZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZmZdd lmZmZdd lmZdd lmZddlmZmZddl m!Z!erfddl"m#Z#GdddeZ$GdddeZ%GdddeZ&GdddeZ'GdddeZ(GdddeZ)GdddeZ*dS)z;This module contains the Telegram Business related classes.N)Sequence) TYPE_CHECKINGOptional)Chat)Location)Sticker)TelegramObject)User)de_json_optionalde_list_optionalparse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)warn)!build_deprecation_warning_message&warn_about_deprecated_attr_in_property)PTBDeprecationWarning)Botc!seZdZdZdZ              ddddeedeedeedeed eed eed eed eed eedeedeedeedeedeedeeffddZZ S)BusinessBotRightsaW This object represents the rights of a business bot. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if all their attributes are equal. .. versionadded:: 22.1 Args: can_reply (:obj:`bool`, optional): True, if the bot can send and edit messages in the private chats that had incoming messages in the last 24 hours. can_read_messages (:obj:`bool`, optional): True, if the bot can mark incoming private messages as read. can_delete_sent_messages (:obj:`bool`, optional): True, if the bot can delete messages sent by the bot. can_delete_all_messages (:obj:`bool`, optional): True, if the bot can delete all private messages in managed chats. can_edit_name (:obj:`bool`, optional): True, if the bot can edit the first and last name of the business account. can_edit_bio (:obj:`bool`, optional): True, if the bot can edit the bio of the business account. can_edit_profile_photo (:obj:`bool`, optional): True, if the bot can edit the profile photo of the business account. can_edit_username (:obj:`bool`, optional): True, if the bot can edit the username of the business account. can_change_gift_settings (:obj:`bool`, optional): True, if the bot can change the privacy settings pertaining to gifts for the business account. can_view_gifts_and_stars (:obj:`bool`, optional): True, if the bot can view gifts and the amount of Telegram Stars owned by the business account. can_convert_gifts_to_stars (:obj:`bool`, optional): True, if the bot can convert regular gifts owned by the business account to Telegram Stars. can_transfer_and_upgrade_gifts (:obj:`bool`, optional): True, if the bot can transfer and upgrade gifts owned by the business account. can_transfer_stars (:obj:`bool`, optional): True, if the bot can transfer Telegram Stars received by the business account to its own account, or use them to upgrade and transfer gifts. can_manage_stories (:obj:`bool`, optional): True, if the bot can post, edit and delete stories on behalf of the business account. Attributes: can_reply (:obj:`bool`): Optional. True, if the bot can send and edit messages in the private chats that had incoming messages in the last 24 hours. can_read_messages (:obj:`bool`): Optional. True, if the bot can mark incoming private messages as read. can_delete_sent_messages (:obj:`bool`): Optional. True, if the bot can delete messages sent by the bot. can_delete_all_messages (:obj:`bool`): Optional. True, if the bot can delete all private messages in managed chats. can_edit_name (:obj:`bool`): Optional. True, if the bot can edit the first and last name of the business account. can_edit_bio (:obj:`bool`): Optional. True, if the bot can edit the bio of the business account. can_edit_profile_photo (:obj:`bool`): Optional. True, if the bot can edit the profile photo of the business account. can_edit_username (:obj:`bool`): Optional. True, if the bot can edit the username of the business account. can_change_gift_settings (:obj:`bool`): Optional. True, if the bot can change the privacy settings pertaining to gifts for the business account. can_view_gifts_and_stars (:obj:`bool`): Optional. True, if the bot can view gifts and the amount of Telegram Stars owned by the business account. can_convert_gifts_to_stars (:obj:`bool`): Optional. True, if the bot can convert regular gifts owned by the business account to Telegram Stars. can_transfer_and_upgrade_gifts (:obj:`bool`): Optional. True, if the bot can transfer and upgrade gifts owned by the business account. can_transfer_stars (:obj:`bool`): Optional. True, if the bot can transfer Telegram Stars received by the business account to its own account, or use them to upgrade and transfer gifts. can_manage_stories (:obj:`bool`): Optional. True, if the bot can post, edit and delete stories on behalf of the business account. )can_change_gift_settingscan_convert_gifts_to_starscan_delete_all_messagescan_delete_sent_messages can_edit_bio can_edit_namecan_edit_profile_photocan_edit_usernamecan_manage_storiescan_read_messages can_replycan_transfer_and_upgrade_giftscan_transfer_starscan_view_gifts_and_starsN api_kwargsr rrrrrrrrr#rr!r"rr%cstj|d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_||_|j|j|j|j|j|j|j|j |j |j |j |j |j|jf|_|dSNr$)super__init__r rrrrrrrrr#rr!r"r _id_attrs_freeze)selfr rrrrrrrrr#rr!r"rr% __class__E/var/www/html/venv/lib/python3.10/site-packages/telegram/_business.pyr(s> zBusinessBotRights.__init__)NNNNNNNNNNNNNN) __name__ __module__ __qualname____doc__ __slots__rboolrr( __classcell__r.r.r,r/r,sdG     rcseZdZdZdZ   ddddeddded ejd e e d e e d e e d e e ffddZ ede e fddZedde de dddffdd ZZS)BusinessConnectiona{ Describes the connection of the bot with a business account. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`id`, :attr:`user`, :attr:`user_chat_id`, :attr:`date`, :attr:`rights`, and :attr:`is_enabled` are equal. .. versionadded:: 21.1 .. versionchanged:: 22.1 Equality comparison now considers :attr:`rights` instead of :attr:`can_reply`. Args: id (:obj:`str`): Unique identifier of the business connection. user (:class:`telegram.User`): Business account user that created the business connection. user_chat_id (:obj:`int`): Identifier of a private chat with the user who created the business connection. date (:obj:`datetime.datetime`): Date the connection was established in Unix time. can_reply (:obj:`bool`, optional): True, if the bot can act on behalf of the business account in chats that were active in the last 24 hours. .. deprecated:: 22.1 Bot API 9.0 deprecated this argument in favor of :paramref:`rights`. is_enabled (:obj:`bool`): True, if the connection is active. rights (:class:`BusinessBotRights`, optional): Rights of the business bot. .. versionadded:: 22.1 Attributes: id (:obj:`str`): Unique identifier of the business connection. user (:class:`telegram.User`): Business account user that created the business connection. user_chat_id (:obj:`int`): Identifier of a private chat with the user who created the business connection. date (:obj:`datetime.datetime`): Date the connection was established in Unix time. is_enabled (:obj:`bool`): True, if the connection is active. rights (:class:`BusinessBotRights`): Optional. Rights of the business bot. .. versionadded:: 22.1 ) _can_replydateid is_enabledrightsuser user_chat_idNr$r:r=r r>r9r r;r<r%c s|durtd|durttdtddddddd d tj|d ||_||_||_||_ ||_ ||_ ||_ |j|j|j|j |j |j f|_ |dS) Nz&Missing required argument `is_enabled`22.1r r<9.0 parameter)deprecated_namenew_namebot_api_version object_type)versionmessage) stacklevelr$) TypeErrorrrrr'r(r:r=r>r9r8r;r<r)r*) r+r:r=r>r9r r;r<r%r,r.r/r(s>   zBusinessConnection.__init__returncCstddddd|jS)z:obj:`bool`: Optional. True, if the bot can act on behalf of the business account in chats that were active in the last 24 hours. .. deprecated:: 22.1 Bot API 9.0 deprecated this argument in favor of :attr:`rights` r r<r@r?)deprecated_attr_name new_attr_namerD ptb_version)rr8r+r.r.r/r !szBusinessConnection.can_replydatabotrcsd||}t|}t|d|d|d<t|dt||d<t|dt||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.r9)tzinfor=r<rPrQ) _parse_datar rgetr r rr'de_json)clsrPrQ loc_tzinfor,r.r/rW1s zBusinessConnection.de_jsonNNNN)r0r1r2r3r4strintdtmdatetimerr5rrr(propertyr classmethodrWr6r.r.r,r/r7s:'    3*r7c sheZdZdZdZdddededeede e ffd d Z e dd e d e d ddffdd Z ZS)BusinessMessagesDeleteda This object is received when messages are deleted from a connected business account. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`business_connection_id`, :attr:`message_ids`, and :attr:`chat` are equal. .. versionadded:: 21.1 Args: business_connection_id (:obj:`str`): Unique identifier of the business connection. chat (:class:`telegram.Chat`): Information about a chat in the business account. The bot may not have access to the chat or the corresponding user. message_ids (Sequence[:obj:`int`]): A list of identifiers of the deleted messages in the chat of the business account. Attributes: business_connection_id (:obj:`str`): Unique identifier of the business connection. chat (:class:`telegram.Chat`): Information about a chat in the business account. The bot may not have access to the chat or the corresponding user. message_ids (tuple[:obj:`int`]): A list of identifiers of the deleted messages in the chat of the business account. )business_connection_idchat message_idsNr$rcrdrer%csBtj|d||_||_t||_|j|j|jf|_|dSr&)r'r(rcrdr rer)r*)r+rcrdrer%r,r.r/r(_s  z BusinessMessagesDeleted.__init__rPrQrrKc0||}t|dt||d<tj||dS)rRrdrT)rUr rVrr'rWrXrPrQr,r.r/rWt zBusinessMessagesDeleted.de_jsonr[)r0r1r2r3r4r\rrr]rrr(rarWr6r.r.r,r/rb@s *rbc sxeZdZdZdZ   ddddeedeedeedeeffd d Z e dd ed ed ddffdd Z Z S) BusinessIntroa3 This object contains information about the start page settings of a Telegram Business account. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`title`, :attr:`message` and :attr:`sticker` are equal. .. versionadded:: 21.1 Args: title (:obj:`str`, optional): Title text of the business intro. message (:obj:`str`, optional): Message text of the business intro. sticker (:class:`telegram.Sticker`, optional): Sticker of the business intro. Attributes: title (:obj:`str`): Optional. Title text of the business intro. message (:obj:`str`): Optional. Message text of the business intro. sticker (:class:`telegram.Sticker`): Optional. Sticker of the business intro. )rGstickertitleNr$rkrGrjr%cs>tj|d||_||_||_|j|j|jf|_|dSr&)r'r(rkrGrjr)r*)r+rkrGrjr%r,r.r/r(s  zBusinessIntro.__init__rPrQrrKcrf)rRrjrT)rUr rVrr'rWrgr,r.r/rWrhzBusinessIntro.de_jsonrZr[) r0r1r2r3r4rr\rrr(rarWr6r.r.r,r/ri~s&*ric sheZdZdZdZ ddddedeedeeffdd Z e dd ed ed d dffdd Z Z S)BusinessLocationaD This object contains information about the location of a Telegram Business account. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`address` is equal. .. versionadded:: 21.1 Args: address (:obj:`str`): Address of the business. location (:class:`telegram.Location`, optional): Location of the business. Attributes: address (:obj:`str`): Address of the business. location (:class:`telegram.Location`): Optional. Location of the business. )addresslocationNr$rmrnr%cs0tj|d||_||_|jf|_|dSr&)r'r(rmrnr)r*)r+rmrnr%r,r.r/r(s   zBusinessLocation.__init__rPrQrrKcrf)rRrnrT)rUr rVrr'rWrgr,r.r/rWrhzBusinessLocation.de_jsonr[) r0r1r2r3r4r\rrrr(rarWr6r.r.r,r/rls*rlcseZdZdZdZdddededeeffdd Zd ed e eeeffd d Z e d e eeeffddZ e d e eeeffddZ ZS)BusinessOpeningHoursIntervala This object describes an interval of time during which a business is open. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`opening_minute` and :attr:`closing_minute` are equal. .. versionadded:: 21.1 Examples: A day has (24 * 60 =) 1440 minutes, a week has (7 * 1440 =) 10080 minutes. Starting the the minute's sequence from Monday, example values of :attr:`opening_minute`, :attr:`closing_minute` will map to the following day times: * Monday - 8am to 8:30pm: - ``opening_minute = 480`` :guilabel:`8 * 60` - ``closing_minute = 1230`` :guilabel:`20 * 60 + 30` * Tuesday - 24 hours: - ``opening_minute = 1440`` :guilabel:`24 * 60` - ``closing_minute = 2879`` :guilabel:`2 * 24 * 60 - 1` * Sunday - 12am - 11:58pm: - ``opening_minute = 8640`` :guilabel:`6 * 24 * 60` - ``closing_minute = 10078`` :guilabel:`7 * 24 * 60 - 2` Args: opening_minute (:obj:`int`): The minute's sequence number in a week, starting on Monday, marking the start of the time interval during which the business is open; 0 - 7 * 24 * 60. closing_minute (:obj:`int`): The minute's sequence number in a week, starting on Monday, marking the end of the time interval during which the business is open; 0 - 8 * 24 * 60 Attributes: opening_minute (:obj:`int`): The minute's sequence number in a week, starting on Monday, marking the start of the time interval during which the business is open; 0 - 7 * 24 * 60. closing_minute (:obj:`int`): The minute's sequence number in a week, starting on Monday, marking the end of the time interval during which the business is open; 0 - 8 * 24 * 60 ) _closing_time _opening_timeclosing_minuteopening_minuteNr$rsrrr%cs@tj|d||_||_d|_d|_|j|jf|_|dSr&)r'r(rsrrrqrpr)r*)r+rsrrr%r,r.r/r(s z%BusinessOpeningHoursInterval.__init__minuterKcCs|d|dd|ddfS)Ni<r.)r+rtr.r.r/ _parse_minute#sz*BusinessOpeningHoursInterval._parse_minutecC|jdur ||j|_|jS)aWConvenience attribute. A :obj:`tuple` parsed from :attr:`opening_minute`. It contains the `weekday`, `hour` and `minute` in the same ranges as :attr:`datetime.datetime.weekday`, :attr:`datetime.datetime.hour` and :attr:`datetime.datetime.minute` Returns: tuple[:obj:`int`, :obj:`int`, :obj:`int`]: N)rqrvrsrOr.r.r/ opening_time& z)BusinessOpeningHoursInterval.opening_timecCrw)aWConvenience attribute. A :obj:`tuple` parsed from :attr:`closing_minute`. It contains the `weekday`, `hour` and `minute` in the same ranges as :attr:`datetime.datetime.weekday`, :attr:`datetime.datetime.hour` and :attr:`datetime.datetime.minute` Returns: tuple[:obj:`int`, :obj:`int`, :obj:`int`]: N)rprvrrrOr.r.r/ closing_time3ryz)BusinessOpeningHoursInterval.closing_time)r0r1r2r3r4r]rrr(tuplervr`rxrzr6r.r.r,r/ros ) "rocsdeZdZdZdZdddedeedee ffdd Z e dd e d ed d dffdd Z Z S)BusinessOpeningHoursaS This object describes the opening hours of a business. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`time_zone_name` and :attr:`opening_hours` are equal. .. versionadded:: 21.1 Args: time_zone_name (:obj:`str`): Unique name of the time zone for which the opening hours are defined. opening_hours (Sequence[:class:`telegram.BusinessOpeningHoursInterval`]): List of time intervals describing business opening hours. Attributes: time_zone_name (:obj:`str`): Unique name of the time zone for which the opening hours are defined. opening_hours (Sequence[:class:`telegram.BusinessOpeningHoursInterval`]): List of time intervals describing business opening hours. ) opening_hourstime_zone_nameNr$r~r}r%cs8tj|d||_t||_|j|jf|_|dSr&)r'r(r~r r}r)r*)r+r~r}r%r,r.r/r(Zs zBusinessOpeningHours.__init__rPrQrrKcrf)rRr}rT)rUr rVror'rWrgr,r.r/rWks  zBusinessOpeningHours.de_jsonr[)r0r1r2r3r4r\rrorrr(rarWr6r.r.r,r/r|As*r|)+r3r_r^collections.abcrtypingrrtelegram._chatrtelegram._files.locationrtelegram._files.stickerrtelegram._telegramobjectrtelegram._userr telegram._utils.argumentparsingr r r telegram._utils.datetimer rtelegram._utils.typesrtelegram._utils.warningsr#telegram._utils.warnings_transitionrrtelegram.warningsrtelegramrrr7rbrirlror|r.r.r.r/s4          >61\