o Zzji@s$dZddlZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZmZmZdd lmZmZmZdd lmZerXddlmZGdddeZGdddeZ GdddeZ!GdddeZ"GdddeZ#GdddeZ$GdddeZ%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!seZdZdZdZ              ddddedBdedBdedBdedBd edBd edBd edBd edBd edBdedBdedBdedBdedBdedBdedBffddZZS)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 rrrrr"cstj|d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_||_|j|j|j|j|j|j|j|j |j |j |j |j |j|jf|_|dSNr!)super__init__rrrrrrrrrr rrrr _id_attrs_freeze)selfrrrrrrrrrr rrrrr" __class__M/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_business.pyr%s> zBusinessBotRights.__init__)NNNNNNNNNNNNNN) __name__ __module__ __qualname____doc__ __slots__boolrr% __classcell__r+r+r)r,r0sdG     rcsveZdZdZdZ ddddeddded ejd e d e dBd e dBffd dZ e dde ddddffdd 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 ``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!r6r9r r:r5r7r8r"cs\tj|d||_||_||_||_||_||_|j|j|j|j|j|jf|_| dSr#) r$r%r6r9r:r5r7r8r&r')r(r6r9r:r5r7r8r"r)r+r,r%s  zBusinessConnection.__init__databot Bot | Nonereturncsd||}t|}t|d|d|d<t|dt||d<t|dt||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.r5tzinfor9r8r;r<) _parse_datar rgetr r rr$de_json)clsr;r< loc_tzinfor)r+r,rE s zBusinessConnection.de_jsonN)r-r.r/r0r1strintdtmdatetimer2rrr% classmethodrEr3r+r+r)r,r4s.%  &r4c sdeZdZdZdZdddededeede dBffd d Z e dd e d d ddffdd Z Z 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!rOrPrQr"csBtj|d||_||_t||_|j|j|jf|_|dSr#)r$r%rOrPr rQr&r')r(rOrPrQr"r)r+r,r%;s  z BusinessMessagesDeleted.__init__r;r<r=r>c0||}t|dt||d<tj||dS)r?rPrB)rCr rDrr$rErFr;r<r)r+r,rEP zBusinessMessagesDeleted.de_jsonrH)r-r.r/r0r1rIrrrJrr%rMrEr3r+r+r)r,rNs &rNc steZdZdZdZ   ddddedBdedBdedBdedBffd d Ze dd ed d 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. )messagestickertitleNr!rXrVrWr"cs>tj|d||_||_||_|j|j|jf|_|dSr#)r$r%rXrVrWr&r')r(rXrVrWr"r)r+r,r%us  zBusinessIntro.__init__r;r<r=r>crR)r?rWrB)rCr rDrr$rErSr)r+r,rErTzBusinessIntro.de_json)NNNrH) r-r.r/r0r1rIrrr%rMrEr3r+r+r)r,rUZs&&rUc s`eZdZdZdZ ddddedddedBffd d Zedd ed d ddffdd 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!rZr[zLocation | Noner"cs0tj|d||_||_|jf|_|dSr#)r$r%rZr[r&r')r(rZr[r"r)r+r,r%s   zBusinessLocation.__init__r;r<r=r>crR)r?r[rB)rCr rDrr$rErSr)r+r,rErTzBusinessLocation.de_jsonrH) r-r.r/r0r1rIrr%rMrEr3r+r+r)r,rYs&rYcseZdZdZdZdddedededBffdd Zd ed eeeeffd d Z e d eeeeffddZ e d eeeeffddZ Z 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!r`r_r"cs@tj|d||_||_d|_d|_|j|jf|_|dSr#)r$r%r`r_r^r]r&r')r(r`r_r"r)r+r,r%s z%BusinessOpeningHoursInterval.__init__minuter>cCs|d|dd|ddfS)N<r+)r(rar+r+r, _parse_minutesz*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)r^rdr`r(r+r+r, opening_time z)BusinessOpeningHoursInterval.opening_timecCre)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)r]rdr_rfr+r+r, closing_timerhz)BusinessOpeningHoursInterval.closing_time)r-r.r/r0r1rJrr%tuplerdpropertyrgrir3r+r+r)r,r\s ) "r\c seZdZdZdZdddedeededBffdd Z e d e fd d Z dd e jde jeBdBd eee je jfdffddZde jd efddZeddeddd dffdd ZZS)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!rornr"cs>tj|d||_t||_d|_|j|jf|_|dSr#)r$r%ror rnrmr&r')r(rornr"r)r+r,r%6s zBusinessOpeningHours.__init__r>cCs|jdur t|j|_|jSrH)rmrrorfr+r+r, _zone_infoIs  zBusinessOpeningHours._zone_infor5 time_zone.c Cs|}g}t|trt|}n |dur|j}n|}|jD]B}|j}|j}|d|kr,qtj |j |j |j |d|d|jd |} tj |j |j |j |d|d|jd |} || | fqtt|dddS) 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)yearmonthdayhourrarAcSs|dS)Nrr+)xr+r+r,sz@BusinessOpeningHours.get_opening_hours_for_day..)key)weekday isinstancerIrrprnrgrirKrLrtrurv astimezoneappendrjsorted) r(r5rqweek_dayres tz_targetintervalint_open int_closeresult_int_openresult_int_closer+r+r,get_opening_hours_for_dayOsD      z.BusinessOpeningHours.get_opening_hours_for_dayrLcCsp|jdur |j|jdn||j}|d|jd|j}|jD]}|j|kr3|j kr5dSq#q#dS)aCheck if the business is open at the specified datetime. .. versionadded:: 22.5 Args: datetime (:obj:`datetime.datetime`): The datetime to check. If the object is timezone-naive, it is assumed to be in the timezone specified by :attr:`time_zone_name`. Returns: :obj:`bool`: True if the business is open at the specified time, False otherwise. Nr@rbrcTF) rAreplacerpr}r{rwrarnr`r_)r(rLdatetime_in_native_tzminute_of_weekrr+r+r,is_opens  zBusinessOpeningHours.is_openr;r<r=crR)r?rnrB)rCr rDr\r$rErSr)r+r,rEs  zBusinessOpeningHours.de_jsonrH)r-r.r/r0r1rIrr\rr%rkrrprKr5rArjrLrr2rrMrEr3r+r+r)r,rls0  >&rl)&r0rLrKcollections.abcrtypingrzoneinfortelegram._chatrtelegram._files.locationrtelegram._files.stickerrtelegram._telegramobjectrtelegram._userr telegram._utils.argumentparsingr r r telegram._utils.datetimer rrtelegram._utils.typesrtelegramrrr4rNrUrYr\rlr+r+r+r,s.          \>61\