Metadata-Version: 1.1
Name: whenIO
Version: 1.3
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(timezone='US/Eastern')
        
            >>> w.format(datetime.datetime.now(), fromUTC=False)
            'Today 2:30pm'
            >>> w.format(datetime.datetime.utcnow())
            'Today 2:30pm'
            >>> w.format(datetime.datetime.utcnow(), dateTemplate_=' %m/%d/%Y')
            'Today 3/10/2013 2:30pm'
            >>> date1 = datetime.datetime(2000, 1, 1, 0, 0)
            >>> date2 = datetime.datetime(2000, 1, 1, 1, 0)
            >>> w.format([date1, date2], fromUTC=False)
            '1/1/2000 12am 1am'
        
            >>> w.parse('10am', toUTC=False)[0]
            [datetime.datetime(2013, 3, 10, 10, 0)]
            >>> w.parse('today 10am', toUTC=False)[0]
            [datetime.datetime(2013, 3, 10, 10, 0)]
            >>> w.parse('tom 8pm', toUTC=False)[0]
            [datetime.datetime(2013, 3, 11, 20, 0)]
            >>> w.parse('mon 10am 12pm', toUTC=False)[0]
            [datetime.datetime(2013, 3, 11, 10, 0), 
             datetime.datetime(2013, 3, 11, 12, 0)]
        
            >>> 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'
        
        
        1.3
        ---
        - Changed constructor to use timezones from pytz and tzlocal
        - Added weeks to format_interval()
        - Added withLeadingZero to format(), format_date(), format_time()
        - Added withStartDate to format()
        - Removed parse_offset(), format_offset()
        
        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
