datasift 2.8.0

The official DataSift API library for Python.

This is the official Python library for accessing DataSift APIs.

Getting Started

Read our Python Getting Started Guide to get started with the DataSift platform. This guide will take you through creating a DataSift account, and activating data sources which you will need to do before using the DataSift API.

Many of the examples and API endpoints used in this library require you have enabled certain data sources before you can receive any data (you should do this at datasift.com/source). Certain API features, such as Historics and Managed Sources will require you have signed up to a monthly subscription before you can access them.

If you are interested in using these features, or would like more information about DataSift, please get in touch!

Installation

Install with pip:

pip install datasift

Install from source:

git clone https://github.com/datasift/datasift-python.git
cd datasift-python
python setup.py install

Usage

Full documentation is available at http://datasift.github.io/datasift-python

Supported Operating Environment

This version of the client library has been tested, and is known to work against the following language versions and Operating Systems:

Language versions

• Python 2.6

• Python 2.7

• Python 3.4

• Python 3.5

• pypy 2.7

Operating Systems

• Linux

• BSD

• OS X

• Windows 7/8/10 (only with python 2.x) (upstream bug here: <http://twistedmatrix.com/trac/ticket/7626>)

Style Guide

This code should conform to pep8, with the exception of E501, the 79 character line limit.

It can be style checked with the pep8 module by running pep8 --show-source --ignore=E501 datasift/*.py

Requirements

Supports Python 2.6, 2.7 and 3.3, as well as pypy. Uses requests, autobahn, six, twisted, pyopenssl and dateutil.

On non-Windows systems, the twisted and pyopenssl packages require the Python and OpenSSL development headers before they can be installed. These are usually provided by distribution package managers in a separate package to the main packages.

Windows users may need to use Python 2.7 due to compatability issues with the Twisted library

License

All code contained in this repository is Copyright 2012-Present MediaSift Ltd.

This code is released under the BSD license. Please see the LICENSE file for more details.

Contributors

• woozyking - patches for Historics/prepare

• glyph from rackspace - assisting with Twisted SSL code

Changelog

See CHANGELOG file