Overview
birding
is an open source project to produce a stream of recent twitter_
activity based on a sequence of search terms, using only twitter's public APIs
. It serves as both a standalone project and a demo of distributed
real-time computing with Python using Storm_/streamparse_ and Kafka_/pykafka_.
Dependencies are fully automated; in a birding checkout, run with::
make run
See the docs (below) for a full discussion of birding, including how to use
birding in an existing streamparse project.
To discuss this project, join the streamparse user group
_.
.. _twitter: https://twitter.com
.. _twitter's public APIs
: https://dev.twitter.com/rest/public
.. _Storm: http://storm.apache.org
.. _Python: http://python.org
.. _Kafka: http://kafka.apache.org
.. _streamparse: https://github.com/Parsely/streamparse
.. _pykafka: https://github.com/Parsely/pykafka
.. _streamparse user group
: https://github.com/Parsely/streamparse#user-group
Documentation
HEAD <http://birding.readthedocs.org/en/master/>
_Stable <http://birding.readthedocs.org/en/stable/>
_
Interaction
Given a checkout of birding, to run birding in place, see Downloading and running birding <http://birding.readthedocs.org/en/master/solo.html>
_.
Python Support
The birding project uses Python 2.7 and will also support Python 3.4+ when
underlying dependencies support Python 3.