Metadata-Version: 2.0
Name: datefinder
Version: 0.0.1.dev2
Summary: Extract datetime objects from strings
Home-page: https://github.com/akoumjian/datefinder
Author: Alec Koumjian
Author-email: akoumjian@gmail.com
License: MIT
Keywords: datetime parser nlp
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Natural Language :: English
Requires-Dist: dateparser
Requires-Dist: regex
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'

datefinder - extract dates from text
====================================

.. image:: https://img.shields.io/travis/akoumjian/datefinder/master.svg
    :target: https://travis-ci.org/akoumjian/datefinder
    :alt: travis build status

.. image:: https://img.shields.io/pypi/dd/datefinder.svg
    :target: https://pypi.python.org/pypi/datefinder/
    :alt: pypi downloads per day

.. image:: https://img.shields.io/pypi/v/datefinder.svg
    :target: https://pypi.python.org/pypi/datefinder
    :alt: pypi version


A module for locating dates inside text. Use this package to extract all sorts 
of date like strings from a document and turn them into datetime objects.

This module finds the likely datetime strings and then uses the excellent 
`dateparser <https://github.com/scrapinghub/dateparser>`_ package to convert 
to the datetime object.

Installation
------------

.. code-block::

    pip install datefinder


How to Use
----------

.. code-block:: python

    >>> import datefinder
    >>> matches = datefinder.find_dates(string_with_dates)

    >>> for match in matches:
        print match

    2016-01-13 11:00:00
    2016-01-05 00:00:00
    2014-01-02 00:00:00
    2014-01-02 00:00:00



