o Zzj@spUdZddlZddlmZddlmZmZmZddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1erddl(m2Z2GdddeZ3Gddde3Z4GdddeZ5Gdd d e5Z6Gd!d"d"e5Z7Gd#d$d$e5Z8Gd%d&d&e4Z9Gd'd(d(e4Z:Gd)d*d*e4Z;Gd+d,d,e3ZGd1d2d2e4Z?Gd3d4d4e4Z@Gd5d6d6e4ZAe9e?Be@BeABeBe=Be;BZDeeCd8<dS)9zfBase classes for Telegram InputMedia, InputPaidMedia, InputPollMedia and InputPollOptionMedia Objects.N)Sequence) TYPE_CHECKINGFinal TypeAlias) constants) Animation)Audio)Document) InputFile) PhotoSize)Sticker)Video) MessageEntity)TelegramObject)enum)parse_sequence_arg to_timedelta)get_timedelta_value) DEFAULT_NONEparse_file_input)JSONDictODVInput TimePeriod)warn)BaseInputMediaType)PTBDeprecationWarning) FileInputcs8eZdZdZdZdddededBffddZZS) _BaseInputMediaz Base class for objects representing the various input media types. Args: media_type (:obj:`str`): Type of media that the instance represents. Attributes: type (:obj:`str`): Type of media that the instance represents. )typeN api_kwargs media_typer!cs$tj|dttj|||_dSNr )super__init__r get_memberrrr)selfr"r! __class__U/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_files/inputmedia.pyr%?sz_BaseInputMedia.__init__ __name__ __module__ __qualname____doc__ __slots__strrr% __classcell__r*r*r(r+r2s rcseZdZdZdZddefdddedeeBdedBdee dBd e ed e dBf fd d Z e d ddeeBdBfddZZS) InputMediaa This object represents the content of a media message to be sent. It should be one of: * :class:`telegram.InputMediaAnimation` * :class:`telegram.InputMediaAudio` * :class:`telegram.InputMediaDocument` * :class:`telegram.InputMediaLivePhoto` * :class:`telegram.InputMediaPhoto` * :class:`telegram.InputMediaVideo` .. versionchanged:: 20.0 Added arguments and attributes :attr:`type`, :attr:`media`, :attr:`caption`, :attr:`caption_entities`, :paramref:`parse_mode`. .. seealso:: :wiki:`Working with Files and Media ` Args: media_type (:obj:`str`): Type of media that the instance represents. media (:obj:`str` | :class:`~telegram.InputFile`): File to send. |fileinputnopath| caption (:obj:`str`, optional): Caption of the media to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| .. versionchanged:: 20.0 |sequenceclassargs| parse_mode (:obj:`str`, optional): |parse_mode| Attributes: type (:obj:`str`): Type of the input media. media (:obj:`str` | :class:`telegram.InputFile`): Media to send. caption (:obj:`str`): Optional. Caption of the media to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. |parse_mode| caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| .. versionchanged:: 20.0 * |tupleclassattrs| * |alwaystuple| )captioncaption_entitiesmedia parse_modeNr r"r7r5r6r8r!csZtj||d|||_||_t||_||_WddS1s&wYdSNr"r!)r$r% _unfrozenr7r5rr6r8)r'r"r7r5r6r8r!r(r*r+r%zs  "zInputMedia.__init__ thumbnailFileInput | NonereturncCs|dur t|dddS|S)NTattach local_moder)r<r*r*r+_parse_thumbnail_inputs  z!InputMedia._parse_thumbnail_input)r-r.r/r0r1rr2r rrrrr% staticmethodrBr3r*r*r(r+r4Is.. $r4cseZdZUdZejjZeee d< ejj Z eee d< ejj Z eee d< dZ ddded ee Bd edBffd d ZZS) InputPaidMediaa Base class for Telegram InputPaidMedia Objects. Currently, it can be one of: * :class:`telegram.InputPaidMediaPhoto` * :class:`telegram.InputPaidMediaVideo` * :class:`telegram.InputPaidMediaLivePhoto` .. seealso:: :wiki:`Working with Files and Media ` .. versionadded:: 21.4 Args: type (:obj:`str`): Type of media that the instance represents. media (:obj:`str` | :class:`~telegram.InputFile`): File to send. |fileinputnopath| Attributes: type (:obj:`str`): Type of the input media. media (:obj:`str` | :class:`telegram.InputFile`): Media to send. PHOTOVIDEO LIVE_PHOTO)r7rNr rr7r!cs2tj|dttj|||_||_|dSr#) r$r%rr&rInputPaidMediaTyperr7_freeze)r'rr7r!r(r*r+r%s zInputPaidMedia.__init__)r-r.r/r0rrHrErr2__annotations__rFrGr1r rr%r3r*r*r(r+rDs" rDcs8eZdZdZdZdddddedBffdd ZZS) InputPaidMediaPhotoaThe paid media to send is a photo. .. seealso:: :wiki:`Working with Files and Media ` .. versionadded:: 21.4 Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.PhotoSize`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.PhotoSize` object to send. Attributes: type (:obj:`str`): Type of the media, always :tg-const:`telegram.constants.InputPaidMediaType.PHOTO`. media (:obj:`str` | :class:`telegram.InputFile`): Photo to send. r*Nr r7FileInput | PhotoSizer!cs0t|tddd}tjtj||d|dSNTr?rr7r!)rr r$r%rDrErI)r'r7r!r(r*r+r%s zInputPaidMediaPhoto.__init__r-r.r/r0r1rr%r3r*r*r(r+rKsrKcseZdZdZdZ       dddddddd edBd edBd edBd edBd ddedBdedBffddZ e dee j BdBfddZ ZS)InputPaidMediaVideoa The paid media to send is a video. .. seealso:: :wiki:`Working with Files and Media ` .. versionadded:: 21.4 Note: * When using a :class:`telegram.Video` for the :attr:`media` attribute, it will take the width, height and duration from that video, unless otherwise specified with the optional arguments. * :paramref:`thumbnail` will be ignored for small video files, for which Telegram can easily generate thumbnails. However, this behaviour is undocumented and might be changed by Telegram. Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.Video`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.Video` object to send. thumbnail (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): |thumbdocstringnopath| cover (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): Cover for the video in the message. |fileinputnopath| .. versionchanged:: 21.11 start_timestamp (:obj:`int`, optional): Start timestamp for the video in the message .. versionchanged:: 21.11 width (:obj:`int`, optional): Video width. height (:obj:`int`, optional): Video height. duration (:obj:`int` | :class:`datetime.timedelta`, optional): Video duration in seconds. .. versionchanged:: v22.2 |time-period-input| supports_streaming (:obj:`bool`, optional): Pass :obj:`True`, if the uploaded video is suitable for streaming. Attributes: type (:obj:`str`): Type of the media, always :tg-const:`telegram.constants.InputPaidMediaType.VIDEO`. media (:obj:`str` | :class:`telegram.InputFile`): Video to send. thumbnail (:class:`telegram.InputFile`): Optional. |thumbdocstringbase| cover (:class:`telegram.InputFile`): Optional. Cover for the video in the message. |fileinputnopath| .. versionchanged:: 21.11 start_timestamp (:obj:`int`): Optional. Start timestamp for the video in the message .. versionchanged:: 21.11 width (:obj:`int`): Optional. Video width. height (:obj:`int`): Optional. Video height. duration (:obj:`int` | :class:`datetime.timedelta`): Optional. Video duration in seconds. .. deprecated:: v22.2 |time-period-int-deprecated| supports_streaming (:obj:`bool`): Optional. :obj:`True`, if the uploaded video is suitable for streaming. ) _durationcoverheightstart_timestampsupports_streamingr<widthNr r7FileInput | Videor<r=rVrSdurationrUrRrTr!c  st|tr$|dur |n|j}|dur|n|j}|dur|n|j}|j}nt|ddd}tjt j || d| ,t ||_||_||_t||_||_|rWt|dddnd|_||_WddS1shwYdSrM) isinstancer rVrSrQfile_idrr$r%rDrFr;r4rBr<rrUrRrT) r'r7r<rVrSrXrUrRrTr!r(r*r+r%+s"    "zInputPaidMediaVideo.__init__r>cCt|jddSNrX) attributerrQr'r*r*r+rXNzInputPaidMediaVideo.duration)NNNNNNN)r-r.r/r0r1intrboolrr%propertydtm timedeltarXr3r*r*r(r+rPsB;    #"rPcs<eZdZdZdZddddddd edBffd d ZZS) InputPaidMediaLivePhotoa The paid media to send is a live photo. .. seealso:: :wiki:`Working with Files and Media ` .. versionadded:: 22.8 Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`~telegram.Video`): Video of the live photo to send. Pass a ``file_id`` to send a file that exists on the Telegram servers (recommended). |uploadinputnopath| Sending live photos by a URL is currently unsupported. Lastly you can pass an existing :class:`telegram.Video` object to send. photo (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`~telegram.PhotoSize`): Photo of the live photo to send. Pass a ``file_id`` to send a file that exists on the Telegram servers (recommended). |uploadinputnopath| Sending live photos by a URL is currently unsupported. Lastly you can pass an existing :class:`telegram.PhotoSize` object to send. Attributes: type (:obj:`str`): Type of the media, always :tg-const:`telegram.constants.InputPaidMediaType.LIVE_PHOTO`. media (:obj:`str` | :class:`telegram.InputFile`): Video of the live photo to send. |fileinputnopath| photo (:obj:`str` | :class:`telegram.InputFile`): Photo of the live photo to send. |fileinputnopath| )photoNr r7rWrgrLr!csht|tddd}t|tddd}tjtj||d| ||_WddS1s-wYdS)NTtg_typer@rArN) rr r r$r%rDrGr;rg)r'r7rgr!r(r*r+r%rs  "z InputPaidMediaLivePhoto.__init__rOr*r*r(r+rfSsrfcseZdZdZdZdeddddddddf ddddddedBdeed edBd edBd e dBd e e dBd edBde dBddde dBdedBde dBffddZedeejBdBfddZZS)InputMediaAnimationaRepresents an animation file (GIF or H.264/MPEG-4 AVC video without sound) to be sent. Note: When using a :class:`telegram.Animation` for the :attr:`media` attribute, it will take the width, height and duration from that animation, unless otherwise specified with the optional arguments. .. seealso:: :wiki:`Working with Files and Media ` .. versionchanged:: 20.5 |removed_thumb_note| Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.Animation`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.Animation` object to send. .. versionchanged:: 13.2 Accept :obj:`bytes` as input. filename_depr (:obj:`str`, optional): Positional placeholder for keyword only parameter :paramref:`filename`. For backward compatibility. .. versionadded:: 22.8 .. deprecated:: 22.8 This parameter is deprecated, use :paramref:`filename` instead. caption (:obj:`str`, optional): Caption of the animation to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`, optional): |parse_mode| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| .. versionchanged:: 20.0 |sequenceclassargs| width (:obj:`int`, optional): Animation width. height (:obj:`int`, optional): Animation height. duration (:obj:`int` | :class:`datetime.timedelta`, optional): Animation duration in seconds. .. versionchanged:: v22.2 |time-period-input| has_spoiler (:obj:`bool`, optional): Pass :obj:`True`, if the animation needs to be covered with a spoiler animation. .. versionadded:: 20.0 thumbnail (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): |thumbdocstringnopath| .. versionadded:: 20.2 show_caption_above_media (:obj:`bool`, optional): Pass |show_cap_above_med| .. versionadded:: 21.3 Keyword Args: filename (:obj:`str`, optional): Custom file name for the animation, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the :obj:`tempfile` module. .. versionadded:: 13.1 .. versionchanged:: 22.8 This parameter is now keyword-only. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.ANIMATION`. media (:obj:`str` | :class:`telegram.InputFile`): Animation to send. caption (:obj:`str`): Optional. Caption of the animation to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. The parse mode to use for text formatting. caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| .. versionchanged:: 20.0 * |tupleclassattrs| * |alwaystuple| width (:obj:`int`): Optional. Animation width. height (:obj:`int`): Optional. Animation height. duration (:obj:`int` | :class:`datetime.timedelta`): Optional. Animation duration in seconds. .. deprecated:: v22.2 |time-period-int-deprecated| has_spoiler (:obj:`bool`): Optional. :obj:`True`, if the animation is covered with a spoiler animation. .. versionadded:: 20.0 thumbnail (:class:`telegram.InputFile`): Optional. |thumbdocstringbase| .. versionadded:: 20.2 show_caption_above_media (:obj:`bool`): Optional. |show_cap_above_med| .. versionadded:: 21.3 )rQ has_spoilerrSshow_caption_above_mediar<rVNfilenamer!r7zFileInput | Animationr5r8rVrSrXr6 filename_deprrkr<r=rlrnr!c s|dur | dur td|durttddddt|tr=|dur%|jn|}|dur.|jn|}|dur6|n|j}|j}n |p@| }t ||ddd}t j t j ||||| d| || |_||_||_t||_| |_| |_WddS1s}wYdS N6`filename_depr` and `filename` are mutually exclusive.22.8Positional passing of `filename` or keyword usage of `filename_depr` is deprecated. `filename` will become a keyword-only argument. stacklevelTrnr@rAr ) ValueErrorrrrYrrVrSrQrZrr$r%r ANIMATIONr;rBr<rrkrl)r'r7r5r8rVrSrXr6rorkr<rlrnr!effective_filenamer(r*r+r%sF    "zInputMediaAnimation.__init__r>cCr[r\r^r_r*r*r+rX$r`zInputMediaAnimation.duration)r-r.r/r0r1rr2rrarrrrbrr%rcrdrerXr3r*r*r(r+rjsZ^     <"rjcseZdZdZdZdeddddfddddddedBdeed ee dBd edBd e dBd e dBd edBde dBffddZ Z S)InputMediaPhotoa Represents a photo to be sent. .. seealso:: :wiki:`Working with Files and Media ` Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.PhotoSize`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.PhotoSize` object to send. .. versionchanged:: 13.2 Accept :obj:`bytes` as input. filename_depr (:obj:`str`, optional): Positional placeholder for keyword only parameter :paramref:`filename`. For backward compatibility. .. versionadded:: 22.8 .. deprecated:: 22.8 This parameter is deprecated, use :paramref:`filename` instead. caption (:obj:`str`, optional ): Caption of the photo to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`, optional): |parse_mode| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| .. versionchanged:: 20.0 |sequenceclassargs| has_spoiler (:obj:`bool`, optional): Pass :obj:`True`, if the photo needs to be covered with a spoiler animation. .. versionadded:: 20.0 show_caption_above_media (:obj:`bool`, optional): Pass |show_cap_above_med| .. versionadded:: 21.3 Keyword Args: filename (:obj:`str`, optional): Custom file name for the photo, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the :obj:`tempfile` module. .. versionadded:: 13.1 .. versionchanged:: 22.8 This parameter is now keyword-only. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.PHOTO`. media (:obj:`str` | :class:`telegram.InputFile`): Photo to send. caption (:obj:`str`): Optional. Caption of the photo to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. |parse_mode| caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| .. versionchanged:: 20.0 * |tupleclassattrs| * |alwaystuple| has_spoiler (:obj:`bool`): Optional. :obj:`True`, if the photo is covered with a spoiler animation. .. versionadded:: 20.0 show_caption_above_media (:obj:`bool`): Optional. |show_cap_above_med| .. versionadded:: 21.3 )rkrlNrmr7rLr5r8r6rorkrlrnr!c s|dur |dur td|durttdddd|p|} t|t| ddd}tjtj||||| d| ||_ ||_ WddS1sIwYdSrp) rxrrrr r$r%rrEr;rkrl) r'r7r5r8r6rorkrlrnr!rzr(r*r+r%os4   "zInputMediaPhoto.__init__r-r.r/r0r1rr2rrrrbrr%r3r*r*r(r+r{)s>@      r{c#seZdZdZdZdddddedddddddf ddddddedBdedBd edBd edBd e dBd e ed e e dBdedBde dBddde dBdddedBdedBde dBf fddZedeejBdBfddZZS)InputMediaVideoaRepresents a video to be sent. .. seealso:: :wiki:`Working with Files and Media ` Note: * When using a :class:`telegram.Video` for the :attr:`media` attribute, it will take the width, height and duration from that video, unless otherwise specified with the optional arguments. * :paramref:`thumbnail` will be ignored for small video files, for which Telegram can easily generate thumbnails. However, this behaviour is undocumented and might be changed by Telegram. .. versionchanged:: 20.5 |removed_thumb_note| Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.Video`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.Video` object to send. .. versionchanged:: 13.2 Accept :obj:`bytes` as input. filename_depr (:obj:`str`, optional): Positional placeholder for keyword only parameter :paramref:`filename`. For backward compatibility. .. versionadded:: 22.8 .. deprecated:: 22.8 This parameter is deprecated, use :paramref:`filename` instead. caption (:obj:`str`, optional): Caption of the video to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`, optional): |parse_mode| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| .. versionchanged:: 20.0 |sequenceclassargs| width (:obj:`int`, optional): Video width. height (:obj:`int`, optional): Video height. duration (:obj:`int` | :class:`datetime.timedelta`, optional): Video duration in seconds. .. versionchanged:: v22.2 |time-period-input| supports_streaming (:obj:`bool`, optional): Pass :obj:`True`, if the uploaded video is suitable for streaming. has_spoiler (:obj:`bool`, optional): Pass :obj:`True`, if the video needs to be covered with a spoiler animation. .. versionadded:: 20.0 thumbnail (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): |thumbdocstringnopath| .. versionadded:: 20.2 cover (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): Cover for the video in the message. |fileinputnopath| .. versionchanged:: 21.11 start_timestamp (:obj:`int`, optional): Start timestamp for the video in the message .. versionchanged:: 21.11 show_caption_above_media (:obj:`bool`, optional): Pass |show_cap_above_med| .. versionadded:: 21.3 Keyword Args: filename (:obj:`str`, optional): Custom file name for the video, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the :obj:`tempfile` module. .. versionadded:: 13.1 .. versionchanged:: 22.8 This parameter is now keyword-only. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.VIDEO`. media (:obj:`str` | :class:`telegram.InputFile`): Video file to send. caption (:obj:`str`): Optional. Caption of the video to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. |parse_mode| caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| .. versionchanged:: 20.0 * |tupleclassattrs| * |alwaystuple| width (:obj:`int`): Optional. Video width. height (:obj:`int`): Optional. Video height. duration (:obj:`int` | :class:`datetime.timedelta`): Optional. Video duration in seconds. .. deprecated:: v22.2 |time-period-int-deprecated| supports_streaming (:obj:`bool`): Optional. :obj:`True`, if the uploaded video is suitable for streaming. has_spoiler (:obj:`bool`): Optional. :obj:`True`, if the video is covered with a spoiler animation. .. versionadded:: 20.0 thumbnail (:class:`telegram.InputFile`): Optional. |thumbdocstringbase| .. versionadded:: 20.2 show_caption_above_media (:obj:`bool`): Optional. |show_cap_above_med| .. versionadded:: 21.3 cover (:class:`telegram.InputFile`): Optional. Cover for the video in the message. |fileinputnopath| .. versionchanged:: 21.11 start_timestamp (:obj:`int`): Optional. Start timestamp for the video in the message .. versionchanged:: 21.11 ) rQrRrkrSrlrTrUr<rVNrmr7rWr5rVrSrXrUr8r6rorkr<r=rlrRrTrnr!cs,| dur |dur td| durttddddt|tr=|dur$|n|j}|dur-|n|j}|dur6|n|j}|j}n | p@|}t ||ddd}t j t j |||||d|2||_||_t||_|| |_||_| |_| |_| r~t | ddd nd|_||_WddS1swYdS) NrqrrrsrtruTrwr r?)rxrrrYr rVrSrQrZrr$r%rrFr;rrBr<rUrkrlrRrT)r'r7r5rVrSrXrUr8r6rorkr<rlrRrTrnr!rzr(r*r+r%sN    "zInputMediaVideo.__init__r>cCr[r\r^r_r*r*r+rX`r`zInputMediaVideo.duration)r-r.r/r0r1rr2rarrbrrrrr%rcrdrerXr3r*r*r(r+r}slq   D"r}c sHeZdZdZdZ d dddedededBdedBffd d ZZS) InputMediaLocationaRepresents a location to be sent. .. versionadded:: 22.8 Args: latitude (:obj:`float`): Latitude of the location. longitude (:obj:`float`): Longitude of the location. horizontal_accuracy (:obj:`float`, optional): The radius of uncertainty for the location, measured in meters; 0-:tg-const:`telegram.Location.HORIZONTAL_ACCURACY`. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.LOCATION`. latitude (:obj:`float`): Latitude of the location. longitude (:obj:`float`): Longitude of the location. horizontal_accuracy (:obj:`float`): Optional. The radius of uncertainty for the location, measured in meters; 0-:tg-const:`telegram.Location.HORIZONTAL_ACCURACY`. )horizontal_accuracylatitude longitudeNr rrrr!csRtjtj|d|||_||_||_WddS1s"wYdSr9)r$r%rLOCATIONr;rrr)r'rrrr!r(r*r+r%zs  "zInputMediaLocation.__init__N) r-r.r/r0r1floatrr%r3r*r*r(r+r~esr~csneZdZdZdZ    ddddedededed edBd edBd edBd edBd edBffddZZ S)InputMediaVenueuRepresents a venue to be sent. .. versionadded:: 22.8 Args: latitude (:obj:`float`): Latitude of the location. longitude (:obj:`float`): Longitude of the location. title (:obj:`str`): Name of the venue. address (:obj:`str`): Address of the venue. foursquare_id (:obj:`str`, optional): Foursquare identifier of the venue. foursquare_type (:obj:`str`, optional): Foursquare type of the venue, if known. (For example, ``“arts_entertainment/default”``, ``“arts_entertainment/aquarium”`` or ``“food/icecream”``). google_place_id (:obj:`str`, optional): Google Places identifier of the venue. google_place_type (:obj:`str`, optional): Google Places type of the venue. (See `supported types `__) Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.VENUE`. latitude (:obj:`float`): Latitude of the location. longitude (:obj:`float`): Longitude of the location. title (:obj:`str`): Name of the venue. address (:obj:`str`): Address of the venue. foursquare_id (:obj:`str`): Optional. Foursquare identifier of the venue. foursquare_type (:obj:`str`): Optional. Foursquare type of the venue, if known. (For example, ``“arts_entertainment/default”``, ``“arts_entertainment/aquarium”`` or ``“food/icecream”``). google_place_id (:obj:`str`): Optional. Google Places identifier of the venue. google_place_type (:obj:`str`): Optional. Google Places type of the venue. (See `supported types `__) )address foursquare_idfoursquare_typegoogle_place_idgoogle_place_typerrtitleNr rrrrrrrrr!c  sptjtj| d|!||_||_||_||_||_ ||_ ||_ ||_ WddS1s1wYdSr9) r$r%rVENUEr;rrrrrrrr) r'rrrrrrrrr!r(r*r+r%s "zInputMediaVenue.__init__)NNNN) r-r.r/r0r1rr2rr%r3r*r*r(r+rs8    rc sNeZdZdZdZ d ddddddedBdedBd edBffd d ZZS) InputMediaStickeraQRepresents a sticker file to be sent. .. seealso:: :wiki:`Working with Files and Media ` .. versionadded:: 22.8 Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.Sticker`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.Sticker` object to send. emoji (:obj:`str`, optional): Emoji associated with the sticker; only for just uploaded stickers. Keyword Args: filename (:obj:`str`, optional): Custom file name for the sticker, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the :obj:`tempfile` module. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.STICKER`. media (:obj:`str` | :class:`telegram.InputFile`): Sticker file to send. emoji (:obj:`str`): Optional. Emoji associated with the sticker; only for just uploaded stickers. )emojir7Nrmr7zFileInput | Stickerrrnr!cs^t|t|ddd}tjtj|d|||_||_WddS1s(wYdS)NTrwr:) rr r$r%rSTICKERr;r7r)r'r7rrnr!r(r*r+r%s  "zInputMediaSticker.__init__rr,r*r*r(r+rs rcseZdZdZdZdeddddddfddddddedBdeed edBd edBd edBd e e dBd edBdddedBde dBffddZ e deejBdBfddZZS)InputMediaAudioa[Represents an audio file to be treated as music to be sent. .. seealso:: :wiki:`Working with Files and Media ` Note: When using a :class:`telegram.Audio` for the :attr:`media` attribute, it will take the duration, performer and title from that video, unless otherwise specified with the optional arguments. .. versionchanged:: 20.5 |removed_thumb_note| Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.Audio`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.Audio` object to send. .. versionchanged:: 13.2 Accept :obj:`bytes` as input. filename_depr (:obj:`str`, optional): Positional placeholder for keyword only parameter :paramref:`filename`. For backward compatibility. .. versionadded:: 22.8 .. deprecated:: 22.8 This parameter is deprecated, use :paramref:`filename` instead. caption (:obj:`str`, optional): Caption of the audio to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`, optional): |parse_mode| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| .. versionchanged:: 20.0 |sequenceclassargs| duration (:obj:`int` | :class:`datetime.timedelta`, optional): Duration of the audio in seconds as defined by the sender. .. versionchanged:: v22.2 |time-period-input| performer (:obj:`str`, optional): Performer of the audio as defined by the sender or by audio tags. title (:obj:`str`, optional): Title of the audio as defined by the sender or by audio tags. thumbnail (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): |thumbdocstringnopath| .. versionadded:: 20.2 Keyword Args: filename (:obj:`str`, optional): Custom file name for the audio, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the :obj:`tempfile` module. .. versionadded:: 13.1 .. versionchanged:: 22.8 This parameter is now keyword-only. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.AUDIO`. media (:obj:`str` | :class:`telegram.InputFile`): Audio file to send. caption (:obj:`str`): Optional. Caption of the audio to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. |parse_mode| caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| .. versionchanged:: 20.0 * |tupleclassattrs| * |alwaystuple| duration (:obj:`int` | :class:`datetime.timedelta`): Optional. Duration of the audio in seconds. .. deprecated:: v22.2 |time-period-int-deprecated| performer (:obj:`str`): Optional. Performer of the audio as defined by the sender or by audio tags. title (:obj:`str`): Optional. Title of the audio as defined by the sender or by audio tags. thumbnail (:class:`telegram.InputFile`): Optional. |thumbdocstringbase| .. versionadded:: 20.2 )rQ performerr<rNrmr7zFileInput | Audior5r8rXrrr6ror<r=rnr!c  s|dur | dur td|durttddddt|tr=|dur$|n|j}|dur.|jn|}|dur7|jn|}|j}n |p@| } t || ddd}t j t j ||||| d||| |_t||_||_||_WddS1swwYdSrp)rxrrrYrrQrrrZrr$r%rAUDIOr;rBr<r) r'r7r5r8rXrrr6ror<rnr!rzr(r*r+r%QsB    "zInputMediaAudio.__init__r>cCr[r\r^r_r*r*r+rXr`zInputMediaAudio.duration)r-r.r/r0r1rr2rrrrrr%rcrardrerXr3r*r*r(r+rsNS   8"rcseZdZdZdZdeddddfddddddedBdeed edBd e e dBd edBd d dedBde dBffddZ Z S)InputMediaDocumenta Represents a general file to be sent. .. seealso:: :wiki:`Working with Files and Media ` .. versionchanged:: 20.5 |removed_thumb_note| Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`telegram.Document`): File to send. |fileinputnopath| Lastly you can pass an existing :class:`telegram.Document` object to send. .. versionchanged:: 13.2 Accept :obj:`bytes` as input. filename_depr (:obj:`str`, optional): Positional placeholder for keyword only parameter :paramref:`filename`. For backward compatibility. .. versionadded:: 22.8 .. deprecated:: 22.8 This parameter is deprecated, use :paramref:`filename` instead. caption (:obj:`str`, optional): Caption of the document to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`, optional): |parse_mode| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| .. versionchanged:: 20.0 |sequenceclassargs| disable_content_type_detection (:obj:`bool`, optional): Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always :obj:`True`, if the document is sent as part of an album. thumbnail (:term:`file object` | :obj:`bytes` | :class:`pathlib.Path` | :obj:`str`, optional): |thumbdocstringnopath| .. versionadded:: 20.2 Keyword Args: filename (:obj:`str`, optional): Custom file name for the document, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the :obj:`tempfile` module. .. versionadded:: 13.1 .. versionchanged:: 22.8 This parameter is now keyword-only. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.DOCUMENT`. media (:obj:`str` | :class:`telegram.InputFile`): File to send. caption (:obj:`str`): Optional. Caption of the document to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. |parse_mode| caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| .. versionchanged:: 20.0 * |tupleclassattrs| * |alwaystuple| disable_content_type_detection (:obj:`bool`): Optional. Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always :obj:`True`, if the document is sent as part of an album. thumbnail (:class:`telegram.InputFile`): Optional. |thumbdocstringbase| .. versionadded:: 20.2 )disable_content_type_detectionr<Nrmr7zFileInput | Documentr5r8rr6ror<r=rnr!c s|dur |dur td|durttdddd|p|} t|t| ddd}tjtj||||| d| | ||_ ||_ WddS1sLwYdSrp) rxrrrr r$r%rDOCUMENTr;rBr<r) r'r7r5r8rr6ror<rnr!rzr(r*r+r%s4    "zInputMediaDocument.__init__)r-r.r/r0r1rr2rrbrrrr%r3r*r*r(r+rs>C     rcsteZdZdZdZdedddfddddddd edBd eed ee dBd e dBd e dBde dBffddZ Z S)InputMediaLivePhotoa Represents a live photo to be sent. .. seealso:: :wiki:`Working with Files and Media ` .. versionadded:: 22.8 Args: media (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`~telegram.Video`): Video of the live photo to send. Pass a ``file_id`` to send a file that exists on the Telegram servers (recommended). |uploadinputnopath| Sending live photos by a URL is currently unsupported. Lastly you can pass an existing :class:`telegram.Video` object to send. photo (:obj:`str` | :term:`file object` | :class:`~telegram.InputFile` | :obj:`bytes` | :class:`pathlib.Path` | :class:`~telegram.PhotoSize`): The static photo to send. Pass a ``file_id`` to send a file that exists on the Telegram servers (recommended). |uploadinputnopath| Sending live photos by a URL is currently unsupported. Lastly you can pass an existing :class:`telegram.PhotoSize` object to send. caption (:obj:`str`, optional): Caption of the live photo to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`, optional): |parse_mode| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): |caption_entities| show_caption_above_media (:obj:`bool`, optional): Pass |show_cap_above_med| has_spoiler (:obj:`bool`, optional): Pass :obj:`True`, if the video needs to be covered with a spoiler animation. Attributes: type (:obj:`str`): :tg-const:`telegram.constants.BaseInputMediaType.LIVE_PHOTO`. media (:obj:`str` | :class:`telegram.InputFile`): Video of the live photo to send. photo (:obj:`str` | :class:`telegram.InputFile`): The static photo to send. caption (:obj:`str`): Optional. Caption of the live photo to be sent, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters after entities parsing. parse_mode (:obj:`str`): Optional. |parse_mode| caption_entities (tuple[:class:`telegram.MessageEntity`]): Optional. |captionentitiesattr| show_caption_above_media (:obj:`bool`): Optional. |show_cap_above_med| has_spoiler (:obj:`bool`): Optional. :obj:`True`, if the video is covered with a spoiler animation. )rkrgrlNr r7rWrgrLr5r8r6rlrkr!c szt|tddd}t|tddd}tjtj|||||d|||_||_ ||_ WddS1s6wYdS)NTrhr ) rr r r$r%rrGr;rgrlrk) r'r7rgr5r8r6rlrkr!r(r*r+r%.s  "zInputMediaLivePhoto.__init__r|r*r*r(r+rs6(   rInputPollMediaInputPollOptionMedia)Er0datetimerdcollections.abcrtypingrrrtelegramrtelegram._files.animationrtelegram._files.audiortelegram._files.documentr telegram._files.inputfiler telegram._files.photosizer telegram._files.stickerr telegram._files.videor telegram._messageentityrtelegram._telegramobjectrtelegram._utilsrtelegram._utils.argumentparsingrrtelegram._utils.datetimertelegram._utils.defaultvaluertelegram._utils.filesrtelegram._utils.typesrrrtelegram._utils.warningsrtelegram.constantsrtelegram.warningsrrrr4rDrKrPrfrjr{r}r~rrrrrrrJrr*r*r*r+s                   M0n-*uH$E-uI