Metadata-Version: 2.0
Name: predicthq
Version: 0.0.3.dev1
Summary: PredictHQ Event Intelligence
Home-page: https://github.com/predicthq/sdk-py
Author: PredictHQ
Author-email: developers@predicthq.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Web Environment
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: six (>=1.9.0)
Requires-Dist: requests (>=2.7.0)
Requires-Dist: schematics (>=2.0.0.dev2)
Requires-Dist: python-dateutil (>=2.4.2)
Requires-Dist: pytz (>=2015.4)

.. note::

   For the latest source, discussions, bug reports, etc., please visit the `GitHub repository <https://github.com/predicthq/sdk-py>`_


###############################
PredictHQ API Client for Python
###############################

.. image:: https://badge.fury.io/py/predicthq.svg
    :target: https://badge.fury.io/py/predicthq
.. image:: https://travis-ci.org/predicthq/sdk-py.svg?branch=master
    :target: https://travis-ci.org/predicthq/sdk-py
.. image:: https://coveralls.io/repos/github/predicthq/sdk-py/badge.svg?branch=master
    :target: https://coveralls.io/github/predicthq/sdk-py?branch=master


`PredictHQ <https://www.predicthq.com/>`_ is a global events intelligence platform that aggregates, enriches and connects scheduled and real-time event data happening both locally and globally, then predicts which ones could impact your business.


Installation
############

.. code-block:: shell

    pip install predicthq

Usage
#####

.. code-block:: python

    from predicthq import Client

    phq = Client(access_token="$ACCESS_TOKEN")

    for event in phq.events.search(q="Foo Fighters", rank_level=[4, 5], country='US'):
        print("{} - {} - {} - {}".format(event.rank, event.category, event.title, event.start.strftime('%Y-%m-%d')))

    81 - concerts - Foo Fighters - 2015-11-17
    99 - concerts - Foo Fighters - 2015-11-16

Endpoints
#########

* ``Client.oauth2``
* ``Client.accounts``
* ``Client.events``
* ``Client.signals``
* ``Client.places``

For a description of all available endpoints, refer to our `API Documentation <https://developer.predicthq.com/>`_.

Running Tests
#############

.. code-block:: shell

    pip install tox
    tox


