Metadata-Version: 1.0
Name: rauth
Version: 0.4.10
Summary: A Python library for OAuth 1.0/a, 2.0, and Ofly.
Home-page: https://github.com/litl/rauth
Author: Max Countryman
Author-email: max@litl.com
License: MIT
Description: # Rauth: OAuth 1.0/a, 2.0, and Ofly for Python
        
        This package provides OAuth 1.0/a, 2.0, and Ofly consumer support. The
        package is wrapped around the superb Python Requests.
        
        
        ## Installation
        
        Install the package with one of the following commands:
        
            $ easy_install rauth
        
        or
        
            $ pip install rauth
        
        
        ## Features
        
        * Built on [Requests](https://github.com/kennethreitz/requests)
        * Supports OAuth 1.0, 1.0a, 2.0 and [Ofly](http://www.shutterfly.com/documentation/start.sfly)
        * Service wrappers for convenient connection initialization
        * Well tested (100% coverage)
        
        
        ## Example Usage
        
        Using the package is quite simple. Ensure that Python Requests is installed.
        Import the relevant module and start utilizing OAuth endpoints!
        
        Let's get a user's Twitter timeline. Start by creating a service container 
        object:
        
            from rauth.service import OAuth1Service
        
            # Get a real consumer key & secret from https://dev.twitter.com/apps/new
            twitter = OAuth1Service(
                name='twitter',
                consumer_key='YOUR_CONSUMER_KEY',
                consumer_secret='YOUR_CONSUMER_SECRET',
                request_token_url='https://api.twitter.com/oauth/request_token',
                access_token_url='https://api.twitter.com/oauth/access_token',
                authorize_url='https://api.twitter.com/oauth/authorize',
                header_auth=True)
        
        Then get an OAuth 1.0 request token:
        
            request_token, request_token_secret = \
                twitter.get_request_token(method='GET')
        
        Go through the authentication flow.  Since our example is a simple console
        application, Twitter will give you a PIN to enter.
        
            authorize_url = twitter.get_authorize_url(request_token)
        
            print 'Visit this URL in your browser: ' + authorize_url
            pin = raw_input('Enter PIN from browser: ')
        
        Exchange the authorized request token for an access token:
        
            response = twitter.get_access_token('GET',
                                                request_token=request_token,
                                                request_token_secret=request_token_secret,
                                                params={'oauth_verifier': pin})
            data = response.content
        
            access_token = data['oauth_token']
            access_token_secret = data['oauth_token_secret']
        
        And now we can fetch our Twitter timeline!
        
            params = {'include_rts': 1,  # Include retweets
                      'count': 10}       # 10 tweets
        
            response = twitter.get('https://api.twitter.com/1/statuses/home_timeline.json',
                                   params=params,
                                   access_token=access_token,
                                   access_token_secret=access_token_secret,
                                   header_auth=True)
        
            for i, tweet in enumerate(response.content, 1):
                handle = tweet['user']['screen_name'].encode('utf-8')
                text = tweet['text'].encode('utf-8')
                print '{0}. @{1} - {2}'.format(i, handle, text)
        
        The full example is in [examples/twitter-timeline.py](https://github.com/litl/rauth/blob/master/examples/twitter-timeline.py).
        
        
        ## Documentation
        
        The Sphinx-compiled documentation is available here: [http://packages.python.org/rauth/](http://packages.python.org/rauth/)
        
        
        ## Copyright and License
        
        Rauth is Copyright (c) 2012 litl, LLC and licensed under the MIT license.
        See the LICENSE file for full details.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
