Tabular Preview

一个用于使用tabular-api预览表格文件（CSV、Excel ...）的插件

使用方法

在您的udata环境中安装插件包

pip install udata-tabular-preview

然后在您的udata.cfg中激活它

PLUGINS = ['tabular']

配置

您可以使用以下udata.cfg参数控制此插件的行为

• TABULAR_API_URL: 到您的tabular-api实例的URL（不带尾部斜杠）。示例： https://my.tabular.api
• TABULAR_EXPLORE_URL: 到您的explore实例的URL（不带尾部斜杠）。示例： https://my.explore
• TABULAR_ALLOW_REMOTE: 是否允许远程资源预览。默认值是True
• TABULAR_PAGE_SIZE: 获取数据页面大小。默认为5

开发

JS依赖项

使用以下方式安装JS依赖项

npm install

然后您可以使用以下方式打包这些资源

inv assets-watch

（您可能需要在拉取上游更改后重新启动这些命令）。

您可以使用以下方式构建生产就绪的JS和CSS资产版本

inv assets-build

修改此插件后，您应使用以下方式提取vue-i18n语言文件

inv i18n

Python 依赖项

假设您在一个已安装 udata 的活跃虚拟环境中，并且位于当前项目的克隆仓库目录中，使用以下命令安装所有依赖项：

pip install -e requirements/develop.pip

（在拉取上游更改时可能需要重新启动此命令）。

测试

测试位于 tests 文件夹中，可以使用以下命令运行：

inv test

质量

代码必须通过 Flake 8 验证，README 应与 PyPI 兼容。您可以使用以下命令检查这两个条件：

inv qa

变更日志

4.0.1 (2024-10-03)

• 移除无用的最大尺寸设置 #41
• 改进探索按钮逻辑 #43

4.0.0 (2024-05-06)

• :warning: 将 udata-tabular-preview 连接到表格 API 并弃用 csvapi #33
• 根据 udata 依赖项升级迁移到 Python 3.11 #35
• 如果解析失败，则不显示预览 #36
• 显示预览的最新日期 #37
• 在 dist 中将长描述内容类型设置为 markdown #39
• 在 PyPI 上发布 .dev 版本 #40

4.0.0 (2024-03-22)

• 将预览与 hydra 连接并移除 csvapi + 预览样式 #32 当前（进行中）
• 使用来自包 @etalab/data.gouv.fr-components 的分页 #34

3.1.0 (2024-01-23)

• 使用分析或标题检查 MIME #32

3.0.4 (2024-01-09)

• 在 CI 中更新 mongoDB #25
• 在检查：headers 之上使用分析额外内容 #30

3.0.3 (2023-03-07)

• 在静态中指定版本 #27
• 添加 Python 翻译逻辑 #26

3.0.2 (2023-03-02)

• 为钩子 dataset.display.explore-button 添加数据结构组件和探索按钮 #19

3.0.1 (2023-02-06)

• 为探索预览组件添加排序 #20
• 修复 CI 中使用的 setuptools 版本 #23
• 为探索预览组件添加分页 #21

3.0.0 (2023-01-18)

• :warning: 重大更改 改变预览行为 #14
  • 移除 preview 路由
  • 添加探索预览 Vue 组件
  • 添加可探索资源元数据
• 在 CI 中替换 mongo 旧版镜像 #13
• 将 json5 更新以修复 CVE-2022-46175 #16

2.0.3 (2022-07-11)

• 移除旧版清单逻辑和数据探索集成 #12

2.0.2 (2020-10-16)

• 为 SUPPORTED_MIME_TYPES 添加设置 #9

2.0.1 (2020-06-17)

• 使用额外属性来启用预览 #8

2.0.0 (2020-03-11)

• 迁移到 Python3 #5

1.0.0 (2018-10-02)

初始发布