Metadata-Version: 1.1
Name: google_spreadsheet
Version: 0.0.1
Summary: Google spreadsheet create/update util
Home-page: https://github.com/pahaz/google-spreadsheets-api
Author: Pahaz Blinov
Author-email: pahaz.blinov@gmail.com
License: MIT
Download-URL: https://pypi.python.org/packages/source/s/google_spreadsheet/google_spreadsheet-0.0.1.zip
Description: **Author**: `Pahaz Blinov`_
        
        **Repo**: https://github.com/pahaz/google-spreadsheets-api/
        
        Simple create/append google spreadsheet api helper.
        
        Requirements
        -------------
        
        * `oauth2client`_
        * `apiclient`_
        
        Installation
        ============
        
        `google-spreadsheets-api`_ is on PyPI, so simply run:
        
        ::
        
            pip install google_spreadsheet
        
        or ::
        
            easy_install google_spreadsheet
        
        to have it installed in your environment.
        
        For installing from source, clone the
        `repo <https://github.com/pahaz/google-spreadsheets-api>`_ and run::
        
            python setup.py install
        
        Usage scenarios
        ===============
        
        Two typical usecases where ``google_spreadsheet`` is helpful there are:
        1. create new spreadsheet with restricted acccess rules,
        2. append data to existing spreadsheet.
        
        You can use it for export your user data to the google spreadsheet. 
        And sharing this data to all around the world or sharing to specific users.
        
        Usage examples
        ==============
        
        Example 1: create spreadsheet
        -----------------------------
        
        .. code-block:: py
        
            from google_spreadsheet import get_credentials, Spreadsheets
        
        
            def create_example():
                credentials = get_credentials('auth.json', [
                    'https://www.googleapis.com/auth/drive',
                    'https://www.googleapis.com/auth/spreadsheets'])
                api = Spreadsheets(credentials=credentials)
                sheet = api.create('test1', writers=['pahaz.blinov@gmail.com'])
                print(sheet)
        
            if __name__ == '__main__':
                create_example()
        
        
        Example 2: append row to existing spreadsheet
        ---------------------------------------------
        
        .. code-block:: py
        
            from google_spreadsheet import get_credentials, Spreadsheets
        
        
            def append_data_example():
                credentials = get_credentials('auth.json', [
                    'https://www.googleapis.com/auth/drive',
                    'https://www.googleapis.com/auth/spreadsheets'])
                api = Spreadsheets(credentials=credentials)
                sheet = api.get('1jSHsmPTOOiPXdYQlrVBwbo3MO1vp64lmi5R_Ld_duKo')
                sheet.append([[1, 2], [3, 4]])
        
        
            if __name__ == '__main__':
                append_data_example()
        
        .. _Pahaz Blinov: https://github.com/pahaz/
        .. _oauth2client: https://github.com/google/oauth2client/
        .. _apiclient: https://github.com/shazow/apiclient/
        
Keywords: google spreadsheet api util helper
Platform: unix
Platform: macos
Platform: windows
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
