Y
d Z ddlmZ ddlmZmZ ddlZddlZddlZg dZ e e Z
e e
\ Z Z
ZZZZZg dZeddd d
d d d
dddddd edddd d
d d diZdddddddZdZej d k reefZe Znee efZ ed Z ed Z ed Z ed Z ed
Z! ed! Z" ed" Z# e$ Z%d# Z&d$ Z'd% Z(d& d' d( d) e'd* e(d+ d, d- d. d/ d0 g
Z)d1 Z*d2 Z+d3 Z,d4 Z-d5 d6 d7 e*e+d8 e,d9 d: d; e-d< d= e,gZ. ed>d? Z/d@ Z0 G dA dBe$ Z1dC Z2 G dD dEe$ Z3 ed fdFZ4dS )Ga>
crontab.py
Originally written July 15, 2011 by Josiah Carlson
Copyright 2011-2025 Josiah Carlson
Released under the GNU LGPL v2.1 and v3
available:
http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
http://www.gnu.org/licenses/lgpl.html
Other licenses may be available upon request.
)
namedtuple)datetime timedeltaN)r ; r )r ) )r )r ) i3 )secondminutehourdaymonth
isoweekdayyearr r
r ) janfebmaraprmayjunjulaugsepoctnovdec)sunmontuewedthufrisatz 0 0 1 1 *z 0 0 1 * *z 0 0 * * 0z 0 0 * * *z 0 * * * *)z@yearlyz @annuallyz@monthlyz@weeklyz@dailyz@hourlya Version 0.22.0+ of crontab will use datetime.utcnow() and
datetime.utcfromtimestamp() instead of datetime.now() and
datetime.fromtimestamp() as was previous. This had been a bug, which will be
remedied. If you would like to keep the *old* behavior:
`ct.next(..., default_utc=False)` . If you want to use the new behavior *now*:
`ct.next(..., default_utc=True)`. If you pass a datetime object with a tzinfo
attribute that is not None, timezones will *just work* to the best of their
ability. There are tests...)r r )seconds)minutes)hours)days im c | t z }| j |j k r|t z
}| j |j k | d t z
S Nr )r )DAYr replace)dtndts p/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/crontab/_crontab.py
_end_of_monthr= W sM
s(C
(ci
s
(ci
;;1; ## c | }| t z
} | j |j k r| t z
} | j |j k | d } | |z
S r7 )MONTHr r8 r9 r: modts r< _month_incrrD ] sW
C%KB
(ci
c
(ci
B
8Or> c | j dz }|dk r!| j | j fdk rt t z S |dk r!| j | j fdk rt t z S t S )Nr r r r r r r YEARr8 r: rB mods r<
_year_incrrL f s^
'A+C
axxRXrv&00cz
axxRXrv&00cz Kr> c t S NSECONDas r< rS p v r> c t S rN MINUTErQ s r< rS rS q rT r> c t S rN HOURrQ s r< rS rS r s t r> c t S rN r8 rQ s r< rS rS s s r> c t S rN r\ rQ s r< rS rS u r] r> c . | d S )Nr r r9 r: xs r< rS rS w 1%% r> c . | d S )Nr r ra rb s r< rS rS x rd r> c . | d S )Nr r ra rb s r< rS rS y s ## r> c H |t k r| d n| S r7 r8 r9 rb s r< rS rS z s! a#gg"""2 r> c H |t k r| d n| S )Nr r rj rb s r< rS rS { s! C!$$$R r> c | S rN rb s r< rS rS | r> c |j j dk rt S | }| t z
x}} | j |j k r| t z } | j |j k | |z
S )Nl)r inputr8 r )r: rB rC r; s r< _day_decrrs s] u{ct
CCxC"
(ci
c
(ci
8Or> c L | }| d t z
} | |z
S r7 )r9 r8 rA s r< _month_decrru s(
C S B
8Or> c | j dz }|dk r"| j | j fdk rt t z S |dk r"| j | j fdk rt t z S t S )Nr r rF r rH rJ s r<
_year_decrrw sd
'A+C
axxRXrv&00}
axxRXrv&00} 5Lr> c |t k r| S | j }| j |k r| t z
} | j |k | t z
S rN )r8 r )r: rc curs r< _day_decr_resetrz sC SDyy
(C
(c//
c
(c//
8Or> c t S rN rO rQ s r< rS rS w r> c t S rN rV rQ s r< rS rS r| r> c t S rN rY rQ s r< rS rS s u r> c t S rN r\ rQ s r< rS rS s t r> c . | d S )Nr r` ra rb s r< rS rS 2&& r> c . | d S )Nr rf ra rb s r< rS rS r r> c . | d S )Nr rh ra rb s r< rS rS s $$ r> c J |t k r| d n| S )Nr rl rj rb s r< rS rS s# cT"%%%r r> c | S rN rn rb s r< rS rS ro r> Matcherz/second, minute, hour, day, month, weekday, yearc . | st ||z d S rN )
ValueError) conditionmessageargss r< _assertr s& ' &&&' 'r> c > e Zd ZdZd dZd Zd Zd Zd Zd Z d Z
d
S ) _Matcher)allowedendanyrr whichsplitloopFc L t d|cxk o
t k nc d | | _ | j d | _ || _ t
| _ d| _ d| j v pd| j v | _ || _
| j D ]>}| || \ }}|| j | || _ ?t | j dud| t | j | _ dS )a.
input:
`which` - index into the increment / validation lookup tables
`entry` - the value of the column
`loop` - do we loop when we validate / construct counts
(turning 55-5,1 -> 0,1,2,3,4,5,55,56,57,58,59 in a "minutes" column)
r z)improper number of cron entries specified,N*?z improper item specification: %r)r YEAR_OFFSETlowerrr r r setr r r r _parse_crontabupdate frozenset)selfr entryr italens r< __init__z_Matcher.__init__ s$ U))))k)))) 7 9 9 9[[]]
Z%%c**
uu $*$9tz(9 * B((33FB~ ##B'''DHH$ -u{{}}
! .. r> c
t | j D ]\ }}|dk r |t | j k r dS (| d r|j |t z j k rV|dd }| r"|dk rt |d nd}||k r dS d | d d d d D \ }}t t ||dz }d
|v r| d ||v r dS | d r|dd }t | j | rt |d }|z
|k c S d | d d d d D \ }}|t fd
t ||dz D v r dS | j
p|| j v S )Nrq Tr 7r r c 3 6 K | ]}t |d V dS r Nint.0is r< z$_Matcher.__call__.. * H HQc!Rjj H H H H H Hr> -r r zc 3 6 K | ]}t |d V dS r r r s r< r z$_Matcher.__call__.. r r> c 3 " K | ] }|z
V
d S rN rn )r r eoms r< r z$_Matcher.__call__.. s' AAC!GAAAAAAr> ) enumerater r= r
startswithr WEEKisdigitr partitionr rangeaddr r ) r vr: r rc startr r r s @r< __call__z_Matcher.__call__ s dj)) " " DAqCxx
b))--- 44 . c""
8T 000 abbE99;; &'3hhAr
AAAvv #tt H H!++c2B2B33Q32G H H H
s eE3q5 1 122<<KKNNN<< 44 c""
abbE#B''+99;; *Ar
A !G>))) H H!++c2B2B33Q32G H H H
sAAAAU5#a%-@-@AAAAAAA 44x,1 ,,r> c h | j r | j k S t fd| j D S )Nc 3 $ K | ]
}|k V d S rN rn r itemothers r< r z"_Matcher.__lt__.. ' 99D4%<999999r> )r r allr r r s `r< __lt__z_Matcher.__lt__ s? 8 $8e# #9999DL999999r> c | j r t | j d k S t fd| j D S )Nr c 3 $ K | ]
}|k V d S rN rn r s r< r z"_Matcher.__gt__.. r r> )r _rangesr r r r s `r< __gt__z_Matcher.__gt__ sI 8 24:&q)E1 19999DL999999r> c > | j r|j S | j |j k S rN )r r r s r< __eq__z_Matcher.__eq__ s# 8 9 |u},,r> c 8 t | j | j f S rN )hashr r )r s r< __hash__z_Matcher.__hash__ s TXt|,---r> c
fd
fd}t \ dv r4dk r*t t t fv dt dfS dk r t t k d dfS d rt t k d
d d d \ }}}t d d r d
t |d cxk odk nc pk|oi| oU| oAd
t |d cxk odk nc o#d t |d cxk odk nc o||k d dfS d rt t k d d d d \ }}}t d d r d
t |d cxk odk nc pe|oc| oO| o;d
t |d cxk odk nc o d
t |d cxk odk nc d dfS t k rd d dv rS d \ t d t d
k d t k d | }t k r.d|v r*|
d | d
|fS )z
This parses a single crontab field and returns the data necessary for
this matcher to accept the proper values.
See the README for information about what is accepted.
c 0 t v r6| s"| t v rt | S t | d| t | d } t | cxk ok nc d| | S )Nz invalid range specifier: %r (%r)r z#item value %r out of range [%r, %r])
_alternater r r )r
_end_limit_startr r s r< _fixz%_Matcher._parse_crontab.._fix s
""2::<<"E***%e,R00 BJJLL2B
?
?
?RB Fb....J....5FJ
(
(
( Ir> c D d| v r?t | d \ }} t t fv r|dk rd}n*| dk r }}n | }}
t |g S t |cxk ok nc dt | t |cxk ok nc dt | j s"t ||k dt ||
r# j s |
z }t |k d|| ||k r#t t ||d z
pd S t t |d z
pd }t ||
pd z
z }t t ||d z
pd |z S ) Nr r r r z-%s range start value %r out of range [%r, %r]z+%s range end value %r out of range [%r, %r]z&%s range start value %r > end value %rz,first next value %r is out of range [%r, %r]r )default)
mapr
DAY_OFFSET WEEK_OFFSETr r
_attributer r max)
r r r
next_valuerightfirst_endr r r incrementr r s
r< _parse_piecez-_Matcher._parse_crontab.._parse_piece$ s byy rxx}} 5 5
sZ 555#((Cs R $ w<<' Fe1111z1111?5!5&*
>
>
>
Fc////Z////=5!3
<
<
< 9
3 < u%uc3 3 3
7
7 "Y .
j0F"E:7 7 7 ||5Ay~A>>???c:>9>BBCCEsin1'=>>>KEuUE!GY^!<<==E Er> )r r r z cannot use '?' in the %r fieldNrq z2you can only specify a bare 'L' in the 'day' fieldr z5you can only specify a leading 'Z' in the 'day' fieldr r r r r zZ specifier must include a day number or range 0..7 in the 'day' field, you entered %rz9you can only specify a leading 'L' in the 'weekday' fieldzclast specifier must include a day number or range 0..7 in the 'weekday' field, you entered %r/z;you can only use positive increment values, you provided %rz5increment value must be less than %r, you provided %r) r r r r r r r r r r discardr )
r r r r es_eegoodr r r r r s
``` @@@@@r< r z_Matcher._parse_crontab s\
% F % F % F % F % F % F % F % F % F % F % FN u~
J ||*k!::4j6GI I I: C<< EZ'D
F
F
F:
c
"
" EZ'G
I
I
I abb ++C00IB2 U122Y&&((BQ#b"++-B-B-B-B-B-B-B-B {y2::<<yBJJLLyQ#b"++=R=R=R=RQR=R=R=R=RyWX\_`bdf\g\gWlWlWlWlklWlWlWlWlyqswyqylns
u
u
u :
c
"
" E[(K
M
M
M abb ++C00IB2 U122Y&&((BQ#b"++-B-B-B-B-B-B-B-B nl2::<<lBJJLLlQ#b"++=R=R=R=RQR=R=R=R=RlWX\_`bdf\g\gWlWlWlWlklWlWlWlWluw|
~
~
~ : K J %<< ${{3 / / E9Ir**I IMM
I+K
+
+
+
|E"" K AII LLOOO HHQKKKTzr> N)F) __name__
__module__ __qualname__ __slots__r r r r r r r rn r> r< r r s JI/ / / /8%- %- %-N: : :
: : :
- - -
. . .x x x x xr> r c D t t j d S )N< )strrandom randrangern r> r< rS rS s c&"2&&'' r> c T e Zd ZdZd dZd Zd Zd Zdede dfd Z
dde dfd
Z d Z dS )
CronTab)matchersrsFc L || _ | ||| | _ dS )aM
inputs:
`crontab` - crontab specification of "[S=0] Mi H D Mo DOW [Y=*]"
`loop` - do we loop when we validate / construct counts
(turning 55-5,1 -> 0,1,2,3,4,5,55,56,57,58,59 in a "minutes" column)
`random_seconds` - randomly select starting second for tasks
N)r _make_matchersr )r crontabr random_secondss r< r zCronTab.__init__ s( ! ++GT>JJ
r> c t |t sdS | j dd |j dd k }|o9| j r|j p+| j o#|j o| j d |j d k S )NFr r )
isinstancer r r )r r
match_lasts r< r zCronTab.__eq__ s %)) 5]122&%.*<<
E 4EH Ddg+ ;CL;C !]1 - 1B B Er> c t || }| }t | dk r<| d|rt nd | d n9t | dk r&| d|rt nd t t | dk dt | z fdt | D }t | S ) z:
This constructs the full matcher struct.
r r 0r r r z=improper number of cron entries specified; got %i need 5 to 7c 8 g | ]\ }}t || S rn )r )r r r r s r<
z*CronTab._make_matchers.. s) SSS\UEHUE400SSSr> )
_aliasesgetr leninsert_gvappendr r r )r r r r ctr s ` r< r zCronTab._make_matchers s ,,w00
]]__ r77a<< IIa.9c : : : IIcNNNN
WW\\ IIa.9c : : :B1 KSQSXX V X X X TSSSYr]]SSS!!r> c t | }t || }|t k r
| dz } | j | || S )zt
This tests the given field for whether it matches with the current
datetime object passed.
r )r getattrr r )r indexr: atattrs r< _test_matchzCronTab._test_match sN
r2 K 466A:D#t}U#D"---r> NTc |t u rBt |t s |r|j r|"t j t t d d}|p0|r |t urt j nt j
}t |t r*|rt j | nt j | }||
d }}|j }|
d |d z |k r$ fd}|j r|
d n fd}t d z
} | dk r | s || j }
|
z
t% d| D ] } |t | z |
| rdS n1# t' t) t) |
xY wt d z
} | d z } | dk fd
t% t D } t+ t- | d d d
j D | |r
| S |st dd d x}}|z
}
|r|
t1 | z
}
t5 |d r8|
t1 | z }
n8|
t1
| z }
|
j dz |
j z |
j dz z S )ze
How long to wait in seconds before this crontab entry can next be
executed.
Nr F)tzinfor ) microsecondc . j j j k S rN )r r futurer s r< rS z CronTab.next.. s FK$-*< < r> c . j j j k S rN )r r r s r< rS z CronTab.next.. s DM . < r> r c < g | ]} | S rn )r )r r r r s r< r z CronTab.next.. s) FFF!!!V,,FFFr> zu
You have discovered a bug with crontab, please notify the
author with the following information:
crontab: %r
now: %r c 3 $ K | ] }|j V d S rN )rr )r rB s r< r z CronTab.next.. s$ ? ?A ? ? ? ? ? ?r> r
localizeiQ g .A) WARN_CHANGEr
_number_typesr warningswarnWARNING_CHANGE_MESSAGE
FutureWarningr utcnownowutcfromtimestamp
fromtimestampr9 r ENTRIESr r xrangeprinttyper r join _fix_none utcoffsethasattrr r4 r1 microseconds)r r!
incrementsdelta default_utcreturn_datetimeonowtz_testto_testincr matchdelayr s ` @r< nextz CronTab.next s
+ % %:c=+I+I %c %Z]Zd %ilit M0- C C C Kn;m;k;Y;Yho'''_g_k_m_m c= ) ) a4?`(+C000XE[\_E`E`C D11c
[++mjmoo= C<<<<<<>>,, , .!$1-- -D3
J Yt~~ / /00 0Er:&&
J2;;v#6#6#@#@#B#BCCC6>>>#<#<#F#F#H#HIIIzE!EM1E4F4QQQs &
F3 3.G!c > | |t ||| S rN )r8 _decrements)r r! r. r/ r0 s r< previouszCronTab.previous s yyk5+OOOr> c t |t rt j | }t t
D ]}| || s dS dS )NFT)r r r r" r% r$ r )r r r s r< testz CronTab.test
sb e] + + 5 -e44EG__ E##E511
uu
tr> )FF)
r r r r r r r r _incrementsr r8 r; r= rn r> r< r r s I K K K KE E E" " "& . . . 4[jo GR GR GR GRR tV[ P P P P r> r c | |S | S rN rn )dr s r< r) r) s y Hr> )5__doc__ collectionsr r r r sysr r r r$ r
SECOND_OFFSET
MINUTE_OFFSET HOUR_OFFSETr MONTH_OFFSETr r r r r r version_infor floatr r% longrP rW rZ r8 r r@ rI objectr r= rD rL r> rs ru rw rz r: r r r r r r) rn r> r< rL s # " " " " " ( ( ( ( ( ( ( (
#g,,`e`efm`n`n ]
}k:|[R]
!Aa!A1RrE E1Qq1
v %LM
FF$&M 1 1 yqiQya rycfhh $ $ $ ONN%%%%##5577O "
O&&&&$$99O " *Y Q
R
R' ' 'O O O O Ov O O Od ('D D D D Df D D DL 9Q<<
r>