Metadata-Version: 1.1
Name: whenIO
Version: 1.2
Summary: Methods for formatting and parsing friendly timestamps
Home-page: https://github.com/invisibleroads/whenIO
Author: Roy Hyunjin Han
Author-email: starsareblueandfaraway@gmail.com
License: MIT
Description: whenIO
        ======
        Here are some methods for formatting and parsing friendly timestamps.
        
        
        Installation
        ------------
        ::
        
            easy_install -U whenIO
        
        
        Usage
        -----
        ::
        
            >>> import whenIO
            >>> import datetime
            >>> w = whenIO.WhenIO(offsetMinutes=240)
        
            >>> w.format(datetime.datetime.utcnow(), fromUTC=False)
            'Today 5:15pm'
            >>> w.format(datetime.datetime.utcnow(), fromUTC=True)
            'Today 1:15pm'
            >>> w.format(datetime.datetime.utcnow(), dateTemplate_=' %m/%d/%Y', fromUTC=True)
            'Today 04/24/2011 1:15pm'
            >>> w.format([datetime.datetime(2000, 1, 1, 0, 0), datetime.datetime(2000, 1, 1, 1, 0)], fromUTC=False)
            '01/01/2000 12am 1am'
        
            >>> w.parse('10am', toUTC=False)
            ([datetime.datetime(2011, 4, 24, 10, 0)], [])
            >>> w.parse('today 10am', toUTC=False)
            ([datetime.datetime(2011, 4, 24, 10, 0)], [])
            >>> w.parse('today 10am', toUTC=True)
            ([datetime.datetime(2011, 4, 24, 14, 0)], [])
            >>> w.parse('tom 8pm', toUTC=True)
            ([datetime.datetime(2011, 4, 26, 0, 0)], [])
            >>> w.parse('monday 8:10pm tag1 tag2', toUTC=True)
            ([datetime.datetime(2011, 4, 26, 0, 10)], ['tag1', 'tag2'])
        
            >>> w.format_offset()
            '-0400 UTC'
            >>> whenIO.format_offset(-540)
            '+0900 UTC'
            >>> whenIO.parse_offset('-0400 UTC')
            (240, '')
        
            >>> rdelta = whenIO.parse_interval('2 years 7 months 1 second')
            >>> whenIO.format_interval(rdelta, precision=1)
            '3 years'
            >>> whenIO.format_interval(rdelta, precision=2)
            '2 years 7 months'
            >>> whenIO.format_interval(rdelta, precision=3)
            '2 years 7 months'
        
        
        1.2
        ---
        - Removed python-dateutil==1.5 requirement
        - Restored test coverage to 100%
        
        1.1
        ---
        - Added format_interval() for formatting relativedelta objects
        - Added parse_interval() for parsing text into relativedelta objects
        
        1.0
        ---
        - Expanded test coverage to 100%
        
Keywords: datetime time
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: MIT License
