՟f dZddlmZddlmZddlmZmZmZm Z m Z m Z m Z m Z mZmZmZddlZddlmZddlmZmZmZddlmZmZmZmZmZmZdd lm Z dd l!m"Z"dd l#m$Z$m%Z%dd l&m'Z'dd l(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:erddl;mZ>m?Z?m@Z@mAZAddl.mBZBedeZCedede+fZDeddZEedZFedZGedZHedd ZIgd!ZJd"ZKGd#d e e0e1e4e2e/e3fZLeLe)de'je eefe eefe eefe+e'jfZNy)$zEThis module contains the Builder classes for the telegram.ext module.)Queue)Path) TYPE_CHECKINGAnyCallable Collection CoroutineDictGenericOptionalTypeTypeVarUnionN)Bot) DEFAULT_FALSE DEFAULT_NONE DefaultValue)DVInputDVType FilePathInput HTTPVersionODVInput SocketOpt)warn) Application)BaseUpdateProcessorSimpleUpdateProcessor) ContextTypes)ExtBot)JobQueue)Updater)BDBTCCTCDJQUD) BaseRequest) HTTPXRequest)PTBDeprecationWarning)Update)BasePersistenceBaseRateLimiterCallbackContextDefaults)RLARGSInBT)boundInJQInCCTr.InUDInCDInBD BuilderTypeApplicationBuilder))requestrequest instance)get_updates_requestget_updates_request instance)connection_pool_sizer>)proxyr?)socket_optionsr@) pool_timeoutrA)connect_timeoutrB) read_timeoutrC) write_timeoutrD)media_write_timeoutrE) http_versionrF) get_updates_connection_pool_sizerG)get_updates_proxyrH)get_updates_socket_optionsrI)get_updates_pool_timeoutrJ)get_updates_connect_timeoutrK)get_updates_read_timeoutrL)get_updates_write_timeoutrM)get_updates_http_versionrN) base_file_urlrO)base_urlrP)tokenrQ)defaultsrR)arbitrary_callback_datarS) private_keyrT) rate_limiterzrate_limiter instance) local_modezlocal_mode settingz5The parameter `{}` may only be set, if no {} was set.c eZdZdZdZdgdZdedefdZde fdZ d e dd fd Z d e dd fd Z dd deeeeeeeffdZ dhdedeeeeeeeefdeee efdefdZdede defdZdede defdZdede defdZdedd fdZ d e dedd fdZ!dededefdZ"dede#defdZ$dede defdZ%ded e&e e'jPe'jRfdefd!Z*ded"e+e,defd#Z-ded$ee.defd%Z/ded&ee.defd'Z0ded(ee.defd)Z1ded*ee.defd+Z2ded,ee.defd-Z3ded.e4defd/Z5ded0edefd1Z6ded2e#defd3Z7ded4e defd5Z8ded6e&e e'jPe'jRfdefd7Z9ded8e+e,defd9Z:ded:ee.defd;Z;dedee.defd?Z=ded@ee.defdAZ>dedBe4defdCZ? dhdedDe&e@eAfdEee&e@eAfdefdFZBdedGdHdefdIZCdedJe&ee#fdefdKZDdedLedefdMZEdd dNeFddOfdPZGdedQdRdefdSZHdedTe&ee#dUfdefdVZIdd dWeJddXfdYZKdedZd[defd\ZL did]ZMded^eeNdefd_ZOded`ePegeQeed ffdefdaZRdedbePegeQeed ffdefdcZSdeddePegeQeed ffdefdeZT djdfZUy )kr9aJThis class serves as initializer for :class:`telegram.ext.Application` via the so called `builder pattern`_. To build a :class:`telegram.ext.Application`, one first initializes an instance of this class. Arguments for the :class:`telegram.ext.Application` to build are then added by subsequently calling the methods of the builder. Finally, the :class:`telegram.ext.Application` is built by calling :meth:`build`. In the simplest case this can look like the following example. Example: .. code:: python application = ApplicationBuilder().token("TOKEN").build() Please see the description of the individual methods for information on which arguments can be set and what the defaults are when not called. When no default is mentioned, the argument will not be used by default. Note: * Some arguments are mutually exclusive. E.g. after calling :meth:`token`, you can't set a custom bot with :meth:`bot` and vice versa. * Unless a custom :class:`telegram.Bot` instance is set via :meth:`bot`, :meth:`build` will use :class:`telegram.ext.ExtBot` for the bot. .. seealso:: :wiki:`Your First Bot `, :wiki:`Builder Pattern ` .. _`builder pattern`: https://en.wikipedia.org/wiki/Builder_pattern )(_application_class_application_kwargs_arbitrary_callback_data_base_file_url _base_url_bot_connect_timeout_connection_pool_size_context_types _defaults_get_updates_connect_timeout!_get_updates_connection_pool_size_get_updates_http_version_get_updates_pool_timeout_get_updates_proxy_get_updates_read_timeout_get_updates_request_get_updates_socket_options_get_updates_write_timeout _http_version _job_queue _local_mode_media_write_timeout _persistence _pool_timeout _post_init_post_shutdown _post_stop _private_key_private_key_password_proxy _rate_limiter _read_timeout_request_socket_options_token_update_processor _update_queue_updater_write_timeoutselfcRtd|_td|_td|_t|_t|_t|_t|_t|_ t|_ t|_ t|_ t|_ t|_t|_t|_t|_t|_t|_t|_t|_td|_t|_t|_t|_t4|_t4|_t|_tt=|_ ttA|_!t|_$ttK|_&ttN|_(i|_)tUd|_+t|_,d|_-d|_.d|_/t|_0td|_1y#tD$r#}dtG|vrt|_!Yd}~d}~wwxYw)Nzhttps://api.telegram.org/botz!https://api.telegram.org/file/bot1.1zPTB must be installed via)max_concurrent_updates)2rr{r\r[rr_rvrzr^rxrrnrpryrcrfrirbrgrjrerhrdrtrurarrZrmr]rr}r rl RuntimeErrorstrrorr`rrXrYrr|r~rqrrrsrwrk)rexcs [/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/ext/_applicationbuilder.py__init__zApplicationBuilder.__init__s#/#3 &23Q&R+78[+\3?"CO ?K1=.:/;5A!.:.: ?K.O[KW(=I):F&;G':F&:F!7CE7J&-96B"-9HU%)6". COPUPWCX +2>xz2JDO 8D4@4P=I+=V68 6K#$7 ,8 X\\`X\8D+7+># +*#c(:*DOO +sG:: H&H!!H& get_updatesreturnc|rdnd}tt||dtst||dStjt||d}tjt||d}|r'tjt||dxsd}n&tjt||dxsd}t||d t||d t||d t||d d }|s|j|d<|j Dcic]\}}t|tr||} }}tjt||dxsd} t d||| |d| Scc}}w)N _get_updates__r:r?r@r>rrBrCrDrArBrCrDrArErFr)r>r?rFr@) isinstancegetattrr get_valuernitemsr)) rrprefixr?r@r>timeoutskeyvalueeffective_timeoutsrFs r_build_requestz!ApplicationBuilder._build_requests$/S'$6('(:;\J4F87!34 4&&wtxu5E'FG%//>W0XY &&wtx?S5T'UV[Z[ ! &&wtx?S5T'UV]Z] ! 'tx-GH#DVHL*AB$TfX]+CD#DVHL*AB  .2.G.GH* +*2)9 %3ES_A`CJ  $--gdvhlE<ct|jtr tdt |jtj |j tj |jtj |jtj |jtj |jtj |j|jd|jdtj |jtj |j S)NzNo bot token was set.FrT) rQrPrOrTprivate_key_passwordrRrSr:r<rUrV)rr{rrrrr\r[rtrurarZrrwrm)rs r_build_ext_botz!ApplicationBuilder._build_ext_bot s dkk< 067 7++!++DNN;&001D1DE$..t/@/@A!-!7!78R8R!S!++DNN;$0$:$:4;X;X$Y''E': $ 3 3 3 E%//0B0BC#--d.>.>?  nameNcf|jturttj |dy)N bot instance)r]rr _TWO_ARGS_REQformatrrs r _bot_checkzApplicationBuilder._bot_checks+ 99L (}33D.IJ J )rcj|jtdfvrttj |dy)Nupdater)r~rrrrrs r_updater_checkz!ApplicationBuilder._updater_check"s0 ==t 4 4}33D)DE E 5r+ApplicationBuilder[BT, CCT, UD, CD, BD, JQ]cntj|j}tj|j}t |j ts |j st |j tr|j}n |j }tj|j}|j d}nFt||}n8|j }|j j}|j j}tj|jd||||j||tj|j|j|j |j"d |j$}||j'|||j)||S)aBuilds a :class:`telegram.ext.Application` with the provided arguments. Calls :meth:`telegram.ext.JobQueue.set_application` and :meth:`telegram.ext.BasePersistence.set_bot` if appropriate. Returns: :class:`telegram.ext.Application` N)bot update_queue) rrrupdate_processor job_queue persistence context_types post_init post_shutdown post_stopr)rrrlrorr~r]rr}r!rrrXr|r`rqrrrsrYset_applicationset_bot)rrrrrr applications rbuildzApplicationBuilder.build&sp!**4??; ",,T->->? dmm\ 2dmm6K$))\2..0ii'11$2D2DEL}}$!c EmmG--##C==55L= L`, :meth:`base_file_url` Args: base_url (:obj:`str`): The URL. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rP)rrr\)rrPs rrPzApplicationBuilder.base_urls*  # J'! rrOcX|jd|jd||_|S)aSets the base file URL for :attr:`telegram.ext.Application.bot`. If not called, will default to ``'https://api.telegram.org/file/bot'``. .. seealso:: :paramref:`telegram.Bot.base_file_url`, :wiki:`Local Bot API Server `, :meth:`base_url` Args: base_file_url (:obj:`str`): The URL. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rO)rrr[)rrOs rrOz ApplicationBuilder.base_file_urls+ ( O,+ rc B|rdnd}|dz}gd}|s|jd|D]@}tt|d||tr#t t j ||tt|d|dtst t j |dtt|d|dtst t j |dtt|d|d tst t j |d tt|d|d tst t j |d |j||jtdfvrt t j |d y) N get_updates_rr:rrErr>r?r@rFupdater instance) appendrrrrrrrr~r)rrrrrattrs r_request_checkz!ApplicationBuilder._request_checksy#.B !W OO1 2 EDgdaxv,>?N"=#7#7d#CDD E'$!F83G(HI<X}33D:PQR R'$!F85(9:LI}33D'BC C'$!F8>(BC\R}33D:JKL L'$!F8<(@A<P}33D.IJ J  ==t 4 4}33D:LMN N 5rc|r4|jtur"ttj d|d|j turttj |d|j tur/ttj |rd|d|d|jtdfvr/ttj |rd|d|dy)Nrr=r;rr)rhrrrrryr]r~)rrrs r_request_param_checkz'ApplicationBuilder._request_param_checks 444LH$$|D6%:BN  ==t 4 4$$k|D6%:U^_ OSU^_  5rr:c8|jd||_|S)aSets a :class:`telegram.request.BaseRequest` instance for the :paramref:`telegram.Bot.request` parameter of :attr:`telegram.ext.Application.bot`. .. seealso:: :meth:`get_updates_request` Args: request (:class:`telegram.request.BaseRequest`): The request instance. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. Fr)rry)rr:s rr:zApplicationBuilder.requests! .  rr>c:|jdd||_|S)aSets the size of the connection pool for the :paramref:`~telegram.request.HTTPXRequest.connection_pool_size` parameter of :attr:`telegram.Bot.request`. Defaults to ``256``. .. include:: inclusions/pool_size_tip.rst .. seealso:: :meth:`get_updates_connection_pool_size` Args: connection_pool_size (:obj:`int`): The size of the connection pool. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. r>Frr)rr_)rr>s rr>z'ApplicationBuilder.connection_pool_sizes% !!'=5!Q%9" r proxy_urlcRttddd|j|S)aLegacy name for :meth:`proxy`, kept for backward compatibility. .. seealso:: :meth:`get_updates_proxy` .. deprecated:: 20.7 Args: proxy_url (:obj:`str` | ``httpx.Proxy`` | ``httpx.URL``): See :paramref:`telegram.ext.ApplicationBuilder.proxy.proxy`. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. 20.7zU`ApplicationBuilder.proxy_url` is deprecated. Use `ApplicationBuilder.proxy` instead. stacklevel)rr*r?)rrs rrzApplicationBuilder.proxy_urls2 !    zz)$$rr?c:|jdd||_|S)a]Sets the proxy for the :paramref:`~telegram.request.HTTPXRequest.proxy` parameter of :attr:`telegram.Bot.request`. Defaults to :obj:`None`. .. seealso:: :meth:`get_updates_proxy` .. versionadded:: 20.7 Args: proxy (:obj:`str` | ``httpx.Proxy`` | ``httpx.URL``): The URL to a proxy server, a ``httpx.Proxy`` object or a ``httpx.URL`` object. See :paramref:`telegram.request.HTTPXRequest.proxy` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. r?Fr)rrv)rr?s rr?zApplicationBuilder.proxys# !!wE!B  rr@c:|jdd||_|S)a*Sets the options for the :paramref:`~telegram.request.HTTPXRequest.socket_options` parameter of :attr:`telegram.Bot.request`. Defaults to :obj:`None`. .. seealso:: :meth:`get_updates_socket_options` .. versionadded:: 20.7 Args: socket_options (Collection[:obj:`tuple`], optional): Socket options. See :paramref:`telegram.request.HTTPXRequest.socket_options` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. r@Fr)rrz)rr@s rr@z!ApplicationBuilder.socket_options.s% !!'7U!K- rrBc:|jdd||_|S)aSets the connection attempt timeout for the :paramref:`~telegram.request.HTTPXRequest.connect_timeout` parameter of :attr:`telegram.Bot.request`. Defaults to ``5.0``. .. seealso:: :meth:`get_updates_connect_timeout` Args: connect_timeout (:obj:`float`): See :paramref:`telegram.request.HTTPXRequest.connect_timeout` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rBFr)rr^)rrBs rrBz"ApplicationBuilder.connect_timeoutAs% !!'8e!L / rrCc:|jdd||_|S)aSets the waiting timeout for the :paramref:`~telegram.request.HTTPXRequest.read_timeout` parameter of :attr:`telegram.Bot.request`. Defaults to ``5.0``. .. seealso:: :meth:`get_updates_read_timeout` Args: read_timeout (:obj:`float`): See :paramref:`telegram.request.HTTPXRequest.read_timeout` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rCFr)rrx)rrCs rrCzApplicationBuilder.read_timeoutSs$ !!~5!I) rrDc:|jdd||_|S)aSets the write operation timeout for the :paramref:`~telegram.request.HTTPXRequest.write_timeout` parameter of :attr:`telegram.Bot.request`. Defaults to ``5.0``. .. seealso:: :meth:`get_updates_write_timeout` Args: write_timeout (:obj:`float`): See :paramref:`telegram.request.HTTPXRequest.write_timeout` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rDFr)rr)rrDs rrDz ApplicationBuilder.write_timeoutes$ !!E!J+ rrEc:|jdd||_|S)aSets the media write operation timeout for the :paramref:`~telegram.request.HTTPXRequest.media_write_timeout` parameter of :attr:`telegram.Bot.request`. Defaults to ``20``. .. versionadded:: 21.0 Args: media_write_timeout (:obj:`float`): See :paramref:`telegram.request.HTTPXRequest.media_write_timeout` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rEFr)rrn)rrEs rrEz&ApplicationBuilder.media_write_timeoutws% !!'<%!P$7! rrAc:|jdd||_|S)a8Sets the connection pool's connection freeing timeout for the :paramref:`~telegram.request.HTTPXRequest.pool_timeout` parameter of :attr:`telegram.Bot.request`. Defaults to ``1.0``. .. include:: inclusions/pool_size_tip.rst .. seealso:: :meth:`get_updates_pool_timeout` Args: pool_timeout (:obj:`float`): See :paramref:`telegram.request.HTTPXRequest.pool_timeout` for more information. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rAFr)rrp)rrAs rrAzApplicationBuilder.pool_timeouts$ !!~5!I) rrFc:|jdd||_|S)aSets the HTTP protocol version which is used for the :paramref:`~telegram.request.HTTPXRequest.http_version` parameter of :attr:`telegram.Bot.request`. By default, HTTP/1.1 is used. .. seealso:: :meth:`get_updates_http_version` Note: Users have observed stability issues with HTTP/2, which happen due to how the `h2 library handles `_ cancellations of keepalive connections. See `#3556 `_ for a discussion. If you want to use HTTP/2, you must install PTB with the optional requirement ``http2``, i.e. .. code-block:: bash pip install "python-telegram-bot[http2]" Keep in mind that the HTTP/1.1 implementation may be considered the `"more robust option at this time" `_. .. versionadded:: 20.1 .. versionchanged:: 20.2 Reset the default version to 1.1. Args: http_version (:obj:`str`): Pass ``"2"`` or ``"2.0"`` if you'd like to use HTTP/2 for making requests to Telegram. Defaults to ``"1.1"``, in which case HTTP/1.1 is used. .. versionchanged:: 20.5 Accept ``"2"`` as a valid value. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rFFr)rrk)rrFs rrFzApplicationBuilder.http_versions%J !!~5!I) rr<c8|jd||_|S)aSets a :class:`telegram.request.BaseRequest` instance for the :paramref:`~telegram.Bot.get_updates_request` parameter of :attr:`telegram.ext.Application.bot`. .. seealso:: :meth:`request` Args: get_updates_request (:class:`telegram.request.BaseRequest`): The request instance. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. Tr)rrh)rr<s rr<z&ApplicationBuilder.get_updates_requests" -$7! rrGc:|jdd||_|S)aSets the size of the connection pool for the :paramref:`telegram.request.HTTPXRequest.connection_pool_size` parameter which is used for the :meth:`telegram.Bot.get_updates` request. Defaults to ``1``. .. seealso:: :meth:`connection_pool_size` Args: get_updates_connection_pool_size (:obj:`int`): The size of the connection pool. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. r>Tr)rrc)rrGs rrGz3ApplicationBuilder.get_updates_connection_pool_sizes% !!'=4!P1Q. rget_updates_proxy_urlcRttddd|j|S)aLegacy name for :meth:`get_updates_proxy`, kept for backward compatibility. .. seealso:: :meth:`proxy` .. deprecated:: 20.7 Args: get_updates_proxy_url (:obj:`str` | ``httpx.Proxy`` | ``httpx.URL``): See :paramref:`telegram.ext.ApplicationBuilder.get_updates_proxy.get_updates_proxy`. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rzm`ApplicationBuilder.get_updates_proxy_url` is deprecated. Use `ApplicationBuilder.get_updates_proxy` instead.rr)rr*rH)rrs rrz(ApplicationBuilder.get_updates_proxy_urls6 !B    %%&;<`_ cancellations of keepalive connections. See `#3556 `_ for a discussion. You will also need to install the http2 dependency. Keep in mind that the HTTP/1.1 implementation may be considered the `"more robust option at this time" `_. .. code-block:: bash pip install httpx[http2] .. versionadded:: 20.1 .. versionchanged:: 20.2 Reset the default version to 1.1. Args: get_updates_http_version (:obj:`str`): Pass ``"2"`` or ``"2.0"`` if you'd like to use HTTP/2 for making requests to Telegram. Defaults to ``"1.1"``, in which case HTTP/1.1 is used. .. versionchanged:: 20.5 Accept ``"2"`` as a valid value. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rFTr)rrd)rrNs rrNz+ApplicationBuilder.get_updates_http_versions%L !!~4!H)A& rrTpasswordc|jd|jdt|tr|nt |j |_|t|tr ||_|St |j |_|S)aSets the private key and corresponding password for decryption of telegram passport data for :attr:`telegram.ext.Application.bot`. Examples: :any:`Passport Bot ` .. seealso:: :wiki:`Telegram Passports ` Args: private_key (:obj:`bytes` | :obj:`str` | :obj:`pathlib.Path`): The private key or the file path of a file that contains the key. In the latter case, the file's content will be read automatically. password (:obj:`bytes` | :obj:`str` | :obj:`pathlib.Path`, optional): The corresponding password or the file path of a file that contains the password. In the latter case, the file's content will be read automatically. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rT)rrrbytesr read_bytesrtru)rrTrs rrTzApplicationBuilder.private_keys0  & M*&k59KtK?P?[?[?]   z(E:)1D & *.h)B)B)DD & rrRr/cX|jd|jd||_|S)aSets the :class:`telegram.ext.Defaults` instance for :attr:`telegram.ext.Application.bot`. .. seealso:: :wiki:`Adding Defaults to Your Bot ` Args: defaults (:class:`telegram.ext.Defaults`): The defaults instance. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rR)rrra)rrRs rrRzApplicationBuilder.defaultss*  # J'! rrScX|jd|jd||_|S)aISpecifies whether :attr:`telegram.ext.Application.bot` should allow arbitrary objects as callback data for :class:`telegram.InlineKeyboardButton` and how many keyboards should be cached in memory. If not called, only strings can be used as callback data and no data will be stored in memory. Important: If you want to use this feature, you must install PTB with the optional requirement ``callback-data``, i.e. .. code-block:: bash pip install "python-telegram-bot[callback-data]" Examples: :any:`Arbitrary callback_data Bot ` .. seealso:: :wiki:`Arbitrary callback_data ` Args: arbitrary_callback_data (:obj:`bool` | :obj:`int`): If :obj:`True` is passed, the default cache size of ``1024`` will be used. Pass an integer to specify a different cache size. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rS)rrrZ)rrSs rrSz*ApplicationBuilder.arbitrary_callback_datas-: 12 56(?% rrVcX|jd|jd||_|S)aSpecifies the value for :paramref:`~telegram.Bot.local_mode` for the :attr:`telegram.ext.Application.bot`. If not called, will default to :obj:`False`. .. seealso:: :wiki:`Local Bot API Server ` Args: local_mode (:obj:`bool`): Whether the bot should run in local mode. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rV)rrrm)rrVs rrVzApplicationBuilder.local_modes+  % L)% rrz-ApplicationBuilder[InBT, CCT, UD, CD, BD, JQ]c|jdtD]A\}}tt|d|tr$t t jd|||_|S)aZSets a :class:`telegram.Bot` instance for :attr:`telegram.ext.Application.bot`. Instances of subclasses like :class:`telegram.ext.ExtBot` are also valid. Args: bot (:class:`telegram.Bot`): The bot. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rr) r _BOT_CHECKSrrrrrrr])rrrerrors rrzApplicationBuilder.botsd E"& GKD%gdavJ7F"=#7#7u#EFF G  rrz Queue[object]cz|jtdfvrttj dd||_|S)aSets a :class:`asyncio.Queue` instance for :attr:`telegram.ext.Application.update_queue`, i.e. the queue that the application will fetch updates from. Will also be used for the :attr:`telegram.ext.Application.updater`. If not called, a queue will be instantiated. .. seealso:: :attr:`telegram.ext.Updater.update_queue` Args: update_queue (:class:`asyncio.Queue`): The queue. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. Nrr)r~rrrrr})rrs rrzApplicationBuilder.update_queue(s; ==t 4 4}33NDVWX X) rconcurrent_updatesrcd|durd}n|durd}t|tr t|}||_|S)aDSpecifies if and how many updates may be processed concurrently instead of one by one. If not called, updates will be processed one by one. Warning: Processing updates concurrently is not recommended when stateful handlers like :class:`telegram.ext.ConversationHandler` are used. Only use this if you are sure that your bot does not (explicitly or implicitly) rely on updates being processed sequentially. .. include:: inclusions/pool_size_tip.rst .. seealso:: :attr:`telegram.ext.Application.concurrent_updates` Args: concurrent_updates (:obj:`bool` | :obj:`int` | :class:`BaseUpdateProcessor`): Passing :obj:`True` will allow for ``256`` updates to be processed concurrently using :class:`telegram.ext.SimpleUpdateProcessor`. Pass an integer to specify a different number of updates that may be processed concurrently. Pass an instance of :class:`telegram.ext.BaseUpdateProcessor` to use that instance for handling updates concurrently. .. versionchanged:: 20.4 Now accepts :class:`BaseUpdateProcessor` instances. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. TrFr)rintrr|)rrs rrz%ApplicationBuilder.concurrent_updates;sI>  %!$  5 (!"  (# .!67I!J 7I rrz-ApplicationBuilder[BT, CCT, UD, CD, BD, InJQ]c||_|S)aSets a :class:`telegram.ext.JobQueue` instance for :attr:`telegram.ext.Application.job_queue`. If not called, a job queue will be instantiated if the requirements of :class:`telegram.ext.JobQueue` are installed. Examples: :any:`Timer Bot ` .. seealso:: :wiki:`Job Queue ` Note: * :meth:`telegram.ext.JobQueue.set_application` will be called automatically by :meth:`build`. * The job queue will be automatically started and stopped by :meth:`telegram.ext.Application.start` and :meth:`telegram.ext.Application.stop`, respectively. * When passing :obj:`None` or when the requirements of :class:`telegram.ext.JobQueue` are not installed, :attr:`telegram.ext.ConversationHandler.conversation_timeout` can not be used, as this uses :attr:`telegram.ext.Application.job_queue` internally. Args: job_queue (:class:`telegram.ext.JobQueue`): The job queue. Pass :obj:`None` if you don't want to use a job queue. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. )rl)rrs rrzApplicationBuilder.job_queuejs<$ rrzBasePersistence[Any, Any, Any]c||_|S)aSets a :class:`telegram.ext.BasePersistence` instance for :attr:`telegram.ext.Application.persistence`. Note: When using a persistence, note that all data stored in :attr:`context.user_data `, :attr:`context.chat_data `, :attr:`context.bot_data ` and in :attr:`telegram.ext.ExtBot.callback_data_cache` must be copyable with :func:`copy.deepcopy`. This is due to the data being deep copied before handing it over to the persistence in order to avoid race conditions. Examples: :any:`Persistent Conversation Bot ` .. seealso:: :wiki:`Making Your Bot Persistent ` Warning: If a :class:`telegram.ext.ContextTypes` instance is set via :meth:`context_types`, the persistence instance must use the same types! Args: persistence (:class:`telegram.ext.BasePersistence`): The persistence instance. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. )ro)rrs rrzApplicationBuilder.persistences<( rc||_|S)aSets a :class:`telegram.ext.ContextTypes` instance for :attr:`telegram.ext.Application.context_types`. Examples: :any:`Context Types Bot ` Args: context_types (:class:`telegram.ext.ContextTypes`): The context types. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. )r`)rrs rrz ApplicationBuilder.context_typess , rrcd| ||_|S|jdf|jdffD]4\}}t|trt t jd|tD]A\}}tt|d|tr$t t jd|||_|S)aYSets a :class:`telegram.ext.Updater` instance for :attr:`telegram.ext.Application.updater`. The :attr:`telegram.ext.Updater.bot` and :attr:`telegram.ext.Updater.update_queue` will be used for :attr:`telegram.ext.Application.bot` and :attr:`telegram.ext.Application.update_queue`, respectively. Args: updater (:class:`telegram.ext.Updater` | :obj:`None`): The updater instance or :obj:`None` if no updater should be used. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rrrr) r~r]r}rrrrrrr)rrrr attr_names rrzApplicationBuilder.updaters ?#DMKYY '    0  KKD%dL1"=#7#7 5#IJJ  K!, K Iugda {O None: await application.bot.set_my_commands([('start', 'Starts the bot')]) application = Application.builder().token("TOKEN").post_init(post_init).build() Note: |post_methods_note| .. seealso:: :meth:`post_stop`, :meth:`post_shutdown` Args: post_init (:term:`coroutine function`): The custom callback. Must be a :term:`coroutine function` and must accept exactly one positional argument, which is the :class:`~telegram.ext.Application`:: async def post_init(application: Application) -> None: Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. )rq)rrs rrzApplicationBuilder.post_initsH$ rrc||_|S)a+ Sets a callback to be executed by :meth:`Application.run_polling` and :meth:`Application.run_webhook` *after* executing :meth:`Updater.shutdown` and :meth:`Application.shutdown`. Tip: This can be used for custom shutdown logic that requires to await coroutines, e.g. closing a database connection Example: .. code:: async def post_shutdown(application: Application) -> None: await application.bot_data['database'].close() application = Application.builder() .token("TOKEN") .post_shutdown(post_shutdown) .build() Note: |post_methods_note| .. seealso:: :meth:`post_init`, :meth:`post_stop` Args: post_shutdown (:term:`coroutine function`): The custom callback. Must be a :term:`coroutine function` and must accept exactly one positional argument, which is the :class:`~telegram.ext.Application`:: async def post_shutdown(application: Application) -> None: Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. )rr)rrs rrz ApplicationBuilder.post_shutdownsL, rrc||_|S)a Sets a callback to be executed by :meth:`Application.run_polling` and :meth:`Application.run_webhook` *after* executing :meth:`Updater.stop` and :meth:`Application.stop`. .. versionadded:: 20.1 Tip: This can be used for custom stop logic that requires to await coroutines, e.g. sending message to a chat before shutting down the bot. Hint: The callback will be called only, if :meth:`Application.stop` was indeed called successfully. For example, if the application is stopped early by calling :meth:`Application.stop_running` within :meth:`post_init`, then the set callback will *not* be called. Example: .. code:: async def post_stop(application: Application) -> None: await application.bot.send_message(123456, "Shutting down...") application = Application.builder() .token("TOKEN") .post_stop(post_stop) .build() Note: |post_methods_note| .. seealso:: :meth:`post_init`, :meth:`post_shutdown` Args: post_stop (:term:`coroutine function`): The custom callback. Must be a :term:`coroutine function` and must accept exactly one positional argument, which is the :class:`~telegram.ext.Application`:: async def post_stop(application: Application) -> None: Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. )rs)rrs rrzApplicationBuilder.post_stop/s\$ rcX|jd|jd||_|S)aSets a :class:`telegram.ext.BaseRateLimiter` instance for the :paramref:`telegram.ext.ExtBot.rate_limiter` parameter of :attr:`telegram.ext.Application.bot`. Args: rate_limiter (:class:`telegram.ext.BaseRateLimiter`): The rate limiter. Returns: :class:`ApplicationBuilder`: The same builder with the updated argument. rU)rrrw)rrUs rrUzApplicationBuilder.rate_limiter`s+ ' N+) r)rInitApplicationBuilder)N)rrrz%ContextTypes[InCCT, InUD, InCD, InBD]rz3ApplicationBuilder[BT, InCCT, InUD, InCD, InBD, JQ])rrrUzBaseRateLimiter[RLARGS]rz7ApplicationBuilder[ExtBot[RLARGS], CCT, UD, CD, BD, JQ])V__name__ __module__ __qualname____doc__ __slots__rboolr(rrrrrrrr#r$r'r%r"r&rr8r rr r objectrrQrPrOrrr:rr>rrhttpxProxyURLr?rrr@floatrBrCrDrErArrFr<rGrrHrIrKrLrMrJrNrrrTrRrSrVr1rrrr3rrrr!rrr rrrrUrrrr9r9hs:8)IV1?f' $' ;' R  $KsKtKF3F4F7;7 Rb"b", -7x/3 Cc3S,H IJc6k*+  6 K   {ck$K $O$O4O>4D(kKK ;ck&% %% %0Kc5;; .I(J{([*Y:OT_&kHUOP[$;huo+$KK$08 (;huo+(';'k'k'R+KT_"=@ &=K==P[=0.3Ceii4O.P ,7A)7L *8@ (5=e_ (6>uo (5=e_ (((5@( (Z;?##5-/0#5 !567#  #J{j["  49$)4D   D$;$;  9*;o+&--/4T3@U5U/V- -^; 9B(H B;> ?&kHW,=+@%%&. }iSRV>W/W&X% %N''*2K=)CQTVZNB[3[*\' 'R//&. }iSRV>W/W&X/ /b;/ Cr)Orasynciorpathlibrtypingrrrrr r r r r rrr telegram._botrtelegram._utils.defaultvaluerrrtelegram._utils.typesrrrrrrtelegram._utils.warningsrtelegram.ext._applicationr!telegram.ext._baseupdateprocessorrrtelegram.ext._contexttypesrtelegram.ext._extbotrtelegram.ext._jobqueuer telegram.ext._updaterr!telegram.ext._utils.typesr"r#r$r%r&r'telegram.requestr(telegram.request._httpxrequestr)telegram.warningsr*telegramr+ telegram.extr,r-r.r/r0r1r3r4r5r6r7r8rrr9 DEFAULT_TYPErrrrrsG&L     RRbb)1X3'+)==(73XX0 vS!vU4>2301vvvm+?@  <H IS"b"b!89IZ(t !! S#X S#X S#X**+  -r