{"id":21680005,"url":"https://github.com/squarespace/datasheets","last_synced_at":"2025-05-16T05:05:52.528Z","repository":{"id":49826945,"uuid":"79260189","full_name":"Squarespace/datasheets","owner":"Squarespace","description":"Read data from, write data to, and modify the formatting of Google Sheets","archived":false,"fork":false,"pushed_at":"2023-12-19T05:06:36.000Z","size":933,"stargazers_count":621,"open_issues_count":6,"forks_count":55,"subscribers_count":34,"default_branch":"master","last_synced_at":"2025-05-16T05:05:46.509Z","etag":null,"topics":["data","data-analytics","data-science","dataframe","google","pandas","python"],"latest_commit_sha":null,"homepage":"https://datasheets.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Squarespace.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-01-17T18:53:24.000Z","updated_at":"2025-04-22T18:13:31.000Z","dependencies_parsed_at":"2024-01-18T20:05:27.510Z","dependency_job_id":null,"html_url":"https://github.com/Squarespace/datasheets","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Squarespace%2Fdatasheets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Squarespace%2Fdatasheets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Squarespace%2Fdatasheets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Squarespace%2Fdatasheets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Squarespace","download_url":"https://codeload.github.com/Squarespace/datasheets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254471061,"owners_count":22076585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","data-analytics","data-science","dataframe","google","pandas","python"],"created_at":"2024-11-25T15:13:56.791Z","updated_at":"2025-05-16T05:05:47.518Z","avatar_url":"https://github.com/Squarespace.png","language":"Python","readme":"datasheets\n==========\n|pip_versions| |travis_ci| |coveralls|\n\n.. |pip_versions| image:: https://img.shields.io/pypi/pyversions/datasheets.svg\n    :target: https://pypi.python.org/pypi/datasheets\n\n.. |travis_ci| image:: https://travis-ci.org/Squarespace/datasheets.svg?branch=master\n    :target: https://travis-ci.org/Squarespace/datasheets\n\n.. |coveralls| image:: https://coveralls.io/repos/github/Squarespace/datasheets/badge.svg?branch=master\u0026service=github\n    :target: https://coveralls.io/github/Squarespace/datasheets?branch=master\n\n\ndatasheets is a library for interfacing with Google Sheets, including reading data from, writing\ndata to, and modifying the formatting of Google Sheets. It is built on top of Google's\n`google-api-python-client`_, `google_auth`_, and `google_auth_oauthlib`_ libraries using the `Google Drive v3`_ and\n`Google Sheets v4`_ REST APIs.\n\n.. _google-api-python-client: https://github.com/google/google-api-python-client\n.. _google_auth: https://github.com/GoogleCloudPlatform/google-auth-library-python\n.. _google_auth_oauthlib: https://github.com/GoogleCloudPlatform/google-auth-library-python-oauthlib\n.. _Google Drive v3: https://developers.google.com/drive/v3/reference/\n.. _Google Sheets v4: https://developers.google.com/sheets/reference/rest/\n\nIt can be installed with pip via ``pip install datasheets``.\n\nDetailed information can be found in the `documentation`_.\n\n.. _documentation: https://datasheets.readthedocs.io/en/latest/\n\n\nBasic Usage\n-----------\nGet the necessary OAuth credentials from the Google Developer Console as described\nin `Getting OAuth Credentials`_.\n\n.. _Getting OAuth Credentials: https://datasheets.readthedocs.io/en/latest/getting_oauth_credentials.html\n\nAfter that, using datasheets looks like:\n\n.. code-block:: python\n\n    import datasheets\n\n    # Create a data set to upload\n    import pandas as pd\n    df = pd.DataFrame([('a', 1.3), ('b', 2.7), ('c', 3.9)], columns=['letter', 'number'])\n\n    client = datasheets.Client()\n    workbook = client.create_workbook('my_new_workbook')\n    tab = workbook.create_tab('my_new_tab')\n\n    # Upload a data set\n    tab.insert_data(df, index=False)\n\n    # Fetch the data again\n    df_again = tab.fetch_data()\n\n    # Show workbooks you have access to; this may be slow if you are shared on many workbooks\n    client.fetch_workbooks_info()\n\n    # Show tabs within a given workbook\n    workbook.fetch_tab_names()\n\nFor further information, see the `documentation`_.\n\n\nLicense\n-------\nCopyright 2018 Squarespace, INC.\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in\ncompliance with the License. You may obtain a copy of the License at:\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is\ndistributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\nimplied. See the License for the specific language governing permissions and limitations under the\nLicense.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquarespace%2Fdatasheets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquarespace%2Fdatasheets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquarespace%2Fdatasheets/lists"}