跳转到主要内容

Google Visualization的Python API

项目描述

Gviz Data Table是一个简单的Python库,用于将Python数据类型转换为Google Visualization Data Table JSON格式。https://developers.google.com/chart/interactive/docs/reference

Google Visualization库本身是一个JavaScript库,它提供了在几乎所有浏览器中工作的交互式图表。这些库涵盖了大多数用例,包括表格和图表,因此您可以使用相同数据的图表和表格。

Gviz Data Table主要用于与数据库等数据源一起使用。使用应该是最小的:您提供模式,即列列表和数据行。列必须有一个名称和Python数据类型。它还可以有一个标签,该标签将用于显示,否则将使用名称。

每一行都是一个单元格序列。尽管列是显式的,行名称始终是行的第一个单元格。像列一样,单元格也可以有标签。Gviz Data Table将对每个单元格进行验证,以确保数据符合模式中指定的类型,并将Python类型映射到它们的JSON等效类型,但它不会强制转换任何数据,即如果列类型为并且单元格数据是只包含数字字符的字符串,这仍将引发异常。

Gviz 数据表只处理数据转换。您需要将必要的 JavaScript 添加到网页中,以便绘制任何图表或表格。表格、列和单元格都可以有选项,这些选项只是字典。因为没有进一步定义选项,所以不会对它们的项进行验证。未知项将被简单地忽略。

Gviz 数据表由以下部分组成:一个容器类 Table;两个数据类,CellColumn,以及一个 JSON 编码器。应用程序代码可能只需要使用 Table 和编码器。

使用方法

可以使用模式初始化表格,或者可以强制添加。一旦向表格中添加了一行,就不能再添加更多列。一旦添加了所有行,就可以使用编码器将表格转换为 JSON。

示例

假设我们有代表人员姓名和工资的数据

姓名

工资

Jim

50

Bob

80

这可以用 Gviz 数据表这样编写

from gviz_data_table import Table

table = Table()
table.add_column('name', str, "Name")
table.add_column('salary', int, "Salary")
table.append(["Jim", 50])
table.append(["Bob", 80])

可以使用编码器将其编码为 JSON

from gviz_data_table import encode

encode(table)

也可以直接编码

table.encode()

并且可以直接作为 JavaScript 的静态数据源用于异步加载

table.source()

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分发

gviz_data_table-2.0.0.tar.gz (11.2 kB 查看散列)

上传时间

构建分发

gviz_data_table-2.0.0-py2.py3-none-any.whl (11.3 kB 查看散列)

上传时间 Python 2 Python 3

支持者