o [@sddlZddlZddlmZddlmZddlmZddlm Z gdZ dZ dZ Gd d d e Z d d ZGd ddeZgZdddZddZddZdS)N)TarFile)get_data)BytesIO)tzfile)get_zonefile_instancegettzgettz_db_metadatazdateutil-zoneinfo.tar.gzMETADATAc@seZdZddZdS)rcCs t|jffSN)r _filenameselfr"s z)ZoneInfoFile.__init__..cs,i|]}|s |r|jj|jqSr)islnkissymr!zoneslinkname)r$zlr rrr''s zUTF-8)ropen getmembersr*updater# getmemberr"readdecodejsonloadsmetadataKeyError)r zonefile_streamlinks metadata_json metadata_strr)r r&r__init__s,     " zZoneInfoFile.__init__cCs|j||S)ak Wrapper for :func:`ZoneInfoFile.zones.get`. This is a convenience method for retrieving zones from the zone dictionary. :param name: The name of the zone to retrieve. (Generally IANA zone names) :param default: The value to return in the event of a missing key. .. versionadded:: 2.6.0 )r*get)r r!defaultrrrr<6szZoneInfoFile.getr )rrrr;r<rrrrrs rFcCs2|rd}nttdd}|durtt}|t_|S)a% This is a convenience function which provides a :class:`ZoneInfoFile` instance using the data provided by the ``dateutil`` package. By default, it caches a single instance of the ZoneInfoFile object and returns that. :param new_instance: If ``True``, a new instance of :class:`ZoneInfoFile` is instantiated and used as the cached instance for the next call. Otherwise, new instances are created only as necessary. :return: Returns a :class:`ZoneInfoFile` object. .. versionadded:: 2.6 N_cached_instance)getattrrrrr>) new_instancezifrrrrPs  rcCs8tdtttdkrttttdj |S)a+ This retrieves a time zone from the local zoneinfo tarball that is packaged with dateutil. :param name: An IANA-style time zone name, as found in the zoneinfo file. :return: Returns a :class:`dateutil.tz.tzfile` time zone object. .. warning:: It is generally inadvisable to use this function, and it is only provided for API compatibility with earlier versions. This is *not* equivalent to ``dateutil.tz.gettz()``, which selects an appropriate time zone based on the inputs, favoring system zoneinfo. This is ONLY for accessing the dateutil-specific zoneinfo (which may be out of date compared to the system zoneinfo). .. deprecated:: 2.6 If you need to use a specific zoneinfofile over the system zoneinfo, instantiate a :class:`dateutil.zoneinfo.ZoneInfoFile` object and call :func:`dateutil.zoneinfo.ZoneInfoFile.get(name)` instead. Use :func:`get_zonefile_instance` to retrieve an instance of the dateutil-provided zoneinfo. zzoneinfo.gettz() will be removed in future versions, to use the dateutil-provided zoneinfo files, instantiate a ZoneInfoFile object and use ZoneInfoFile.zones.get() instead. See the documentation for details.r) rrDeprecationWarninglen_CLASS_ZONE_INSTANCEappendrrr*r<)r!rrrrms  rcCs2tdtttdkrttttdjS)a! Get the zonefile metadata See `zonefile_metadata`_ :returns: A dictionary with the database metadata .. deprecated:: 2.6 See deprecation warning in :func:`zoneinfo.gettz`. To get metadata, query the attribute ``zoneinfo.ZoneInfoFile.metadata``. zzoneinfo.gettz_db_metadata() will be removed in future versions, to use the dateutil-provided zoneinfo files, ZoneInfoFile object and query the 'metadata' attribute instead. See the documentation for details.r) rrrBrCrDrErrr5rrrrrs    r)F)rr3tarfilerpkgutilrior dateutil.tzr_tzfile__all__rr"robjectrrDrrrrrrrs     /  &