
Datasette Lite 用 Service Worker 重写,可在浏览器运行完整服务端应用
来源标题:Running the full server-side Datasette Python app in the browser with service workers and Pyodide
Datasette 作者 Simon Willison 用 service workers 完全重写了 Datasette Lite,使其在浏览器中运行的效果几乎与真正的服务端应用无异。新版通过 lite.datasette.io 的特定 URL 可加载 SQLite、JSON、CSV 等数据,选择 Datasette 版本、GitHub 分支或提交,从 100 多个 SQLite 版本中挑选,并安装 PyPI 插件。
以下正文由 AI 翻译自 Simon Willison(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Datasette Lite 是我将 Datasette Python 应用移植到浏览器中直接运行的版本,基于 WebAssembly 和 Pyodide 实现。我发布了一个使用 service worker 完全重写的 Datasette Lite,现在它几乎与真正的服务端应用没有区别。
现在,你可以通过精心构造的 URL 访问 lite.datasette.io,完成以下所有操作:
- 加载客户端 Datasette,浏览任意 SQLite 数据库、JSON 文件、CSV 文件或 SQL 脚本
- 从 PyPI 选择加载某个已发布的 Datasette 版本
- 从 Datasette GitHub 仓库加载特定的 commit、tag 或分支名
- 从 100 多个 SQLite 版本中选择一个与 Datasette 配合使用
- 从 PyPI 或 wheel 文件 URL 安装额外的 Datasette 插件,包括 JavaScript 可视化工具
能够加载特定的 Datasette 引用、插件和 SQLite 版本,使得它成为一个极佳的工具,可以用来链接到进行中功能或 bug 复现的演示,而无需启动一个完整的 Web 服务器来提供该演示。
举个例子,考虑以下 URL: https://lite.datasette.io/?install=datasette-maplibre&url=https://gist.githubusercontent.com/simonw/39fa5d399465766039549912e2b3d291/raw/f6dfba99a75cbb8b5d9386223220eb52272767ee/demo.db&metadata=https://gist.githubusercontent.com/simonw/39fa5d399465766039549912e2b3d291/raw/f6dfba99a75cbb8b5d9386223220eb52272767ee/metadata.yml#/demo/capitals_and_countries%23map=0/4.2/180&color=continent 打开该链接,经过短暂的加载界面后,你会看到一个类似这样的页面: 这是 Datasette 运行着新的 datasette-maplibre 插件,加载了一个包含各国 GeoJSON 形状的数据库,并在表格中同时显示了一张组合地图和各个边界地图。 让我们拆解一下这个 URL,看看它在做什么:
https://lite.datasette.io/
?install=datasette-maplibre
&url=https://.../demo.db
&metadata=https://.../metadata.yml
#/demo/capitals_and_countries%23map=0/4.2/180&color=continent
?install=datasette-maplibre 会从 PyPI 安装该额外插件。你可以根据需要多次传入 &install=... 来加载更多插件。
&url=https://.../demo.db 会从提供的 URL 加载该 SQLite 数据库。这些 URL 需要具有开放的 CORS 头——我把这类文件托管在 Gist 上,因为 Gist 提供了一种简单的方式,让 Web 托管的文件具有开放的 CORS 头。
&metadata=https://.../metadata.yml 会加载这个 metadata.yml 文件。该 metadata 文件为各个表以及 Datasette 首页添加了 HTML 描述。访问该首页可以查看该插件其他功能的引导介绍,这些功能全部在 metadata 文件中定义。
#/demo/capitals_and_countries%23map=0/4.2/180&color=continent 是一个片段哈希,会转换为 Datasette 内的一个位置——这里它会加载 /demo/capitals_and_countries SQL 视图,然后向其追加另一个片段哈希(%23 是 URL 编码的 #),告诉地图插件缩放到特定位置,并根据数据中的 continent 列设置地图上形状的颜色。
那个 URL 做了很多工作!去年我在 URL-addressable Pyodide Python environments 一文中,更详细地写了这种构建 URL 可寻址软件的技巧。
支持的完整 URL 参数集合在 Datasette Lite README 中有描述。
我已经开始将 Datasette Lite 作为 Datasette 开发流程的一部分来使用。这里有一个最近描述分页 bug 的 issue——我在那里发表了一条评论,用 Datasette Lite 的链接演示了旧的、有问题的行为以及新的修复:
该 bug 的演示:https://lite.datasette.io/?ref=1.0a42&sql=https://gist.github.com/simonw/75ececf61d50e6e8d50f0c150150ee81#/data/scores?_size=2&_sort=score ——点击下一页,第二页是空的。
这是同一个页面在 bug 修复后的效果(运行在 1.0a43 上):https://lite.datasette.io/?ref=1.0a43&sql=https://gist.github.com/simonw/75ececf61d50e6e8d50f0c150150ee81#/data/scores?_size=2&_sort=score
这是如何工作的,使用 service worker
Datasette Lite 并不是一个新项目。我在 2022 年发布了第一个版本,最初多少有点玩笑性质(在浏览器中运行服务端应用相当有趣),但它很快就开始证明了自己的价值。 最初那个版本的问题在于它是一个 hack。它的工作方式是在一个 Pyodide web worker 中运行 Datasette,通过该技术栈模拟请求,然后使用 innerHTML 将生成的 HTML 注入回顶层页面。 这对基本的 Datasette 有效,但意味着任何使用 JavaScript 的功能都无法工作,因为 innerHTML 中的 script 标签不会执行,而且它使用的 web worker 技巧也无法加载额外的 JavaScript 或 CSS 文件。 新版本采用了基于 Service Worker 的完全不同的方法。Service Worker 允许 JavaScript 拦截对新页面和资源的 HTTP 请求,并从客户端代码中提供响应。 Datasette Lite 为整个 lite.datasette.io 域注册了一个 service worker。然后父页面创建一个 iframe,将 Datasette 页面的请求发送到如下形式的 URL:
/app/aa94e6851595/ # 首页 (HTML)
/app/aa94e6851595/data/places # 表格页面 (HTML)
/app/aa94e6851595/-/static/navigation-search.js # (JavaScript)
/app/aa94e6851595/-/static/app.css # (CSS)
这些是常规的 Datasette URL,但带有 /app/aa94e6851595/ 前缀。这是怎么回事?
/app// 前缀是必要的,因为有多个标签页。
考虑上面的 URL,它加载了带有 datasette-maplibre 插件的演示实例。该 URL 定义了一个完整的、自定义的 Datasette 实例。你可能在一个标签页中运行着那个实例,然后在另一个标签页中运行我的另一个演示链接。
lite.datasette.io 的 service worker 在所有那些标签页之间共享。如果它路由到单个 Datasette 实例,那么每个标签页都会共享那个底层实例,无论它们的 URL 试图配置什么插件或其他设置。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。