Metadata-Version: 1.1
Name: python-oauth2
Version: 0.3.1
Summary: OAuth 2.0 provider for python
Home-page: https://github.com/wndhydrnt/python-oauth2
Author: Markus Meyer
Author-email: hydrantanderwand@gmail.com
License: UNKNOWN
Description: python-oauth2
        ###############
        
        python-oauth2 is a framework that aims at making it easy to provide authentication
        via `OAuth 2.0 <http://tools.ietf.org/html/rfc6749>`_ within an application stack. 
        
        `Documentation <http://python-oauth2.readthedocs.org/en/latest/index.html>`_
        
        Status
        ******
        
        .. image:: https://travis-ci.org/wndhydrnt/python-oauth2.png?branch=master
           :target: https://travis-ci.org/wndhydrnt/python-oauth2
        
        python-oauth2 is currently not ready for use in production environments.
        While the basic implementations work already pretty well, some types of
        authorization Grants
        `defined in the RFC <http://tools.ietf.org/html/rfc6749#section-1.3>`_ are
        still missing.
        Also some features like `Refreh Tokens <http://tools.ietf.org/html/rfc6749#section-1.5>`_
        have not been implemented yet.
        
        Installation
        ************
        
        python-oauth2 is available on
        `PyPI <http://pypi.python.org/pypi/python-oauth2/>`_.
        
            pip install python-oauth2
        
        Usage
        *****
        
        Example Authorization server::
            
            from wsgiref.simple_server import make_server
            import oauth2
            import oauth2.grant
            import oauth2.error
            import oauth2.store
            import oauth2.tokengenerator
            import oauth2.web
        
            # Create a SiteAdapter to interact with the user.
            # This can be used to display confirmation dialogs and the like.
            class ExampleSiteAdapter(oauth2.web.SiteAdapter):
                def authenticate(self, request, environ, scopes):
                    if request.post_param("confirm") == "1":
                        return {}
        
                    raise oauth2.error.UserNotAuthenticated
        
                def render_auth_page(self, request, response, environ, scopes):
                    response.body = '''
            <html>
                <body>
                    <form method="POST" name="confirmation_form">
                        <input name="confirm" type="hidden" value="1" />
                        <input type="submit" value="confirm" />
                    </form>
                </body>
            </html>'''
                    return response
        
            # Create an in-memory storage to store your client apps.
            client_store = oauth2.store.LocalClientStore()
            # Add a client
            client_store.add_client(client_id="abc", client_secret="xyz",
                                    redirect_uris=["http://localhost/callback"])
        
            # Create an in-memory storage to store issued tokens.
            # LocalTokenStore can store access and auth tokens
            token_store = oauth2.store.LocalTokenStore()
        
            # Create the controller.
            auth_controller = oauth2.AuthorizationController(
                access_token_store=token_store,
                auth_code_store=token_store,
                client_store=client_store,
                site_adapter=ExampleSiteAdapter(),
                token_generator=oauth2.tokengenerator.Uuid4()
            )
        
            # Add Grants you want to support
            auth_controller.add_grant(oauth2.grant.AuthorizationCodeGrant())
            auth_controller.add_grant(oauth2.grant.ImplicitGrant())
        
            # Wrap the controller with the Wsgi adapter
            app = oauth2.web.Wsgi(server=auth_controller)
        
            if __name__ == "__main__":
                httpd = make_server('', 8080, app)
                httpd.serve_forever()
        
        Storage adapters
        ================
        
        python-oauth2 handles the request/response flow needed to create a OAuth 2.0 token.
        It does not define how a token is stored so you can choose the
        persistence strategy that works best for you. It is possible to write a token to
        mysql or mongodb for persistence, save it in memcache or redis for fast access or
        mix both approaches. This flexibility is achieved by the use of storage adapters
        that define an interface which is called by a Grant handler during processing.
        
        The ``oauth2.store`` module defines base classes for each type of storage.
        Also take a look at the examples in the *examples* directory of the project.
        
        Site adapter
        ============
        
        Like for storage, python-oauth2 does not define how you identify a user or
        show a confirmation dialogue.
        Instead your application should use the API defined by
        ``oauth2.web.SiteAdapter``.
        
        Changelog
        *********
        
        New in version 0.3.1
        ====================
        - Fixed a bug causing a supplied redirect uri being ignored if it is not the first entry in the list of a client object.
        
        New in version 0.3.0
        ====================
        - Headers of a response are returned as a dictionary
        - Status code of a response is an integer
        - Streamlining the integration of storage classes and site adapters by requiring them to raise specified errors
        
        New in version 0.2.0
        ====================
        - Support for scopes
        - Local token and client stores
        - Memcache token store
        - Support for Python 2.6, 3.2 and 3.3
        
        New in version 0.1.0
        ====================
        - Working implementation of Authorization Code Grant
        - Working implementation of Implicit Grant
        - Working implementation of Resource Owner Password Credentials Grant
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
