Yi\SrSSKrSSKrSSKrSSKJrJrJrJrJ r J r J r SSK r SSK Jr SSKJr SrSSKJr SS KJr SS KJr SS KJr SS KJrJr \(a\(aSS KJr SSK!J"r" \#"\$"S55r%\"\&SS9r'"SS\\5r("SS\\5rg!\a SrNvf=f)z2This module contains the classes JobQueue and Job.N) TYPE_CHECKINGAnyGenericOptionalUnioncastoverload)AsyncIOExecutor)AsyncIOSchedulerTF) get_logger)build_repr_with_selected_attrs)JSONDict)ExtBot)CCT JobCallback)Job) ApplicationJobQueue) class_namec2\rSrSrSrSrSrS,SjrS\4Sjr \ S-S j5r \ S\ 4S j5r S\R4S jr\S.S SS \SS4Sjj5r\S.S \\\R*\R\R,4S \S\R4Sjj5rS.S \\\R*\R\R,S4S \S\\R4SjjrS/Sjr\S0Sj5rS1S\\S\\\R*\R\R,4S\\S\\S\\S\\S\\ SS4SjjrS2S\\S\\\R*4S\\\\R*\R\R,4S\\\\R*\R\R,4S\\S\\S\\S\\S\\ SS4Sjjr S1S\\S\R,S \S\\S\\S\\S\\S\\ SS4S!jjr!\"SSSSS4S\\S \R,S"\#\S#4S\\S\\S\\S\\S\\ SS4S$jjr$S3S\\S\ S\\S\\S\\S\\SS4S%jjr%S,S&jr&S4S'\SS4S(jjr'S\#S)4S*jr(S\S\#S)4S+jr)Sr*g)5r3a@This class allows you to periodically perform tasks with the bot. It is a convenience wrapper for the APScheduler library. This class is a :class:`~typing.Generic` class and accepts one type variable that specifies the type of the argument ``context`` of the job callbacks (:paramref:`~run_once.callback`) of :meth:`run_once` and the other scheduling methods. Important: If you want to use this class, you must install PTB with the optional requirement ``job-queue``, i.e. .. code-block:: bash pip install "python-telegram-bot[job-queue]" Examples: :any:`Timer Bot ` .. seealso:: :wiki:`Architecture Overview `, :wiki:`Job Queue ` .. versionchanged:: 20.0 To use this class, PTB must be installed via ``pip install "python-telegram-bot[job-queue]"``. Attributes: scheduler (:class:`apscheduler.schedulers.asyncio.AsyncIOScheduler`): The scheduler. Warning: This scheduler is configured by :meth:`set_application`. Additional configuration settings can be made by users. However, calling :meth:`~apscheduler.schedulers.base.BaseScheduler.configure` will delete any previous configuration settings. Therefore, please make sure to pass the values returned by :attr:`scheduler_configuration` to the method call in addition to your custom values. Alternatively, you can also use methods like :meth:`~apscheduler.schedulers.base.BaseScheduler.add_jobstore` to avoid using :meth:`~apscheduler.schedulers.base.BaseScheduler.configure` altogether. .. versionchanged:: 20.0 Uses :class:`~apscheduler.schedulers.asyncio.AsyncIOScheduler` instead of :class:`~apscheduler.schedulers.background.BackgroundScheduler` ) _application _executor scheduler)sunmontuewedthufrisatreturnNc[(d [S5eSUl[5Ul[ S0UR D6Ulg)Nz\To use `JobQueue`, PTB must be installed via `pip install "python-telegram-bot[job-queue]"`.) APS_AVAILABLE RuntimeErrorrr rr scheduler_configurationrselfs A/app/.venv/lib/python3.13/site-packages/telegram/ext/_jobqueue.py__init__JobQueue.__init__dsI}5  KO(*-=. **. c([XRS9$)zGive a string representation of the JobQueue in the form ``JobQueue[application=...]``. As this class doesn't implement :meth:`object.__str__`, the default implementation will be used, which is equivalent to :meth:`__repr__`. Returns: :obj:`str` ) application)r r0r)s r+__repr__JobQueue.__repr__qs.d@P@PQQr.crURc [S5eUR5nUbU$[S5e)z1The application this JobQueue is associated with.z)No application was set for this JobQueue.z,The application instance is no longer alive.)rr'r*r0s r+r0JobQueue.application|sB    $JK K'')  " IJJr.c[RnUR(a[URR [ 5(afURR R(aAURR RR=(d [RnUSUR0S.$)aProvides configuration values that are used by :class:`JobQueue` for :attr:`scheduler`. Tip: Since calling :meth:`scheduler.configure() ` deletes any previous setting, please make sure to pass these values to the method call in addition to your custom values: .. code-block:: python scheduler.configure(..., **job_queue.scheduler_configuration) Alternatively, you can also use methods like :meth:`~apscheduler.schedulers.base.BaseScheduler.add_jobstore` to avoid using :meth:`~apscheduler.schedulers.base.BaseScheduler.configure` altogether. .. versionadded:: 20.7 Returns: dict[:obj:`str`, :obj:`object`]: The configuration values as dictionary. default)timezone executors) pytzutcr isinstancer0botrdefaultstzinfor)r*r8s r+r( JobQueue.scheduler_configurations0 88   4++//88  $$--''++44;;GtxxH!#T^^4  r.ch[RRURR5$N)datetimenowrr8r)s r+_tz_nowJobQueue._tz_nows#  $$T^^%<%<==r.time shift_daycgrBr%r*rGrHs r+_parse_time_inputJobQueue._parse_time_inputsNQr.cgrBr%rJs r+rKrLs  r.cUcg[U[[45(a%UR5[R "US9-$[U[R 5(aUR5U-$[U[R 5(a[RR[RRUR=(d URRS9R5U5nURc%URRRU5nU(aHU[RR[R5::aU[R "SS9- nU$U$)N)seconds)tz)days)r<intfloatrErC timedeltarGcombinerDr?rr8datelocalizer:r;)r*rGrH date_times r+rKrLs! < dS%L ) )<<>H$6$6t$DD D dH.. / /<<>D( ( dHMM * * ))11!!%%)O8O8O%PUUWY]I' NN33<`. job_kwargs (:obj:`dict`, optional): Arbitrary keyword arguments to pass to the :meth:`apscheduler.schedulers.base.BaseScheduler.add_job()`. Returns: :class:`telegram.ext.Job`: The new :class:`Job` instance that has been added to the job queue. rgrirjrkrlT)rHrW)rjtriggerrun_dateargsr8) __name__rrKradd_jobrer?r8_job) r*rgrhrirjrkrlrmrdrYjs r+run_onceJobQueue.run_onces@J(x((8TT[\**44*@ NN " "    %%@)@)@    r.intervalfirstlastc U (d0n U=(d URn[XXgUS9n URU5n URU5n U (aU (aX:a [S5e[ U[ R 5(aUR5nURR"UR4SX 4U U UUS.U D6n Xl U $)a~Creates a new :class:`Job` instance that runs at specified intervals and adds it to the queue. Note: For a note about DST, please see the documentation of `APScheduler`_. .. _`APScheduler`: https://apscheduler.readthedocs.io/en/stable/modules/triggers/cron.html #daylight-saving-time-behavior Args: callback (:term:`coroutine function`): The callback function that should be executed by the new job. Callback signature:: async def callback(context: CallbackContext) interval (:obj:`int` | :obj:`float` | :obj:`datetime.timedelta`): The interval in which the job will run. If it is an :obj:`int` or a :obj:`float`, it will be interpreted as seconds. first (:obj:`int` | :obj:`float` | :obj:`datetime.timedelta` | :obj:`datetime.datetime` | :obj:`datetime.time`, optional): Time in or at which the job should run. This parameter will be interpreted depending on its type. * :obj:`int` or :obj:`float` will be interpreted as "seconds from now" in which the job should run. * :obj:`datetime.timedelta` will be interpreted as "time from now" in which the job should run. * :obj:`datetime.datetime` will be interpreted as a specific date and time at which the job should run. If the timezone (:attr:`datetime.datetime.tzinfo`) is :obj:`None`, the default timezone of the bot will be used. * :obj:`datetime.time` will be interpreted as a specific time of day at which the job should run. This could be either today or, if the time has already passed, tomorrow. If the timezone (:attr:`datetime.time.tzinfo`) is :obj:`None`, the default timezone of the bot will be used, which is UTC unless :attr:`telegram.ext.Defaults.tzinfo` is used. Defaults to :paramref:`interval` Note: Setting :paramref:`first` to ``0``, ``datetime.datetime.now()`` or another value that indicates that the job should run immediately will not work due to how the APScheduler library works. If you want to run a job immediately, we recommend to use an approach along the lines of:: job = context.job_queue.run_repeating(callback, interval=5) await job.run(context.application) .. seealso:: :meth:`telegram.ext.Job.run` last (:obj:`int` | :obj:`float` | :obj:`datetime.timedelta` | :obj:`datetime.datetime` | :obj:`datetime.time`, optional): Latest possible time for the job to run. This parameter will be interpreted depending on its type. See :paramref:`first` for details. If :paramref:`last` is :obj:`datetime.datetime` or :obj:`datetime.time` type and ``last.tzinfo`` is :obj:`None`, the default timezone of the bot will be assumed, which is UTC unless :attr:`telegram.ext.Defaults.tzinfo` is used. Defaults to :obj:`None`. data (:obj:`object`, optional): Additional data needed for the callback function. Can be accessed through :attr:`Job.data` in the callback. Defaults to :obj:`None`. .. versionchanged:: 20.0 Renamed the parameter ``context`` to :paramref:`data`. name (:obj:`str`, optional): The name of the new job. Defaults to :external:attr:`callback.__name__ `. chat_id (:obj:`int`, optional): Chat id of the chat associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.chat_data` will be available in the callback. .. versionadded:: 20.0 user_id (:obj:`int`, optional): User id of the user associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.user_data` will be available in the callback. .. versionadded:: 20.0 job_kwargs (:obj:`dict`, optional): Arbitrary keyword arguments to pass to the :meth:`apscheduler.schedulers.base.BaseScheduler.add_job()`. Returns: :class:`telegram.ext.Job`: The new :class:`Job` instance that has been added to the job queue. roz"'last' must not be before 'first'!ry)rprr start_dateend_daterOrj) rsrrK ValueErrorr<rCrU total_secondsrrtreru)r*rgryrzr{rirjrkrlrmrddt_firstdt_lastrvs r+ run_repeatingJobQueue.run_repeatingFsDJ(x((8TT[\))%0((. xG$6AB B h 2 2 3 3--/H NN " "       r.dayc `U(d0nU=(d URn[XXVUS9n URR"UR4SX 4UUS:XaSOUUR UR URUR=(d URRS.UD6n Xl U $)aCreates a new :class:`Job` that runs on a monthly basis and adds it to the queue. .. versionchanged:: 20.0 The ``day_is_strict`` argument was removed. Instead one can now pass ``-1`` to the :paramref:`day` parameter to have the job run on the last day of the month. Args: callback (:term:`coroutine function`): The callback function that should be executed by the new job. Callback signature:: async def callback(context: CallbackContext) when (:obj:`datetime.time`): Time of day at which the job should run. If the timezone (``when.tzinfo``) is :obj:`None`, the default timezone of the bot will be used, which is UTC unless :attr:`telegram.ext.Defaults.tzinfo` is used. day (:obj:`int`): Defines the day of the month whereby the job would run. It should be within the range of ``1`` and ``31``, inclusive. If a month has fewer days than this number, the job will not run in this month. Passing ``-1`` leads to the job running on the last day of the month. data (:obj:`object`, optional): Additional data needed for the callback function. Can be accessed through :attr:`Job.data` in the callback. Defaults to :obj:`None`. .. versionchanged:: 20.0 Renamed the parameter ``context`` to :paramref:`data`. name (:obj:`str`, optional): The name of the new job. Defaults to :external:attr:`callback.__name__ `. chat_id (:obj:`int`, optional): Chat id of the chat associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.chat_data` will be available in the callback. .. versionadded:: 20.0 user_id (:obj:`int`, optional): User id of the user associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.user_data` will be available in the callback. .. versionadded:: 20.0 job_kwargs (:obj:`dict`, optional): Arbitrary keyword arguments to pass to the :meth:`apscheduler.schedulers.base.BaseScheduler.add_job()`. Returns: :class:`telegram.ext.Job`: The new :class:`Job` instance that has been added to the job queue. rocronr{)rprrrjrhourminutesecondr8) rsrrrtrerrrr?r8ru) r*rgrhrrirjrkrlrmrdrvs r+ run_monthlyJobQueue.run_monthlysrJ(x((8TT[\ NN " "    );;;;[[;DNN$;$;   r.rR.c U(d0nU=(d URn[XXVUS9n URR"UR4UX 4SSR UV s/sHoR U PM sn 5URURURUR=(d URRS.UD6n Xl U $s sn f)aCreates a new :class:`Job` that runs on a daily basis and adds it to the queue. Note: For a note about DST, please see the documentation of `APScheduler`_. .. _`APScheduler`: https://apscheduler.readthedocs.io/en/stable/modules/triggers/cron.html #daylight-saving-time-behavior Args: callback (:term:`coroutine function`): The callback function that should be executed by the new job. Callback signature:: async def callback(context: CallbackContext) time (:obj:`datetime.time`): Time of day at which the job should run. If the timezone (:obj:`datetime.time.tzinfo`) is :obj:`None`, the default timezone of the bot will be used, which is UTC unless :attr:`telegram.ext.Defaults.tzinfo` is used. days (tuple[:obj:`int`], optional): Defines on which days of the week the job should run (where ``0-6`` correspond to sunday - saturday). By default, the job will run every day. .. versionchanged:: 20.0 Changed day of the week mapping of 0-6 from monday-sunday to sunday-saturday. data (:obj:`object`, optional): Additional data needed for the callback function. Can be accessed through :attr:`Job.data` in the callback. Defaults to :obj:`None`. .. versionchanged:: 20.0 Renamed the parameter ``context`` to :paramref:`data`. name (:obj:`str`, optional): The name of the new job. Defaults to :external:attr:`callback.__name__ `. chat_id (:obj:`int`, optional): Chat id of the chat associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.chat_data` will be available in the callback. .. versionadded:: 20.0 user_id (:obj:`int`, optional): User id of the user associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.user_data` will be available in the callback. .. versionadded:: 20.0 job_kwargs (:obj:`dict`, optional): Arbitrary keyword arguments to pass to the :meth:`apscheduler.schedulers.base.BaseScheduler.add_job()`. Returns: :class:`telegram.ext.Job`: The new :class:`Job` instance that has been added to the job queue. ror,)rjrrrp day_of_weekrrrr8) rsrrrtrejoin _CRON_MAPPINGrrrr?r8ru) r*rgrGrRrirjrkrlrmrddrvs r+ run_dailyJobQueue.run_dailys|J(x((8TT[\ NN " "    !FA"4"4Q"7!FG;;;;[[;DNN$;$;   "GsCcU=(d URn[XXEUS9nURR"UR4X4US.UD6nXlU$)aCreates a new custom defined :class:`Job`. Args: callback (:term:`coroutine function`): The callback function that should be executed by the new job. Callback signature:: async def callback(context: CallbackContext) job_kwargs (:obj:`dict`): Arbitrary keyword arguments. Used as arguments for :meth:`apscheduler.schedulers.base.BaseScheduler.add_job`. data (:obj:`object`, optional): Additional data needed for the callback function. Can be accessed through :attr:`Job.data` in the callback. Defaults to :obj:`None`. .. versionchanged:: 20.0 Renamed the parameter ``context`` to :paramref:`data`. name (:obj:`str`, optional): The name of the new job. Defaults to :external:attr:`callback.__name__ `. chat_id (:obj:`int`, optional): Chat id of the chat associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.chat_data` will be available in the callback. .. versionadded:: 20.0 user_id (:obj:`int`, optional): User id of the user associated with this job. If passed, the corresponding :attr:`~telegram.ext.CallbackContext.user_data` will be available in the callback. .. versionadded:: 20.0 Returns: :class:`telegram.ext.Job`: The new :class:`Job` instance that has been added to the job queue. ro)rrrj)rsrrrtreru) r*rgrmrirjrkrlrdrvs r+ run_customJobQueue.run_customgsWX(x((8TT[\ NN " "4#4#4 `D;T `U_ ` r.cx# URR(dURR5 gg7f)z+Starts the :class:`~telegram.ext.JobQueue`.N)rrunningstartr)s r+rJobQueue.starts)~~%% NN "&s8:waitc,# U(a2[R"URRSS06IShvN URR (a8URR US9 [R"S5IShvN ggNXN7f)zShuts down the :class:`~telegram.ext.JobQueue`. Args: wait (:obj:`bool`, optional): Whether to wait until all currently running jobs have finished. Defaults to :obj:`True`. return_exceptionsTN)rg{Gz?)asynciogatherr_pending_futuresrrshutdownsleep)r*rs r+stop JobQueue.stops| ..00"&   >> ! ! NN # # # .--% % % "   &s"5BBAB B BB)r`.cV[SURR555$)zReturns a tuple of all *scheduled* jobs that are currently in the :class:`JobQueue`. Returns: tuple[:class:`Job`]: Tuple of all *scheduled* jobs. c3L# UHn[RU5v M g7frB)r from_aps_job).0rds r+ JobQueue.jobs..s P6OsS%%c**6Os"$)tuplerget_jobsr)s r+jobs JobQueue.jobss" Pdnn6M6M6OPPPr.cJ^[U4SjUR555$)zReturns a tuple of all *pending/scheduled* jobs with the given name that are currently in the :class:`JobQueue`. Returns: tuple[:class:`Job`]: Tuple of all *pending* or *scheduled* jobs matching the name. c3J># UHoRT:XdMUv M g7frBrj)rrdrjs r+r,JobQueue.get_jobs_by_name..sDKS88t3CSSKs# #)rr)r*rjs `r+get_jobs_by_nameJobQueue.get_jobs_by_namesDDIIKDDDr.r#N)r#3Application[Any, CCT, Any, Any, Any, JobQueue[CCT]])Fr0rr#N)rcz JobQueue[CCT]rdr`r#N)NNNNN)NNNNNNNNNNN)T)+rs __module__ __qualname____firstlineno____doc__ __slots__rr,strr1propertyr0rr(rCrEr boolrKrrTrUrGrr^ staticmethodrerrobjectrSrwrr _ALL_DAYSrrrrrrr__static_attributes__r%r.r+rr3s+Z;IEM   R# RKK" " " H>**>QdQtQQQ   E8--x/@/@(--OP         E8--x/@/@(--QUUV (## $ , AP A  A--6"&"!%!%)-Rc"RE8--x/@/@(--OPRv R sm R # R#RX&R Rp_c]a!%"!%!%)-}c"}x1112}eX%7%79J9JHMMYZ[ } uUH$6$68I8I8==XYZ } v }sm}#}#}X&} }H"&"!%!%)-Lc"LmmL L v L sm L#L#LX&L Ld!*!%"!%!%)-Rc"RmmRCHo R v R sm R#R#RX&R Rp"&"!%!%2c"22v 2 sm 2 # 2#2 2h# &t&t&.QeO,QESEU?-CEr.c \rSrSrSrSrSS\\S\\ S\\ S\\ S \\ 4 S jjr S \ S \ 4S jr S\ S \4SjrS \ 4SjrS \ 4Sjr\SSj5r\S \4Sj5r\S \4Sj5r\R,S\S S4Sj5r\S \\R.4Sj5r\SSj5rSSjrSSjrS SjrSrg)!riaB This class is a convenience wrapper for the jobs held in a :class:`telegram.ext.JobQueue`. With the current backend APScheduler, :attr:`job` holds a :class:`apscheduler.job.Job` instance. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :class:`id ` is equal. This class is a :class:`~typing.Generic` class and accepts one type variable that specifies the type of the argument ``context`` of :paramref:`callback`. Important: If you want to use this class, you must install PTB with the optional requirement ``job-queue``, i.e. .. code-block:: bash pip install "python-telegram-bot[job-queue]" Note: All attributes and instance methods of :attr:`job` are also directly available as attributes/methods of the corresponding :class:`telegram.ext.Job` object. Warning: This class should not be instantiated manually. Use the methods of :class:`telegram.ext.JobQueue` to schedule jobs. .. seealso:: :wiki:`Job Queue ` .. versionchanged:: 20.0 * Removed argument and attribute ``job_queue``. * Renamed ``Job.context`` to :attr:`Job.data`. * Removed argument ``job`` * To use this class, PTB must be installed via ``pip install "python-telegram-bot[job-queue]"``. Args: callback (:term:`coroutine function`): The callback function that should be executed by the new job. Callback signature:: async def callback(context: CallbackContext) data (:obj:`object`, optional): Additional data needed for the :paramref:`callback` function. Can be accessed through :attr:`Job.data` in the callback. Defaults to :obj:`None`. name (:obj:`str`, optional): The name of the new job. Defaults to :external:obj:`callback.__name__ `. chat_id (:obj:`int`, optional): Chat id of the chat that this job is associated with. .. versionadded:: 20.0 user_id (:obj:`int`, optional): User id of the user that this job is associated with. .. versionadded:: 20.0 Attributes: callback (:term:`coroutine function`): The callback function that should be executed by the new job. data (:obj:`object`): Optional. Additional data needed for the :attr:`callback` function. name (:obj:`str`): Optional. The name of the new job. chat_id (:obj:`int`): Optional. Chat id of the chat that this job is associated with. .. versionadded:: 20.0 user_id (:obj:`int`): Optional. User id of the user that this job is associated with. .. versionadded:: 20.0 )_enabledru_removedrgrkrirjrlNrgrirjrkrlc[(d [S5eXlX lU=(d URUlX@lXPlSUlSUl [SS5Ul g)NzWTo use `Job`, PTB must be installed via `pip install "python-telegram-bot[job-queue]"`.FAPSJob) r&r'rgrirsrjrkrlrrrru)r*rgrirjrkrls r+r, Job.__init__s_}5  +3 &* #'#<8+<+< &- &-   4( r.itemr#ct[URU5$![an[SUS35UeSnAff=f)aOverrides :py:meth:`object.__getattr__` to get specific attribute of the :class:`telegram.ext.Job` object or of its attribute :class:`apscheduler.job.Job`, if exists. Args: item (:obj:`str`): The name of the attribute. Returns: :object: The value of the attribute. Raises: :exc:`AttributeError`: If the attribute does not exist in both :class:`telegram.ext.Job` and :class:`apscheduler.job.Job` objects. zDNeither 'telegram.ext.Job' nor 'apscheduler.job.Job' has attribute ''N)getattrrdAttributeError)r*rexcs r+ __getattr__Job.__getattr__1sG 488T* *  VW[V\\]^  s 727othercj[XR5(aURUR:H$g)a Defines equality condition for the :class:`telegram.ext.Job` object. Two objects of this class are considered to be equal if their :class:`id ` are equal. Returns: :obj:`True` if both objects have :paramref:`id` parameters identical. :obj:`False` otherwise. F)r< __class__id)r*rs r+__eq__ Job.__eq__Gs) e^^ , ,77ehh& &r.c,[UR5$)zBuilds a hash value for this object such that the hash of two objects is equal if and only if the objects are equal in terms of :meth:`__eq__`. Returns: :obj:`int`: The hash value of the object. )hashrr)s r+__hash__ Job.__hash__TsDGG}r.c[UURRURURR URR S9$)aGive a string representation of the job in the form ``Job[id=..., name=..., callback=..., trigger=...]``. As this class doesn't implement :meth:`object.__str__`, the default implementation will be used, which is equivalent to :meth:`__repr__`. Returns: :obj:`str` )rrjrgrp)r rdrrjrgrsrpr)s r+r1 Job.__repr__]s@. xx{{]]++HH$$   r.cUR$)z:class:`apscheduler.job.Job`: The APS Job this job is a wrapper for. .. versionchanged:: 20.0 This property is now read-only. )rur)s r+rdJob.jobosyyr.cUR$)z3:obj:`bool`: Whether this job is due to be removed.)rr)s r+removed Job.removedx}}r.cUR$)z):obj:`bool`: Whether this job is enabled.)rr)s r+enabled Job.enabled}rr.statuscU(aURR5 OURR5 XlgrB)rdresumepauser)r*rs r+rrs&  HHOO  HHNN  r.c.URR$)a{ :class:`datetime.datetime`: Datetime for the next job execution. Datetime is localized according to :attr:`datetime.datetime.tzinfo`. If job is removed or already ran it equals to :obj:`None`. Warning: This attribute is only available, if the :class:`telegram.ext.JobQueue` this job belongs to is already started. Otherwise APScheduler raises an :exc:`AttributeError`. )rd next_run_timer)s r+next_t Job.next_tsxx%%%r.c0URSnXlU$)a]Provides the :class:`telegram.ext.Job` that is associated with the given APScheduler job. Tip: This method can be useful when using advanced APScheduler features along with :class:`telegram.ext.JobQueue`. .. versionadded:: 20.4 Args: aps_job (:class:`apscheduler.job.Job`): The APScheduler job Returns: :class:`telegram.ext.Job` rQ)rrru)clsaps_jobext_jobs r+rJob.from_aps_jobs",,q/ r.cj# [R"URU55IShvN gN7f)aMExecutes the callback function independently of the jobs schedule. Also calls :meth:`telegram.ext.Application.update_persistence`. .. versionchanged:: 20.0 Calls :meth:`telegram.ext.Application.update_persistence`. Args: application (:class:`telegram.ext.Application`): The application this job is associated with. N)rshield_runr4s r+rbJob.runs"nnTYY{3444s )313c ,# URRRX5nUR5IShvN URU5IShvN URUS9 g![a8n[R SUR US9 SnAURUS9 gSnAff=fNrN[![a?nURURSX0S9SURS3S9IShvN SnANSnAff=f!URUS9 f=f7f)NzEError while building CallbackContext for job %s. Job will not be run.)exc_info)rdzJob:z:run:process_errorr) context_typescontextfrom_job Exception_LOGGERcriticalru_mark_for_persistence_update refresh_datarg create_task process_errorr)r*r0rrs r+rJob._runs ? %33;;DDTW&&( ( (--( ( (  4 4 4 >#   [II !   4 4 4 >#  ) ( ))))$)>DGG9$67*     4 4 4 >sD%A+B4B0B4B2B4D+ B-5B(B4D(B--B42B44 C=>/C8-C0.C83D8C==DDDcFURR5 SUlg)z~ Schedules this job for removal from the :class:`JobQueue`. It will be removed without executing its callback function again. TN)rdremoverr)s r+schedule_removalJob.schedule_removals  r.r)r#r)rrr#r`rr)rsrrrrrrrrrrrSr,rrrrr1rrdrrsetterrCr classmethodrrbrr rr%r.r+rrs@D I"&"!%!% )c")v)sm ) # ) # )2, F t # # $ ^^dt &!2!23 & &(5P5 5 ?P? ?2r.r))rrrCr[typingrrrrrrr r:apscheduler.executors.asyncior apscheduler.schedulers.asyncior r& ImportErrortelegram._utils.loggingr telegram._utils.reprr telegram._utils.typesrtelegram.ext._extbotrtelegram.ext._utils.typesrrapscheduler.jobrr telegram.extrrrangerrsrrr%r.r+rs&9OOO=?M/?*'61( %(O X* 5T Ews|T EnQ'#,QWMsB B+*B+