Metadata-Version: 2.1
Name: datefinder
Version: 0.7.0
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 :: 4 - Beta
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.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Natural Language :: English
Requires-Dist: regex (>=2017.02.08)
Requires-Dist: python-dateutil (>=2.4.2)
Requires-Dist: pytz
Provides-Extra: dev
Requires-Dist: pytest (>=2.8.5) ; extra == 'dev'
Requires-Dist: mock ; extra == 'dev'
Requires-Dist: pytz (>=2015.7) ; extra == 'dev'
Requires-Dist: pylint (==2.1.1) ; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest (>=2.8.5) ; extra == 'test'
Requires-Dist: mock ; extra == 'test'
Requires-Dist: pytz (>=2015.7) ; 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/dm/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

.. image:: https://img.shields.io/gitter/room/nwjs/nw.js.svg
    :target: https://gitter.im/datefinder/Lobby
    :alt: gitter chat


A python 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  
`dateutil`to convert to the datetime object.


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

.. code-block:: sh

    pip install datefinder


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


.. automodule:: datefinder
   :members: find_dates


.. code-block:: python

    In [1]: string_with_dates = """
       ...: ...
       ...: entries are due by January 4th, 2017 at 8:00pm
       ...: ...
       ...: created 01/15/2005 by ACME Inc. and associates.
       ...: ...
       ...: """

    In [2]: import datefinder

    In [3]: matches = datefinder.find_dates(string_with_dates)

    In [4]: for match in matches:
       ...:     print match
       ...:
    2017-01-04 20:00:00
    2005-01-15 00:00:00


Support
-------

You can talk to us on `Gitter <https://gitter.im/datefinder/Lobby>`_ or just submit an issue on `github <https://github.com/akoumjian/datefinder/issues/>`_. 



