
    i9                         S SK r S SKrS SKrS SKJr  S SKJrJrJrJrJ	r	  S SK
r
S SK
JrJrJrJrJr  S SKJr  S SKJr  \ R(                  " \5      r " S S5      rg)	    N)datetime)BinaryIOCallableListOptionalUnion)StopTransmissionenumsrawtypesutils)FilePartMissing)FileTypec            @          \ rS rSr                           S+SSS\\\4   S\\\4   S\\\4   S	\S
\S   S\	S   S\S\
S\
S\S\S\SSS\S\S\
S\S\
S\SSS\S   S \S!\S"\S#\\\4   S$\S%\S&\	S   S'\S(\S)   4>S* jjrSrg),SendDocument    N selfzpyrogram.Clientchat_iddocumentthumbcaption
parse_modezenums.ParseModecaption_entitiesztypes.MessageEntity	file_nameforce_documentdisable_notificationmessage_thread_iddirect_messages_topic_id	effect_idreply_parametersztypes.ReplyParametersschedule_daterepeat_periodprotect_contentbusiness_connection_idallow_paid_broadcastpaid_message_star_countsuggested_post_parametersztypes.SuggestedPostParametersreply_markup)ztypes.InlineKeyboardMarkupztypes.ReplyKeyboardMarkupztypes.ReplyKeyboardRemoveztypes.ForceReplyprogressprogress_argsreply_to_message_idreply_to_chat_idreply_to_story_id
quote_textquote_entitiesquote_offsetreturnztypes.Messagec                   #    [        USLUSLUSLUSLUSLUSL45      (       a  Ub  [        R                  S5        Ub  [        R                  S5        Ub  [        R                  S5        Ub  [        R                  S5        Ub  [        R                  S5        Ub  [        R                  S5        [        R                  " UUUUUUUS9nSn [        U[        5      (       Ga<  [        R                  R                  U5      (       a  U R                  U5      I Sh  vN nU R                  UUUS	9I Sh  vN n[        R                  R                  U R                  U5      =(       d    S
UU=(       d    SU[        R                  R                  U=(       d    [        R                  R                  U5      S9/S9nGO[         R"                  " SU5      (       a  [        R                  R%                  US9nO[&        R(                  " U[*        R,                  5      nOU R                  U5      I Sh  vN nU R                  UUUS	9I Sh  vN n[        R                  R                  U R                  U=(       d    UR.                  5      =(       d    S
UU[        R                  R                  U=(       d    UR.                  S9/S9n  U R1                  U5      I Sh  vN n U R3                  [        R4                  R6                  R8                  " SU UU	=(       d    S[&        R:                  " U UU
U5      I Sh  vN U R=                  5       [&        R>                  " U5      UUUU(       a  URA                  U 5      I Sh  vN OSUUU(       a  URA                  5       OSS.[&        RB                  " XXV5      I Sh  vN D6US9I Sh  vN n![&        RD                  " U U!S9I Sh  vN n"U"(       a  U"S   $ S$  GN GN GN GN GN( N N NO ND N)! [F         a8  n#U R                  UURH                  U#RJ                  S9I Sh  vN     Sn#A#OSn#A#ff = fGM  ! [L         a     gf = f7f)a  Send generic files.

.. include:: /_includes/usable-by/users-bots.rst

Parameters:
    chat_id (``int`` | ``str``):
        Unique identifier (int) or username (str) of the target chat.
        For your personal cloud (Saved Messages) you can simply use "me" or "self".
        For a contact that exists in your Telegram address book you can use his phone number (str).

    document (``str`` | ``BinaryIO``):
        File to send.
        Pass a file_id as string to send a file that exists on the Telegram servers,
        pass an HTTP URL as a string for Telegram to get a file from the Internet,
        pass a file path as string to upload a new file that exists on your local machine, or
        pass a binary file-like object with its attribute ".name" set for in-memory uploads.

    thumb (``str`` | ``BinaryIO``, *optional*):
        Thumbnail of the file sent.
        The thumbnail should be in JPEG format and less than 200 KB in size.
        A thumbnail's width and height should not exceed 320 pixels.
        Thumbnails can't be reused and can be only uploaded as a new file.

    caption (``str``, *optional*):
        Document caption, 0-1024 characters.

    parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
        By default, texts are parsed using both Markdown and HTML styles.
        You can combine both syntaxes together.

    caption_entities (List of :obj:`~pyrogram.types.MessageEntity`):
        List of special entities that appear in the caption, which can be specified instead of *parse_mode*.

    file_name (``str``, *optional*):
        File name of the document sent.
        Defaults to file's path basename.

    force_document (``bool``, *optional*):
        Pass True to force sending files as document. Useful for video files that need to be sent as
        document messages instead of video messages.
        Defaults to False.

    disable_notification (``bool``, *optional*):
        Sends the message silently.
        Users will receive a notification with no sound.

    message_thread_id (``int``, *optional*):
        Unique identifier for the target message thread (topic) of the forum.
        For forums only.

    direct_messages_topic_id (``int``, *optional*):
        Unique identifier of the topic in a channel direct messages chat administered by the current user.
        For directs only only.

    effect_id (``int``, *optional*):
        Unique identifier of the message effect.
        For private chats only.

    reply_parameters (:obj:`~pyrogram.types.ReplyParameters`, *optional*):
        Describes reply parameters for the message that is being sent.

    schedule_date (:py:obj:`~datetime.datetime`, *optional*):
        Date when the message will be automatically sent.

    repeat_period (``int``, *optional*):
        Period after which the message will be sent again in seconds.

    protect_content (``bool``, *optional*):
        Protects the contents of the sent message from forwarding and saving.

    business_connection_id (``str``, *optional*):
        Unique identifier of the business connection on behalf of which the message will be sent.

    allow_paid_broadcast (``bool``, *optional*):
        If True, you will be allowed to send up to 1000 messages per second.
        Ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message.
        The relevant Stars will be withdrawn from the bot's balance.
        For bots only.

    paid_message_star_count (``int``, *optional*):
        The number of Telegram Stars the user agreed to pay to send the messages.

    suggested_post_parameters (:obj:`~pyrogram.types.SuggestedPostParameters`, *optional*):
        Information about the suggested post.

    reply_markup (:obj:`~pyrogram.types.InlineKeyboardMarkup` | :obj:`~pyrogram.types.ReplyKeyboardMarkup` | :obj:`~pyrogram.types.ReplyKeyboardRemove` | :obj:`~pyrogram.types.ForceReply`, *optional*):
        Additional interface options. An object for an inline keyboard, custom reply keyboard,
        instructions to remove reply keyboard or to force a reply from the user.

    progress (``Callable``, *optional*):
        Pass a callback function to view the file transmission progress.
        The function must take *(current, total)* as positional arguments (look at Other Parameters below for a
        detailed description) and will be called back each time a new file chunk has been successfully
        transmitted.

    progress_args (``tuple``, *optional*):
        Extra custom arguments for the progress callback function.
        You can pass anything you need to be available in the progress callback scope; for example, a Message
        object or a Client instance in order to edit the message with the updated progress status.

Other Parameters:
    current (``int``):
        The amount of bytes transmitted so far.

    total (``int``):
        The total size of the file.

    *args (``tuple``, *optional*):
        Extra custom arguments as defined in the ``progress_args`` parameter.
        You can either keep ``*args`` or add every single extra argument in your function signature.

Returns:
    :obj:`~pyrogram.types.Message` | ``None``: On success, the sent document message is returned, otherwise, in
    case the upload is deliberately stopped with :meth:`~pyrogram.Client.stop_transmission`, None is returned.

Example:
    .. code-block:: python

        # Send document by uploading from local file
        await app.send_document("me", "document.zip")

        # Add caption to the document file
        await app.send_document("me", "document.zip", caption="document caption")

        # Keep track of the progress while uploading
        async def progress(current, total):
            print(f"{current * 100 / total:.1f}%")

        await app.send_document("me", "document.zip", progress=progress)
Nzj`reply_to_message_id` is deprecated and will be removed in future updates. Use `reply_parameters` instead.zg`reply_to_chat_id` is deprecated and will be removed in future updates. Use `reply_parameters` instead.zh`reply_to_story_id` is deprecated and will be removed in future updates. Use `reply_parameters` instead.za`quote_text` is deprecated and will be removed in future updates. Use `reply_parameters` instead.ze`quote_entities` is deprecated and will be removed in future updates. Use `reply_parameters` instead.zc`quote_offset` is deprecated and will be removed in future updates. Use `reply_parameters` instead.)
message_idr   story_idquotequote_parse_moder0   quote_position)r*   r+   zapplication/zip)r   )	mime_typefile
force_filer   
attributesz
^https?://)url)r9   r:   r   r<   )peermediasilentreply_to	random_idr"   schedule_repeat_period
noforwardsallow_paid_floodskipr)   effectallow_paid_starssuggested_post)r%   )clientmessagesr   )file_id	file_partr   )'anylogwarningr   ReplyParameters
isinstancestrospathisfile	save_filer   InputMediaUploadedDocumentguess_mime_typeDocumentAttributeFilenamebasenamerematchInputMediaDocumentExternalr   get_input_media_from_file_idr   DOCUMENTnameresolve_peerinvoke	functionsrJ   	SendMediaget_reply_tornd_iddatetime_to_timestampwriteparse_text_entitiesparse_messagesr   idvaluer	   )$r   r   r   r   r   r   r   r   r   r   r   r   r    r!   r"   r#   r$   r%   r&   r'   r(   r)   r*   r+   r,   r-   r.   r/   r0   r1   r:   r?   r>   rrJ   es$                                       T/app/mltbenv/lib/python3.13/site-packages/pyrogram/methods/messages/send_document.pysend_documentSendDocument.send_document!   s2    P #4/ ,!-$&d*D(	
 	
 #. A  +} !,~ %w ){ 'y  %44.(* !+-+  B	(C((77>>(++"&.."77E!%8[h!iiDII@@"&"6"6x"@"UDU!#1#9T#II??)JqWYW^W^WgWghpWq?r$ A E XXlH55II@@$ A E ">>xIZIZ[E"nnU33!^^HxWd^ee		<<"2293MNcRc		;;iF`S[S`S`;a 	 =  =!%!2!27!;;D"kk..88 !%"'#7#?4+0+=+= $ 0 1 8	, & '+kkm*/*E*Em*T3@'61EKW|/A/A$/G)G)G]a#,-DPi+D+J+J+Los%& %*$=$=dZ$jj'* 0F- *  A6 &+%9%9PQ%RRH*28A;<<{ 8i" 4e <& *H k)6  S ' W..477agg.VVVW7 B   		s%  CQ3AQ#  P!Q# 9P:C>Q# 8P9Q# PA?Q# P &P'AP PAP 	P 
;P PP PP Q# /P0Q# ?Q3 Q# Q3Q# Q# Q# Q# P P P P P Q# 
Q%(QQQQ# QQ# #
Q0-Q3/Q00Q3)N NNNNNNNNNNNNNNNNNNr   NNNNNN)__name__
__module____qualname____firstlineno__r   intrR   r   r   r   boolr   r   tuplerp   __static_attributes__r       ro   r   r       s   
 '+268<#%)!%(,48"&! $&*%)'+EI !!#',0!%6: I^^sCx^ X&^ S(]#	^
 ^ ./^ 45^ ^ ^ #^ ^ #&^ ^ 2^  ^  !^" #^$ !$%^& #'^( "%)^* $C+^, 
-^8 9^: ;^> !?^@  S/A^B C^D E^F 23G^H I^J 
/	"K^ ^r{   r   )loggingrS   r[   r   typingr   r   r   r   r   pyrogramr	   r
   r   r   r   pyrogram.errorsr   pyrogram.file_idr   	getLoggerrs   rN   r   r   r{   ro   <module>r      sD   &  	 	  < <  ? ? + %!_ _r{   