U c$@sddlZddlmZddlmZddlmZmZmZm Z m Z e Z e Z ifddZifdd Zd d Ze ifd d ZGdddeZeejdZdZdS)Ntzinfo)_compat)AmbiguousTimeErrorNonExistentTimeErrorPytzUsageWarningUnknownTimeZoneError get_exceptioncCs||d}|dkr|t|dkr:|dkr:||t}nBzt|}Wntk rftt |YnX||t ||d}|S)aBuilds an IANA database time zone shim. This is the equivalent of ``pytz.timezone``. :param key: A valid key from the IANA time zone database. :raises UnknownTimeZoneError: If an unknown value is passed, this will raise an exception that can be caught by :exc:`pytz_deprecation_shim.UnknownTimeZoneError` or ``pytz.UnknownTimeZoneError``. Like :exc:`zoneinfo.ZoneInfoNotFoundError`, both of those are subclasses of :exc:`KeyError`. Nutckey) getlenlower setdefaultUTCrZ get_timezoneKeyErrorr r wrap_zone)r_cacheinstancezoner?/tmp/pip-unpacked-wheel-pe1vybbg/pytz_deprecation_shim/_impl.pytimezones rcCsld|krdks ntd|||d}|dkrh|dkrJ||t}nt|}||t|dd}|S)aBuilds a fixed offset time zone shim. This is the equivalent of ``pytz.FixedOffset``. An alias is available as ``pytz_deprecation_shim.FixedOffset`` as well. :param offset: A fixed offset from UTC, in minutes. This must be in the range ``-1439 <= offset <= 1439``. :raises ValueError: For offsets whose absolute value is greater than or equal to 24 hours. :return: A shim time zone. i`izabsolute offset is too largeNrr ) ValueErrorrrrrZget_fixed_offset_zoner)offsetrrrrrrfixed_offset_timezone/s   rcCst|}t||dS)aTBuilds a shim object from a TZif file. This is a shim for ``pytz.build_tzinfo``. Given a value to use as the zone IANA key and a file-like object containing a valid TZif file (i.e. conforming to :rfc:`8536`), this builds a time zone object and wraps it in a shim class. The argument names are chosen to match those in ``pytz.build_tzinfo``. :param zone: A string to be used as the time zone object's IANA key. :param fp: A readable file-like object emitting bytes, pointing to a valid TZif file. :return: A shim time zone. r )rZget_timezone_filer)rfpZ zone_filerrr build_tzinfoMs r cCs^|tkrt|dt}|tkr$td|t||fd}|dkrZ|t||ft||}|S)aWrap an existing time zone object in a shim class. This is likely to be useful if you would like to work internally with non-``pytz`` zones, but you expose an interface to callers relying on ``pytz``'s interface. It may also be useful for passing non-``pytz`` zones to libraries expecting to use ``pytz``'s interface. :param tz: A :pep:`495`-compatible time zone, such as those provided by :mod:`dateutil.tz` or :mod:`zoneinfo`. :param key: The value for the IANA time zone key. This is optional for ``zoneinfo`` zones, but required for ``dateutil.tz`` zones. :return: A shim time zone. rzVThe `key` argument is required when wrapping zones that do not have a `key` attribute.N) KEY_SENTINELgetattr TypeErrorridr_PytzShimTimezone)tzrrrrrrrfs rc@seZdZdZdZddZddZddZdd Zd d Z d d Z ddZ ddZ e ddZefddZddZddZdddZddZdS)r%NcCs||_||_dSN)_key_zone)selfrrrrr__init__sz_PytzShimTimezone.__init__cCs |j|Sr')r) utcoffsetr*dtrrrr,sz_PytzShimTimezone.utcoffsetcCs |j|Sr')r)dstr-rrrr/sz_PytzShimTimezone.dstcCs |j|Sr')r)tznamer-rrrr0sz_PytzShimTimezone.tznamecCs&|j|jd}|j|}|j|dS)Nr)replacer)fromutc)r*r.Zdt_basedt_outrrrr2s z_PytzShimTimezone.fromutccCs |jdk rt|jSt|SdSr')r(strreprr*rrr__str__s  z_PytzShimTimezone.__str__cCsd|jjt|jt|jfS)Nz %s(%s, %s)) __class____name__r5r)r(r6rrr__repr__s z_PytzShimTimezone.__repr__cCs|jS)aReturns the underlying class that the shim is a wrapper for. This is a shim-specific method equivalent to :func:`pytz_deprecation_shim.helpers.upgrade_tzinfo`. It is provided as a method to allow end-users to upgrade shim timezones without requiring an explicit dependency on ``pytz_deprecation_shim``, e.g.: .. code-block:: python if getattr(tz, "unwrap_shim", None) is None: tz = tz.unwrap_shim() )r)r6rrr unwrap_shims z_PytzShimTimezone.unwrap_shimcCstjddttdd|jS)Nz`The zone attribute is specific to pytz's interface; please migrate to a new time zone provider. z(For more details on how to do so, see %s stacklevel)warningswarnPYTZ_MIGRATION_GUIDE_URLrr(r6rrrrs z_PytzShimTimezone.zonecCstjddttdd|jdk r*td|j|d}|tkrB|St |}|sZt |nd}|dkr|r|t t |jdd|rt t |jddnp|s|rt|r|}tj|dd }ntj|d d }t|}t||kr||k}||kr|}|S) NzThe localize method is no longer necessary, as this time zone supports the fold attribute (PEP 495). For more details on migrating to a PEP 495-compliant implementation, see %sr<r=z*Not naive datetime (tzinfo is already set)rFr)foldr)r?r@rArrrr1IS_DST_SENTINELrZ is_ambiguousZ is_imaginaryr rrZget_foldZenfoldboolr/r,)r*r.Zis_dstr3Z dt_ambiguousZ dt_imaginaryZ dt_enfoldedZ enfolded_dstrrrlocalizesD        z_PytzShimTimezone.localizecCsBtjddttdd|jdkr*td|j|kr8|S||S)NzThe normalize method is no longer necessary, as this time zone supports the fold attribute (PEP 495). For more details on migrating to a PEP 495-compliant rBr<r=zNaive time - no tzinfo set)r?r@rArrr astimezoner-rrr normalize s  z_PytzShimTimezone.normalizecCs|Sr'rr6rrr__copy__sz_PytzShimTimezone.__copy__cCs|Sr'r)r*memorrr __deepcopy__sz_PytzShimTimezone.__deepcopy__cCst|j|jffSr')rr)r(r6rrr __reduce__!sz_PytzShimTimezone.__reduce__)N)r9 __module__ __qualname__r)r(r+r,r/r0r2r7r:r;propertyrrDrFrHrIrKrLrrrrr%s" < r%rzEhttps://pytz-deprecation-shim.readthedocs.io/en/latest/migration.html)r?datetimerr _exceptionsrrrr r objectrDr!rrr rr%rrArrrrs    #