Metadata-Version: 1.1
Name: GoogleToken
Version: 0.7.6
Summary: Google User Account login automation
Home-page: http://github.com/scottphilip/google-token
Author: Scott Philip
Author-email: sp@scottphilip.com
License: GNU (v3) License
Description: .. image:: https://travis-ci.org/scottphilip/google-token.svg?branch=master
            :target: https://travis-ci.org/scottphilip/google-token
        
        Google Token
        ============
        
        Python Package allowing `Google
        Account <https://myaccount.google.com>`__ Authorization Tokens to be
        issued when user is not in attendance.
        
        Installation Instructions
        -------------------------
        
        ::
        
            pip install GoogleToken
        
        Properties
        ----------
        
        When manually logging into a Google Account secured web application, the
        initial URL will be in the format;
        
        ::
        
            https://accounts.google.com/o/oauth2/v2/auth?response_type=token&client_id=0000000000000-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com&redirect_uri=https://www.website.com/google/callback&scope=https://www.googleapis.com/auth/userinfo.email%20https://www.googleapis.com/auth/userinfo.profile
        
        +-----------+----------------------------------------------------------------+
        | Property  | Example                                                        |
        +===========+================================================================+
        | Client Id | 0000000000000-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleuser |
        |           | content.com                                                    |
        +-----------+----------------------------------------------------------------+
        | Redirect  | https://www.website.com/google/callback                        |
        | Uri       |                                                                |
        +-----------+----------------------------------------------------------------+
        | Scope     | https://www.googleapis.com/auth/userinfo.email                 |
        |           | https://www.googleapis.com/auth/userinfo.profile               |
        +-----------+----------------------------------------------------------------+
        
        Usage Instructions
        ------------------
        
        First time login will create a Cookies file which stores the issued
        tokens which will subsequently be reused. It is recommended not to the
        password or the OTP secret in configuration. Once the cookies file is
        created the credentials are not required.
        
        .. code:: python
        
                from GoogleToken import GoogleTokenGenerator, GoogleTokenParameters
                parameters = GoogleTokenParameters(oauth_client_id="0000000000000-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com",
                                          oauth_redirect_uri="https://www.website.com/google/callback",
                                          oauth_scope="https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/userinfo.profile",
                                          account_email="user@gmail.com",
                                          account_password="password",
                                          account_otp_secret="secret")
                generator = GoogleTokenGenerator(parameters)
                token = generator.generate()
                print(token)
        
        Once the cookies file is created, the credentials can be omitted.
        
        .. code:: python
        
            from GoogleToken import get_google_token
            token, expiry = get_google_token(account_email="account@gmail.com",
                                             account_password="password",
                                             account_otp_secret="secret",
                                             oauth_client_id="0000000000000-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com",
                                             oauth_redirect_uri="https://www.website.com/google/callback",
                                             oauth_scope="https://www.googleapis.com/auth/userinfo.profile")
        
        
        Dependencies
        ------------
        
        `Selenium <https://pypi.python.org/pypi/selenium>`__
        
        `Pyotp <https://pypi.python.org/pypi/pyotp>`__
        
        Credits
        -------
        
        Scott Philip
        
        Berlin, Germany
        
        Licence
        -------
        
        GNU General Public License (Version 3, 29 June 2007)
        
        CallerLookup Copyright © 2017 Scott Philip
        
Keywords: Google Account,Access Token,oauth2,Automation
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
