The official DataSift API library for Python.
Project description
This is the official Python library for accessing DataSift.
We have recently performed a major update to this library. The previous version is available here. That version will be supported until 4th September 2014.
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.3
Python 3.4
pypy 2.7
Operating Systems
Linux
BSD
OS X
Windows 7/8
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.
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.
Changelog
v.2.0.8 Bumped to release stable version (2014-06-04)
v.2.0.7 Small bugfix for livestreaming (2014-05-09)
v.2.0.6 Added windows support for livestreaming (2014-05-09)
v.2.0.5 Added support for all 3 outputs in pull (2014-04-29)
v.2.0.4 Upgraded the output mapper date logic to be more robust (2014-03-18)
v.2.0.3 Fixed secure websockets on OpenSSL >1.0 (2014-02-20)
v.2.0.2 Improved reconnection logic for livestreaming (2014-02-20)
v.2.0.1 Fixed disconnect problems in livestreaming on slow streams (2014-02-19)
v.2.0.0 Ground up rewrite. (2014-02-14)
v.0.5.7 Fixed issues with buffers on reconnections (2013-06-28)
v.0.5.6 Fixed broken tests, multistreaming, reconnection timeout (2013-05-03)
v.0.5.5 Introduced automatic reconnection after 65 seconds of no data or ticks. Solves ‘silent disconnect’ issue (2013-03-06)
v.0.5.4 Removed checks for existance of deprecated ‘volume_info’ field in historics/prepare response (2013-01-18)
v.0.5.3 Added missing Historic sample size into historic/prepare requests (2012-12-03)
v.0.5.2 Patch for the missing availability info after Historic/prepare [woozyking](https://github.com/woozyking) (2012-11-28)
v.0.5.1 Removed unit tests that are no longer required (2012-08-30)
v.0.5.0 Added support for Historic queries and Push delivery (2012-08-27)
v.0.4.0 Fixed issues with SSL timeouts & low throughput streams (2012-08-08)
v.0.3.0 Added SSL support and fixed a reconnection bug (2012-05-16)
The SSL support is enabled by default and can be disabled by passing false as the third parameter to the User constructor, or calling enableSSL(false) on the User object.
v.0.2.0 Fixed the handling of error messages in streams (2012-05-04)
v.0.1.1 Initial release (2012-03-09)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.