+
    ÁFñj�£  ã                   óš  € R t ^ RIt^ RIt^ RIt^ RIt^ RIHtHtH	t	H
t
Ht  ^ RIHt ^ RIHt Rt^ RIHtHt ^ RIHt ^ R	IHt ^ R
IHt ^ RIHt ^ RIHtHt ]'       d   ^ RI H!t! ]'       d   ^ RI"H#t$ ^ RI%H&t& ]'! ](! ^4      4      t)]! ]*RR7      t+R R lt, ! R R]	],          4      t- ! R R]	],          4      t#R#   ] d    Rt L™i ; i)z2This module contains the classes JobQueue and Job.N)ÚTYPE_CHECKINGÚAnyÚGenericÚcastÚoverload)ÚAsyncIOExecutor)ÚAsyncIOSchedulerTF)ÚUTCÚlocalize)Ú
get_logger)Úbuild_repr_with_selected_attrs©ÚJSONDict)ÚExtBot)ÚCCTÚJobCallback)ÚIterable)ÚJob)ÚApplicationÚJobQueue)Ú
class_namec                ó0   € V ^8„  d   QhR\         R\        /# )é   ÚcallbackÚreturn)ÚobjectÚstr)Úformats   "ÚL/opt/hermes-site/venv/lib/python3.14/site-packages/telegram/ext/_jobqueue.pyÚ__annotate__r   7   s   € ÷ 	Nñ 	N¤ð 	N¬Cñ 	Nó    c                óX   € \        V RR4      ;'       g    V P                  P                  # )zíGet the name of a callback function or callable object.

Args:
    callback: A callable object (function, method, or callable class instance)

Returns:
    The name of the callback, using __name__ if available, otherwise the class name.
Ú__name__N)ÚgetattrÚ	__class__r"   )r   s   &r   Ú_get_callback_namer%   7   s'   € ô �8˜Z¨Ó.×MÐM°(×2DÑ2D×2MÑ2MÐMr    c                   óè  a € ] tR t^Ct o RtR)tR*tV 3R lR ltV 3R lR lt]	V 3R lR l4       t
]	V 3R lR	 l4       tV 3R
 lR lt]R+V 3R lR ll4       t]R+V 3R lR ll4       tR+V 3R lR lltV 3R lR lt]V 3R lR l4       tR,V 3R lR lltR-V 3R lR lltR,V 3R lR llt]RRRRR3V 3R lR lltR.V 3R lR  lltV 3R! lR" ltR/V 3R# lR$ lltR0V 3R% lR& lltV 3R' lR( ltR)tV tR# )1r   a@  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 <examples.timerbot>`

.. seealso:: :wiki:`Architecture Overview <Architecture>`,
    :wiki:`Job Queue <Extensions---JobQueue>`

.. 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`

c                ó   <€ V ^8„  d   QhRR/# ©r   r   N© )r   Ú__classdict__s   "€r   r   ÚJobQueue.__annotate__t   s   ø€ ÷ 
ñ 
˜$ñ 
r    c                ó”   € \         '       g   \        R 4      hRV n        \        4       V n        \        R/ V P                  B V n        R# )z\To use `JobQueue`, PTB must be installed via `pip install "python-telegram-bot[job-queue]"`.Nr)   )ÚAPS_AVAILABLEÚRuntimeErrorÚ_applicationr   Ú	_executorr   Úscheduler_configurationÚ	scheduler©Úselfs   &r   Ú__init__ÚJobQueue.__init__t   sI   € ß‹}Üð5óð ð
 HLˆÔÜ(Ó*ˆŒÜ-=ñ .
Ø×*Ñ*ñ.
ˆŽr    c                ó    <€ V ^8„  d   QhRS[ /# ©r   r   ©r   )r   r*   s   "€r   r   r+   �   s   ø€ ÷ 	Rñ 	R™#ñ 	Rr    c                ó.   € \        W P                  R7      # )züGive 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   r;   r3   s   &r   Ú__repr__ÚJobQueue.__repr__�   s   € ô .¨d×@PÑ@PÔQÐQr    c                ó   <€ V ^8„  d   QhRR/# )r   r   ú3Application[Any, CCT, Any, Any, Any, JobQueue[CCT]]r)   )r   r*   s   "€r   r   r+   �   s   ø€ ÷ Kñ KÐRñ Kr    c                óv   € V P                   f   \        R4      hV P                  4       pVe   V# \        R4      h)z1The application this JobQueue is associated with.z)No application was set for this JobQueue.z,The application instance is no longer alive.)r/   r.   ©r4   r;   s   & r   r;   ÚJobQueue.applicationŒ   sB   € ð ×ÑÒ$ÜÐJÓKÐKØ×'Ñ'Ó)ˆØÒ"ØÐÜÐIÓJÐJr    c                ó    <€ V ^8„  d   QhRS[ /# r8   r   )r   r*   s   "€r   r   r+   —   s   ø€ ÷ "
ñ "
©ñ "
r    c                óf  € \         pV P                  '       d‰   \        V P                  P                  \
        4      '       d_   V P                  P                  P                  '       d9   V P                  P                  P                  P                  ;'       g    \         pRVRRV P                  //# )aï  Provides configuration values that are used by :class:`JobQueue` for :attr:`scheduler`.

Tip:
    Since calling
    :meth:`scheduler.configure() <apscheduler.schedulers.base.BaseScheduler.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.

ÚtimezoneÚ	executorsÚdefault)	r	   r/   Ú
isinstancer;   Úbotr   ÚdefaultsÚtzinfor0   )r4   rE   s   & r   r1   Ú JobQueue.scheduler_configuration–   sŠ   € ô0  #ˆà××ÐÜ˜4×+Ñ+×/Ñ/´×8Ò8Ø× Ñ ×$Ñ$×-×-Ð-à×'Ñ'×+Ñ+×4Ñ4×;Ñ;×BÐB¼sˆHð ˜Ø˜) T§^¡^Ð4ð
ð 	
r    c                ó4   <€ V ^8„  d   QhRS[ P                  /# r8   ©ÚdtmÚdatetime)r   r*   s   "€r   r   r+   »   s   ø€ ÷ 9ñ 9™Ÿ™ñ 9r    c                óh   € \         P                  P                  V P                  P                  4      # ©N)rO   rP   Únowr2   rE   r3   s   &r   Ú_tz_nowÚJobQueue._tz_now»   s!   € Ü�|‰|×Ñ §¡× 7Ñ 7Ó8Ð8r    c                ó(   <€ V ^8„  d   QhRRRS[ RR/# ©r   ÚtimeNÚ	shift_dayr   ©Úbool)r   r*   s   "€r   r   r+   ¿   s   ø€ ×QÑQ dÐQ±tÐQÈÑQr    c                ó   € R # rR   r)   ©r4   rX   rY   s   &&&r   Ú_parse_time_inputÚJobQueue._parse_time_input¾   s   € ÙNQr    c                ó¬   <€ V ^8„  d   QhRS[ S[P                  ,          S[P                  ,          S[P                  ,          RS[RS[P                  /# )r   rX   rY   r   ©ÚfloatrO   Ú	timedeltarP   rX   r[   )r   r*   s   "€r   r   r+   Â   sH   ø€ ÷ ñ á‘c—m‘mÕ#¡c§l¡lÕ2±S·X±XÕ=ðñ ðñ 
�‰ñ	r    c                ó   € R # rR   r)   r]   s   &&&r   r^   r_   Á   s   € ñ
 r    c                óÈ   <€ V ^8„  d   QhRS[ S[P                  ,          S[P                  ,          S[P                  ,          R,          RS[RS[P                  R,          /# rW   ra   )r   r*   s   "€r   r   r+   È   sR   ø€ ÷ ñ á‘c—m‘mÕ#¡c§l¡lÕ2±S·X±XÕ=ÀÕDðñ ðñ 
�‰˜Õ	ñ	r    c                ó<  € Vf   R # \        V\        \        ,          4      '       d-   V P                  4       \        P
                  ! VR7      ,           # \        V\        P
                  4      '       d   V P                  4       V,           # \        V\        P                  4      '       dò   \        P                  P                  \        P                  P                  VP                  ;'       g    V P                  P                  R7      P                  4       V4      pVP                  f    \        W0P                  P                  4      pV'       dG   V\        P                  P                  \        4      8:  d   V\        P
                  ! ^R7      ,          pV# V# )N)Úseconds)Útz)Údays)rH   Úintrb   rT   rO   rc   rX   rP   ÚcombinerS   rK   r2   rE   Údater
   r	   )r4   rX   rY   Ú	date_times   &&& r   r^   r_   È   s  € ð
 Š<ÙÜ�dœC¤%�K×(Ò(Ø—<‘<“>¤C§M¢M¸$Ô$?Õ?Ð?Ü�dœCŸM™M×*Ò*Ø—<‘<“> DÕ(Ð(Ü�dœCŸH™H×%Ò%ÜŸ™×,Ñ,Ü—‘× Ñ  D§K¡K×$JÐ$J°4·>±>×3JÑ3JÐ ÓK×PÑPÓRÐTXóˆIð ×ÑÒ'ô % Y·±×0GÑ0GÓH�	ß˜Y¬#¯,©,×*:Ñ*:¼3Ó*?Ô?ØœSŸ]š]°Ô2Õ2�	ØÐØˆr    c                ó"   <€ V ^8„  d   QhRRRR/# ©r   r;   r?   r   Nr)   )r   r*   s   "€r   r   r+   à   s!   ø€ ÷ 
Añ 
AØPð
Aà	ñ
Ar    c                óˆ   € \         P                  ! V4      V n        V P                  P                  ! R/ V P
                  B  R# )zSet the application to be used by this JobQueue.

Args:
    application (:class:`telegram.ext.Application`): The application.

Nr)   )ÚweakrefÚrefr/   r2   Ú	configurer1   rA   s   &&r   Úset_applicationÚJobQueue.set_applicationà   s0   € ô $ŸKšK¨Ó4ˆÔØ�‰× Ò Ñ@ 4×#?Ñ#?Ô@r    c                ó&   <€ V ^8„  d   QhRRRRRR/# )r   Ú	job_queuezJobQueue[CCT]ÚjobúJob[CCT]r   Nr)   )r   r*   s   "€r   r   r+   í   s"   ø€ ÷ -ñ - oð -¸Jð -È4ñ -r    c              ƒ  óX   "  € VP                  V P                  4      G Rj  x€L
  R#  L5i)a!  This method is used as a callback for the APScheduler jobs.

More precisely, the ``func`` argument of :class:`apscheduler.job.Job` is set to this method
and the ``arg`` argument (representing positional arguments to ``func``) is set to a tuple
containing the :class:`JobQueue` itself and the :class:`~telegram.ext.Job` instance.

Tip:
    This method is a static method rather than a bound method. This makes the arguments
    more transparent and allows for easier handling of PTBs integration of APScheduler
    when utilizing advanced features of APScheduler.

Hint:
    This method is effectively a wrapper for :meth:`telegram.ext.Job.run`.

.. versionadded:: 20.4

Args:
    job_queue (:class:`JobQueue`): The job queue that created the job.
    job (:class:`~telegram.ext.Job`): The job to run.
N)Úrunr;   )rw   rx   s   &&r   Újob_callbackÚJobQueue.job_callbackì   s   é € ð, �g‰g�i×+Ñ+Ó,×,Ô,ùs   ‚*¡(¢*Nc                ó
  <€ V ^8„  d   QhRS[ S[,          RS[S[P                  ,          S[P
                  ,          S[P                  ,          RS[R,          RS[R,          RS[	R,          RS[	R,          RS[
R,          R	R
/# )r   r   ÚwhenÚdataNÚnameÚchat_idÚuser_idÚ
job_kwargsr   ry   ©r   r   rb   rO   rc   rP   rX   r   r   rj   r   )r   r*   s   "€r   r   r+     s™   ø€ ÷ Rñ Rá™cÕ"ðRñ ‘c—m‘mÕ#¡c§l¡lÕ2±S·X±XÕ=ðRñ �t�mð	Rñ
 �D�jðRñ �t•ðRñ �t•ðRñ ˜t•OðRð 
ñRr    c                óF  € V'       g   / pT;'       g    \        V4      p\        WWEVR7      pV P                  VRR7      p	V P                  P                  ! V P
                  3RTRRRT	RW3R	V	P                  ;'       g    V P                  P                  /VB p
W¨n        V# )
ao
  Creates a new :class:`Job` instance that runs once and adds it to the queue.

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:`int` | :obj:`float` | :obj:`datetime.timedelta` |                                           :obj:`datetime.datetime` | :obj:`datetime.time`):
        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, which is UTC unless
          :attr:`telegram.ext.Defaults.tzinfo` is 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.

    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
    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__ <definition.__name__>`.
    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.

©r   r€   r�   r‚   rƒ   T)rY   r�   Útriggerrl   Úrun_dateÚargsrE   )	r%   r   r^   r2   Úadd_jobr|   rK   rE   Ú_job)r4   r   r   r€   r�   r‚   rƒ   r„   rx   rm   Újs   &&&&&&&&   r   Úrun_onceÚJobQueue.run_once  sÁ   € ÷@ ØˆJà×3Ð3Ô)¨(Ó3ˆÜ˜8°TÐT[Ô\ˆØ×*Ñ*¨4¸4Ð*Ó@ˆ	à�N‰N×"Ò"Ø×Ññ
àð
ð ð
ð ð	
ð
 �ð
ð ×%Ñ%×@Ð@¨¯©×)@Ñ)@ð
ð ñ
ˆð ŒØˆ
r    c                óÂ  <€ V ^8„  d   QhRS[ S[,          RS[S[P                  ,          RS[S[P                  ,          S[P
                  ,          S[P                  ,          R,          RS[S[P                  ,          S[P
                  ,          S[P                  ,          R,          RS[R,          RS[R,          RS[	R,          R	S[	R,          R
S[
R,          RR/
# )r   r   ÚintervalÚfirstNÚlastr€   r�   r‚   rƒ   r„   r   ry   r…   )r   r*   s   "€r   r   r+   X  sÝ   ø€ ÷ }ñ }á™cÕ"ð}ñ ™#Ÿ-™-Õ'ð}ñ ‘s—}‘}Õ$¡s§|¡|Õ3±c·h±hÕ>ÀÕEð	}ñ
 ‘c—m‘mÕ#¡c§l¡lÕ2±S·X±XÕ=ÀÕDð}ñ �t�mð}ñ �D�jð}ñ �t•ð}ñ �t•ð}ñ ˜t•Oð}ð 
ñ}r    c
                óº  € V	'       g   / p	T;'       g    \        V4      p\        WWgVR7      p
V P                  V4      pV P                  V4      pV'       d   V'       d   WË8  d   \        R4      h\	        V\
        P                  4      '       d   VP                  4       pV P                  P                  ! V P                  3RRRW
3RVRVRVR	V/V	B pWÚn        V
# )
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__ <definition.__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.

r‡   z"'last' must not be before 'first'!rˆ   r‘   rŠ   Ú
start_dateÚend_daterg   r�   )r%   r   r^   Ú
ValueErrorrH   rO   rc   Útotal_secondsr2   r‹   r|   rŒ   )r4   r   r‘   r’   r“   r€   r�   r‚   rƒ   r„   rx   Údt_firstÚdt_lastr�   s   &&&&&&&&&&    r   Úrun_repeatingÚJobQueue.run_repeatingX  só   € ÷D ØˆJà×3Ð3Ô)¨(Ó3ˆÜ˜8°TÐT[Ô\ˆà×)Ñ)¨%Ó0ˆØ×(Ñ(¨Ó.ˆç—x GÔ$6ÜÐAÓBÐBä�h¤§¡×.Ò.Ø×-Ñ-Ó/ˆHà�N‰N×"Ò"Ø×Ññ	
àð	
ð �ð	
ð  ð		
ð
 ð	
ð ð	
ð ð	
ð ñ	
ˆð ŒØˆ
r    c                ó¸   <€ V ^8„  d   QhRS[ S[,          RS[P                  RS[RS[R,          RS[R,          RS[R,          RS[R,          R	S[R,          R
R/	# )r   r   r   Údayr€   Nr�   r‚   rƒ   r„   r   ry   )r   r   rO   rX   rj   r   r   r   )r   r*   s   "€r   r   r+   ×  s�   ø€ ÷ Lñ Lá™cÕ"ðLñ �h‰hðLñ ð	Lñ
 �t�mðLñ �D�jðLñ �t•ðLñ �t•ðLñ ˜t•OðLð 
ñLr    c	                óz  € V'       g   / pT;'       g    \        V4      p\        WWVVR7      p	V P                  P                  ! V P                  3RRRW	3RTRVR8X  d   RMTRVP
                  R	VP                  R
VP                  RVP                  ;'       g    V P                  P                  /VB p
W©n
        V	# )a¦  Creates 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__ <definition.__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.

r‡   rˆ   ÚcronrŠ   r�   rž   r“   ÚhourÚminuteÚsecondrE   éÿÿÿÿ)r%   r   r2   r‹   r|   r¡   r¢   r£   rK   rE   rŒ   )r4   r   r   rž   r€   r�   r‚   rƒ   r„   rx   r�   s   &&&&&&&&&  r   Úrun_monthlyÚJobQueue.run_monthly×  sÜ   € ÷r ØˆJà×3Ð3Ô)¨(Ó3ˆÜ˜8°TÐT[Ô\ˆà�N‰N×"Ò"Ø×Ññ
àð
ð �ð
ð ð	
ð
  œ)‘¨ð
ð —‘ð
ð —;‘;ð
ð —;‘;ð
ð —[‘[×;Ð; D§N¡N×$;Ñ$;ð
ð ñ
ˆð ŒØˆ
r    c                óÌ   <€ V ^8„  d   QhRS[ S[,          RS[P                  RS[S[R3,          RS[R,          RS[R,          RS[R,          R	S[R,          R
S[R,          RR/	# )r   r   rX   ri   .r€   Nr�   r‚   rƒ   r„   r   ry   )	r   r   rO   rX   Útuplerj   r   r   r   )r   r*   s   "€r   r   r+   %  s•   ø€ ÷ Rñ Rá™cÕ"ðRñ �h‰hðRñ ‘C˜�H�oð	Rñ
 �t�mðRñ �D�jðRñ �t•ðRñ �t•ðRñ ˜t•OðRð 
ñRr    c	                óÐ  € V'       g   / pT;'       g    \        V4      p\        WWVVR7      p	V P                  P                  ! V P                  3RTRW	3RRRRP                  V U
u. uF  q P                  V
,          NK  	  up
4      RVP                  R	VP                  R
VP                  RVP                  ;'       g    V P                  P                  /VB pW¹n        V	# u up
i )a×  Creates 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__ <definition.__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.

r‡   r�   rŠ   rˆ   r    Úday_of_weekÚ,r¡   r¢   r£   rE   )r%   r   r2   r‹   r|   ÚjoinÚ_CRON_MAPPINGr¡   r¢   r£   rK   rE   rŒ   )r4   r   rX   ri   r€   r�   r‚   rƒ   r„   rx   Údr�   s   &&&&&&&&&   r   Ú	run_dailyÚJobQueue.run_daily%  sþ   € ÷| ØˆJà×3Ð3Ô)¨(Ó3ˆÜ˜8°TÐT[Ô\ˆà�N‰N×"Ò"Ø×Ññ
àð
ð �ð
ð ð	
ð
 Ÿ™ÁÓ!FÁ¸A×"4Ñ"4°Q×"7Ð"7ÁÑ!FÓGð
ð —‘ð
ð —;‘;ð
ð —;‘;ð
ð —[‘[×;Ð; D§N¡N×$;Ñ$;ð
ð ñ
ˆð ŒØˆ
ùò "Gs   Á'C#c                óŠ   <€ V ^8„  d   QhRS[ S[,          RS[RS[R,          RS[R,          RS[R,          RS[R,          RR	/# )
r   r   r„   r€   Nr�   r‚   rƒ   r   ry   )r   r   r   r   r   rj   )r   r*   s   "€r   r   r+   y  sf   ø€ ÷ 2ñ 2á™cÕ"ð2ñ ð2ñ �t�mð	2ñ
 �D�jð2ñ �t•ð2ñ �t•ð2ð 
ñ2r    c                ó°   € T;'       g    \        V4      p\        WWEVR7      pV P                  P                  ! V P                  3RW3RV/VB pW‡n        V# )a„  Creates 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__ <definition.__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.

r‡   rŠ   r�   )r%   r   r2   r‹   r|   rŒ   )	r4   r   r„   r€   r�   r‚   rƒ   rx   r�   s	   &&&&&&&  r   Ú
run_customÚJobQueue.run_customy  s]   € ðX ×3Ð3Ô)¨(Ó3ˆÜ˜8°TÐT[Ô\ˆà�N‰N×"Ò" 4×#4Ñ#4Ñ`¸D¸;Ð`ÈTÐ`ÐU_Ñ`ˆàŒØˆ
r    c                ó   <€ V ^8„  d   QhRR/# r(   r)   )r   r*   s   "€r   r   r+   ­  s   ø€ ÷ #ñ #˜Tñ #r    c              ƒ  ó~   "  € V P                   P                  '       g   V P                   P                  4        R# R# 5i)z+Starts the :class:`~telegram.ext.JobQueue`.N)r2   ÚrunningÚstartr3   s   &r   r¸   ÚJobQueue.start­  s,   é € ð �~‰~×%×%Ð%Ø�N‰N× Ñ Ö"ñ &ùs   ‚;=c                ó$   <€ V ^8„  d   QhRS[ RR/# )r   Úwaitr   NrZ   )r   r*   s   "€r   r   r+   ³  s   ø€ ÷ &ñ &™tð &¨tñ &r    c              ƒ  ó:  "  € V'       d3   \         P                  ! V P                  P                  RR/ G Rj  x€L
  V P                  P
                  '       d=   V P                  P                  VR7       \         P                  ! R4      G Rj  x€L
  R# R#  L^ L
5i)z»Shuts 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)r»   g{®Gáz„?)ÚasyncioÚgatherr0   Ú_pending_futuresr2   r·   ÚshutdownÚsleep)r4   r»   s   &&r   ÚstopÚJobQueue.stop³  s   é € ÷ ä—.’.Ø—‘×0Ñ0ðà"&ñ÷ ð ð �>‰>×!×!Ð!Ø�N‰N×#Ñ#¨Ð#Ô.ô —-’- Ó%×%Ò%ñ	 "ñ	ñ &ùs'   ‚6B¸B¹BÁ5BÂBÂ	BÂBc                óv   <€ V ^8„  d   QhRS[ S[P                  S[ ,          ,          R,          RS[R,          /# )r   ÚpatternNr   ©ry   .)r   ÚreÚPatternr¨   )r   r*   s   "€r   r   r+   Ê  s2   ø€ ÷ 
ñ 
™C¡"§*¡*©S¥/Õ1°DÕ8ð 
ÁEÈ/ÕDZñ 
r    c                óÈ   a€ R V P                   P                  4        4       pSf   \        V4      # \        ;QJ d    . V3R lV 4       F  NK  	  5# ! V3R lV 4       4      # )aÕ  Returns a tuple of all *scheduled* jobs that are currently in the :class:`JobQueue`.

Args:
    pattern (:obj:`str` | :obj:`re.Pattern`, optional): A regular expression pattern. If
        passed, only jobs whose name matches the pattern will be returned.
        Defaults to :obj:`None`.

        Hint:
            This uses :func:`re.search` and not :func:`re.match`.

        .. versionadded:: 21.10

Returns:
    tuple[:class:`Job`]: Tuple of all *scheduled* jobs.
c              3   óL   "  € T F  p\         P                  V4      x € K  	  R # 5irR   )r   Úfrom_aps_job)Ú.0rx   s   & r   Ú	<genexpr>Ú JobQueue.jobs.<locals>.<genexpr>Ú  s"   é € ð )
Ù-F cŒC×Ñ˜S×!Ð!Ó-Fùs   ‚"$c              3   ó¼   <"  € T FQ  qP                   '       g   K  \        P                  ! S4      P                  VP                   4      '       g   KM  Vx € KS  	  R # 5irR   )r�   rÈ   ÚcompileÚsearch)rÍ   rx   rÆ   s   & €r   rÎ   rÏ   ß  s9   øé € ð 
Ù)�C¯h­hŒC¼2¿:º:ÀgÓ;N×;UÑ;UÐVY×V^ÑV^×;_�CŠC›>ùs   ƒA›2AÁ
A)r2   Úget_jobsr¨   )r4   rÆ   Újobs_generators   &f r   ÚjobsÚJobQueue.jobsÊ  sc   ø€ ñ )
Ø-1¯^©^×-DÑ-DÔ-Fó)
ˆð Š?Ü˜Ó(Ð(ßŒuô 
Ù)ó
�uð 	
ˆuô 
Ù)ó
ó 
ð 	
r    c                ó4   <€ V ^8„  d   QhRS[ RS[R,          /# )r   r�   r   rÇ   )r   r¨   )r   r*   s   "€r   r   r+   ã  s    ø€ ÷ 1ñ 1¡Sð 1©U°?Õ-Cñ 1r    c                óT   € V P                  R\        P                  ! V4       R24      # )a.  Returns a tuple of all *scheduled* jobs with the given name that are currently
in the :class:`JobQueue`.

Hint:
    This method is a convenience wrapper for :meth:`jobs` with a pattern that matches the
    given name.

Returns:
    tuple[:class:`Job`]: Tuple of all *scheduled* jobs matching the name.
Ú^Ú$)rÕ   rÈ   Úescape)r4   r�   s   &&r   Úget_jobs_by_nameÚJobQueue.get_jobs_by_nameã  s%   € ð �y‰y˜1œRŸYšY t›_Ð-¨QÐ/Ó0Ð0r    )r/   r0   r2   )ÚsunÚmonÚtueÚwedÚthuÚfriÚsat)F)NNNNN)NNNNNNN©NNNN)TrR   )r"   Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Ú	__slots__r­   r5   r<   Úpropertyr;   r1   rT   r   r^   rt   Ústaticmethodr|   rŽ   r›   r¥   Ú	_ALL_DAYSr¯   r³   r¸   rÃ   rÕ   rÜ   Ú__static_attributes__Ú__classdictcell__©r*   s   @r   r   r   C   s1  ø‡ € ñ+ðZ ;€IØE€M÷
ð 
÷	Rð 	Rð ÷Kó ðKð ÷"
ó ð"
÷H9ð 9ð ßQÑQó ØQà÷ñ ó ð÷ò ÷0
Að 
Að ÷-ó ð-÷.Rò R÷h}ò }÷~Lò Lðd !*Ø"ØØ"Ø"Ø&*÷Rò R÷h2ò 2÷h#ð #÷&ò &÷.
ò 
÷21ö 1r    c                   óx  a € ] tR tRt o RtR tR!V 3R lR lltV 3R lR ltV 3R lR	 ltV 3R
 lR lt	V 3R lR lt
]V 3R lR l4       t]V 3R lR l4       t]V 3R lR l4       t]P                  V 3R lR l4       t]V 3R lR l4       t]V 3R lR l4       tV 3R lR ltV 3R lR ltV 3R lR ltR tV tR# )"r   iñ  aB
  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 <apscheduler.job.Job>` 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 <Extensions---JobQueue>`

.. 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__ <definition.__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
Nc                ó€   <€ V ^8„  d   QhRS[ S[,          RS[R,          RS[R,          RS[R,          RS[R,          /# )r   r   r€   Nr�   r‚   rƒ   )r   r   r   r   rj   )r   r*   s   "€r   r   ÚJob.__annotate__?  sR   ø€ ÷ )ñ )á™cÕ"ð)ñ �t�mð)ñ �D�jð	)ñ
 �t•ð)ñ �t•ñ)r    c                óÖ   € \         '       g   \        R 4      hWn        W n        T;'       g    \	        V4      V n        W@n        WPn        RV n        RV n	        \        RR4      V n        R# )zWTo use `Job`, PTB must be installed via `pip install "python-telegram-bot[job-queue]"`.FÚAPSJobN)r-   r.   r   r€   r%   r�   r‚   rƒ   Ú_removedÚ_enabledr   rŒ   )r4   r   r€   r�   r‚   rƒ   s   &&&&&&r   r5   ÚJob.__init__?  sb   € ÷ ‹}Üð5óð ð
 +3ŒØ#'Œ	Ø $× DÐ DÔ(:¸8Ó(DˆŒ	Ø#*ŒØ#*ŒàˆŒØˆŒä˜ 4Ó(ˆŽ	r    c                ó&   <€ V ^8„  d   QhRS[ RS[/# )r   Úitemr   )r   r   )r   r*   s   "€r   r   ró   X  s   ø€ ÷ ñ ¡ð ©ñ r    c                óv   €  \        V P                  V4      #   \         d   p\        RT R24      ThRp?ii ; i)aª  Overrides :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)r#   rx   ÚAttributeError)r4   rú   Úexcs   && r   Ú__getattr__ÚJob.__getattr__X  sG   € ð	Ü˜4Ÿ8™8 TÓ*Ð*øÜô 	Ü ØVÐW[ÐV\Ð\]Ð^óàðûð	ús   ‚ ˜8£3³8c                ó&   <€ V ^8„  d   QhRS[ RS[/# )r   Úotherr   )r   r[   )r   r*   s   "€r   r   ró   n  s   ø€ ÷ ñ ™Fð ¡tñ r    c                ón   € \        WP                  4      '       d   V P                  VP                  8H  # R# )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 <apscheduler.job.Job>` are equal.

Returns:
    :obj:`True` if both objects have :paramref:`id` parameters identical.
    :obj:`False` otherwise.
F)rH   r$   Úid)r4   r  s   &&r   Ú__eq__Ú
Job.__eq__n  s)   € ô �eŸ^™^×,Ò,Ø—7‘7˜eŸh™hÑ&Ð&Ùr    c                ó    <€ V ^8„  d   QhRS[ /# r8   )rj   )r   r*   s   "€r   r   ró   {  s   ø€ ÷ ñ ™#ñ r    c                ó,   € \        V P                  4      # )zÈBuilds 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.
)Úhashr  r3   s   &r   Ú__hash__ÚJob.__hash__{  s   € ô �D—G‘G‹}Ðr    c                ó    <€ V ^8„  d   QhRS[ /# r8   r9   )r   r*   s   "€r   r   ró   „  s   ø€ ÷ 
ñ 
™#ñ 
r    c                ó¬   € \        V V P                  P                  V P                  \	        V P
                  4      V P                  P                  R7      # )a  Give 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`
)r  r�   r   rˆ   )r   rx   r  r�   r%   r   rˆ   r3   s   &r   r<   ÚJob.__repr__„  s?   € ô .ØØ�x‰x�{‰{Ø—‘Ü'¨¯©Ó6Ø—H‘H×$Ñ$ô
ð 	
r    c                ó   <€ V ^8„  d   QhRR/# )r   r   rõ   r)   )r   r*   s   "€r   r   ró   —  s   ø€ ÷ ñ �Xñ r    c                ó   € V P                   # )zƒ:class:`apscheduler.job.Job`: The APS Job this job is a wrapper for.

.. versionchanged:: 20.0
    This property is now read-only.
)rŒ   r3   s   &r   rx   ÚJob.job–  s   € ð �y‰yÐr    c                ó    <€ V ^8„  d   QhRS[ /# r8   rZ   )r   r*   s   "€r   r   ró      ó   ø€ ÷ ñ ™ñ r    c                ó   € V P                   # )z3:obj:`bool`: Whether this job is due to be removed.)rö   r3   s   &r   ÚremovedÚJob.removedŸ  ó   € ð �}‰}Ðr    c                ó    <€ V ^8„  d   QhRS[ /# r8   rZ   )r   r*   s   "€r   r   ró   ¥  r  r    c                ó   € V P                   # )z):obj:`bool`: Whether this job is enabled.)r÷   r3   s   &r   ÚenabledÚJob.enabled¤  r  r    c                ó$   <€ V ^8„  d   QhRS[ RR/# )r   Ústatusr   NrZ   )r   r*   s   "€r   r   ró   ª  s   ø€ ÷ ñ ™dð  tñ r    c                óŒ   € V'       d   V P                   P                  4        MV P                   P                  4        Wn        R # rR   )rx   ÚresumeÚpauser÷   )r4   r  s   &&r   r  r  ©  s&   € çØ�H‰H�O‰OÕà�H‰H�N‰NÔØŽr    c                óB   <€ V ^8„  d   QhRS[ P                  R,          /# r(   rN   )r   r*   s   "€r   r   ró   ²  s   ø€ ÷ 
&ñ 
&™Ÿ™ tÕ+ñ 
&r    c                ó.   € V P                   P                  # )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`.
)rx   Únext_run_timer3   s   &r   Únext_tÚ
Job.next_t±  s   € ð �x‰x×%Ñ%Ð%r    c                ó"   <€ V ^8„  d   QhRRRR/# )r   Úaps_jobrõ   r   ry   r)   )r   r*   s   "€r   r   ró   ¿  s   ø€ ÷ ñ  8ð °
ñ r    c                ó8   € VP                   ^,          pWn        V# )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`
)rŠ   rŒ   )Úclsr'  Úext_jobs   && r   rÌ   ÚJob.from_aps_job¾  s   € ð" —,‘,˜q•/ˆØŒØˆr    c                ó"   <€ V ^8„  d   QhRRRR/# ro   r)   )r   r*   s   "€r   r   ró   Ó  s   ø€ ÷ 5ñ 5ØPð5à	ñ5r    c              ƒ  ól   "  € \         P                  ! V P                  V4      4      G Rj  x€L
  R#  L5i)aM  Executes 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)r¾   ÚshieldÚ_runrA   s   &&r   r{   ÚJob.runÓ  s"   é € ô �nŠn˜TŸY™Y {Ó3Ó4×4Ô4ùs   ‚)4«2¬4c                ó"   <€ V ^8„  d   QhRRRR/# ro   r)   )r   r*   s   "€r   r   ró   ã  s   ø€ ÷ ?ñ ?ØPð?à	ñ?r    c           	   ƒ  óX  "  €   VP                   P                  P                  W4      pTP                  4       G Rj  x€L
  T P                  T4      G Rj  x€L
  TP                  T R7       R#   \         d@   p\        P                  R T P                  TR7        Rp?TP                  T R7       R# Rp?ii ; i L~ Lg  \         dF   pTP                  TP                  RY0R7      RT P                   R2R7      G Rj  x€L 
   Rp?L°Rp?ii ; i  TP                  T R7       i ; i5i)zEError while building CallbackContext for job %s. Job will not be run.)Úexc_infoN)rx   zJob:z:run:process_error)r�   )Úcontext_typesÚcontextÚfrom_jobÚ	ExceptionÚ_LOGGERÚcriticalrŒ   Ú_mark_for_persistence_updateÚrefresh_datar   Úcreate_taskÚprocess_errorr  )r4   r;   r5  rþ   s   &&  r   r/  ÚJob._runã  s  é € ð	?ðØ%×3Ñ3×;Ñ;×DÑDÀTÓW�ð ×&Ñ&Ó(×(Ð(Ø—-‘- Ó(×(Ð(ð ×4Ñ4¸Ð4Ö>øô# ô Ü× Ñ Ø[Ø—I‘IØ ð !ô ó
 ð ×4Ñ4¸Ð4Ö>ûð#úñ )Ù(øÜô 	Ø×)Ñ)Ø×)Ñ)¨$°Ð)Ó>Ø˜DŸG™G˜9Ð$6Ð7ð *ó ÷ ö ûð	ûð ×4Ñ4¸Ð4Õ>üs‹   ‚D*…%A/ ªC  ½B<¾C  ÁB>ÁC  ÁD*Á/B9Á:"B4ÂC  Â D*Â4B9Â9C  Â>C  Ã DÃ5DÄ DÄDÄD ÄDÄD ÄD'Ä'D*c                ó   <€ V ^8„  d   QhRR/# r(   r)   )r   r*   s   "€r   r   ró   ü  s   ø€ ÷ ñ  $ñ r    c                óH   € V P                   P                  4        RV n        R# )z~
Schedules this job for removal from the :class:`JobQueue`. It will be removed without
executing its callback function again.
TN)rx   Úremoverö   r3   s   &r   Úschedule_removalÚJob.schedule_removalü  s   € ð
 	�‰�‰ÔØˆŽr    )r÷   rŒ   rö   r   r‚   r€   r�   rƒ   rå   )r"   ræ   rç   rè   ré   rê   r5   rÿ   r  r
  r<   rë   rx   r  r  Úsetterr$  ÚclassmethodrÌ   r{   r/  rB  rî   rï   rð   s   @r   r   r   ñ  sß   ø‡ € ñ@ðD	€I÷)ò )÷2ð ÷,ð ÷ð ÷
ð 
ð$ ÷ó ðð ÷ó ðð ÷ó ðð ‡^�^÷ó ðð ÷
&ó ð
&ð ÷ó ð÷(5ð 5÷ ?ð ?÷2ö r    r   ).ré   r¾   rP   rO   rÈ   rq   Útypingr   r   r   r   r   Úapscheduler.executors.asyncior   Úapscheduler.schedulers.asyncior   r-   ÚImportErrorÚtelegram._utils.datetimer	   r
   Útelegram._utils.loggingr   Útelegram._utils.reprr   Útelegram._utils.typesr   Útelegram.ext._extbotr   Útelegram.ext._utils.typesr   r   Úcollections.abcr   Úapscheduler.jobr   rõ   Útelegram.extr   r¨   Úrangerí   r"   r8  r%   r   r)   r    r   Ú<module>rT     s¬   ðñ& 9ã Û Û 	Û ß >Õ >ðÝ=Ý?à€M÷ 3Ý .Ý ?Ý *Ý 'ß 6çÝ(çÝ1å(ñ ‘%˜“(‹O€	Ù
�X¨*Ô
5€õ	Nôk
1ˆw�s�|ô k
1ô\Qˆ'�#�,ö Qøðc ô Ø‚Mðús   ¢B> Â>	C
Ã	C
