Metadata-Version: 2.4
Name: delorean
Version: 2.0.0
Summary: library for manipulating datetimes with ease and clarity
Project-URL: Homepage, https://github.com/myusuf3/delorean
Author-email: Mahdi Yusuf <yusuf.mahdi@gmail.com>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: babel>=2.10.3
Requires-Dist: humanize>=4.2.2
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: tzlocal>=4.2
Description-Content-Type: text/x-rst



.. image:: http://delorean.readthedocs.org/en/latest/_static/delorean.png

Delorean: Time Travel Made Easy
===============================

`Delorean` is a library for clearing up the inconvenient truths that arise dealing with datetimes in Python. Understanding that timing is a delicate enough of a problem `delorean` hopes to provide a cleaner less troublesome solution to shifting, manipulating, and generating `datetimes`.

Delorean stands on the shoulders of giants: the standard library's `zoneinfo <https://docs.python.org/3/library/zoneinfo.html>`_ and `dateutil <https://dateutil.readthedocs.io/>`_

`Delorean` will provide natural language improvements for manipulating time, as well as datetime abstractions for ease of use. The overall goal is to improve datetime manipulations, with a little bit of software and philosophy.

Pretty much make you a badass time traveller.

Getting Started
^^^^^^^^^^^^^^^

Here is the world without a flux capacitor at your side:

.. code-block:: python

    from datetime import datetime, timezone
    from zoneinfo import ZoneInfo

    est = ZoneInfo('US/Eastern')
    d = datetime.now(timezone.utc)
    d = d.astimezone(est)
    return d

Now lets warm up the `delorean`:

.. code-block:: python

    from delorean import Delorean

    d = Delorean()
    d = d.shift('US/Eastern')
    return d

Look at you looking all fly. This was just a test drive: check out out what else
`delorean` can help with in the `documentation <http://delorean.readthedocs.org/en/latest/>`_.
