Ki>W ddlmZddlmZddlmZedGddZd+dZd d d d d dddddd Zd,dZ d-d.dZ GddZ Gdde Z Gdde Z Gdde ZGdd e ZGd!d"e ZGd#d$e ZGd%d&Zd/d'Zed(k(r6ddlZeej.d)k(reeej.d*yyy)0) annotations) Generator) dataclassT)frozencVeZdZUdZded<dZded<dZded<dZded<d d Zd d Z y) SequenceN int | Nonestartstopintstepnthc@|jduxr|jdk(S)z2Return True if this sequence describes a wildcard.Nr )r rselfs [/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/cronsim/explain.pyis_starzSequence.is_starszzT!4dii1n4cT|jduxr|j|jk(S)zBReturn True if this sequence describes a a single, specific value.Nr r rs r is_singlezSequence.is_singles#zz%A$** *AAr)returnbool) __name__ __module__ __qualname__r __annotations__r rrrrrrrrs4E:D*D#MC5Brrct|dk(r|dSt|dk(r |dd|dSdj|dd}|d|dS) zJoin together strings using commas and 'and' as separators. >>> join(["a"]) 'a' >>> join(["a", "b"]) 'a and b' >>> join(["a", "b", "c"]) 'a, b, and c' r rz and z, Nz, and )lenjoin)lheads rr$r$se 1v{t  1v{A$uQqTF## 99QsV DV6!B% !!rlastfirstsecondthirdfourthfifthsixthseventheighthninth) r"r r! c4tj||dS)zhFormat integer as an ordinal number. >>> ordinal(1) 'first' >>> ordinal(15) '15th' th)ORDINALSget)xs rordinalr=9s <<aS8 $$rNc2| |dd|dS|dd|dd|dS)zFormat time as HH:MM or HH:MM:SS (if seconds are specified). >>> format_time(0, 0) '00:00' >>> format_time(1, 23) '01:23' >>> format_time(11, 22, 33) '11:22:33' 02d:r)hmss r format_timerDDs; yC!C!!WAaWAaW %%rceZdZUdZgZded<dZdZddZddZ ddZ ddZ dd Z dd Z dd Zddd Zddd ZddZddZy)FieldFIXME list[str]symbolicrcb||_g|_|j|D],}||jvs|jj|.|jdj|_|jD]=}|j|j k7s|j |j k7s6d|_n|j dk(|_td|jD|_ td|jD|_ td|jD|_ y)Nrc3<K|]}|jywN)r.0seqs r z!Field.__init__..ms=# =c3<K|]}|jywrLrrMs rrPz!Field.__init__..oF3s}}FrQc3<K|]}|jywrLrSrMs rrPz!Field.__init__..qrTrQ) valueparsedparseappendr single_valuer zeroallstarany any_singles all_singles)rrVrOs r__init__zField.__init__Zs &( ::e$ (C$++% ""3' ( !KKN00;; CyyD---T=N=N1N$(!  %%* === F$++FFF$++FFrc#DK|jdD]}|dk(r tt|tr6|j dr%|j |dd}t||d\d|vr?|jd\}}|j |}t||t |d|vr|jd\}}t |}|dk(rt| |d k(rtd d d|dk(rtdddd |vr7|jd \}}|j ||j |} } n|j |} |j} | |jkr| |jk\rt| t| | | d |vr|jd \}}|j ||j |} } | dz| k(r t| | t| | | |jkr| |jk\rt)t| | :|d k(rtd d dQ|dk(rtdddh|j |}t||yw)z@Parse a single field of a cron expression into Sequence objects.,*LNr")r r r#/)rLW-)r r rr r) splitr isinstanceWeekdayendswith_intr max_value min_value) rrVtermvrstep_strr start_strstop_strr r s rrXz Field.parsessDKK$0 0Ds{j D'*t}}S/AIId3Bi(QQB77 JJsO cIIdOQQCH==!%Ch8}3;"--T\"""==S["""==d{.2jjo+ 8&*ii &:DIIh>3I&D11&UDII&*jjo# 8"ii 2DIIh4Gt19$"U;;"D99dnn,1G"*$"T::Rbb99Rbb99IIdOQQ//a0 0sJJ cj||jvr|jj|St|S)zConvert a value from a cron expression to an integer. For month and weekday fields, this takes care of converting JAN, FEB, ... and MON, TUE, ... )rIindexr rrVs rroz Field._ints/ DMM !==&&u- -5zrc|jDcgc])}t|jts|j+c}Scc}w)z3Return a list only the single values in this field.)rWrlr r )rrOs rsinglesz Field.singless+%)[[OcJsyy#4N OOOs AAct|S)z\Convert an integer value to a string for display. >>> label(1) '1' strridxs rlabelz Field.labels 3xrcB|jd|j|S)z\Format a single value for display. >>> format_single(1) 'minute 1'  )namerrys r format_singlezField.format_singles# ))Adjj/011rct)zhFormat nth-weekday-of-month and L values. Implemented in Month and Weekday subclasses. )NotImplementedError)rrVrs r format_nthzField.format_nths "!rc`|dk(rd|jSdt|d|jS)zFormat wildcard and wildcard-with-step values. >>> format_every(1) 'every minute' >>> format_every(5) 'every 5th minute' r every r)rr=)rrs r format_everyzField.format_everys7 19DII;' ' a {33rc|j|}|j|}|dk(rd|jd|d|Sdt|d|jd|d|S)zFormat a sequence. >>> format_seq(1, 10) 'every minute from 1 through 10' >>> format_seq(1, 10, 2) 'every 2nd minute from 1 through 10' r r from through r)rrr=)rr r rrurvs r format_seqzField.format_seqskJJu% ::d# 19DII;fYKy K K a {& 9XJWWrcXg}|jD]}|j+|j|j|j;|j |jk7rO|j J|j|j |j|j |j|j6|j|j|j|j|j|j|jt|S)z=Format every component of this field, and join them together.) rWr rYrrr rrrrr$)rpartsrOs rformatz Field.formats;; ! rr rrrrrqrprr __classcell__rs@rrr! DII  rrc8eZdZdZdZdZdfd Zdfd ZxZS)Minuteminuterrc|jrRt|jdkDr:|jDcgc]}|j |}}dt |St |Scc}w)zFormat the minute field. This method adds special handling when all values are single values. Instead of "minute 1, minute 3, and minute 5", it produces "minutes 1, 3, and 5". r zminutes rrs rrz Minute.format&rrcFt|}|jrd|zS|S)aReturn a human-friendly representation of the minute field. This method adds the 'at' preposition to the formatted string if the field has any single values. For example, if the field has a single range (1-5), the result will be "every minute from 1 through 5". But if the field also has a single field (1-5,10), the result will be "at every minute from 1 through 5 and minute 10". rrrs rrzMinute.__str__1rrrrrs@rrr!rrrc8eZdZdZdZdZdfd Zdfd ZxZS)Hourhourrc|jrRt|jdkDr:|jDcgc]}|j |}}dt |St |Scc}w)zFormat the hour field. This method adds special handling when all values are single values. Instead of "hour 1, hour 3, and hour 5", it produces "hours 1, 3, and 5". r zhours rrs rrz Hour.formatGsb   DKK 01 4-1\\^<djjm* *w~=rc&dt|zS)zReturn a human-friendly representation of the minute field. This method adds the 'past' preposition to the formatted string. For example, if the hour field has a single value (5), the result will be "past hour 5". zpast rrrrs rrz Hour.__str__Rs ***rrrrs@rrrBs! DII  ++rrcLeZdZdZdZdZddZd fd Zd fd Zd fd Z xZ S) Dayz day of monthr c dt|dS)zuFormat a single day-of-month value for display. >>> format_single(2) 'the 2nd day of month' the day of month)r=rys rrzDay.format_single`s gen%]33rcP|dk(r|dk(ry|dk(r|dk(ryt|||S)zFormat the L and LW values. >>> format_nth(-1) 'the last day of the month' >>> format_nth(-2) 'the last weekday of the month' r"zthe last day of the monthrizthe last weekday of the month)rr)rrVrrs rrzDay.format_nthhs7 "9". "9"2w!%--rc|jrUt|jdkDr=|j}d|vr)|Dcgc]}dt |}}t |dSt |Scc}w)aFormat the day field. This method adds special handling for the case when all values are single values. For example, instead of "the 1st day of month, the 3rd day of month, and the 5th day of month" it produces "the 1st, 3rd, and 5th day of month". We cannot apply this optimization if the single values contain "-2" (the special value for "last weekday of the month"). r rirr)r`r#rWr{r=r$rr)rr{rsrrs rrz Day.formatvss   DKK 01 4llnG 7>?!D -??v,}55w~@sA1c&dt|zS)zReturn a human-friendly representation of the day of month field. This method unconditionally adds the 'on' preposition. on rrs rrz Day.__str__ uw(((rrrr) rrrrrqrprrrrrrs@rrr[s+ DII4 . $))rrc|eZdZdZdZdZdj Zdj Zd dZ d dZ d fd Z xZ S) Monthmonthr z1_ JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DECzW_ January February March April May June July August September October November Decemberc |j|S)zZConvert an integer value to a month name. >>> label(1) 'January' rrs rrz Month.label {{3rc$|j|S)zbFormat a single month value for display. >>> format_single(2) 'February' rrys rrzMonth.format_single zz%  rc&dt|zS)zReturn a human-friendly representation of the month field. This method unconditionally adds the 'in' preposition. zin rrs rrz Month.__str__rrrrr) rrrrrqrprkrIrrrrrrs@rrrsB DIIBHHJH f l l nF !))rrceZdZdZdZdZdj Zdj Zd dZ d dZ d dZ ddfd Z dfd Z xZS)rmz day of weekrr5zSUN MON TUE WED THU FRI SAT SUNz?Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sundayc |j|S)z_Convert an integer value to a day of week name. >>> label(1) 'Monday' rrs rrz Weekday.labelrrc$|j|S)zaFormat a single month value for display. >>> format_single(2) 'Tuesday' rrys rrzWeekday.format_singlerrc^|j|}|dk(rd|dSdt|d|dS)zFormat the nth-weekday-of-month value. >>> format_nth(2, -1) 'the last Tuesday of the month' >>> format_nth(2, 4) 'the 4th Tuesday of the month' r"z the last z of the monthrr)rr=)rrVrrs rrzWeekday.format_nthsA 5! "9ug]3 3gcl^1UG=99rcz|dk(r%|j|d|j|St| |||S)zFormat a sequence of weekdays. >>> format_seq(1, 3) 'Monday through Wednesday' >>> format_seq(1, 7, 2) 'evary 2nd day of week from Monday through Sunday' r r)rrr)rr r rrs rrzWeekday.format_seqsG 19jj'( $**T2B1CD Dw!%t44rc&dt|zS)zReturn a human-friendly representation of the month field. This method unconditionally adds the 'on' preposition. rrrs rrzWeekday.__str__rrrrrrrr)rrrrrqrprkrIrrrrrrrrs@rrmrmsL DII0668H N T T VF ! :5 ))rrmc<eZdZddZd dZd dZd dZd dZd dZy) Expressionct|dk(r|jddt|d|_t |d|_t |d|_t|d|_ t|d|_ t|d|_ |djdxs|djd|_y) Nr3r0r r!r1r2rd)r#insertrr)rrrrrdayrrrmdow startswithday_and)rrs rrazExpression.__init__s u:? LLC U1X& U1X& qN uQx=58_ 58$Qx**3/K583F3Fs3K rc >|jjr|jjr|jjr|jj }|jj }|jj }t |t |zt |zdkrxg}t |D]X}t |D]H}t |D]8}|jjrdn|}|jt|||:JZdt|zdfS|jjrt |jjdk(r|jjr|jjd} | jy| jm| jdk(r^t|jj| j} t|jj| j} d| d| d fSt |jjdk(rt |jjdk(r|jjr|jjd} | j|jjd} | j]| jQ| jdk(rBt| jd} t| jd } |jd | d| d fSy) a.Apply formatting optimizations for hours and minutes. If both hours and minutes contain only a few single values, format them as "at HH:MM, HH:MM, HH:MM, and HH:MM" If hours have a single value, and minutes have a single sequence with step 1, format them as "every minute from HH:MM through HH:MM". If minutes have a single "*/" sequence and hours have a sequence with step 1, format them as "every nth minute from HH:00 through HH:59" If no special optimizations apply, return None. r2NrTr rzevery minute from rFrr)rr`rr)r{r#sortedr[rYrDr$rZrWr r r)r second_terms minute_terms hour_termstimesrArBrCssrOhhmm1hhmm2mseqhseqs roptimized_timeszExpression.optimized_timess II ! ! '' '';;..0L;;..0L**,J< 3|#44s:F!K +@A#L1@!' !5@A*.)9)9qB!LLQ2)>? @@@tE{*D00 99 ! !c$++*<*<&=&Bt{{GWGW++$$Q'Cyy$)=#((a-#DII$:$:CIIF#DII$:$:CHHE+E7)E7CUJJ    !Q &DKK&&'1,   ;;%%a(Dzz!yy''*::)dii.C UV' A6E' 26E"kk]&yH%OOrct|jjr!|jjdk(rd|jj S|jjdk(rd|jj S|jjrJ|jjr4d|jj d|jjS|jjr?t |jj}d|d|jj Sy ) aVApply formatting optimizations for specific dates. If day-of-month is L, format it as "on the last day of ". If day-of-month is LW, format it as "on the last weekday of ". If month and day-of-month each have a single value (for example, month 2 and day-of-month 1), format them as "February 1st". If day-of-month has a single value (for example, 2), format it as "on the 2nd day of ". If no special optimizations apply, return None. r"zon the last day of rizon the last weekday of rrzon the z day of N)rr]rrZrrr=)rdate_ords roptimized_dateszExpression.optimized_dates5s& 88==xx$$*,TZZ->->-@,ABBxx$$*01B1B1D0EFFzz&&488+@+@TZZ..014883H3H2IJJxx$$"488#8#89  (4::3D3D3F2GHHrc|jjr|jjr|jjry|jjr|jjry|jjr|jddfS|jj dk(r|jjry|jjr|jddfS|j x}r|S|jjr|jd|jdfS|jd|jd|jdfS) z+Convert the minute and hour fields to text.)z every secondF)z every minuteFz of every minuteFr)zat the start of every hourFz of every hourr)rr]rr)r[rZr)rrs rtranslate_timezExpression.translate_timeUs 99>>{{DKK$4$4,{{DKK$4$4,{{++&67>>{{''1,1A1A:{{++n5u<<((* *5 *L ;;  kk]!DII;/6 6++a }Adii[95@@rc|jx}r|S|rQ|jjr;|jjr%|jj rd|jSg}|jjs|j |j|jjs|jjs|jr|j dn3|jjs|js|j d|j |j|jjs|j |jdjd|DS)z3Convert the day, month, and weekday fields to text.z every day zif it'sandrc32K|]}t|ywrLr})rNparts rrPz,Expression.translate_date..s4dD 4s) rrr]rrr`rYrr$)rallow_every_daydatesrs rtranslate_datezExpression.translate_datels((* *5 *L xx}}4::3I3I#DJJ<00#%xx}} LL "xx}}88==T\\ Y'XX]]4<< U# LL "zz LL $xx4e444rc|j\}}|j|x}r|d|}n |r|d}n|}|dj|ddzS)z$Convert the full expression to text.rz every dayrr N)rrupper)rtimerdaters rexplainzExpression.explainsm $ 3 3 5o&&7 74 7vQtf%F vZ(FvFay 6!":--rN)rrH)rztuple[str, bool] | None)rz str | None)rztuple[str, bool])rrrr~r) rrrrarrrrrrrrrrs$ L:x@A.50 .rrcp|jj}t|jS)zConvert the given cron expression to human-friendly description. >>> explain("0 0 15 JAN-FEB *") 'At 00:00 on the 15th day of January and February' )rrkrr)exprrs rrrs, JJL   E e  $ $ &&r__main__r!r )r%rHrr~)r<r rr~rL)rAr rBr rCr rr~)rr~rr~) __future__rcollections.abcr dataclassesrrr$r:r=rDrFrrrrrrmrrrsysr#argvprintrrrrs "%! $ B B B"*  % & iiXUBUB+5+22)%2)j)E)>:)e:)zb.b.J' z 388} gchhqk"#r