Metadata-Version: 1.1
Name: radar
Version: 0.2
Summary: Generate a random date from range given.
Home-page: https://bitbucket.org/barseghyanartur/radar
Author: Artur Barseghyan
Author-email: artur.barseghyan@gmail.com
License: GPL 2.0/LGPL 2.1
Description: Package
        ===================================
        radar
        
        Description
        ===================================
        Random date generation.
        
        Installation
        ===================================
        Install latest stable version from pypi:
        
            $ pip install radar
        
        Optionally install python-dateutil (see `Usage and examples` section first).
        
            $ pip install python-dateutil
        
        Usage and examples
        ===================================
        If you expect to have really weird date formats when generating random dates from strings, you might want to consider
        installing wonderful `python-dateutil` package.
        
        A basic (fallback) parser (``radar.utils.parse``) is used when `dateutil` is not available.
        
        When generating thousands of objects (using `dateutil` or fallback parser), you're advised to pass
        ``datetime.datetime`` or ``datetime.date`` objects to `radar`, rather than passing ``str`` (performance issue).
        
        In numbers (based on my local tests), using `dateutil` could slow down things 35 times. Basic built-in parser slows
        down things 10 times compared to when passing ``datetime.datetime`` or ``datetime.date`` objects directly.
        
        You can pass a custom parser as an argument too.
        
        Generate random date
        -----------------------------------
        Using built-in parser:
        
        >>> from dateutil_parser import parse as dateutil_parser
        >>> import radar
        >>> radar.random_date(start='2013-05-24', stop='2013-07-01', parse=radar.utils.parse)
        datetime.date(2013, 5, 31)
        
        Generate random datetime
        -----------------------------------
        Using dateutil parser:
        
        >>> radar.random_datetime(start='2013-05-24T00:00:00', stop='2013-05-24T23:59:59', parse=dateutil_parser)
        datetime.datetime(2013, 5, 24, 16, 54, 52)
        >>> start = radar.utils.parse('2012-01-01')
        datetime.datetime(2012, 1, 1, 0, 0)
        >>> stop = radar.utils.parse('2013-01-01')
        datetime.datetime(2013, 1, 1, 0, 0)
        >>> radar.random_datetime(start=start, stop=stop)
        datetime.datetime(2012, 6, 19, 13, 48, 7)
        >>> radar.random_datetime(start=start)
        datetime.datetime(2012, 2, 26, 6, 49, 7)
        >>> radar.random_datetime(stop=stop)
        datetime.datetime(1985, 12, 10, 2, 40, 50)
        
        Generate random time
        -----------------------------------
        >>> radar.random_time(start='2012-01-01T00:00:00', stop='2012-01-01T23:59:59')
        datetime.time(11, 33, 59)
        
        License
        ===================================
        GPL 2.0/LGPL 2.1
        
        Support
        ===================================
        For any issues contact me at the e-mail given in the `Author` section.
        
        Author
        ===================================
        Artur Barseghyan <artur.barseghyan@gmail.com>
        
Keywords: random date,python
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
