WSrSSKJr SSKJr SSKJr SSKrSSKrSSKJr Sr Sr S r S r "S S \ 5r"S S\ 5rSSjr"SS\5rSrSrSr"SS\5r"SS\5rg)aImplementation of scheduling for Groc format schedules. A Groc schedule looks like '1st,2nd monday 9:00', or 'every 20 mins'. This module takes a parsed schedule (produced by Antlr) and creates objects that can produce times that match this schedule. A parsed schedule is one of two types - an Interval or a Specific Time. See the class docstrings for more. Extensions to be considered: allowing a comma separated list of times to run )absolute_import)division)print_functionN)groczarb@google.com (Anthony Baxter)hoursminutesc\rSrSrSrg)NonExistentTimeError7N__name__ __module__ __qualname____firstlineno____static_attributes__r @lib/googlecloudsdk/appengine/googlecron/groctimespecification.pyr r 7rr c\rSrSrSrg)AmbiguousTimeError:r Nrr rrrr:rrrcx[R"U5nUR5 UR(aB[ UR URUR URURU5$[URURURURURU5$)aXFactory function. Turns a schedule specification into a TimeSpecification. Arguments: schedule: the schedule specification, as a string timezone: the optional timezone as a string for this specification. Defaults to 'UTC' - valid entries are things like 'Australia/Victoria' or 'PST8PDT'. Returns: a TimeSpecification instance )r CreateParsertimespec period_stringIntervalTimeSpecification interval_mins synchronizedstart_time_stringend_time_stringSpecificTimeSpecification ordinal_set weekday_set month_set monthday_set time_string)scheduletimezoneparsers rGrocTimeSpecificationr,>s   X &&//  $V%9%96;O;O%+%8%8%+%=%=%+%;%;X GG %V%7%79K9K%+%5%5v7J7J%+%7%7 CCrc$\rSrSrSrSrSrSrg)TimeSpecificationZz#Base class for time specifications.c/n[U5U:a3URU5nURU5 [U5U:aM3U$)zReturns the next n times that match the schedule, starting at time start. Arguments: start: a datetime to start from. Matches will start from after this time. n: the number of matching times to return Returns: a list of n datetime objects )lenGetMatchappend)selfstartnouts r GetMatchesTimeSpecification.GetMatches]sB C c(Q,mmE"e jj c(Q, Jrc[e)EReturns the next match after time start. Must be implemented in subclasses. Arguments: start: a datetime to start from. Matches will start from after this time. This may be in any pytz time zone, or it may be timezone-naive (interpreted as UTC). Returns: a datetime object in the timezone of the input 'start' )NotImplementedError)r4r5s rr2TimeSpecification.GetMatchms  rr N)rrrr__doc__r8r2rr rrr.r.Zs+ rr.c[cU(a [S5egU(a[RU5$[R$)a Converts a timezone string to a pytz timezone object. Arguments: timezone_string: a string representing a timezone, or None Returns: a pytz timezone object, or None Raises: ValueError: if timezone_string is specified, but pytz module could not be loaded Nz(need pytz in order to specify a timezone)pytz ValueErrorr*utc)timezone_strings r _GetTimezonerD}s6 \ A BB  == )) 88Orc[cURSS9$U(aPUR(d[RR U5nUR UR U55$UR(aI[RR UR [R55RSS9$U$)aConverts 't' to the time zone 'tzinfo'. Arguments: t: a datetime object. It may be in any pytz time zone, or it may be timezone-naive (interpreted as UTC). tzinfo: a pytz timezone object, or None. Returns: a datetime object in the time zone 'tzinfo' Ntzinfo)r@replacerGrBlocalize normalize astimezone)trGs r _ToTimeZonerMs \ 99D9 !! 88 ((  A a   ALL0 11xx 88  all4884 5 = =T = JJ HrczURS5up[R"[U5[U55$)zConverts a string to a datetime.time object. Arguments: time_string: a string representing a time ('hours:minutes') Returns: a datetime.time object :)splitdatetimetimeint)r(hourstr minutestrs r_GetTimerVs0#((-' s7|S^ 44rct^\rSrSrSrS U4SjjrSrSr\S5r \S5r \S5r S r U=r $) raA time specification for a given interval. An Interval type spec runs at the given fixed interval. It has the following attributes: period - the type of interval, either 'hours' or 'minutes' interval - the number of units of type period. synchronized - whether to synchronize the times to be locked to a fixed period (midnight in the specified timezone). start_time, end_time - restrict matches to a given range of times every day. If these are None, there is no restriction. Otherwise, they are datetime.time objects. timezone - the time zone in which start_time and end_time should be interpreted, or None (defaults to UTC). This is a pytz timezone object. c">[[U] 5 US:a[R"S5eXlX lX0lUR [:XaUR S-Ul OUR S-Ul [U5Ul UR(aU(a [S5eU(a [S5eURS:dSUR-S:wa[R"S 5e[R"SS5Ul[R"S S 5UlgU(a3U(d [S 5e[#U5Ul[#U5UlgU(a [S 5eSUlSUlg)Nrz"interval must be greater than zeroi<z>start_time_string may not be specified if synchronized is truezsK 668D (<< V%f   h  a((d rcUR5n[RX1U5nX@:aU$U[R"SS9- nM6)a"Returns the earliest datetime > 't' that has the time target_time. Arguments: t: a datetime.datetime object, in any timezone target_time: a datetime.time object, in any timezone tzinfo: a pytz timezone object, or None Returns: a datetime.datetime object, in the timezone 'tzinfo' rr|r}rs rrn*IntervalTimeSpecification._GetNextDateTimeSsK 668D (<< V%f   h  a((d rc [R"URURURURUR UR 5nUcU$URUSS9$![a+ [URUSS9URUSS95s$[a> U[R"SS9- nURUSS9s$![a Of=fM<f=f)a|Creates a datetime object from date and time objects. This is similar to the datetime.combine method, but its timezone calculations are designed to work with pytz. Arguments: date: a datetime.date object, in any timezone time: a datetime.time object, in any timezone tzinfo: a pytz timezone object, or None Returns: a datetime.datetime object, in the timezone 'tzinfo' Nis_dstTFr)r ) rQyearmonthdayhourminuterkrIrminr rj)r~rRrG naive_results rr-IntervalTimeSpecification._CombineDateAndTimehs$$TYY DHHdii%)[[$++?L ~  __\$_ 77 7 //,t/ 4 //,u/ 577  **155  d; ;#     s6A..2C)"!C)CC) C# C)"C##C))rer`rarcrdr r*)FrN)rrrrr>r^r2ro staticmethodrlrnrr __classcell__rfs@rrrsc $"!#! -^,-\$())())(%%rrcN^\rSrSrSrSU4SjjrSrSrSrSr U=r $) r#iaRSpecific time specification. A Specific interval is more complex, but defines a certain time to run and the days that it should run. It has the following attributes: time - the time of day to run, as 'HH:MM' ordinals - first, second, third &c, as a set of integers in 1..5 months - the months that this should run, as a set of integers in 1..12 weekdays - the days of the week that this should run, as a set of integers, 0=Sunday, 6=Saturday timezone - the optional timezone as a string for this specification. Defaults to UTC - valid entries are things like Australia/Victoria or PST8PDT. A specific time schedule can be quite complex. A schedule could look like this: '1st,third sat,sun of jan,feb,mar 09:15' In this case, ordinals would be {1,3}, weekdays {0,6}, months {1,2,3} and time would be '09:15'. c>[[U] 5 U(aU(a [S5eUc[ [ SS55UlOa[ U5UlUR (a@[UR 5S:d[UR 5S:a[SU-5eUc[ [ S55Ul Oa[ U5Ul UR(a@[UR5S:d[UR5S:a[SU-5eUc[ [ SS 55Ul Oa[ U5Ul UR(a@[UR5S:d[UR5S :a[S U-5eU(d[ 5Ul O[U5S:a [S 5e[U5S :a [S5eUR(aYURH-n[R"SU5up[U5U ::dM- O [S[U5<SW<35e[ U5Ul [U5Ul[!U5Ulg)Nz)cannot supply both monthdays and weekdaysrz2ordinals must be between 1 and 5 inclusive, got %rrz>weekdays must be between 0 (sun) and 6 (sat) inclusive, got %r z=months must be between 1 (jan) and 12 (dec) inclusive, got %rz#day of month must be greater than 0z!day of month must be less than 32zinvalid day of month, got day z of month )r]r#r^rAsetrangeordinalsrmaxweekdaysmonths monthdayscalendar monthrangerVrRrDr*) r4rrrrtimestrr*r_ndaysrfs rr^"SpecificTimeSpecification.__init__s  #T35I B CC%1+&dm(mdm C .2c$--6H16L"$,-. .%(mdm(mdm C .2c$--6H16L"$,-. .~a %dkKdk #dkk*Q.#dkk2BR2G"$*+, , udn Y! >?? Y" <== [[E((E2(! ^u $ ! 7:9~uNO O9~dn!DI *DMrc[R"X5up4UR(a-[URVs/sH oUU::dM UPM sn5$/nUS-S-nURHCnUR H0nX- S-S-nUSUS- -- nXT::dMUR U5 M2 ME [U5$s snf)aReturns matching days for the given year and month. For the given year and month, return the days that match this instance's day specification, based on either (a) the ordinals and weekdays, or (b) the explicitly specified monthdays. If monthdays are specified, dates that fall outside the range of the month will not be returned. Arguments: year: the year as an integer month: the month as an integer, in range 1-12 Returns: a list of matching days, as ints in range 1-31 rr)rrrsortedrrr3) r4rr start_daylast_dayrout_daysordinalweekdays r _MatchingDays'SpecificTimeSpecification._MatchingDayss#--d:I ~~ DNNFNSXoSNF GGHQ!#I==]]'#q(A- qGaK   ? //#  #! ( Gs B? B?c## [U5=p2US- nSnUVs/sH ofU:dM UPM nnU(dUS- nUnUSnXE4v M3s snf7f)aCreates a generator that produces results from the set 'matches'. Matches must be >= 'start'. If none match, the wrap counter is incremented, and the result set is reset to the full set. Yields a 2-tuple of (match, wrapcount). Arguments: start: first set of matches will be >= this value (an int) matches: the set of potential matches (a sequence of ints) Yields: a two-tuple of (match, wrap counter). match is an int in range (1-12), wrapcount is a int indicating how many times we've wrapped around. rr)r)r4r5matches potentialafter wrapcountxs r_NextMonthGenerator-SpecificTimeSpecification._NextMonthGeneratorsi!/)I AIEI '5iu91ii5  Q  le   5sA A A !Ac[XR5RSS9nUR(a&UR UR UR5n[ W5upEURSXBRU-S9nURURU5nURUR 4URUR 4:Xa#UVs/sHoUR:dMUPM nnU(aURUSURRURRSSS9n UR(a"[bURRU SS9n U[XR&5:a[XR&5$UR%S5 U(aMGM^s snf![a [U[R 5n [URRU SS9[R 5n X:aURRU SS9n NURRU S S9n N["a UR%S5 GMyf=f) r;NrFTr)rrrr)rrrrk microsecondrF)rMr*rHrrrnextrrrrRrrr@rIrrBr poprG) r4r5rdrr yearwrapscandidate_month day_matchesrr7 start_utc dst_doubled_time_first_match_utcs rr2"SpecificTimeSpecification.GetMatchs#$UMM2::$:GJ {{'' (8(8$++Ff fe"**u??Y#>+@o&&';';UCk   !6!6 7JOO $E4884I/: &&s4&8$((0D ,;MM**3t*>A5I05I0I0/I0)rrrrRr*r)NNNNz00:00N) rrrrr>r^rrr2rrrs@rr#r#s8, 8+t<:GGrr#)N)r> __future__rrrrrQrr __author__r@rbMINUTES Exceptionr rr,objectr.rDrMrVrr#r rrrs( '% .   9C8  F0 6 5Q 1QhR 1Rr