README.md

A simple library for the twitter streaming api

Its as simple as:

from twitter.stream import BaseStreamingHandler

class SimpleClass(BaseStreamingHandler):
    def process_tweet(self,tweet):
       print tweet['text']

streamer = SimpleClass('username', 'password')
streamer.track(['key', 'words'])
streamer.sample()

you can also implement your own conversion of each tweet into a model of your choosing by overriding json_to_object in your subclass.