.hSJddlZddlZddlZddlmZmZmZmZmZm Z ddl Z ddl m Z ddl mZddlZddlZddlmZddlmZmZmZmZmZmZmZ ddlZdZej@dZ!ejDZ#gd Z$gd Z%gd Z&Gd d ejNZ(GddZ)GddZ*GddZ+dZ,de-de.fdZ/de-de e-dffdZ0de-de-xsdfdZ1de-dejdde-fdZ3de-de4dee-fdZ5efde-de4dee-fdZ6de-dee-fdZ7d:d ejpd!e.de-fd"Z9d;d#ee-ee-effd$e4dejtfd%Z;d&Zd)Z?d:d*Z@d.decorator..wrappersR1$1&1 1rwr)rrs` rv decoratorzasync_dec..decorators 2rwr)rs rv async_decrs  rwrreturnc*|y|jdS)z Checks if `text` is a command. Telegram chat commands start with the '/' character. :param text: Text to check. :type text: :obj:`str` :return: True if `text` is a command, else False. :rtype: :obj:`bool` F/) startswithrs rv is_commandrs |E ??3 rwcr|yt|r(|jdjddddSdS)av Extracts the command from `text` (minus the '/') if `text` is a command (see is_command). If `text` is not a command, this function returns None. .. code-block:: python3 :caption: Examples: extract_command('/help'): 'help' extract_command('/help@BotName'): 'help' extract_command('/search black eyed peas'): 'search' extract_command('Good day to you'): None :param text: String to extract the command from :type text: :obj:`str` :return: the command if `text` is a command (according to is_command), else None. :rtype: :obj:`str` or :obj:`None` Nr@ra)rsplitrs rvextract_commandrs>& |D0:40@4::<?  %a ( ,JdJrwctjdtj}|j|}t |r|j dSdS)a Returns the argument after the command. .. code-block:: python3 :caption: Examples: extract_arguments("/get name"): 'name' extract_arguments("/get"): '' extract_arguments("/get@botName name"): 'name' :param text: String to extract the arguments from a command :type text: :obj:`str` :return: the arguments if `text` is a command (according to is_command), else None. :rtype: :obj:`str` or :obj:`None` z/\w*(@\w*)*\s*([\s\S]*)rN)recompile IGNORECASEmatchrgroup)rregexprs rvextract_argumentsrsA"ZZ2BMM BF \\$ F(.6<<?8D8rwrcd}d}|j}t|}d}|D]Q}|dzdk7rB||jk(r|}n ||jz |jk(r|}n|dk\r|dz }n|dz }|dz }S|||j S)a Returns the content of the entity. :param text: The text of the message the entity belongs to :type text: :obj:`str` :param e: The entity to extract :type e: :obj:`MessageEntity` :return: The content of the entity :rtype: :obj:`str` rrra)encodelenoffsetlengthdecode)rrrrt encoded_textendibytes rvextract_entityrsF E;;=L l C A 4KD !!(("ahh.t|! !  Q c " ) ) ++rwchars_per_stringc`tdt||Dcgc] }||||z c}Scc}w)a Splits one string into multiple strings, with a maximum amount of `chars_per_string` characters per string. This is very useful for splitting one giant message into multiples. :param text: The text to split :type text: :obj:`str` :param chars_per_string: The number of characters per line the text is split into. :type chars_per_string: :obj:`int` :return: The splitted text as a list of strings. :rtype: :obj:`list` of :obj:`str` r)rr)rrrs rv split_stringr9s9383t9FV2W X2WQD1'' (2W XX Xs+c$dtdtffd }|tkDrt}g} t||kr|j||S|d|dvr |dndvr |dn dvr|d|j|td}l)aT Splits one string into multiple strings, with a maximum amount of `chars_per_string` characters per string. This is very useful for splitting one giant message into multiples. If `chars_per_string` > 4096: `chars_per_string` = 4096. Splits by '\n', '. ' or ' ' in exactly this priority. :param text: The text to split :type text: :obj:`str` :param chars_per_string: The number of maximum characters per part the text is split to. :type chars_per_string: :obj:`int` :return: The splitted text as a list of strings. :rtype: :obj:`list` of :obj:`str` substrrcP|jj|dd|zS)N)rr)rparts rv_text_before_lastz&smart_split.._text_before_last[s'{{4::f-cr23f< E  t9' ' LL L%%& 4<$T*D T\$T*D D[$S)D TCIJ rwcldddd}|y|jD]\}}|j||}|S)z Replaces the following chars in `text` ('&' with '&', '<' with '<' and '>' with '>'). :param text: the text to escape :return: the escaped text z&z<z>)&<>N)itemsreplace)rcharsoldnews rvescaperssAV 4E |KKMS||C%" Krwuser include_idct|j}d|jd|d|rd|jdzSdzS)a Returns an HTML user link. This is useful for reports. Attention: Don't forget to set parse_mode to 'HTML'! .. code-block:: python3 :caption: Example: bot.send_message(your_user_id, user_link(message.from_user) + ' started the bot!', parse_mode='HTML') .. note:: You can use formatting.* for all other formatting options(bold, italic, links, and etc.) This method is kept for backward compatibility, and it is recommended to use formatting.* for more options. :param user: the user (not the user_id) :type user: :obj:`telebot.types.User` :param include_id: include the user_id :type include_id: :obj:`bool` :return: HTML user link :rtype: :obj:`str` zzz (
z
)r)r first_nameid)rrrbs rv user_linkrsU2 $// "D$TWWIRvT :-7 ) AB=? ABrwvalues row_widthc tj|}|jDcgc]\}}tjdd|i|}}}|j||Scc}}w)aK Returns a reply markup from a dict in this format: {'text': kwargs} This is useful to avoid always typing 'btn1 = InlineKeyboardButton(...)' 'btn2 = InlineKeyboardButton(...)' Example: .. code-block:: python3 :caption: Using quick_markup: from telebot.util import quick_markup markup = quick_markup({ 'Twitter': {'url': 'https://twitter.com'}, 'Facebook': {'url': 'https://facebook.com'}, 'Back': {'callback_data': 'whatever'} }, row_width=2) # returns an InlineKeyboardMarkup with two buttons in a row, one leading to Twitter, the other to facebook # and a back button below # kwargs can be: { 'url': None, 'callback_data': None, 'switch_inline_query': None, 'switch_inline_query_current_chat': None, 'callback_game': None, 'pay': None, 'login_url': None, 'web_app': None } :param values: a dict containing all buttons to create in this format: {text: kwargs} {str:} :type values: :obj:`dict` :param row_width: number of :class:`telebot.types.InlineKeyboardButton` objects on each row :type row_width: :obj:`int` :return: InlineKeyboardMarkup :rtype: :obj:`types.InlineKeyboardMarkup` )rrr)r InlineKeyboardMarkupr InlineKeyboardButtonadd)rrmarkuprrbuttonss rv quick_markupr snR ' ') zorify..s F1IrwctSr)r(r+srvr,zorify..s hqkrwN)hasattrrr#r}r'r$)rchanged_callbacks` rvorifyr0sD 1f  1h 77 AI AE!AGrwctjfd}fd}D]}t||j_|_|S)r_cDcgc]}|j}}t|rjyjycc}wr)ranyrr})evboolseventsor_events rvr$zOrEvent..changeds<'-.vv. u: LLN NN  /sA cljs#jdjs"yy)N)r_wait)r7srv busy_waitzOrEvent..busy_waits%//# NN1 //#rw)rgrlr0rr:)r6r$r;rr7s` @rvOrEventr<sM H  a]]HNHM I Orwcv|stt|s|}tt||tt|S)r_)r. thread_localsetattrgetattr)keyconstruct_valueresetvalues rv per_threadrE s1 GL#.! c5) < %%rwwarn alternativecfd}|S)a Use this decorator to mark functions as deprecated. When the function is used, an info (or warning if `warn` is True) is logged. :meta private: :param warn: If True a warning is logged else an info :type warn: :obj:`bool` :param alternative: The new function to use instead :type alternative: :obj:`Callable` :param deprecation_text: Custom deprecation text :type deprecation_text: :obj:`str` :return: The decorated function cfd}|S)Ncdjd}r|djdz }r|dzz }stj|ntj||i|S)N`z` is deprecated.z Use `z ` insteadr)rr~infowarning)rrrLrGdeprecation_textfunctionrFs rvrz.deprecated..decorator..wrapper)stx(())9:D&!5!5 6i@@... D!t$T,V, ,rwr)rOrrGrNrFs` rvrzdeprecated..decorator(s -rwr)rFrGrNrs``` rv deprecatedrPs&  rwc|jrC |j}tjj |}|j |gyy#t $r}t|Yd}~yd}~wwxYw)a( A webhook endpoint for Google Cloud Functions FaaS. :param bot: The bot instance :type bot: :obj:`telebot.TeleBot` or :obj:`telebot.async_telebot.AsyncTeleBot` :param request: The request object :type request: :obj:`flask.Request` :return: The response object rN)zBot FAILizBot ON)is_jsonget_jsonr Updatede_jsonprocess_new_updatesrprint)botrequest request_jsonupdaters rvwebhook_google_functionsr\;sf #"++-L\\)),7F  # #VH -   # !H" #sAA A/ A**A/)number_retriesrOcddlm}ddlm}t |dz D] } ||i|cS||i|S#|$r3}|j dk(r||j ddnYd}~Jd}~wwxYw) a Use this function inside loops in order to avoid getting TooManyRequests error. Example: .. code-block:: python3 from telebot.util import antiflood for chat_id in chat_id_list: msg = antiflood(bot.send_message, chat_id, text) :param function: The function to call :type function: :obj:`Callable` :param number_retries: Number of retries to send :type function: :obj:int :param args: The arguments to pass to the function :type args: :obj:`tuple` :param kwargs: The keyword arguments to pass to the function :type kwargs: :obj:`dict` :return: None r)ApiTelegramException)sleeprai parameters retry_afterN)telebot.apihelperr`timerar error_code result_json)rOr^rrr`rarexs rv antifloodriTs27 >A% & T,V, ,'((( $ }}#bnn\2=ABC s2A*)A%%A*token raw_init_datact||}|syi}t|D] \}} tj|}|||<"|S#tj$r|||<Y?wxYw)z Parses web app data. :param token: The bot token :type token: :obj:`str` :param raw_init_data: The raw init data :type raw_init_data: :obj:`str` :return: The parsed init data F)validate_web_app_datar rrJSONDecodeError)rjrkis_validrrArDs rvparse_web_app_datarp|ss%UM:H  F . U JJu%E F3K / M ## F3K sAAAc tt|}d|vry|jd}dj dt |j D}tjd|jt}tj|j|jtj|k(S#t$rYywxYw)z Validates web app data. :param token: The bot token :type token: :obj:`str` :param raw_init_data: The raw init data :type raw_init_data: :obj:`str` :return: The parsed init data Fhashr{c30K|]\}}|d|yw)=Nr).0rArDs rv z(validate_web_app_data..s"!aE`zsESE5'"2E`ss WebAppData)rAmsg digestmod) dictr ValueErrorpoprsortedr hmacrrr digest hexdigest)rjrk parsed_datainit_data_hashdata_check_string secret_keys rvrmrms9]34 [  __V,N !aVKL]L]L_E`!aam6RJ 88J%%'):)A)A)CV L V V X\j jj sC CCctd|Dr tdd|vr tdt|jddk7r tdy)Nc3<K|]}|jywr)isspace)ruchars rvrvz!validate_token..s ,ed4<<>eszToken must not contain spaces:zToken must contain a colonrz7Token must contain exactly 2 parts separated by a colonT)r3rzrrrjs rvvalidate_tokenrsU ,e ,,899 %566 5;;s !RSS rwcr t|t|jddS#t$rYywxYw)Nrr)rrzintrrs rvextract_bot_idrs>u u{{3" ## s * 66)"content_type_mediacontent_type_service update_typesr^rrrrPrrr r rrrrrrrrrrr rirprmr%r(r0r<rEr\rr)Fr)TNN)Irrgrtypingrrrrrrr}hashlibr urllib.parser rjrfloggingrr telebot.service_utilsr r rrrrrujsonr ImportErrorr getLoggerr~localr>rrrrhr^rrrrrboolrrr MessageEntityrrrrrUserrrr r%r(r0r<rErPr\rirprmrr__all__rrwrvrs{ == "~~~   9 %y  ?9##?D''T< % %   S  T  K#K%T "2K.9C9CK49* , ,!4!4 , ,DYsYcYd3iY"4F& c& S& $s)& R  # BEJJBDBSB12/s/5KeKe/f "4&"T"x/A"L29:%)%)Pc#6kkSk4 T $U39-$ esF F"!F"