Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fiorix/twisted-twitter-stream

Twitter Stream API for Twisted
https://github.com/fiorix/twisted-twitter-stream

Last synced: about 2 months ago
JSON representation

Twitter Stream API for Twisted

Awesome Lists containing this project

README

        

====================
TwistedTwitterStream
====================
:Info: See `Twitter Streaming API `_ for more information. See `github `_ for the latest source.
:Author: Alexandre Fiori

About
=====
The ``TwistedTwitterStream`` package provides an event-driven API for receiving `Twitter `_ status updates through the asynchronous `Twitter Streaming API `_.

The following methods are supported:
- `firehose `_
- `retweet `_
- `sample `_
- `filter `_

Notes
=====
- A JSON parser is required. Like `json `_ or `simplejson `_.
- All methods will automatically reconnect to the server with an exponential back-off. See `t.i.p.ReconnectingClientFactory `_ for details.
- All methods must be initialized with a *consumer* object, inherited from `TwistedTwitterStream.TweetReceiver`
- No proxy support.

Examples
========
Examples are available in the *examples/* directory.

Credits
=======
Thanks to (in no particular order):

- Arnaldo Moraes

- Testing, patching and using for private projects

- Vanderson Mota

- Patching setup.py and PyPi maintenance