ݲk^c @s{dZddlZddlZddlZddlZddlmZmZmZmZdZ dZ ej dZ dZ ded d d fd ed d d fd ed ddfd edd dfd edddfdedddfd edddfgZgeD])Zeded ed edf^q"ZgeD]Zed^qXZdZej deZegeed D]#\ZZZededf^qZdZeZdZddedZddd Zd!Zd e d"Z!edZ"ed#d Z#d$efd%YZ$e$d&Z%ej&de%Z'ej(dZ)d'efd(YZ*e*Z+d)Z,ed d*d+dZ-ed d,d d Z.ed d-d dZ/ed d.d/d Z0ed d-d0dZ1e0Z2d1efd2YZ3e3d3d4d5d6Z4e3d7d8d9d:Z5e3d;d<d=d>Z6e3d?d@dAdBZ7dS(CsPython's :mod:`datetime` module provides some of the most complex and powerful primitives in the Python standard library. Time is nontrivial, but thankfully its support is first-class in Python. ``dateutils`` provides some additional tools for working with time. Additionally, timeutils provides a few basic utilities for working with timezones in Python. The Python :mod:`datetime` module's documentation describes how to create a :class:`~datetime.datetime`-compatible :class:`~datetime.tzinfo` subtype. It even provides a few examples. The following module defines usable forms of the timezones in those docs, as well as a couple other useful ones, :data:`UTC` (aka GMT) and :data:`LocalTZ` (representing the local timezone as configured in the operating system). For timezones beyond these, as well as a higher degree of accuracy in corner cases, check out `pytz`_ and `dateutil`_. .. _pytz: https://pypi.python.org/pypi/pytz .. _dateutil: https://dateutil.readthedocs.io/en/stable/index.html iN(ttzinfot timedeltatdatetdatetimecCs3d}|j|jd}|j||}||S(saFor those with older versions of Python, a pure-Python implementation of Python 2.7's :meth:`~datetime.timedelta.total_seconds`. Args: td (datetime.timedelta): The timedelta to convert to seconds. Returns: float: total number of seconds >>> td = timedelta(days=4, seconds=33) >>> total_seconds(td) 345633.0 g.AiQ(tsecondstdayst microseconds(ttdta_millittd_dsttd_micro((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt total_seconds"s cCs*|jr|t}n |t}t|S(s_Converts from a :class:`~datetime.datetime` object to an integer timestamp, suitable interoperation with :func:`time.time` and other `Epoch-based timestamps`. .. _Epoch-based timestamps: https://en.wikipedia.org/wiki/Unix_time >>> abs(round(time.time() - dt_to_timestamp(datetime.utcnow()), 2)) 0.0 ``dt_to_timestamp`` supports both timezone-aware and naïve :class:`~datetime.datetime` objects. Note that it assumes naïve datetime objects are implied UTC, such as those generated with :meth:`datetime.datetime.utcnow`. If your datetime objects are local time, such as those generated with :meth:`datetime.datetime.now`, first convert it using the :meth:`datetime.datetime.replace` method with ``tzinfo=`` :class:`LocalTZ` object in this module, then pass the result of that to ``dt_to_timestamp``. (Rt EPOCH_AWAREt EPOCH_NAIVER (tdtR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytdt_to_timestamp5s   s\DcCs2gtj|D]}t|^q}t|S(sParses the limited subset of `ISO8601-formatted time`_ strings as returned by :meth:`datetime.datetime.isoformat`. >>> epoch_dt = datetime.utcfromtimestamp(0) >>> iso_str = epoch_dt.isoformat() >>> print(iso_str) 1970-01-01T00:00:00 >>> isoparse(iso_str) datetime.datetime(1970, 1, 1, 0, 0) >>> utcnow = datetime.utcnow() >>> utcnow == isoparse(utcnow.isoformat()) True For further datetime parsing, see the `iso8601`_ package for strict ISO parsing and `dateutil`_ package for loose parsing and more. .. _ISO8601-formatted time: https://en.wikipedia.org/wiki/ISO_8601 .. _iso8601: https://pypi.python.org/pypi/iso8601 .. _dateutil: https://pypi.python.org/pypi/python-dateutil (t _NONDIGIT_REtsplittintR(tiso_strtptdt_args((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytisoparseSs(iRitsecondi<tminuteithourRtdayitweekiitmonthimtyears*[+-]?\ *(\d+(\.\d*)?|\.\d+)([eE][+-]?\d+)?s!((?P%s)\s*(?P\w)\w*)itscCsi}xtj|D]}|jd|jd}}yt|}Wn-tk rxtd|tjfnXyt|}Wn'tk rtd||fnX|||>> parse_td('1d 2h 3.5m 0s') == timedelta(days=1, seconds=7410) True Also supports full words and whitespace. >>> parse_td('2 weeks 1 day') == timedelta(days=15) True Negative times are supported, too: >>> parse_td('-1.5 weeks 3m 20s') == timedelta(days=-11, seconds=43400) True tvaluetunits(invalid time unit %r, expected one of %rs"invalid time value for unit %r: %r( t _PARSE_TD_REtfinditertgroupt_PARSE_TD_KW_MAPtKeyErrort ValueErrortkeystfloatR(ttextt td_kwargstmatchRR tunit_key((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytparse_timedelta~s  cCs|dkr|S|dS(NiR((R R((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt_cardinalize_time_units c Cs|dkrtj}n||}t|}t|}tjt|d}t|\}} } |t| } t| |} |r| t | t| fS| | fS(sGet a tuple representing the relative time difference between two :class:`~datetime.datetime` objects or one :class:`~datetime.datetime` and now. Args: d (datetime): The first datetime object. other (datetime): An optional second datetime object. If unset, defaults to the current time as determined :meth:`datetime.utcnow`. ndigits (int): The number of decimal digits to round to, defaults to ``0``. cardinalize (bool): Whether to pluralize the time unit if appropriate, defaults to ``True``. Returns: (float, str): A tuple of the :class:`float` difference and respective unit of time, pluralized if appropriate and *cardinalize* is set to ``True``. Unlike :func:`relative_time`, this method's return is amenable to localization into other languages and custom phrasing and formatting. >>> now = datetime.utcnow() >>> decimal_relative_time(now - timedelta(days=1, seconds=3600), now) (1.0, 'day') >>> decimal_relative_time(now - timedelta(seconds=0.002), now, ndigits=5) (0.002, 'seconds') >>> decimal_relative_time(now, now - timedelta(days=900), ndigits=1) (-2.5, 'years') iN( tNoneRtutcnowR tabstbisectt _BOUND_DELTASt_BOUNDStroundR.( tdtothertndigitst cardinalizetdifft diff_secondstabs_difftb_idxtbboundtbunittbnametf_difft rounded_diff((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytdecimal_relative_times    cCsPt|||dt\}}d}|dkr9d}ndt|||fS(sIGet a string representation of the difference between two :class:`~datetime.datetime` objects or one :class:`~datetime.datetime` and the current time. Handles past and future times. Args: d (datetime): The first datetime object. other (datetime): An optional second datetime object. If unset, defaults to the current time as determined :meth:`datetime.utcnow`. ndigits (int): The number of decimal digits to round to, defaults to ``0``. Returns: A short English-language string. >>> now = datetime.utcnow() >>> relative_time(now, ndigits=1) '0 seconds ago' >>> relative_time(now - timedelta(days=1, seconds=36000), ndigits=1) '1.4 days ago' >>> relative_time(now + timedelta(days=7), now, ndigits=1) '1 week from now' R9tagoisfrom nows%g %s %s(RCtTrueR1(R6R7R8tdrtR tphrase((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt relative_times   cCstj||}|jS(sqParse the date string according to the format in `format`. Returns a :class:`date` object. Internally, :meth:`datetime.strptime` is used to parse the string and thus conversion specifiers for time fields (e.g. `%H`) may be provided; these will be parsed but ignored. Args: string (str): The date string to be parsed. format (str): The `strptime`_-style date format string. Returns: datetime.date .. _`strptime`: https://docs.python.org/2/library/datetime.html#strftime-strptime-behavior >>> strpdate('2016-02-14', '%Y-%m-%d') datetime.date(2016, 2, 14) >>> strpdate('26/12 (2015)', '%d/%m (%Y)') datetime.date(2015, 12, 26) >>> strpdate('20151231 23:59:59', '%Y%m%d %H:%M:%S') datetime.date(2015, 12, 31) >>> strpdate('20160101 00:00:00.001', '%Y%m%d %H:%M:%S.%f') datetime.date(2016, 1, 1) (RtstrptimeR(tstringtformattwhence((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytstrpdatesc cst|tstdn|rCt|t rCtdny|\}}}Wn%tk r}dd|}}}nXt|t|}}t|trtdt|}n"t|trntd||d krd}n?||kr|rtjntj }n|r.tj ntj }|}xv|||s|V|s`|rt |j |d\} } |jd|j|| d | pd}n||}q@Wd S( sIn the spirit of :func:`range` and :func:`xrange`, the `daterange` generator that yields a sequence of :class:`~datetime.date` objects, starting at *start*, incrementing by *step*, until *stop* is reached. When *inclusive* is True, the final date may be *stop*, **if** *step* falls evenly on it. By default, *step* is one day. See details below for many more details. Args: start (datetime.date): The starting date The first value in the sequence. stop (datetime.date): The stopping date. By default not included in return. Can be `None` to yield an infinite sequence. step (int): The value to increment *start* by to reach *stop*. Can be an :class:`int` number of days, a :class:`datetime.timedelta`, or a :class:`tuple` of integers, `(year, month, day)`. Positive and negative *step* values are supported. inclusive (bool): Whether or not the *stop* date can be returned. *stop* is only returned when a *step* falls evenly on it. >>> christmas = date(year=2015, month=12, day=25) >>> boxing_day = date(year=2015, month=12, day=26) >>> new_year = date(year=2016, month=1, day=1) >>> for day in daterange(christmas, new_year): ... print(repr(day)) datetime.date(2015, 12, 25) datetime.date(2015, 12, 26) datetime.date(2015, 12, 27) datetime.date(2015, 12, 28) datetime.date(2015, 12, 29) datetime.date(2015, 12, 30) datetime.date(2015, 12, 31) >>> for day in daterange(christmas, boxing_day): ... print(repr(day)) datetime.date(2015, 12, 25) >>> for day in daterange(date(2017, 5, 1), date(2017, 8, 1), ... step=(0, 1, 0), inclusive=True): ... print(repr(day)) datetime.date(2017, 5, 1) datetime.date(2017, 6, 1) datetime.date(2017, 7, 1) datetime.date(2017, 8, 1) *Be careful when using stop=None, as this will yield an infinite sequence of dates.* s%start expected datetime.date instances,stop expected datetime.date instance or NoneiRsBstep expected int, timedelta, or tuple (year, month, day), not: %rcSstS(N(tFalse(tt((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytbsi RRN(t isinstanceRt TypeErrorRRR&R/toperatortgttgetlttletdivmodRtreplaceR( tstarttstoptstept inclusivety_steptm_steptd_steptfinishedtnowtm_y_stept cur_month((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt dateranges:3      thourstConstantTZInfocBsPeZdZdedZedZdZdZdZ dZ RS(s A :class:`~datetime.tzinfo` subtype whose *offset* remains constant (no daylight savings). Args: name (str): Name of the timezone. offset (datetime.timedelta): Offset of the timezone. t ConstantTZcCs||_||_dS(N(tnametoffset(tselfRiRj((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt__init__s cCst|jdS(Ni<i(R Rj(Rk((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytutcoffset_hoursscCs|jS(N(Rj(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt utcoffsetscCs|jS(N(Ri(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyttznamescCstS(N(tZERO(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytdstscCs#|jj}d||j|jfS(Ns%s(name=%r, offset=%r)(t __class__t__name__RiRj(Rktcn((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt__repr__s ( Rst __module__t__doc__RpRltpropertyRmRnRoRqRu(((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRgzs   tUTCt LocalTZInfocBsseZdZedej ZeZejrDedej ZndZ dZ dZ dZ dZRS(sKThe ``LocalTZInfo`` type takes data available in the time module about the local timezone and makes a practical :class:`datetime.tzinfo` to represent the timezone settings of the operating system. For a more in-depth integration with the operating system, check out `tzlocal`_. It builds on `pytz`_ and implements heuristics for many versions of major operating systems to provide the official ``pytz`` tzinfo, instead of the LocalTZ generalization. .. _tzlocal: https://pypi.python.org/pypi/tzlocal .. _pytz: https://pypi.python.org/pypi/pytz Rc Cs^|j|j|j|j|j|j|jddf }tjtj |}|j dkS(Nii( RRRRRRtweekdayttimet localtimetmktimettm_isdst(RkRtdt_ttlocal_t((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytis_dstscCs|j|r|jS|jS(N(Rt _dst_offsett _std_offset(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRnscCs!|j|r|j|jStS(N(RRRRp(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRqscCstj|j|S(N(R|RoR(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRoscCsd|jjS(Ns%s()(RrRs(Rk((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRus(RsRvRwRR|ttimezoneRRtdaylighttaltzoneRRnRqRoRu(((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRzs     cCs-d|j}|r)|t|7}n|S(Ni(R{R(Rt days_to_go((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyt_first_sunday_on_or_aftersiii ii iit USTimeZonecBs;eZdZdZdZdZdZdZRS(sCopied directly from the Python docs, the ``USTimeZone`` is a :class:`datetime.tzinfo` subtype used to create the :data:`Eastern`, :data:`Central`, :data:`Mountain`, and :data:`Pacific` tzinfo types. cCs1td||_||_||_||_dS(NRf(Rt stdoffsettreprnametstdnametdstname(RkRfRRR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRls  cCs|jS(N(R(Rk((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRuscCs!|j|r|jS|jSdS(N(RqRR(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRoscCs|j|j|S(N(RRq(RkR((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRnscCs|dks|jdkrtS|j|ks4td|jkrStt}}nbd|jkomdknrtt}}n3d|jkodknrt t }}ntSt |j d|j}t |j d|j}||j ddko|knrt StSdS(NiiiiiRR(R/RRptAssertionErrorRt DSTSTART_2007t DSTEND_2007tDSTSTART_1987_2006tDSTEND_1987_2006tDSTSTART_1967_1986tDSTEND_1967_1986RRYtHOUR(RkRtdststarttdstendRZtend((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRqs((RsRvRwRlRuRoRnRq(((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pyRs     itEasterntESTtEDTitCentraltCSTtCDTitMountaintMSTtMDTitPacifictPSTtPDT(8RwtreR|R2RSRRRRR RtcompileRRR4tbR3t_FLOAT_PATTERNR!tdicttreversedt_R R$R-tparse_tdR.R/RERCRHRMRNReRpRRgRyt fromtimestampR tutcfromtimestampR RztLocalTZRRRRRRRRRRRR(((s>lib/python2.7/site-packages/conda/_vendor/boltons/timeutils.pytsb    "   6: * . Z  +  7