iizdZddlZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZmZmZdd lmZmZmZdd lmZerddlmZGddeZGddeZ GddeZ!GddeZ"GddeZ#GddeZ$GddeZ%dS)z;This module contains the Telegram Business related classes.N)Sequence) TYPE_CHECKING)ZoneInfo)Chat)Location)Sticker)TelegramObject)User)de_json_optionalde_list_optionalparse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp get_zone_info)JSONDict)Botc!eZdZdZdZ ddddedzdedzdedzdedzd edzd edzd edzd edzd edzdedzdedzdedzdedzdedzdedzffdZxZS)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_kwargsrrrrrrrrrr"rr r!rr$ct|||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_||_|j|j|j|j|j|j|j|j |j |j |j |j |j|jf|_|dSNr#)super__init__rrrrrrrrrr"rr r!r _id_attrs_freeze)selfrrrrrrrrrr"rr r!rr$ __class__s R/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_business.pyr(zBusinessBotRights.__init__s& J///&/.?5M%4K$*7)53I#.?5M%5M%7Q';Y+/A/A N  "  )  (      '  "  )  )  +  /  #  # " )NNNNNNNNNNNNNN) __name__ __module__ __qualname____doc__ __slots__boolrr( __classcell__r,s@r-rr0saEENI&"&)-04/3%)$(.2)-0404266:*.*.4"'+#444$;4 $;4#'+ 4 "& 4 d{ 4Tk4!%t 4 $;4#'+4#'+4%)4K4)-t 4!4K4!4K4"tO#4444444444r.rceZdZdZdZ ddddeddded ejd e d e dzd e dzffd Z e dde ddddffd ZxZS)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 ``can_reply``. .. versionremoved:: 22.3 Removed argument and attribute ``can_reply`` deprecated by API 9.0. 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. 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 )dateid is_enabledrightsuser user_chat_idNr#r:r=r r>r9r;r<r$ct|||_||_||_||_||_||_|j|j|j|j|j|jf|_| dSr&) r'r(r:r=r>r9r;r<r)r*) r+r:r=r>r9r;r<r$r,s r-r(zBusinessConnection.__init__s J/// !-"& *06  G I   I K O   r.databot Bot | Nonereturnc||}t|}t|d||d<t |dt ||d<t |dt ||d<t||S),See :meth:`telegram.TelegramObject.de_json`.r9tzinfor=r<r@rA) _parse_datarrgetr r rr'de_json)clsr@rA loc_tzinfor,s r-rKzBusinessConnection.de_json st$$2#66 %dhhv&6&6zJJJV '(8(8$DDV )$((8*<*<>OQTUUXwwDc222r.N)r/r0r1r2r3strintdtmdatetimer4rrr( classmethodrKr5r6s@r-r8r8s##JI ,0'+   l   "D(tO< 3 38 3, 3BV 3 3 3 3 3[ 3 3 3 3 3r.r8c zeZdZdZdZdddededeede dzffd Z e dd e d d d dffd Z xZ S)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#rVrWrXr$ct|||_||_t ||_|j|j|jf|_|dSr&)r'r(rVrWr rXr)r*)r+rVrWrXr$r,s r-r(z BusinessMessagesDeleted.__init__;sn J///+A# ,>{,K,K  ' I    r.r@rArBrCc||}t|dt||d<t ||S)rErWrH)rIr rJrr'rKrLr@rAr,s r-rKzBusinessMessagesDeleted.de_jsonPsQt$$'(8(8$DDV wwDc222r.rN)r/r0r1r2r3rOrrrPrr(rSrKr5r6s@r-rUrUs0I'+  #c]  tO *3383,3B[33333[33333r.rUc eZdZdZdZ ddddedzdedzdedzdedzffd Ze dd ed d d dffd Z xZ 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. )messagestickertitleNr#r`r^r_r$ct|||_||_||_|j|j|jf|_|dSr&)r'r(r`r^r_r)r*)r+r`r^r_r$r,s r-r(zBusinessIntro.__init__usZ J///!& #* '. *dlDLA r.r@rArBrCc||}t|dt||d<t ||S)rEr_rH)rIr rJrr'rKr[s r-rKzBusinessIntro.de_jsonsQt$$*488I+>+>MMYwwDc222r.)NNNrN) r/r0r1r2r3rOrrr(rSrKr5r6s@r-r]r]Zs(I!""&  '+ Tzt4  tO "3383,3/33333[33333r.r]c neZdZdZdZ ddddedddedzffd Zedd ed d d dffd Z xZ 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#rerfzLocation | Noner$ct|||_||_|jf|_|dSr&)r'r(rerfr)r*)r+rerfr$r,s r-r(zBusinessLocation.__init__sJ J///# )1 , r.r@rArBrCc||}t|dt||d<t ||S)rErfrH)rIr rJrr'rKr[s r-rKzBusinessLocation.de_jsonsRt$$+DHHZ,@,@(CPPZwwDc222r.rN) r/r0r1r2r3rOrr(rSrKr5r6s@r-rdrds$I'+  '+    $  tO      3383,3BT33333[33333r.rdceZdZdZdZdddedededzffdZd ed eeeeffd Z e d eeeeffd Z e d eeeeffd Z xZ S)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 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#rnrmr$ct|||_||_d|_d|_|j|jf|_|dSr&)r'r(rnrmrlrkr)r*)r+rnrmr$r,s r-r(z%BusinessOpeningHoursInterval.__init__sc J///#1#1:>:>-t/BC r.minuterCc*|dz|dzdz|dzdzfS)N<)r+rps r- _parse_minutez*BusinessOpeningHoursInterval._parse_minutes%$  3Vd]R5GHHr.c\|j||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`]: )rlrurnr+s r- opening_timez)BusinessOpeningHoursInterval.opening_time/   %!%!3!3D4G!H!HD !!r.c\|j||j|_|jS)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`]: )rkrurmrws r- closing_timez)BusinessOpeningHoursInterval.closing_timeryr.)r/r0r1r2r3rPrr(tuplerupropertyrxr{r5r6s@r-rjrjs''RWI'+  tO $ICIE#sC-,@IIII "eCcM2 " " "X " "eCcM2 " " "X " " " " "r.rjc eZdZdZdZdddedeededzffdZ e d e fd Z dd e jd e jezdzd eee je jfd ffdZde jd efdZeddeddd dffd ZxZS)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. )_cached_zone_info opening_hourstime_zone_nameNr#rrr$ct|||_t||_d|_|j|jf|_|dSr&)r'r(rr rrr)r*)r+rrr$r,s r-r(zBusinessOpeningHours.__init__6sl J///#1EW F F 37-t/AB r.rCcP|jt|j|_|jSrN)rrrrws r- _zone_infozBusinessOpeningHours._zone_infoIs'  ! )%243F%G%GD "%%r.r9 time_zone.c z|}g}t|trt|}n ||j}n|}|jD]}|j}|j}|d|krtj |j |j |j |d|d|j |} tj |j |j |j |d|d|j |} || | ftt!|dS)aReturns the opening hours intervals for a specific day as datetime objects. .. versionadded:: 22.5 Args: date (:obj:`datetime.date`): The date to get opening hours for. time_zone (:obj:`datetime.tzinfo` | :obj:`str`, optional): Timezone to use for the returned datetime objects. If not specified, then :attr:`time_zone_name` be used. Returns: tuple[tuple[:obj:`datetime.datetime`, :obj:`datetime.datetime`], ...]: A tuple of datetime pairs representing opening and closing times for the specified day. Each pair consists of ``(opening_time, closing_time)``. Returns an empty tuple if there are no opening hours for the given day. Nr)yearmonthdayhourrprGc|dS)Nrrt)xs r-z@BusinessOpeningHours.get_opening_hours_for_day..s qtr.)key)weekday isinstancerOrrrrxr{rQrRrrr astimezoneappendr|sorted) r+r9rweek_dayres tz_targetintervalint_open int_closeresult_int_openresult_int_closes r-get_opening_hours_for_dayz.BusinessOpeningHours.get_opening_hours_for_dayOsS&<<>> i % % "$1)$<$rs(BA$$$$$$ ------++++++333333  +*****MMMMMMMM`Y3Y3Y3Y3Y3Y3Y3Y3x;3;3;3;3;3n;3;3;3|3333333333N333333l.3.3.3.3.3~.3.3.3bY"Y"Y"Y"Y">Y"Y"Y"xV3V3V3V3V3>V3V3V3V3V3r.