x'hTLddlZddlZddlZddlmZmZmZmZmZm 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 e-dffdZ1de-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 1rr)rrs` r decoratorzasync_dec..decorators 2rr)rs r async_decrs  rrreturnc*|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 r is_commandrs |E ??3 rcr|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@ro)rsplitrs rextract_commandrs>& |D0:40@4::<?  %a ( ,JdJrctjdtj}|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 rextract_argumentsrsA"ZZ2BMM BF \\$ F(.6<<?8D8rrcd}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` rrro)encodelenoffsetlengthdecode)rrrr encoded_textendibytes rextract_entityrsF E;;=L l C A  4KD !!(("ahh.t|! !  Q  c " ) ) ++rchars_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 r split_stringr =s3383t9FV2W XQD1'' ( 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)r parts r_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 rcldddd}|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 rescaperwsFV 4E |KKM&S||C%& Kruser 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)r r!rps r user_linkr%sU2 $// "D$TWWIRvT :-7 ) AB=? ABrvalues 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` )r'rr)r InlineKeyboardMarkuprInlineKeyboardButtonadd)r&r'markuprrbuttonss r quick_markupr.skR ' ') zorify..s F1IrctSr)r6r9srr:zorify..s hqkrN)hasattrrr1rr5r2)rchanged_callbacks` rorifyr>sD 1f  1h 77 AI AE!AGrctjfd}fd}D]}t||j_|_|S)rmcDcgc]}|j}}t|rjyjycc}wr)ranyrr)evboolseventsor_events rr2zOrEvent..changeds;'-... u: LLN NN  /sA cljs#jdjs"yy)N)r_wait)rEsr busy_waitzOrEvent..busy_waits%//# NN1 //#r)rurzr>rrH)rDr2rIrrEs` @rOrEventrJsR H  a]]HNHM I Orcv|stt|s|}tt||tt|S)rm)r< thread_localsetattrgetattr)keyconstruct_valueresetvalues r per_threadrSs1 GL#.! c5) < %%rwarn 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)rrinfowarning)rrrZrUdeprecation_textfunctionrTs rrz.deprecated..decorator..wrapper-stx(())9:D&!5!5 6i@@... D!t$T,V, ,rr)r]rrUr\rTs` rrzdeprecated..decorator,s -rr)rTrUr\rs``` r deprecatedr^s&  rc|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 rwebhook_google_functionsrj?sf #"++-L\\)),7F  # #VH -   # !H" #sAA A/ A**A/)number_retriesr]cddlm}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)sleeproi parameters retry_afterN)telebot.apihelperrntimeror error_code result_json)r]rlrrrnrorexs r antifloodrwXs27 >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)rxryis_validrrOrRs rparse_web_app_datar~sx%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 Fhashrc30K|]\}}|d|yw)=Nr).0rOrRs r z(validate_web_app_data..s!azsESE5'"2!ass WebAppData)rOmsg digestmod) dictr ValueErrorpoprsortedrhmacrrr digest hexdigest)rxry parsed_datainit_data_hashdata_check_string secret_keys rr{r{s9]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)rchars rrz!validate_token..s ,d4<<> ,szToken must not contain spaces:zToken must contain a colonrz7Token must contain exactly 2 parts separated by a colonT)rArrrrxs rvalidate_tokenrsU ,e ,,899 %566 5;;s !RSS rcr t|t|jddS#t$rYywxYw)Nrr)rrintrrs rextract_bot_idrs>u u{{3" ## s * 66)"content_type_mediacontent_type_service update_typesrlrrrr^rrr r rrrrrrr rrr%r.rwr~r{r3r6r>rJrSrjrr)Fr)TNN)Irrurtypingrrrrrrrhashlibr urllib.parser rxrtloggingrr telebot.service_utilsr r rrrrrujsonr ImportErrorr getLoggerrlocalrLrrrrvrlrrrrrboolrrr MessageEntityrrr rrUserr%r)r.r3r6r>rJrSr^rjrwr~r{rr__all__rrrrs == "~~~   9 %y   ?9##?D''T< % %   S  T  K#K%T "2K.9C9E#t)$49* , ,!4!4 , ,DYsYcYd3iY"4F& c& S& $s)& R  # BEJJBDBSB12/s/5KeKe/f "4&"T"x/A"L29:%)%)Pc#6kkSk4 T $U39-$ msF F#"F#