df2gspread 1.0.4

描述

Python库，提供在Google表格和Pandas DataFrame之间传输表格数据以进行进一步管理或处理的可能。在需要处理位于Google Drive中的数据的所有情况下都非常有用。

状态

最新发布
构建
文档
许可协议

安装

使用VirtualEnv的示例安装

# install/use python virtual environment
virtualenv ~/virtenv_scratch --no-site-packages

# activate the virtual environment
source ~/virtenv_scratch/bin/activate

# upgrade pip in the new virtenv
pip install -U pip setuptools

# install this package in DEVELOPMENT mode
# python setup.py develop

# simply install
# python setup.py install

# or install via pip
pip install df2gspread

访问凭证

为了允许脚本使用Google Drive API，我们需要向Google进行身份验证。为此，我们需要创建一个项目，描述工具并生成凭证。请使用您的网络浏览器并访问 Google控制台 并

• 在顶部弹出菜单中选择 “创建项目”。

• 出现一个对话框，因此为您的项目命名并单击 “创建” 按钮。

• 在左侧菜单中单击 “API管理器”。

• 显示可用API的表格。切换 “驱动API” 并单击 “启用API” 按钮。其他API可能处于关闭状态，对于我们的目的而言。

• 在左侧菜单中单击 “凭证”。

• 在 “OAuth同意屏幕” 部分，选择您的电子邮件地址并给你的产品命名。然后单击 “保存” 按钮。

• 在“证书”部分，点击“添加证书”并切换到“OAuth 2.0 客户端 ID”。

• 出现一个名为“创建客户端 ID”的对话框。将“应用类型”项选择为“其他”。

• 点击“创建”按钮。

• 在创建的“OAuth 2.0 客户端 ID”右侧点击“下载 JSON”图标，并将下载的文件存储到您的文件系统中。请注意，该文件包含您的私有证书，因此请像对待您的私有 SSH 密钥一样小心保管该文件；即，将下载的 JSON 文件移动到 ~/.gdrive_private。

• 然后，您第一次运行它时，浏览器窗口将打开一个 Google 授权请求页面。批准授权后，证书将按预期工作。

使用方法

运行 df2gspread 如下：

from df2gspread import df2gspread as d2g
import pandas as pd
d = [pd.Series([1., 2., 3.], index=['a', 'b', 'c']),
    pd.Series([1., 2., 3., 4.], index=['a', 'b', 'c', 'd'])]
df = pd.DataFrame(d)

# use full path to spreadsheet file
spreadsheet = '/some/folder/New Spreadsheet'
# or spreadsheet file id
# spreadsheet = '1cIOgi90...'

wks_name = 'New Sheet'

d2g.upload(df, spreadsheet, wks_name)
# if spreadsheet already exists, all data of provided worksheet(or first as default)
# will be replaced with data of given DataFrame, make sure that this is what you need!

运行 gspread2df 如下：

from df2gspread import gspread2df as g2d

# use full path to spreadsheet file
spreadsheet = '/some/folder/New Spreadsheet'
# or spreadsheet file id
# spreadsheet = '1cIOgi90...'
wks_name = 'New Sheet'

df = g2d.download(spreadsheet, wks_name, col_names = True, row_names = True)

文档

文档可在此处找到。

测试

测试基于 py.test。运行如下：

py.test tests/ -v

或使用 coverage

coverage run --source df2gspread -m py.test
coverage report

开发

安装提供的 githooks；例如

ln -s ~/repos/df2gspread/_githooks/commit-msg ~/repos/df2gspread/.git/hooks/commit-msg
ln -s ~/repos/df2gspread/_githooks/pre-commit ~/repos/df2gspread/.git/hooks/pre-commit