
Pyr.js 发布:用一个 script 标签在 HTML 页面中直接运行 Python 和 R 代码
来源标题:Pyr.js: Python and R in HTML pages, with one script tag
开发者发布 pyr.js,可在 HTML 页面中直接嵌入并运行 Python 和 R 代码,无需服务器、构建步骤或安装,全部在浏览器本地执行。该工具由 Claude 编写代码与测试,底层依赖 Pyodide 和 webR,自身约 460 行,负责识别页面中的 Python/R 代码并与 HTML 元素连接。示例中通过 py-click、py-out 等属性即可让按钮触发 Python 代码并将结果输出到指定元素。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
如果能把 Python 或 R 代码放进 HTML 页面里,双击文件就能运行,会怎么样?不需要服务器,不需要构建步骤,不需要安装,也不向任何地方发送数据:一切都在浏览器里运行。这就是 pyr.js 做的事。这周我用 Claude(Anthropic 的 AI 助手)把它做了出来——它根据我的设计决策编写了代码和测试,并在无头浏览器里验证了一切。繁重的工作由 Pyodide(编译成 WebAssembly 的 Python)和 webR(R 的同类方案)完成。pyr.js 是粘合剂:单个文件,大约 460 行,你确实读得懂,它会找出页面里的 Python 和 R 代码,并把它们与你的 HTML 连接起来。
第一个例子
把下面内容保存为 .html 文件,然后在浏览器中打开:
<script src"https://cdn.jsdelivr.net/gh/Techtonique/pyr.js@v0.1.0/pyr.js"></script>
<p id"count">count 0</p> <button py-click"add_one()" py-out"count">Add</button>
<script type"text/python"> count 0
def add_one(): global count count + 1 return f"count {count}" </script>
py-click 会在按钮被点击时运行 Python,py-out 指明结果放到哪里。任何 DOM 事件都以同样的方式工作(py-input、py-change……),对 R 来说则是 r-click、r-input 等等。R 的打印输出和图形会直接显示在页面里:
<label>Points: <input type"range" min"10" max"500" value"100" r-input"hist(rnorm(as.numeric(.value)))" r-out"plot"></label> <div id"plot"></div>
这里,.value(在 Python 中是 _value)保存滑块的当前值,直方图会随着你拖动滑块而重绘。
Python 和 R 负责计算,JavaScript 负责绘制
我最喜欢的部分:结果可以作为数据传给任何 JavaScript 图表库。在之前的一篇文章里,我用 Observable Plot 和 Highcharts 做过仪表盘。借助 pyr.js,py-then / r-then 会把结果交给你指定的函数。R 的 data frame 会以行数组的形式到达,可以直接用于绘图:
<script src"https://cdn.jsdelivr.net/npm/d3@7.9.2/dist/d3.min.js"></script> <script src"https://cdn.jsdelivr.net/npm/@observablehq/plot@0.6.19/dist/plot.umd.min.js"></script> <script src"https://cdn.jsdelivr.net/gh/Techtonique/pyr.js@v0.1.0/pyr.js"></script> <script> function draw(rows, el) { el.replaceChildren(Plot.dot(rows, { x: "wt", y: "mpg", stroke: "cyl" }).plot()); } </script>
<script type"text/r"> cars <- function() { d <- mtcars d$cyl <- factor(paste(d$cyl, "cylinders"))
factors arrive as text
d } </script>
<div r-ready"cars()" r-then"draw" r-out"chart"></div> <div id"chart"></div>
Python 也一样:dict 列表、numpy 数组和 pandas DataFrame 都会为你转换。下面是仓库里的 Observable Plot 例子,包含一个 Python 随机游走(由滑块触发重绘)以及上面的 R data frame:
它有多快?
首次访问会下载引擎(Python 有好几 MB,之后由浏览器缓存),启动 Python 大约需要 3 秒。到目前为止没什么神奇的。
有意思的部分在于:当 pyr.js 与你的页面托管在同一个站点时,Python 会运行在一个 shared worker 中。该站点的其他标签页,甚至页面刷新,都会复用已经在运行的解释器:在我的测试(Chromium)中,页面在不到 0.1 秒内就绪,而不是 3 秒。每个标签页仍然有自己的变量,刷新也仍然会让页面从头开始。对 R 来说,webR 还不允许这样做,所以它每次打开页面都会重新启动。
开发时还有一种实时编辑模式:把你的 Python 代码放在 .py 文件里,在 script 标签上加 data-watch,保存后改动就会应用到正在运行的页面,无需重新加载。
隐私
pyr.js 不向任何地方发送数据。没有分析统计,没有遥测:你的代码和数据都留在访问者的浏览器里。唯一的网络请求是获取引擎本身,以及你的代码所导入的包。
试试看
仓库在 GitHub 上(MIT 许可证),有四个示例:基础用法、Observable Plot、Highcharts 和实时编辑。README 解释了其余内容(属性、数据转换、自托管引擎、用 integrity hash 固定版本)。欢迎反馈、提交 issue 和 star!
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。