Metadata-Version: 1.0
Name: twitterspawn
Version: 0.2.0
Summary: Asynchronous, concurrent requests to the Twitter REST API, that respect Twitter's rate limits, using gevent and requests.
Home-page: https://github.com/swinton/twitterspawn
Author: Steve Winton
Author-email: stevewinton@gmail.com
License: MIT
Description: # Twitterspawn
        
        Asynchronous, concurrent requests to the Twitter REST API, that respect Twitter's rate limits, using [gevent](http://www.gevent.org/) and [requests](http://docs.python-requests.org/).
        
        See [example.py](https://github.com/swinton/twitterspawn/blob/develop/example.py) for a working example.
        
        ## Usage
        Basically:
        
        ```python
        import twitterspawn
        
        # Define callback (can define 1 per request)
        def callback(response, worker):
            print "Got", response, "from", worker
        
        # Add requests + callbacks
        twitterspawn.add_request("https://api.twitter.com/1/users/show.json", 
                                 dict(params=dict(screen_name="steveWINton")),
                                 callback)
        twitterspawn.add_request("https://api.twitter.com/1/users/show.json", 
                                 dict(params=dict(screen_name="twitter")),
                                 callback)
        twitterspawn.add_request("https://api.twitter.com/1/users/show.json", 
                                 dict(params=dict(screen_name="catbinlady")),
                                 callback)
        
        # Add workers
        twitterspawn.add_worker(access_token="YOUR_FIRST_ACCESS_TOKEN", 
                                access_token_secret="YOUR_FIRST_ACCESS_TOKEN_SECRET", 
                                consumer_key="YOUR_CONSUMER_KEY", 
                                consumer_secret="YOUR_CONSUMER_SECRET")
        twitterspawn.add_worker(access_token="YOUR_NEXT_ACCESS_TOKEN", 
                                access_token_secret="YOUR_NEXT_ACCESS_TOKEN_SECRET", 
                                consumer_key="YOUR_CONSUMER_KEY", 
                                consumer_secret="YOUR_CONSUMER_SECRET")
        # ...add as many more workers as required...
        twitterspawn.add_worker(access_token="YOUR_LAST_ACCESS_TOKEN", 
                                access_token_secret="YOUR_LAST_ACCESS_TOKEN_SECRET", 
                                consumer_key="YOUR_CONSUMER_KEY", 
                                consumer_secret="YOUR_CONSUMER_SECRET")
        
        # Go!
        twitterspawn.go()
        ```
        
        See also [example.py](https://github.com/swinton/twitterspawn/blob/develop/example.py) for a working example.
        
        ## Installation
        Simply:
        
            $ pip install twitterspawn
        
        ## Contact
        
        @[steveWINton](https://twitter.com/steveWINton).
Keywords: requests,python-requests,gevent,twitterspawn
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
