df2gspread 项目教程

df2gspread 项目教程

df2gspreadManage Google Spreadsheets in Pandas DataFrame with Python项目地址:https://gitcode.com/gh_mirrors/df/df2gspread

1. 项目的目录结构及介绍

df2gspread 项目的目录结构如下：

df2gspread/


├── df2gspread/


│   ├── __init__.py


│   ├── df2gspread.py


│   ├── gspread2df.py


│   └── ...


├── tests/


│   ├── __init__.py


│   ├── test_df2gspread.py


│   └── ...


├── setup.py


├── README.md


├── LICENSE


└── ...

目录结构介绍

df2gspread/: 包含项目的主要代码文件。
__init__.py: 初始化文件，使目录成为一个 Python 包。df2gspread.py: 主要功能文件，用于将 Pandas DataFrame 上传到 Google Spreadsheet。gspread2df.py: 主要功能文件，用于从 Google Spreadsheet 下载数据到 Pandas DataFrame。 tests/: 包含项目的测试文件。
__init__.py: 初始化文件，使目录成为一个 Python 包。test_df2gspread.py: 测试文件，用于测试 df2gspread 功能。 setup.py: 用于安装项目的脚本。README.md: 项目说明文档。LICENSE: 项目许可证文件。

2. 项目的启动文件介绍

项目的启动文件主要是 df2gspread.py 和 gspread2df.py。

df2gspread.py

该文件包含将 Pandas DataFrame 上传到 Google Spreadsheet 的功能。主要函数是 upload，使用方法如下：

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)


spreadsheet = '/some/folder/New Spreadsheet'  # 或使用 spreadsheet file id


wks_name = 'New Sheet'


d2g.upload(df, spreadsheet, wks_name)

gspread2df.py

该文件包含从 Google Spreadsheet 下载数据到 Pandas DataFrame 的功能。主要函数是 download，使用方法如下：

from df2gspread import gspread2df as g2d


 


spreadsheet = '/some/folder/New Spreadsheet'  # 或使用 spreadsheet file id


wks_name = 'New Sheet'


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

3. 项目的配置文件介绍

项目的配置文件主要是 setup.py。

setup.py

该文件用于安装项目，使用方法如下：

pip install -U pip setuptools


python setup.py develop  # 开发模式安装


python setup.py install  # 普通安装


pip install df2gspread  # 通过 pip 安装

访问凭证

为了使脚本能够使用 Google Drive API，需要进行身份验证。具体步骤如下：

在浏览器中访问 Google 控制台。选择“创建项目”。输入项目名称并点击“创建”按钮。在左侧菜单中点击“API Manager”。启用“Drive API”。

通过以上步骤，可以生成所需的凭证，以便项目能够访问 Google Spreadsheet。

以上是 df2gspread 项目的教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！

df2gspreadManage Google Spreadsheets in Pandas DataFrame with Python项目地址:https://gitcode.com/gh_mirrors/df/df2gspread