g~L4dZddlZddlZddlZddlZddlZddlZddlmZddlm Z m Z m Z ddlm Z ddl ZddlZdZ dZdZd Zd Zd Zd ZeezZeezZeez Zej4d Zej4edz Zedz Zeezdz Zej>de fdZ!e ejejDejfZ#e e e$dfejJfZ&de#dejfdZ'de e#e&fdejfdZ(de)de e#e*ejJfde)fdZ+djdZ,djdZ-dZ.dZ/dZ0dZ1dZ2d e)de e e)effd!Z3d"Z4d#Z5d$Z6id%d&d'd&d(d&d)d&d*d&d+d,d-d,d.d,d/d0d1d0d2d3d4d3d5d6d7d6d8d9d:d9d;d<d=d=d=d>Z7d?Z8d@Z9dAZ:GdBdCZ;dkdDZ<e=dlidEej|jdFdGej|jdFdHej|jdIdJej|jdKdLej|jdMdNej|jdOdPej|jdOdQej|jdRdSej|jdRdTej|jdUdVej|jdUdWej|jdXdYej|jdXdZej|jd[d\ej|jd\d]ej|jd^d_ej|jd^d`ej|jdadbej|jdcddej|jdedfej|jdgdhej|jdgZ@diZAy)mz:Objects and routines pertaining to date and time (tempora)N)Number)UnionTupleIterable)castl_Kr4 lmGiL<days returncfttjdddjddk7S)zp Some versions of Python render %Y with only three characters :( https://bugs.python.org/issue39103 ir%Y)lendatetimedatestrftime%/opt/Tautulli/lib/tempora/__init__.py_needs_year_helpr's, x}}S!Q'006 71 <`_. This function aims to smooth over those issues and provide a consistent experience across the major platforms. >>> strftime('%Y', datetime.datetime(1890, 1, 1)) '1890' >>> strftime('%Y', datetime.datetime(900, 1, 1)) '0900' Supports time.struct_time, tuples, and datetime.datetime objects. >>> strftime('%Y-%m-%d', (1976, 5, 7)) '1976-05-07' Also supports date objects >>> strftime('%Y', datetime.date(1976, 5, 7)) '1976' Also supports milliseconds using %s. >>> strftime('%s', datetime.time(microsecond=20000)) '020' Also supports microseconds (3 digits) using %µ >>> strftime('%µ', datetime.time(microsecond=123456)) '456' Historically, %u was used for microseconds, but now it honors the value rendered by stdlib. >>> strftime('%u', datetime.date(1976, 5, 7)) '5' Also supports microseconds (6 digits) using %f >>> strftime('%f', datetime.time(microsecond=23456)) '023456' Even supports time values on date objects (discouraged): >>> strftime('%f', datetime.date(1976, 1, 1)) '000000' >>> strftime('%µ', datetime.date(1976, 1, 1)) '000' >>> strftime('%s', datetime.date(1976, 1, 1)) '000' And vice-versa: >>> strftime('%Y', datetime.time()) '1900' z%sz%03du%µrz%04dc |j|SN)replace)ssubs rdoSubzstrftime..doSubsqyy#rc2tj|Sr,) functoolsreduce)r.r0subss rdoSubszstrftime..doSubsstQ//rz%%)r& microsecondyearrjoinmapsplitr)r'r(r5r0r4s @@rrrJsv qA v$./0 !--$./0   "%5%77 8D 0 ))C $0 1C ::c?rc|@tjj|jtj}||z }d}t |||f\}}tj ||z}||z }|S)a Find the time which is the specified date/time truncated to the time delta relative to the start date/time. By default, the start time is midnight of the same day as the specified date/time. >>> datetime_mod(datetime.datetime(2004, 1, 2, 3), ... datetime.timedelta(days = 1.5), ... start = datetime.datetime(2004, 1, 1)) datetime.datetime(2004, 1, 1, 0, 0) >>> datetime_mod(datetime.datetime(2004, 1, 2, 13), ... datetime.timedelta(days = 1.5), ... start = datetime.datetime(2004, 1, 1)) datetime.datetime(2004, 1, 2, 12, 0) >>> datetime_mod(datetime.datetime(2004, 1, 2, 13), ... datetime.timedelta(days = 7), ... start = datetime.datetime(2004, 1, 1)) datetime.datetime(2004, 1, 1, 0, 0) >>> datetime_mod(datetime.datetime(2004, 1, 10, 13), ... datetime.timedelta(days = 7), ... start = datetime.datetime(2004, 1, 1)) datetime.datetime(2004, 1, 8, 0, 0) cb|jtz|jzdz|jzS)N@B)r seconds_per_dayseconds microsecondstds rget_time_delta_microsecondsz1datetime_mod..get_time_delta_microsecondss(/)BJJ6'ABOOSSrr@)rr rrr9 timedelta)dtperiodstartdeltarCoffsetresults r datetime_modrLsu0 }!!))"'')X]]_E JE T3eV_EME6   UV^ >> datetime_round(datetime.datetime(2004, 11, 13, 8, 11, 13), ... datetime.timedelta(hours = 1)) datetime.datetime(2004, 11, 13, 8, 0) >>> datetime_round(datetime.datetime(2004, 11, 13, 8, 31, 13), ... datetime.timedelta(hours = 1)) datetime.datetime(2004, 11, 13, 9, 0) >>> datetime_round(datetime.datetime(2004, 11, 13, 8, 30), ... datetime.timedelta(hours = 1)) datetime.datetime(2004, 11, 13, 9, 0) r)rLabs)rFrGrHrKs rdatetime_roundrOs6"fe ,F 2;6Q;&& Mrctj}|j}||jz dkDr|dz}|j|z dkDr|dz }|S)aF Returns the nearest year to now inferred from a Julian date. >>> freezer = getfixture('freezer') >>> freezer.move_to('2019-05-20') >>> get_nearest_year_for_day(20) 2019 >>> get_nearest_year_for_day(340) 2018 >>> freezer.move_to('2019-12-15') >>> get_nearest_year_for_day(20) 2020 r)rgmtimetm_yeartm_yday)daynowrKs rget_nearest_year_for_dayrWsQ ++-C [[F S[[8#!  {{S8#!  Mrcltj|dd}|tj|dz z }|S)z Gregorian Date is defined as a year and a julian day (1-based index into the days of the year). >>> gregorian_date(2007, 15) datetime.date(2007, 1, 15) rr )rrrE)r7 julian_dayrKs rgregorian_daterZs4]]4A &F h  j1n55F Mrcpt|tr# d|jz}t|}|St|t jr|}|St|tjr'|jtdz|jz}|Std#t$rd}t |wxYw)a return the number of seconds in the specified period >>> get_period_seconds('day') 86400 >>> get_period_seconds(86400) 86400 >>> get_period_seconds(datetime.timedelta(hours=24)) 86400 >>> get_period_seconds('day + os.system("rm -Rf *")') Traceback (most recent call last): ... ValueError: period not in (second, minute, hour, day, month, year) seconds_per_z6period not in (second, minute, hour, day, month, year)rUz"period must be a string or integer)rstrlowerglobalsKeyError ValueErrornumbersrrrEr get_period_secondsr? TypeError)rGnamerKmsgs rrcrcs&# "!FLLN2DYt_F M FGNN + M FH.. /1%886>>I M<== "JCS/ ! "s BB5ct|tr|jdk(ryt|d}d}tt t t|f}ttfd|}|d|jddz}dj|S) a For a given period (e.g. 'month', 'day', or some numeric interval such as 3600 (in secs)), return the format string that can be used with strftime to format that time to specify the times across that interval, but no more detailed. For example, >>> get_date_format_string('month') '%Y-%m' >>> get_date_format_string(3600) '%Y-%m-%d %H' >>> get_date_format_string('hour') '%Y-%m-%d %H' >>> get_date_format_string(None) Traceback (most recent call last): ... TypeError: period must be a string or integer >>> get_date_format_string('garbage') Traceback (most recent call last): ... ValueError: period not in (second, minute, hour, day, month, year) monthz%Y-%m)rz-%m-%dz %Hz-%Mz-%Src|zSr,r)intervalfile_period_secss rz(get_date_format_string..?s %5%@rNr) rr]r^rcseconds_per_yearr>seconds_per_hourseconds_per_minutelistr9indexr8)rG format_piecesseconds_per_second intervalsmodsrks @rget_date_format_stringrws2&#6<<>W#<)&19M I @)L MD!"5DJJqMA$56M 77= !!rcbtd}t|D]\}}td|d|y)a* >>> monkeypatch = getfixture('monkeypatch') >>> import builtins >>> monkeypatch.setattr(builtins, 'input', lambda prompt: '3/hour') >>> calculate_prorated_values() per minute: 0.05 per hour: 3.0 per day: 72.0 per month: 2191.454166666667 per year: 26297.45 z#Enter the rate (3/hour, 50/month)> zper z: N)input_prorated_valuesprint)raterGvalues rcalculate_prorated_valuesr~Ds< 6 7D)$/(  VHBug&'(rr|c#Ktjd|}ttj|j }t |d}|t |dz }dD]}|t |z}||fyw)aJ Given a rate (a string in units per unit time), and return that same rate for various time periods. >>> for period, value in _prorated_values('20/hour'): ... print('{period}: {value:0.3f}'.format(**locals())) minute: 0.333 hour: 20.000 day: 480.000 month: 14609.694 year: 175316.333 z"(?P[\d.]+)/(?P\w+)$r}rG)minutehourrUrhr7N)rematchrMatch groupdictfloatrc)r|rresr}value_per_secondrG period_values rrzrzUs HH:D AE rxx  ) ) +C #g, E1#h-@@<#'*>> parse_timedelta('1 day') datetime.timedelta(days=1) >>> parse_timedelta('1 day, 30 seconds') datetime.timedelta(days=1, seconds=30) >>> parse_timedelta('47.32 days, 20 minutes, 15.4 milliseconds') datetime.timedelta(days=47, seconds=28848, microseconds=15400) Supports weeks, months, years >>> parse_timedelta('1 week') datetime.timedelta(days=7) >>> parse_timedelta('1 year, 1 month') datetime.timedelta(days=395, seconds=58685) Note that months and years strict intervals, not aligned to a calendar: >>> date = datetime.datetime.fromisoformat('2000-01-01') >>> later = date + parse_timedelta('1 year') >>> diff = later.replace(year=date.year) - date >>> diff.seconds 20940 >>> parse_timedelta('foo') Traceback (most recent call last): ... ValueError: Unexpected 'foo' >>> parse_timedelta('14 seconds foo') Traceback (most recent call last): ... ValueError: Unexpected 'foo' Supports abbreviations: >>> parse_timedelta('1s') datetime.timedelta(seconds=1) >>> parse_timedelta('1sec') datetime.timedelta(seconds=1) >>> parse_timedelta('5min1sec') datetime.timedelta(seconds=301) >>> parse_timedelta('1 ms') datetime.timedelta(microseconds=1000) >>> parse_timedelta('1 µs') datetime.timedelta(microseconds=1) >>> parse_timedelta('1 us') datetime.timedelta(microseconds=1) And supports the common colon-separated duration: >>> parse_timedelta('14:00:35.362') datetime.timedelta(seconds=50435, microseconds=362000) TODO: Should this be 14 hours or 14 minutes? >>> parse_timedelta('14:00') datetime.timedelta(seconds=50400) >>> parse_timedelta('14:00 minutes') Traceback (most recent call last): ... ValueError: Cannot specify units with composite delta Nanoseconds get rounded to the nearest microsecond: >>> parse_timedelta('600 ns') datetime.timedelta(microseconds=1) >>> parse_timedelta('.002 µs, 499 ns') datetime.timedelta(microseconds=1) Expect ValueError for other invalid inputs. >>> parse_timedelta('13 feet') Traceback (most recent call last): ... ValueError: Invalid unit feets )_parse_timedelta_nanosresolve)r]s rparse_timedeltarlsv "# & . . 00rctjd|}t||}tt|}t |t S)Nz)(?P[\d.:]+)\s?(?P[^\W\d_]+)?)rfinditer_check_unmatchedr9_parse_timedelta_partsum _Saved_NS)r]parts chk_partsdeltass rrrs; KKDc JE ,I & 2F vy{ ##rc#Kd}d}|D]/}||||j||j}1|||dyw)z3 Ensure no words appear in unmatched text. cntjd|}|rtd|jdy)Nz\w+z Unexpected r)rsearchragroup) unmatchedfounds rcheck_unmatchedz)_check_unmatched..check_unmatcheds5 &), {5;;q>*<=> > rrN)rHend)matchestextrposrs rrrsV ? CS5;;=12 iikDJsAAuµsr6uµsecususecmicrosms millisecondmsecmillisr.secondsechrhrmrminwweekwkdrU nanosecond)nsnsecnanoscT|y|j}tj||S)Nr)r^ _unit_lookupget) raw_matchrs r _resolve_unitrs* ?? D   D$ ''rc|dk7r td|jd}d}djdt||D}t |S)Nr?z)Cannot specify units with composite delta:)hoursminutesr? c30K|]\}}|d|yw)rNr).0r}units r z-_parse_timedelta_composite..sPkeT5'4&)Ps)rar:r8zipr) raw_valuervaluesunitscomposeds r_parse_timedelta_compositersO yDEE __S !F )ExxPS=OPPH !( ++rct|jd}|jds|dz }|jd}d|vr t||St |}|dk(rd}|dz }|dk(r d}|t z}t j||S) Nrr.r}rmonthsyearsrr )rrendswithrr days_per_yearrderive)rrrr}s rrr s V, -D ==    G$I i))T:: ) E x  w %   D% ((rcteZdZdZej ZdZedddZ dZ e dZ d Z d Zd Zy ) rz Bundle a timedelta with nanoseconds. >>> _Saved_NS.derive('microseconds', .001) _Saved_NS(td=datetime.timedelta(0), nanoseconds=1) riʚ;r=r*)r? millisecondsr@c 8t|j|yr,)varsupdate)selfkwargss r__init__z_Saved_NS.__init__,s T &!rcJ|dk(r t|S tjdi||i}t|}t j t5t||j|zdz|_ ddd|S#t$rt d|wxYw#1swY|SxYw)N nanoseconds)rz Invalid unit rAr*r) rrrErdra contextlibsuppressr`int multiplierr)clsrr}raw_tdrs rrz_Saved_NS.derive/s = / / 5''84-8F6"   * G!%#..*>">?$FCO G  5}TF34 4 5 G sA=$B=BB"cxt|j|jz|j|jzS)NrBr)rrBr)rothers r__add__z_Saved_NS.__add__=s2ww!t/?/?%BSBS/S  rcxt|jdz }|jtj|zS)z Resolve any nanoseconds into the microseconds field, discarding any nanosecond resolution (but honoring partial microseconds). r*rD)roundrrBrrE)r addl_micross rrz_Saved_NS.resolveBs3 D,,t34 ww++EEErc<d|jd|jdS)Nz _Saved_NS(td=z, nanoseconds=)r)rs r__repr__z_Saved_NS.__repr__Ks"twwk8H8H7K1MMrN)__name__ __module__ __qualname____doc__rrErBrdictrr classmethodrrrrrrrrrs[    BKJ "   FNrrc#K|tjd}|tjj}||kr|||z }||kryyw)a Much like the built-in function range, but works with dates >>> range_items = date_range( ... datetime.datetime(2005,12,21), ... datetime.datetime(2005,12,25), ... ) >>> my_range = tuple(range_items) >>> datetime.datetime(2005,12,21) in my_range True >>> datetime.datetime(2005,12,22) in my_range True >>> datetime.datetime(2005,12,25) in my_range False >>> from_now = date_range(stop=datetime.datetime(2099, 12, 31)) >>> next(from_now) datetime.datetime(...) Nrr )rrErV)rHstopsteps r date_rangerOsT& |!!q) }!!%%' $,    $,s A AAAESTzAustralia/SydneyAEDTACSTzAustralia/DarwinACDTzAustralia/AdelaideAWSTzAustralia/PerthESTzAmerica/New_YorkEDTCSTzAmerica/ChicagoCDTMSTzAmerica/DenverMDTPSTzAmerica/Los_AngelesPDTGMTzEtc/GMTUTCCETz Europe/BerlinCESTISTz Asia/KolkataBSTz Europe/LondonMSKz Europe/MoscowEETzEurope/HelsinkiEESTcLtjj|dti|S)z Parse the input using dateutil.parser.parse with friendly tz support. >>> parse('2024-07-26 12:59:00 EDT') datetime.datetime(...America/New_York...) tzinfos)dateutilparserparser )argsrs rrrs# ?? $ B B6 BBrr,)NNNr)Brrrrrbr2rrtypingrrrrdateutil.parserr  dateutil.tz osc_per_yearosc_per_secondrtrnrpminutes_per_hour hours_per_dayror>rrE thirty_days six_monthsseconds_per_monthhours_per_month lru_cacheboolrr AnyDatetimerr$StructDatetimer!r&r]r%rrLrOrWrZrcrwr~rzrrrrrrrrrrtzgettzr rrrrr"s*< ))'  %(88"]2 ?2  h  b) X  ]Q%6 7 $r)-/"4=$==H%%x}}hmmCD uS#X(8(889 1 1(9(9 1 u[.89h>O>O H#H% UD4D4D DEH#HV)X(2 >'"T("#3#8E#v+,>#?#.[1|$ $ = ] - M   m   -  M m 8 & 8  &!"#$   ) 0(,)"0N0Nf8     - .    - .    - .    / 0     , -    ,-    ,-   +,   +,   *+   *+   /0   /0   )$   %    /*! "   ? +# $  .)% &  /*' (  /*) *  +,+ ,   , -- 6Cr