/jUdZddlZddlmZddlmZmZmZddl 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(m2Z2GddeZ3Gdde3Z4GddeZ5Gdd e5Z6Gd!d"e5Z7Gd#d$e5Z8Gd%d&e4Z9Gd'd(e4Z:Gd)d*e4Z;Gd+d,e3Z<Gd-d.e3Z=Gd/d0e3Z>Gd1d2e4Z?Gd3d4e4Z@Gd5d6e4ZAe9e?ze@zeAzeze=ze;zZDeeCd8<y)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) FileInputc<eZdZdZdZdddededzffdZxZS)_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#czt||tjtj |||_yNr")super__init__r get_memberrrr!)selfr$r# __class__s X/var/www/html/maxservice/venv/lib/python3.12/site-packages/telegram/_files/inputmedia.pyr(z_BaseInputMedia.__init__?s0 J/)E)EzS]^ __name__ __module__ __qualname____doc__ __slots__strrr( __classcell__r+s@r,r r 2s8I '+ __tO __r-r ceZdZdZdZddefdddedeezdedzdee dzd e ed e dzf fd Z e d d deezdzfdZxZS) 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$r;r9r:r<r#ct||||j5||_||_t ||_||_dddy#1swYyxYwNr$r#)r'r( _unfrozenr;r9rr:r<)r*r$r;r9r:r<r#r+s r,r(zInputMedia.__init__zsY J:F ^^  8*/DJ'.DL?QRb?cD !-7DO  8 8 8s &AA thumbnailFileInput | Nonereturnc&|t|ddS|S)NTattach local_moder)rAs r,_parse_thumbnail_inputz!InputMedia._parse_thumbnail_inputs' $ Yt E  r-)r/r0r1r2r3rr4r rrrrr( staticmethodrHr5r6s@r,r8r8Is,\GI #;?$0 8'+88Y8t 8 #=1D8 8 SM 8tO8" *< ySWAW  r-r8ceZdZUdZej j Zeee d< ej jZ eee d< ej jZ eee d< dZ ddded ee zd edzffd ZxZS) 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)r;r!Nr"r!r;r#ct||tjtj |||_||_|jyr&) r'r(rr)rInputPaidMediaTyper!r;_freeze)r*r!r;r#r+s r,r(zInputPaidMedia.__init__s? J/)E)EtTR &+  r-)r/r0r1r2rrPrLrr4__annotations__rMrNr3r rr(r5r6s@r,rKrKs*"44::E5::>!44::E5::>&99DDJc D "I'+  Y  tO  r-rKc<eZdZdZdZdddddedzffdZxZS) 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. Nr"r;FileInput | PhotoSizer#ct|tdd}t| tj |||j yNTrEr!r;r#)rr r'r(rKrLrQ)r*r;r#r+s r,r(zInputPaidMediaPhoto.__init__s8 ! $4P n22%JW r-r/r0r1r2r3rr(r5r6s@r,rTrTs4"I '+ &tO r-rTceZdZdZdZ dddddddd edzd edzd edzd edzd ddedzdedzffdZ e dee jzdzfdZ xZS)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_streamingrAwidthNr"r;FileInput | VideorArBrbr_durationrar^r`r#c t|tr=||n |j}||n |j}||n |j}|j }nt |dd}t |!tj|| |j5tj||_||_||_t||_||_|rt |ddnd|_||_dddy#1swYyxYwrX) isinstancerrbr_r]file_idrr'r(rKrMr@r8rHrArrar^r`) r*r;rArbr_rdrar^r`r#r+s r,r(zInputPaidMediaVideo.__init__+s eU #".EEKKE%1Vu||F#+#7xU__HMME%U4DIE n22%JW ^^  ?5?5V5VW`5aDN%*DJ&,DK3?3IDN3ED #IN tETX J0?D  ? ? ?s AC44C=rCc0t|jdSNrd) attributerr]r*s r,rdzInputPaidMediaVideo.durationN"4>>ZHHr-)NNNNNNN)r/r0r1r2r3intrboolrr(propertydtm timedeltardr5r6s@r,r\r\s9vI)- !&**.$(&*!?'+!?"!?&!?Tz !? d !? t# !?!4K!?"!?t!?tO!?FI# -4IIr-r\c@eZdZdZdZddddddd edzffd ZxZS) 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"r;rcrurVr#ct|tdd}t|tdd}t|t j |||j5||_dddy#1swYyxYw)NTtg_typerFrGrY) rrr r'r(rKrNr@ru)r*r;rur#r+s r,r(z InputPaidMediaLivePhoto.__init__rsg!dtT  $SWX n77uQ[\ ^^  0*/DJ 0 0 0s A))A2rZr6s@r,rtrtSs>8I'+ 0" 0' 0 tO 0 0r-rtceZdZdZdZdeddddddddf ddddddedzdeed edzd edzd e dzd e e dzd edzde dzddde dzdedzde dzffdZedeej"zdzfdZxZS)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 )r] has_spoilerr_show_caption_above_mediarArbNfilenamer#r;zFileInput | Animationr9r<rbr_rdr: filename_deprr{rArBr|r~r#c .| | td|ttdddt|tr=| |j n|}| |j n|}||n |j}|j}n|xs| }t||dd}t|-tj||||| |j5|j| |_||_||_t#||_| |_| |_dddy#1swYyxYw 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. stacklevelTr~rFrGr") ValueErrorrrrfrrbr_r]rgrr'r(r ANIMATIONr@rHrArr{r|)r*r;r9r<rbr_rdr:rr{rAr|r~r#effective_filenamer+s r,r(zInputMediaAnimation.__init__s2&  $)=UV V  $ %V    eY '#(=EKKeE%+^U\\F#+#7xU__HMME"/!:( $ 24DE   ( (    !  ^^  R595P5PQZ5[DN%*DJ&,DK3?3IDN,7D 9QD )  R R Rs ?AD  DrCc0t|jdSrirkrls r,rdzInputMediaAnimation.duration$rmr-)r/r0r1r2r3rr4rrnrrrrorr(rprqrrrdr5r6s@r,rzrzs2\|I#$0 !&*;?$(#'(,04:R $&*#:R&:Rt:RSM :R Tz :R d :Rt#:R#=1D8:RTz:RD[:R&:R#'+:R *!:R"tO#:RxI# -4IIr-rzceZdZdZdZdeddddfddddddedzdeed ee dzd edzd e dzd e dzd edzde dzffdZ xZ 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 )r{r|Nr}r;rVr9r<r:rr{r|r~r#c6| | td|ttddd|xs|} t|t| dd}t |tj||||| |j5||_ ||_ dddy#1swYyxYwr) rrrrr r'r(rrLr@r{r|) r*r;r9r<r:rr{r|r~r#rr+s r,r(zInputMediaPhoto.__init__os  $)=UV V  $ %V   +6h 9'9$SW    $ $    !  ^^  R,7D 9QD ) R R Rs 7BBr/r0r1r2r3rr4rrrrorr(r5r6s@r,rr)s>@I#$0;?$(#'04,R $&*,R&,Rt,RSM ,R #=1D8 ,RTz,RD[,R#'+,R*,RtO,R,Rr-rc#eZdZdZdZdddddedddddddf ddddddedzdedzd edzd edzd e dzd e ed e e dzdedzde dzddde dzdddedzdedzde dzf fdZedeej"zdzfdZxZS)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 ) r]r^r{r_r|r`rarArbNr}r;rcr9rbr_rdrar<r:rr{rArBr|r^r`r~r#cx| | td| ttdddt|tr=||n |j }||n |j }||n |j}|j}n| xs|}t||dd}t|-tj||||||j5||_||_t||_|j!| |_||_| |_| |_| rt| dd nd|_||_dddy#1swYyxYw) NrrrrrTrr"rE)rrrrfrrbr_r]rgrr'r(rrMr@rrHrArar{r|r^r`)r*r;r9rbr_rdrar<r:rr{rAr|r^r`r~r#rr+s r,r(zInputMediaVideo.__init__s[,  $)=UV V  $ %V    eU #".EEKKE%1Vu||F#+#7xU__HMME"/!:( $ 24DE   $ $    !  ^^  ?%*DJ&,DK3?3IDN595P5PQZ5[DN3ED #,7D 9QD )IN tETX J0?D  ? ? ?s ?A(D00D9rCc0t|jdSrirkrls r,rdzInputMediaVideo.duration`rmr-)r/r0r1r2r3rr4rnrrorrrrr(rprqrrrdr5r6s@r,rrsdob I# !&**.$0;?$(#'(,04$(&*#B?& $&*)B?"B?tB?Tz B? d B? t# B?!4KB?SMB?#=1D8B?TzB?D[B?&B?#'+B? "!B?"t#B?&*'B?(tO)B?HI# -4IIr-rc NeZdZdZdZ d dddedededzdedzffd ZxZS) 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#ct|tj||j 5||_||_||_dddy#1swYyxYwr>)r'r(rLOCATIONr@rrr)r*rrrr#r+s r,r(zInputMediaLocation.__init__zsW $6$?$?JW ^^  I#+DM$-DN5HD $ I I Is AAN) r/r0r1r2r3floatrr(r5r6s@r,rres^$AI -1 I '+ I I I#T\ I tO I Ir-rczeZdZdZdZ ddddedededed edzd edzd edzd edzd edzffdZxZ 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 t |tj| |j 5||_||_||_||_||_ ||_ ||_ ||_ dddy#1swYyxYwr>) r'r(rVENUEr@rrrrrrrr) r*rrrrrrrrr#r+s r,r(zInputMediaVenue.__init__s} $6$<$<T ^^  C#+DM$-DN#DJ 'DL-:D />D />D 1BD " C C Cs 9A33A<)NNNN) r/r0r1r2r3rr4rr(r5r6s@r,rrs@ I"%)&*&*(,C'+CCC C  C Tz CtCtC:CtOCCr-rc VeZdZdZdZ d ddddddedzdedzd edzffd ZxZS) 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. )emojir;Nr}r;zFileInput | Stickerrr~r#ct|t|dd}t| tj ||j 5||_||_dddy#1swYyxYw)NTrr?) rr r'r(rSTICKERr@r;r)r*r;rr~r#r+s r,r(zInputMediaSticker.__init__s^!(4\`a $6$>$>:V ^^  +*/DJ%*DJ + + +s AA&rr.r6s@r,rrs]4#I ! + $&* +$ +Tz + * + tO + +r-rceZdZdZdZdeddddddfddddddedzdeed edzd edzd edzd e e dzd edzdddedzde dzffdZ e deej zdzfdZxZS)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 )r] performerrArNr}r;zFileInput | Audior9r<rdrrr:rrArBr~r#c | | td|ttdddt|tr=||n |j }| |j n|}| |jn|}|j}n|xs| } t|| dd}t |-tj||||| |j5|j| |_t#||_||_||_dddy#1swYyxYwr)rrrrfr r]rrrgrr'r(rAUDIOr@rHrAr)r*r;r9r<rdrrr:rrAr~r#rr+s r,r(zInputMediaAudio.__init__Qs"  $)=UV V  $ %V    eU ##+#7xU__H+4+<)I#(=EKKeEMME"/!:( $ 24DE   $ $    !  ^^  3595P5PQZ5[DN3?3IDN%*DJ)2DN  3 3 3s ?5C==DrCc0t|jdSrirkrls r,rdzInputMediaAudio.durationrmr-)r/r0r1r2r3rr4rrrrrr(rprnrqrrrdr5r6s@r,rrsQfAI #$0&* $ ;?$((,63 $&*63"63t63SM 63 t# 63 : 63Tz63#=1D863Tz63&63*63tO63pI# -4IIr-rceZdZdZdZdeddddfddddddedzdeed edzd e e dzd edzd d dedzde dzffdZ xZ 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_detectionrANr}r;zFileInput | Documentr9r<rr:rrArBr~r#cT| | td|ttddd|xs|} t|t| dd}t |tj||||| |j5|j||_ ||_ dddy#1swYyxYwr) rrrrr r'r(rDOCUMENTr@rHrAr) r*r;r9r<rr:rrAr~r#rr+s r,r(zInputMediaDocument.__init__s  $)=UV V  $ %V   +6h 8&8RV    ' '    !  ^^  ^595P5PQZ5[DN?]D / ^ ^ ^s 7BB')r/r0r1r2r3rr4rrorrrr(r5r6s@r,rrsAF@I #$06:;?$((,,^ $&*,^%,^t,^SM ,^ )-t ,^ #=1D8 ,^Tz,^&,^*,^tO,^,^r-rceZdZdZdZdedddfddddddd edzd eed ee dzd e dzd e dzde dzffdZ xZ 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. )r{rur|Nr"r;rcrurVr9r<r:r|r{r#c t|tdd}t|tdd}t |t j ||||||j5||_||_ ||_ dddy#1swYyxYw)NTrwr") rrr r'r(rrNr@rur|r{) r*r;rur9r<r:r|r{r#r+s r,r(zInputMediaLivePhoto.__init__.s!dtT  $SWX   ) )    !  ^^  8*/DJ9QD ),7D  8 8 8s A::Brr6s@r,rrs&PEI #$0;?04#'8'+8"8'8t 8 SM 8 #=1D8 8#'+8D[8tO88r-rInputPollMediaInputPollOptionMedia)Er2datetimerqcollections.abcrtypingrrrtelegramrtelegram._files.animationrtelegram._files.audior telegram._files.documentr telegram._files.inputfiler telegram._files.photosizer telegram._files.stickerr telegram._files.videortelegram._messageentityrtelegram._telegramobjectrtelegram._utilsrtelegram._utils.argumentparsingrrtelegram._utils.datetimertelegram._utils.defaultvaluertelegram._utils.filesrtelegram._utils.typesrrrtelegram._utils.warningsrtelegram.constantsrtelegram.warningsrrr r8rKrTr\rtrzrrrrrrrrrrRrrUr-r,rs&%$22/'-//+'13 L852@@)13/_n_.J J Z-^-`.>kI.kI\*0n*0ZfI*fIRrRjrRjDIjDIN!I!IHBCoBCJ*+*+ZPIjPIfr^r^jE8*E8R            ir-