codekingpro/portable-devtools

1Metadata-Version: 2.12Name: python-dateutil3Version: 2.9.0.post04Summary: Extensions to the standard Python datetime module5Home-page: https://github.com/dateutil/dateutil6Author: Gustavo Niemeyer7Author-email: gustavo@niemeyer.net8Maintainer: Paul Ganssle9Maintainer-email: dateutil@python.org10License: Dual License11Project-URL: Documentation, https://dateutil.readthedocs.io/en/stable/12Project-URL: Source, https://github.com/dateutil/dateutil13Classifier: Development Status :: 5 - Production/Stable14Classifier: Intended Audience :: Developers15Classifier: License :: OSI Approved :: BSD License16Classifier: License :: OSI Approved :: Apache Software License17Classifier: Programming Language :: Python18Classifier: Programming Language :: Python :: 219Classifier: Programming Language :: Python :: 2.720Classifier: Programming Language :: Python :: 321Classifier: Programming Language :: Python :: 3.322Classifier: Programming Language :: Python :: 3.423Classifier: Programming Language :: Python :: 3.524Classifier: Programming Language :: Python :: 3.625Classifier: Programming Language :: Python :: 3.726Classifier: Programming Language :: Python :: 3.827Classifier: Programming Language :: Python :: 3.928Classifier: Programming Language :: Python :: 3.1029Classifier: Programming Language :: Python :: 3.1130Classifier: Programming Language :: Python :: 3.1231Classifier: Topic :: Software Development :: Libraries32Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.733Description-Content-Type: text/x-rst34License-File: LICENSE35Requires-Dist: six >=1.536 37dateutil - powerful extensions to datetime38==========================================39 40|pypi| |support| |licence|41 42|gitter| |readthedocs|43 44|travis| |appveyor| |pipelines| |coverage|45 46.. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square47    :target: https://pypi.org/project/python-dateutil/48    :alt: pypi version49 50.. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square51    :target: https://pypi.org/project/python-dateutil/52    :alt: supported Python version53 54.. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build55    :target: https://travis-ci.org/dateutil/dateutil56    :alt: travis build status57 58.. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor59    :target: https://ci.appveyor.com/project/dateutil/dateutil60    :alt: appveyor build status61 62.. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master63    :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master64    :alt: azure pipelines build status65 66.. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master67    :target: https://codecov.io/gh/dateutil/dateutil?branch=master68    :alt: Code coverage69 70.. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg71   :alt: Join the chat at https://gitter.im/dateutil/dateutil72   :target: https://gitter.im/dateutil/dateutil73 74.. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square75    :target: https://pypi.org/project/python-dateutil/76    :alt: licence77 78.. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs79   :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/80   :target: https://dateutil.readthedocs.io/en/latest/81 82The `dateutil` module provides powerful extensions to83the standard `datetime` module, available in Python.84 85Installation86============87`dateutil` can be installed from PyPI using `pip` (note that the package name is88different from the importable name)::89 90    pip install python-dateutil91 92Download93========94dateutil is available on PyPI95https://pypi.org/project/python-dateutil/96 97The documentation is hosted at:98https://dateutil.readthedocs.io/en/stable/99 100Code101====102The code and issue tracker are hosted on GitHub:103https://github.com/dateutil/dateutil/104 105Features106========107 108* Computing of relative deltas (next month, next year,109  next Monday, last week of month, etc);110* Computing of relative deltas between two given111  date and/or datetime objects;112* Computing of dates based on very flexible recurrence rules,113  using a superset of the `iCalendar <https://www.ietf.org/rfc/rfc2445.txt>`_114  specification. Parsing of RFC strings is supported as well.115* Generic parsing of dates in almost any string format;116* Timezone (tzinfo) implementations for tzfile(5) format117  files (/etc/localtime, /usr/share/zoneinfo, etc), TZ118  environment string (in all known formats), iCalendar119  format files, given ranges (with help from relative deltas),120  local machine timezone, fixed offset timezone, UTC timezone,121  and Windows registry-based time zones.122* Internal up-to-date world timezone information based on123  Olson's database.124* Computing of Easter Sunday dates for any given year,125  using Western, Orthodox or Julian algorithms;126* A comprehensive test suite.127 128Quick example129=============130Here's a snapshot, just to give an idea about the power of the131package. For more examples, look at the documentation.132 133Suppose you want to know how much time is left, in134years/months/days/etc, before the next easter happening on a135year with a Friday 13th in August, and you want to get today's136date out of the "date" unix system command. Here is the code:137 138.. code-block:: python3139 140    >>> from dateutil.relativedelta import *141    >>> from dateutil.easter import *142    >>> from dateutil.rrule import *143    >>> from dateutil.parser import *144    >>> from datetime import *145    >>> now = parse("Sat Oct 11 17:13:46 UTC 2003")146    >>> today = now.date()147    >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year148    >>> rdelta = relativedelta(easter(year), today)149    >>> print("Today is: %s" % today)150    Today is: 2003-10-11151    >>> print("Year with next Aug 13th on a Friday is: %s" % year)152    Year with next Aug 13th on a Friday is: 2004153    >>> print("How far is the Easter of that year: %s" % rdelta)154    How far is the Easter of that year: relativedelta(months=+6)155    >>> print("And the Easter of that year is: %s" % (today+rdelta))156    And the Easter of that year is: 2004-04-11157 158Being exactly 6 months ahead was **really** a coincidence :)159 160Contributing161============162 163We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes). For more information about how to contribute to the project, see the ``CONTRIBUTING.md`` file in the repository.164 165 166Author167======168The dateutil module was written by Gustavo Niemeyer <gustavo@niemeyer.net>169in 2003.170 171It is maintained by:172 173* Gustavo Niemeyer <gustavo@niemeyer.net> 2003-2011174* Tomi Pieviläinen <tomi.pievilainen@iki.fi> 2012-2014175* Yaron de Leeuw <me@jarondl.net> 2014-2016176* Paul Ganssle <paul@ganssle.io> 2015-177 178Starting with version 2.4.1 and running until 2.8.2, all source and binary179distributions will be signed by a PGP key that has, at the very least, been180signed by the key which made the previous release. A table of release signing181keys can be found below:182 183===========  ============================184Releases     Signing key fingerprint185===========  ============================1862.4.1-2.8.2  `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_187===========  ============================188 189New releases *may* have signed tags, but binary and source distributions190uploaded to PyPI will no longer have GPG signatures attached.191 192Contact193=======194Our 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 of195conduct <https://www.python.org/psf/conduct/>`_.196 197License198=======199 200All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License <https://www.apache.org/licenses/LICENSE-2.0>`_ or the `BSD 3-Clause License <https://opensource.org/licenses/BSD-3-Clause>`_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License.201 202 203.. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB:204   https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB205