python-dateutil 2.9.0__py2.py3-none-any.whl → 3.0.0__py2.py3-none-any.whl

dateutil/zoneinfo/__init__.py

@@ -1,55 +1,124 @@
 # -*- coding: utf-8 -*-
-import warnings
-import json
+"""
+The ``dateutil.zoneinfo`` module was originally designed to work with a tarball
+shipped with ``dateutil``. Since ``dateutil`` now uses data from the same
+sources as :py:mod:`zoneinfo`, this module is no longer necessary.
+
+.. caution::
+    This module is deprecated, and its functionality has been dramatically
+    curtailed. It is recommended that you adopt the standard library module
+    :py:mod:`zoneinfo` or :func:`dateutil.tz.gettz` instead.
+
+"""
 
+import json
+import sys
+import warnings
 from tarfile import TarFile
-from pkgutil import get_data
-from io import BytesIO
 
+import six
+
+from dateutil import _tzdata_impl
 from dateutil.tz import tzfile as _tzfile
 
 __all__ = ["get_zonefile_instance", "gettz", "gettz_db_metadata"]
 
-ZONEFILENAME = "dateutil-zoneinfo.tar.gz"
+ZONEFILENAME = None
 METADATA_FN = 'METADATA'
 
 
-class tzfile(_tzfile):
-    def __reduce__(self):
-        return (gettz, (self._filename,))
+def _importer_stacklevel():
+    """The ``stacklevel`` that attributes a warning to the importing code.
 
+    This module can be imported through ``dateutil.__getattr__`` (e.g. by
+    ``from dateutil import zoneinfo``), which calls
+    ``importlib.import_module``; the warnings machinery skips the import
+    system's own frames, but not those two, so skip them here.
+    """
+    level = 1
+    frame = sys._getframe(1)  # The body of this module
+    while frame.f_back is not None:
+        frame = frame.f_back
+        filename = frame.f_code.co_filename
+        if "importlib" in filename and "_bootstrap" in filename:
+            # Since Python 3.5, the warnings machinery skips these frames
+            # without counting them; before that they count like any other.
+            if sys.version_info < (3, 5):
+                level += 1
+            continue
+
+        level += 1
+        if frame.f_globals.get("__name__") not in ("importlib", "dateutil"):
+            return level
+
+    return 2
 
-def getzoneinfofile_stream():
-    try:
-        return BytesIO(get_data(__name__, ZONEFILENAME))
-    except IOError as e:  # TODO  switch to FileNotFoundError?
-        warnings.warn("I/O error({0}): {1}".format(e.errno, e.strerror))
-        return None
 
+warnings.warn(
+    "The `dateutil.zoneinfo` module has been replaced with a wrapper around "
+    "the tzdata package, and its use is deprecated, to be removed in a future "
+    "version. Use the standard library module `zoneinfo` or `dateutil.tz` "
+    "instead.",
+    DeprecationWarning,
+    stacklevel=_importer_stacklevel(),
+)
+
+
+tzfile = _tzfile
 
 class ZoneInfoFile(object):
     def __init__(self, zonefile_stream=None):
         if zonefile_stream is not None:
-            with TarFile.open(fileobj=zonefile_stream) as tf:
-                self.zones = {zf.name: tzfile(tf.extractfile(zf), filename=zf.name)
-                              for zf in tf.getmembers()
-                              if zf.isfile() and zf.name != METADATA_FN}
-                # deal with links: They'll point to their parent object. Less
-                # waste of memory
-                links = {zl.name: self.zones[zl.linkname]
-                         for zl in tf.getmembers() if
-                         zl.islnk() or zl.issym()}
-                self.zones.update(links)
-                try:
-                    metadata_json = tf.extractfile(tf.getmember(METADATA_FN))
-                    metadata_str = metadata_json.read().decode('UTF-8')
-                    self.metadata = json.loads(metadata_str)
-                except KeyError:
-                    # no metadata in tar file
-                    self.metadata = None
+            self._load_legacy_zonefile_stream(zonefile_stream)
         else:
-            self.zones = {}
-            self.metadata = None
+            self._eager_load_tzdata()
+
+    def _eager_load_tzdata(self):
+        try:
+            import tzdata
+        except ImportError as e:
+            six.raise_from(
+                ImportError(
+                    "The tzdata module is required to use ZoneInfoFile; either add "
+                    "a dependency on tzdata or migrate away from dateutil.zoneinfo."
+                ),
+                e,
+            )
+
+        zone_dict = {}
+
+        for key in _tzdata_impl._load_tzdata_keys():
+            with _tzdata_impl._load_tzdata(key) as f:
+                zone_dict[key] = tzfile(f, key=key)
+
+        self.zones = zone_dict
+        self.metadata = {
+            "metadata_version": "3.0",
+            "tzversion": tzdata.IANA_VERSION,
+        }
+
+    def _load_legacy_zonefile_stream(self, zonefile_stream):
+        with TarFile.open(fileobj=zonefile_stream) as tf:
+            self.zones = {
+                zf.name: tzfile(tf.extractfile(zf), filename=zf.name)
+                for zf in tf.getmembers()
+                if zf.isfile() and zf.name != METADATA_FN
+            }
+            # deal with links: They'll point to their parent object. Less
+            # waste of memory
+            links = {
+                zl.name: self.zones[zl.linkname]
+                for zl in tf.getmembers()
+                if zl.islnk() or zl.issym()
+            }
+            self.zones.update(links)
+            try:
+                metadata_json = tf.extractfile(tf.getmember(METADATA_FN))
+                metadata_str = metadata_json.read().decode("UTF-8")
+                self.metadata = json.loads(metadata_str)
+            except KeyError:
+                # no metadata in tar file
+                self.metadata = None
 
     def get(self, name, default=None):
         """
@@ -99,7 +168,7 @@ def get_zonefile_instance(new_instance=False):
         zif = getattr(get_zonefile_instance, '_cached_instance', None)
 
     if zif is None:
-        zif = ZoneInfoFile(getzoneinfofile_stream())
+        zif = ZoneInfoFile()
 
         get_zonefile_instance._cached_instance = zif
 
@@ -108,8 +177,7 @@ def get_zonefile_instance(new_instance=False):
 
 def gettz(name):
     """
-    This retrieves a time zone from the local zoneinfo tarball that is packaged
-    with dateutil.
+    This retrieves a time zone from the ``tzdata`` package.
 
     :param name:
         An IANA-style time zone name, as found in the zoneinfo file.
@@ -140,14 +208,12 @@ def gettz(name):
                   DeprecationWarning)
 
     if len(_CLASS_ZONE_INSTANCE) == 0:
-        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream()))
+        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile())
     return _CLASS_ZONE_INSTANCE[0].zones.get(name)
 
 
 def gettz_db_metadata():
-    """ Get the zonefile metadata
-
-    See `zonefile_metadata`_
+    """Get the zonefile metadata
 
     :returns:
         A dictionary with the database metadata
@@ -163,5 +229,5 @@ def gettz_db_metadata():
                   DeprecationWarning)
 
     if len(_CLASS_ZONE_INSTANCE) == 0:
-        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream()))
+        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile())
     return _CLASS_ZONE_INSTANCE[0].metadata

dateutil/zoneinfo/rebuild.py

@@ -1,75 +1,42 @@
-import logging
-import os
-import tempfile
-import shutil
-import json
-from subprocess import check_call, check_output
-from tarfile import TarFile
+import warnings
 
-from dateutil.zoneinfo import METADATA_FN, ZONEFILENAME
+__all__ = ["rebuild", "RebuildDeprecationWarning"]
 
 
-def rebuild(filename, tag=None, format="gz", zonegroups=[], metadata=None):
-    """Rebuild the internal timezone info in dateutil/zoneinfo/zoneinfo*tar*
+class RebuildDeprecationWarning(FutureWarning):
+    """Warning raised by :func:`rebuild`, which no longer does anything.
 
-    filename is the timezone tarball from ``ftp.iana.org/tz``.
+    A warnings filter turns this into an error by default. To keep calling
+    :func:`rebuild` as a no-op, filter it out, e.g.::
 
+        warnings.filterwarnings(
+            "ignore", category=dateutil.zoneinfo.rebuild.RebuildDeprecationWarning
+        )
     """
-    tmpdir = tempfile.mkdtemp()
-    zonedir = os.path.join(tmpdir, "zoneinfo")
-    moduledir = os.path.dirname(__file__)
-    try:
-        with TarFile.open(filename) as tf:
-            for name in zonegroups:
-                tf.extract(name, tmpdir)
-            filepaths = [os.path.join(tmpdir, n) for n in zonegroups]
-
-            _run_zic(zonedir, filepaths)
-
-        # write metadata file
-        with open(os.path.join(zonedir, METADATA_FN), 'w') as f:
-            json.dump(metadata, f, indent=4, sort_keys=True)
-        target = os.path.join(moduledir, ZONEFILENAME)
-        with TarFile.open(target, "w:%s" % format) as tf:
-            for entry in os.listdir(zonedir):
-                entrypath = os.path.join(zonedir, entry)
-                tf.add(entrypath, entry)
-    finally:
-        shutil.rmtree(tmpdir)
 
 
-def _run_zic(zonedir, filepaths):
-    """Calls the ``zic`` compiler in a compatible way to get a "fat" binary.
-
-    Recent versions of ``zic`` default to ``-b slim``, while older versions
-    don't even have the ``-b`` option (but default to "fat" binaries). The
-    current version of dateutil does not support Version 2+ TZif files, which
-    causes problems when used in conjunction with "slim" binaries, so this
-    function is used to ensure that we always get a "fat" binary.
-    """
-
-    try:
-        help_text = check_output(["zic", "--help"])
-    except OSError as e:
-        _print_on_nosuchfile(e)
-        raise
-
-    if b"-b " in help_text:
-        bloat_args = ["-b", "fat"]
-    else:
-        bloat_args = []
-
-    check_call(["zic"] + bloat_args + ["-d", zonedir] + filepaths)
-
-
-def _print_on_nosuchfile(e):
-    """Print helpful troubleshooting message
+def rebuild(filename, tag=None, format="gz", zonegroups=[], metadata=None):
+    """Formerly rebuilt the zoneinfo tarball bundled with ``dateutil``.
 
-    e is an exception raised by subprocess.check_call()
+    ``dateutil`` no longer ships a zoneinfo tarball; it reads time zone data
+    from the system and from the `tzdata <https://pypi.org/project/tzdata/>`_
+    package instead. This function now does nothing except raise
+    :class:`RebuildDeprecationWarning`, which is an error unless a warnings
+    filter says otherwise.
 
+    .. deprecated:: 3.0.0
     """
-    if e.errno == 2:
-        logging.error(
-            "Could not find zic. Perhaps you need to install "
-            "libc-bin or some other package that provides it, "
-            "or it's not in your PATH?")
+    # The filter is added at call time rather than at import time, so that it
+    # is still in place if the module was first imported inside a
+    # warnings.catch_warnings() block. It is appended, so any filter the user
+    # has installed for this category takes precedence.
+    warnings.filterwarnings(
+        "error", category=RebuildDeprecationWarning, append=True
+    )
+    warnings.warn(
+        "dateutil.zoneinfo.rebuild() no longer does anything, because dateutil "
+        "no longer ships a zoneinfo tarball. Use the tzdata package or the "
+        "system time zone data instead.",
+        RebuildDeprecationWarning,
+        stacklevel=2,
+    )

{python_dateutil-2.9.0.dist-info → python_dateutil-3.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-dateutil
-Version: 2.9.0
+Version: 3.0.0
 Summary: Extensions to the standard Python datetime module
 Home-page: https://github.com/dateutil/dateutil
 Author: Gustavo Niemeyer
@@ -28,11 +28,20 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.7
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: six >=1.5
+Requires-Dist: six>=1.6
+Requires-Dist: tzdata
+Dynamic: description
+Dynamic: license-file
 
 dateutil - powerful extensions to datetime
 ==========================================
@@ -41,7 +50,7 @@ dateutil - powerful extensions to datetime
 
 |gitter| |readthedocs|
 
-|travis| |appveyor| |pipelines| |coverage|
+|appveyor| |gha| |coverage|
 
 .. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square
     :target: https://pypi.org/project/python-dateutil/
@@ -51,17 +60,13 @@ dateutil - powerful extensions to datetime
     :target: https://pypi.org/project/python-dateutil/
     :alt: supported Python version
 
-.. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build
-    :target: https://travis-ci.org/dateutil/dateutil
-    :alt: travis build status
-
 .. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor
     :target: https://ci.appveyor.com/project/dateutil/dateutil
     :alt: appveyor build status
 
-.. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master
-    :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master
-    :alt: azure pipelines build status
+.. |gha| image:: https://github.com/dateutil/dateutil/actions/workflows/validate.yml/badge.svg
+    :target: https://github.com/dateutil/dateutil/actions
+    :alt: github actions build status
 
 .. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master
     :target: https://codecov.io/gh/dateutil/dateutil?branch=master
@@ -189,11 +194,6 @@ Releases     Signing key fingerprint
 New releases *may* have signed tags, but binary and source distributions
 uploaded to PyPI will no longer have GPG signatures attached.
 
-Contact
-=======
-Our mailing list is available at `dateutil@python.org <https://mail.python.org/mailman/listinfo/dateutil>`_. As it is hosted by the PSF, it is subject to the `PSF code of
-conduct <https://www.python.org/psf/conduct/>`_.
-
 License
 =======
 

python_dateutil-3.0.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+dateutil/__init__.py,sha256=Rlncv13heMaerX26_chS__gaCqk8o0BPH5zljim_Z_M,650
+dateutil/_common.py,sha256=77w0yytkrxlYbSn--lDVPUMabUXRR9I3lBv_vQRUqUY,932
+dateutil/_tzdata_impl.py,sha256=F4Cj7D4gowRHi6D0649YUtlnB-1ynzOOmVEUCozGw6c,4835
+dateutil/_version.py,sha256=-Oe07VK7JZRuZhf_WAyReYEKe8tlyWlu6k6HEynNyfY,160
+dateutil/easter.py,sha256=dyBi-lKvimH1u_k6p7Z0JJK72QhqVtVBsqByvpEPKvc,2678
+dateutil/relativedelta.py,sha256=NB5lZwcsKtft2nj7Bfaevh7iU8IDFYku_uQg8dCNiOs,24835
+dateutil/rrule.py,sha256=2T1idORGtozykXoZlCr4GFlTkpGEDwSD_FKghaDlfjY,67585
+dateutil/tzwin.py,sha256=7Ar4vdQCnnM0mKR3MUjbIKsZrBVfHgdwsJZc_mGYRew,59
+dateutil/utils.py,sha256=dKCchEw8eObi0loGTx91unBxm_7UGlU3v_FjFMdqwYM,1965
+dateutil/parser/__init__.py,sha256=wWk6GFuxTpjoggCGtgkceJoti4pVjl4_fHQXpNOaSYg,1766
+dateutil/parser/_parser.py,sha256=7klDdyicksQB_Xgl-3UAmBwzCYor1AIZqklIcT6dH_8,58796
+dateutil/parser/isoparser.py,sha256=8Fy999bnCd1frSdOYuOraWfJTtd5W7qQ51NwNuH_hXM,13233
+dateutil/tz/__init__.py,sha256=TtmK228efAGvqU9D2f3MFPPWjdjCS2W5afUoC6WlLb4,1350
+dateutil/tz/_common.py,sha256=cgzDTANsOXvEc86cYF77EsliuSab8Puwpsl5-bX3_S4,12977
+dateutil/tz/_factories.py,sha256=unb6XQNXrPMveksTCU-Ag8jmVZs4SojoPUcAHpWnrvU,2569
+dateutil/tz/_tzfile.py,sha256=Qh5WxE8qDy-P2BQ1grI_qNn2nrazjn54cEZBvuPd0Lg,49242
+dateutil/tz/_tzpath.py,sha256=b83zAaiflC200NjHWa7RRQt6idBnlp5nEQngvol1f90,3288
+dateutil/tz/tz.py,sha256=5AeTP7njYdzWP9nLBFpXUWatk9GDZPk6YIlzkAoRdHY,50272
+dateutil/tz/win.py,sha256=xJszWgSwE1xPx_HJj4ZkepyukC_hNy016WMcXhbRaB8,12935
+dateutil/zoneinfo/__init__.py,sha256=k1tAG2ct92qpNQ7hcHVFkOYz572l_cmVgOpqJFvV434,7972
+dateutil/zoneinfo/rebuild.py,sha256=iCA6CfiNLy_A_zgR0xlb88XTner38nd8CpLmDtq6YCw,1625
+python_dateutil-3.0.0.dist-info/licenses/LICENSE,sha256=ugD1Gg2SgjtaHN4n2LW50jIeZ-2NqbwWPv-W1eF-V34,2889
+python_dateutil-3.0.0.dist-info/METADATA,sha256=4Q6tk1mK7VG9soqjDvZO5dbMyHHoh0HSIOUE6XmvRpU,8237
+python_dateutil-3.0.0.dist-info/WHEEL,sha256=Uvlg2aNlEKdilsyFSJt1QX5me0eEbCjQzR3nZeFkvy4,109
+python_dateutil-3.0.0.dist-info/top_level.txt,sha256=4tjdWkhRZvF7LA_BYe_L9gB2w_p2a-z5y6ArjaRkot8,9
+python_dateutil-3.0.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+python_dateutil-3.0.0.dist-info/RECORD,,

{python_dateutil-2.9.0.dist-info → python_dateutil-3.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py2-none-any
 Tag: py3-none-any

python_dateutil-2.9.0.dist-info/RECORD

@@ -1,25 +0,0 @@
-dateutil/__init__.py,sha256=Mqam67WO9IkTmUFyI66vS6IoSXTp9G388DadH2LCMLY,620
-dateutil/_common.py,sha256=77w0yytkrxlYbSn--lDVPUMabUXRR9I3lBv_vQRUqUY,932
-dateutil/_version.py,sha256=Vb5T-8FcBzgHCb1RYqez20zYqm5tplcF41kZi7B8cik,411
-dateutil/easter.py,sha256=dyBi-lKvimH1u_k6p7Z0JJK72QhqVtVBsqByvpEPKvc,2678
-dateutil/relativedelta.py,sha256=IY_mglMjoZbYfrvloTY2ce02aiVjPIkiZfqgNTZRfuA,24903
-dateutil/rrule.py,sha256=KJzKlaCd1jEbu4A38ZltslaoAUh9nSbdbOFdjp70Kew,66557
-dateutil/tzwin.py,sha256=7Ar4vdQCnnM0mKR3MUjbIKsZrBVfHgdwsJZc_mGYRew,59
-dateutil/utils.py,sha256=dKCchEw8eObi0loGTx91unBxm_7UGlU3v_FjFMdqwYM,1965
-dateutil/parser/__init__.py,sha256=wWk6GFuxTpjoggCGtgkceJoti4pVjl4_fHQXpNOaSYg,1766
-dateutil/parser/_parser.py,sha256=7klDdyicksQB_Xgl-3UAmBwzCYor1AIZqklIcT6dH_8,58796
-dateutil/parser/isoparser.py,sha256=8Fy999bnCd1frSdOYuOraWfJTtd5W7qQ51NwNuH_hXM,13233
-dateutil/tz/__init__.py,sha256=F-Mz13v6jYseklQf9Te9J6nzcLDmq47gORa61K35_FA,444
-dateutil/tz/_common.py,sha256=cgzDTANsOXvEc86cYF77EsliuSab8Puwpsl5-bX3_S4,12977
-dateutil/tz/_factories.py,sha256=unb6XQNXrPMveksTCU-Ag8jmVZs4SojoPUcAHpWnrvU,2569
-dateutil/tz/tz.py,sha256=EUnEdMfeThXiY6l4sh9yBabZ63_POzy01zSsh9thn1o,62855
-dateutil/tz/win.py,sha256=xJszWgSwE1xPx_HJj4ZkepyukC_hNy016WMcXhbRaB8,12935
-dateutil/zoneinfo/__init__.py,sha256=KYg0pthCMjcp5MXSEiBJn3nMjZeNZav7rlJw5-tz1S4,5889
-dateutil/zoneinfo/dateutil-zoneinfo.tar.gz,sha256=Y25Djz4f3ZwC5TcTaM4UJMhWRNZSciMe0zOF9XsDv4I,156385
-dateutil/zoneinfo/rebuild.py,sha256=MiqYzCIHvNbMH-LdRYLv-4T0EIA7hDKt5GLR0IRTLdI,2392
-python_dateutil-2.9.0.dist-info/LICENSE,sha256=ugD1Gg2SgjtaHN4n2LW50jIeZ-2NqbwWPv-W1eF-V34,2889
-python_dateutil-2.9.0.dist-info/METADATA,sha256=K-Gq16MVMeVLv55QoQuFM3r-Ofdvp5ACKJZ3t4wr4oU,8348
-python_dateutil-2.9.0.dist-info/WHEEL,sha256=-G_t0oGuE7UD0DrSpVZnq1hHMBV9DD2XkS5v7XpmTnk,110
-python_dateutil-2.9.0.dist-info/top_level.txt,sha256=4tjdWkhRZvF7LA_BYe_L9gB2w_p2a-z5y6ArjaRkot8,9
-python_dateutil-2.9.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-python_dateutil-2.9.0.dist-info/RECORD,,