v0.1.5

.travis.yml

@@ -1,9 +1,8 @@
 language: python
 python:
   - "2.7"
-  - "3.6"
-
+  # - "3.5" # looks like ruamel.ordereddict doesn't build for python3
 # command to install dependencies
-install: pip install pipenv; pipenv install --dev
+install: "pip install -r requirements.txt"
 # command to run tests
-script: pipenv run pytest
+script: make

AUTHORS.rst

@@ -1,14 +1,12 @@
-Contributions to the maya project
-=================================
 
-Creator & Maintainer
---------------------
+# Contributions to the maya project
+
+## Creator & Maintainer
 
 - Kenneth Reitz <me@kennethreitz.org> `@kennethreitz <https://github.com/kennethreitz>`_
 
 
-Contributors
-------------
+## Contributors
 
 In chronological order:
 
@@ -19,5 +17,3 @@ In chronological order:
 - Tzu-ping Chung <uranusjr@gmail.com> (`@uranusjr <https://github.com/uranusjr>`_)
 - aaronjeline (`@aaronjeline <https://github.com/aaronjeline>`_)
 - jerry2yu (`@jerry2yu <https://github.com/jerry2yu>`_)
-- Joshua Li <joshua.r.li.98@gmail.com> (`@JoshuaRLi <https://github.com/JoshuaRLi>`_)
-- Sébastien Eustace <sebastien@eustace.io> (`@sdispater <https://github.com/sdispater>`_)

Pipfile

@@ -1,10 +0,0 @@
-[packages]
-humanize = "*"
-pytz = "*"
-dateparser = "*"
-"ruamel.yaml" = "*"
-tzlocal = "*"
-pendulum = ">=1.0"
-
-[dev-packages]
-pytest = "*"

Pipfile.lock

@@ -1,102 +0,0 @@
-{
-    "_meta": {
-        "sources": [
-            {
-                "url": "https://pypi.python.org/simple",
-                "verify_ssl": true
-            }
-        ],
-        "requires": {},
-        "hash": {
-            "sha256": "5617ff73ba51e60721267b24dc01e83f33d2a3692870b60e394b0f75ed2dc313"
-        }
-    },
-    "default": {
-        "convertdate": {
-            "hash": "sha256:9c5d8dc984e51789ffaa92e988939ba8734c56ed718a3943998e7832fffa66ed",
-            "version": "==2.1.0"
-        },
-        "dateparser": {
-            "hash": "sha256:bbdb38e35dcf42653bbc88dc8870d0ef7eb5679af64b4f2ffc43d43acd3b24ba",
-            "version": "==0.5.1"
-        },
-        "ephem": {
-            "hash": "sha256:7a4c82b1def2893e02aec0394f108d24adb17bd7b0ca6f4bc78eb7120c0212ac",
-            "version": "==3.7.6.0"
-        },
-        "humanize": {
-            "hash": "sha256:a43f57115831ac7c70de098e6ac46ac13be00d69abbf60bdcac251344785bb19",
-            "version": "==0.5.1"
-        },
-        "jdatetime": {
-            "hash": "sha256:b6bb0bbd822eb0d3f9a55c4e8bfda0ccace3dcfa6d16bdcb29c124ad2ce66335",
-            "version": "==1.8.1"
-        },
-        "pendulum": {
-            "hash": "sha256:2417888ceddbb9c3903317ad321e27b2217aacf4ddcc1993ac3ad4db96f3a701",
-            "version": "==1.0.2"
-        },
-        "python-dateutil": {
-            "hash": "sha256:537bf2a8f8ce6f6862ad705cd68f9e405c0b5db014aa40fa29eab4335d4b1716",
-            "version": "==2.6.0"
-        },
-        "pytz": {
-            "hash": "sha256:a1ea35e87a63c7825846d5b5c81d23d668e8a102d3b1b465ce95afe1b3a2e065",
-            "version": "==2016.10"
-        },
-        "pytzdata": {
-            "hash": "sha256:cf28a9bbb4e7f94ae21f4a3c64439aa44f81d5814fe9989e9ab7374658b6e596",
-            "version": "==2016.10"
-        },
-        "regex": {
-            "hash": "sha256:45b62acff46cb886246e40227a872089d8d4972dbf2f114ec1ae64e5893e87bf",
-            "version": "==2017.02.08"
-        },
-        "ruamel.yaml": {
-            "hash": "sha256:7cfd653648a1d4a635ce7ae254b4dc6ec7df931a5a653c79e627547be5dda71b",
-            "version": "==0.13.13"
-        },
-        "six": {
-            "hash": "sha256:0ff78c403d9bccf5a425a6d31a12aa6b47f1c21ca4dc2573a7e2f32a97335eb1",
-            "version": "==1.10.0"
-        },
-        "tzlocal": {
-            "hash": "sha256:d160c2ce4f8b1831dabfe766bd844cf9012f766539cf84139c2faac5201882ce",
-            "version": "==1.3"
-        },
-        "umalqurra": {
-            "hash": "sha256:719f6a36f908ada1c29dae0d934dd0f1e1f6e3305784edbec23ad719397de678",
-            "version": "==0.2"
-        }
-    },
-    "develop": {
-        "appdirs": {
-            "hash": "sha256:85e58578db8f29538f3109c11250c2a5514a2fcdc9890d9b2fe777eb55517736",
-            "version": "==1.4.0"
-        },
-        "packaging": {
-            "hash": "sha256:99276dc6e3a7851f32027a68f1095cd3f77c148091b092ea867a351811cfe388",
-            "version": "==16.8"
-        },
-        "py": {
-            "hash": "sha256:2d4bba2e25fff58140e6bdce1e485e89bb59776adbe01d490baa6b1f37a3dd6b",
-            "version": "==1.4.32"
-        },
-        "pyparsing": {
-            "hash": "sha256:67101d7acee692962f33dd30b5dce079ff532dd9aa99ff48d52a3dad51d2fe84",
-            "version": "==2.1.10"
-        },
-        "pytest": {
-            "hash": "sha256:da0ab50c7eec0683bc24f1c1137db1f4111752054ecdad63125e7ec71316b813",
-            "version": "==3.0.6"
-        },
-        "setuptools": {
-            "hash": "sha256:5f74aabe68c441b99dca68c22796d5cbf532cb38b0aeada17d1d3988809de6e6",
-            "version": "==34.1.1"
-        },
-        "six": {
-            "hash": "sha256:0ff78c403d9bccf5a425a6d31a12aa6b47f1c21ca4dc2573a7e2f32a97335eb1",
-            "version": "==1.10.0"
-        }
-    }
-}

README.rst

@@ -1,5 +1,5 @@
-Maya: Timestamps for Humans™
-============================
+Maya: Datetime for Humans™
+==========================
 
 .. image:: https://img.shields.io/pypi/v/maya.svg
     :target: https://pypi.python.org/pypi/maya
@@ -7,7 +7,7 @@ Maya: Timestamps for Humans™
 .. image:: https://travis-ci.org/kennethreitz/maya.svg?branch=master
     :target: https://travis-ci.org/kennethreitz/maya
 
-.. image:: https://img.shields.io/badge/SayThanks-!-1EAEDB.svg
+.. image:: https://img.shields.io/badge/SayThanks.io-☼-1EAEDB.svg
     :target: https://saythanks.io/to/kennethreitz
 
 
@@ -40,17 +40,11 @@ Behold, datetimes for humans!
     >>> tomorrow.slang_time()
     '23 hours from now'
 
-    # Also: MayaDT.from_iso8601(...)
     >>> tomorrow.iso8601()
-    '2017-02-10T22:17:01.445418Z'
+    '2016-12-16T15:11:30.263350Z'
 
-    # Also: MayaDT.from_rfc2822(...)
     >>> tomorrow.rfc2822()
-    'Fri, 10 Feb 2017 22:17:01 GMT'
-
-    # Also: MayaDT.from_rfc3339(...)
-    >>> tomorrow.rfc3339()
-    '2017-02-10T22:17:01.44Z'
+    'Fri, 16 Dec 2016 20:11:30 -0000'
 
     >>> tomorrow.datetime()
     datetime.datetime(2016, 12, 16, 15, 11, 30, 263350, tzinfo=<UTC>)
@@ -63,20 +57,14 @@ Behold, datetimes for humans!
     >>> rand_day = maya.when('2011-02-07', timezone='US/Eastern')
     <MayaDT epoch=1297036800.0>
 
+    # Note how this is the 6th, not the 7th.
     >>> rand_day.day
-    7
-
-    >>> rand_day.add(days=10).day
-    17
+    6
 
     # Always.
     >>> rand_day.timezone
     UTC
 
-    # Range of hours in a day:
-    >>> maya.interval(start=maya.now(), end=maya.now().add(days=1), interval=60*60)
-    <generator object intervals at 0x105ba5820>
-
 ☤ Why is this useful?
 ---------------------
 

maya.py

@@ -11,37 +11,31 @@ warnings.simplefilter('ignore', ruamel.yaml.error.UnsafeLoaderWarning)
 
 import email.utils
 import time
-from datetime import timedelta, datetime as Datetime
+from datetime import datetime as Datetime
 
 import pytz
 import humanize
 import dateparser
-import pendulum
+import iso8601
+import dateutil.parser
 from tzlocal import get_localzone
 
 _EPOCH_START = (1970, 1, 1)
 
 
-def validate_class_type_arguments(operator):
+def validate_type_mayadt(func):
     """
     Decorator to validate all the arguments to function
-    are of the type of calling class
+    are of type `MayaDT`
     """
-
-    def inner(function):
-        def wrapper(self, *args, **kwargs):
-            for arg in args + tuple(kwargs.values()):
-                if not isinstance(arg, self.__class__):
-                    raise TypeError('unorderable types: {}() {} {}()'.format(
-                        type(self).__name__, operator, type(arg).__name__))
-            return function(self, *args, **kwargs)
-
-        return wrapper
-
+    def inner(*args, **kwargs):
+        for arg in args + tuple(kwargs.values()):
+            if not isinstance(arg, MayaDT):
+                raise ValueError("Operation allowed only on object of type '{}'".format(MayaDT.__name__))
+        return func(*args, **kwargs)
     return inner
 
 
-
 class MayaDT(object):
     """The Maya Datetime object."""
 
@@ -52,45 +46,38 @@ class MayaDT(object):
     def __repr__(self):
         return '<MayaDT epoch={}>'.format(self._epoch)
 
-    def __str__(self):
-        return self.rfc2822()
-
     def __format__(self, *args, **kwargs):
         """Return's the datetime's format"""
         return format(self.datetime(), *args, **kwargs)
 
+    @validate_type_mayadt
+    def __sub__(self, maya_dt):
+        return MayaDT(self._epoch - maya_dt._epoch)
 
-    @validate_class_type_arguments('==')
+    @validate_type_mayadt
     def __eq__(self, maya_dt):
         return self._epoch == maya_dt._epoch
 
-    @validate_class_type_arguments('!=')
+    @validate_type_mayadt
     def __ne__(self, maya_dt):
-        return self._epoch != maya_dt._epoch
+        return not self.__eq__(maya_dt)
 
-    @validate_class_type_arguments('<')
+    @validate_type_mayadt
     def __lt__(self, maya_dt):
         return self._epoch < maya_dt._epoch
 
-    @validate_class_type_arguments('<=')
+    @validate_type_mayadt
     def __le__(self, maya_dt):
-        return self._epoch <= maya_dt._epoch
+        return self.__lt__(maya_dt) or self.__eq__(maya_dt)
 
-    @validate_class_type_arguments('>')
+    @validate_type_mayadt
     def __gt__(self, maya_dt):
         return self._epoch > maya_dt._epoch
 
-    @validate_class_type_arguments('>=')
+    @validate_type_mayadt
     def __ge__(self, maya_dt):
-        return self._epoch >= maya_dt._epoch
+        return self.__gt__(maya_dt) or self.__eq__(maya_dt)
 
-    def add(self, **kwargs):
-        """"Returns a new MayaDT object with the given offsets."""
-        return self.from_datetime(pendulum.instance(self.datetime()).add(**kwargs))
-
-    def subtract(self, **kwargs):
-        """"Returns a new MayaDT object with the given offsets."""
-        return self.from_datetime(pendulum.instance(self.datetime()).subtract(**kwargs))
 
     # Timezone Crap
     # -------------
@@ -137,18 +124,14 @@ class MayaDT(object):
     @classmethod
     def from_iso8601(klass, string):
         """Returns MayaDT instance from iso8601 string."""
-        return parse(string)
+        dt = iso8601.parse_date(string)
+        return klass.from_datetime(dt)
 
     @staticmethod
     def from_rfc2822(string):
         """Returns MayaDT instance from rfc2822 string."""
         return parse(string)
 
-    @staticmethod
-    def from_rfc3339(string):
-        """Returns MayaDT instance from rfc3339 string."""
-        return parse(string)
-
     # Exporters
     # ---------
 
@@ -185,10 +168,6 @@ class MayaDT(object):
         """Returns an RFC 2822 representation of the MayaDT."""
         return email.utils.formatdate(self.epoch, usegmt=True)
 
-    def rfc3339(self):
-        """Returns an RFC 3339 representation of the MayaDT."""
-        return self.datetime().strftime("%Y-%m-%dT%H:%M:%S.%f")[:-4]+"Z"
-
     # Properties
     # ----------
 
@@ -238,8 +217,7 @@ class MayaDT(object):
 
     def slang_date(self):
         """"Returns human slang representation of date."""
-        dt = self.datetime(naive=True, to_timezone=self.local_timezone)
-        return humanize.naturaldate(dt)
+        return humanize.naturaldate(self.datetime())
 
     def slang_time(self):
         """"Returns human slang representation of time."""
@@ -277,24 +255,11 @@ def when(string, timezone='UTC'):
 def parse(string, day_first=False):
     """"Returns a MayaDT instance for the machine-produced moment specified.
 
-    Powered by pendulum. Accepts most known formats. Useful for working with data.
+    Powered by dateutil. Accepts most known formats. Useful for working with data.
 
     Keyword Arguments:
         string -- string to be parsed
         day_first -- if true, the first value (e.g. 01/05/2016) is parsed as day (default: False)
     """
-    dt = pendulum.parse(string, day_first=day_first)
+    dt = dateutil.parser.parse(string, dayfirst=day_first)
     return MayaDT.from_datetime(dt)
-
-def intervals(start, end, interval):
-    """Yields MayaDT objects between the start and end MayaDTs given, at a given interval (seconds or timedelta)."""
-
-    # Convert seconds into timedelta.
-    if isinstance(interval, int):
-        interval = timedelta(seconds=interval)
-
-    current_timestamp = start
-    while current_timestamp.epoch < end.epoch:
-        yield current_timestamp
-        current_timestamp = current_timestamp.add(seconds=interval.seconds)
-

requirements.txt

@@ -0,0 +1,16 @@
+-e . 
+dateparser==0.5.0
+humanize==0.5.1
+iso8601==0.1.11
+jdatetime==1.8.1
+py==1.4.32
+pytest==3.0.5
+python-dateutil==2.6.0
+pytz==2016.10
+regex==2016.11.21
+ruamel.ordereddict==0.4.9
+ruamel.yaml==0.13.4
+six==1.10.0
+typing==3.5.2.2
+tzlocal==1.3
+umalqurra==0.2

setup.py

@@ -16,9 +16,8 @@ except ImportError:
 
 here = os.path.abspath(dirname(__file__))
 
-with codecs.open(os.path.join(here, 'README.rst'), encoding='utf-8') as f:
-    long_description = '\n' + f.read()
-
+def read(*parts):
+    return codecs.open(os.path.join(here, *parts), 'r').read()
 
 if sys.argv[-1] == "publish":
     os.system("python setup.py sdist bdist_wheel upload")
@@ -28,16 +27,17 @@ required = [
     'humanize',
     'pytz',
     'dateparser',
+    'iso8601',
+    'python-dateutil',
     'ruamel.yaml',
-    'tzlocal',
-    'pendulum'
+    'tzlocal'
 ]
 
 setup(
     name='maya',
-    version='0.1.8',
+    version='0.1.5',
     description='Datetimes for Humans.',
-    long_description=long_description,
+    long_description= '\n' + read('README.rst'),
     author='Kenneth Reitz',
     author_email='me@kennethreitz.com',
     url='https://github.com/kennethreitz/maya',

test_maya.py

@@ -1,73 +1,27 @@
 import pytest
+from datetime import datetime
 import copy
 
 import maya
 
 
 def test_rfc2822():
-    r = maya.parse('February 21, 1994').rfc2822()
+    r = maya.now().rfc2822()
     d = maya.MayaDT.from_rfc2822(r)
-    assert r == 'Mon, 21 Feb 1994 00:00:00 GMT'
     assert r == d.rfc2822()
 
 
 def test_iso8601():
-    r = maya.parse('February 21, 1994').iso8601()
+    r = maya.now().iso8601()
     d = maya.MayaDT.from_iso8601(r)
-    assert r == '1994-02-21T00:00:00Z'
     assert r == d.iso8601()
 
 
-def test_parse_iso8601():
-    string = '20161001T1430.4+05:30'
-    expected = '2016-10-01T09:00:00.400000Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-    string = '2016T14'
-    expected = '2016-01-01T14:00:00Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-    string = '2016-10T14'
-    expected = '2016-10-01T14:00:00Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-    string = '2012W05'
-    expected = '2012-01-30T00:00:00Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-    string = '2012W055'
-    expected = '2012-02-03T00:00:00Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-    string = '2012007'
-    expected = '2012-01-07T00:00:00Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-    string = '2016-W07T09'
-    expected = '2016-02-15T09:00:00Z'
-    d = maya.MayaDT.from_iso8601(string)
-
-    assert expected == d.iso8601()
-
-
 def test_human_when():
     r1 = maya.when('yesterday')
     r2 = maya.when('today')
 
-    assert (r2.day - r1.day) in (1, -30, -29, -28, -27)
-
+    assert r2.day - r1.day == 1
 
 def test_machine_parse():
     r1 = maya.parse('August 14, 2015')
@@ -79,44 +33,28 @@ def test_machine_parse():
 
 def test_dt_tz_translation():
     d1 = maya.now().datetime()
-    d2 = maya.now().datetime(to_timezone='EST')
-    assert (d1.hour - d2.hour) % 24 == 5
+    d2 = maya.now().datetime(to_timezone='US/Eastern')
+    assert d1.hour - d2.hour == 5
 
 
 def test_dt_tz_naive():
     d1 = maya.now().datetime(naive=True)
     assert d1.tzinfo is None
 
-    d2 = maya.now().datetime(to_timezone='EST', naive=True)
+    d2 = maya.now().datetime(to_timezone='US/Eastern', naive=True)
     assert d2.tzinfo is None
-    assert (d1.hour - d2.hour) % 24 == 5
+    assert d1.hour - d2.hour == 5
 
 
 def test_random_date():
-
-    # Test properties for maya.when()
-    d1 = maya.when('11-17-11 08:09:10')
-    assert d1.year == 2011
-    assert d1.month == 11
-    assert d1.day == 17
-    assert d1.week == 46
-    assert d1.weekday == 4
-    assert d1.hour == 8
-    assert d1.minute == 9
-    assert d1.second == 10
-    assert d1.microsecond == 0
-
-    # Test properties for maya.parse()
-    d2 = maya.parse('February 29, 1992 13:12:34')
-    assert d2.year == 1992
-    assert d2.month == 2
-    assert d2.day == 29
-    assert d2.week == 9
-    assert d2.weekday == 6
-    assert d2.hour == 13
-    assert d2.minute == 12
-    assert d2.second == 34
-    assert d2.microsecond == 0
+    d = maya.when('11-17-11 08:09:10')
+    assert d.year == 2011
+    assert d.month == 11
+    assert d.day == 17
+    assert d.hour == 8
+    assert d.minute == 9
+    assert d.second == 10
+    assert d.microsecond == 0
 
 
 def test_print_date(capsys):
@@ -124,9 +62,7 @@ def test_print_date(capsys):
 
     print(d)
     out, err = capsys.readouterr()
-
-    assert out == 'Thu, 17 Nov 2011 00:00:00 GMT\n'
-    assert repr(d) == '<MayaDT epoch=1321488000.0>'
+    assert out == '<MayaDT epoch=1321488000.0>\n'
 
 
 def test_invalid_date():
@@ -159,12 +95,6 @@ def test_datetime_to_timezone():
     dt = maya.when('2016-01-01').datetime(to_timezone='US/Eastern')
     assert dt.tzinfo.zone == 'US/Eastern'
 
-def test_rfc3339():
-    mdt =  maya.when('2016-01-01')
-    out = mdt.rfc3339()
-    mdt2 = maya.MayaDT.from_rfc3339(out)
-    assert mdt.epoch == mdt2.epoch
-
 
 def test_comparison_operations():
     now = maya.now()
@@ -189,22 +119,3 @@ def test_comparison_operations():
     assert (now >= now_copy) is True
     assert (now >= tomorrow) is False
 
-    # Check Exceptions
-    with pytest.raises(TypeError):
-        now == 1
-    with pytest.raises(TypeError):
-        now != 1
-    with pytest.raises(TypeError):
-        now < 1
-    with pytest.raises(TypeError):
-        now <= 1
-    with pytest.raises(TypeError):
-        now > 1
-    with pytest.raises(TypeError):
-        now >= 1
-
-def test_intervals():
-    now = maya.now()
-    tomorrow = now.add(days=1)
-
-    assert len(list(maya.intervals(now, tomorrow, 60*60))) == 24