保存 PyScript REPL 会话代码的策略与实践

本文详细介绍了如何在 pyscript 的 `py-repl` 环境中获取用户输入的 python 代码。我们将探讨两种主要方法:一是利用 `py-repl` 元素的内部 `getpysrc()` 方法,该方法直接获取当前 repl 中的所有代码;二是利用 pyscript 新版本中引入的插件钩子 `beforepyreplexec()` 和 `afterpyreplexec()`,通过其 `src` 参数实现更精细的代码执行跟踪。这些方法对于需要保存、提交或分析用户在 repl 中编写的代码场景至关重要。

在交互式编程环境中,尤其是在教学或在线代码评估场景中,捕获用户在 REPL(Read-Eval-Print Loop)中输入的代码内容是一项核心需求。PyScript 的 py-repl 组件提供了一个便捷的浏览器内 Python REPL,但其原生设计并未直接暴露一个官方 API 来获取完整的会话代码。然而,通过一些现有机制和即将推出的功能,我们可以有效地实现这一目标。

方法一:利用 py-repl 元素的 getPySrc() 方法

py-repl 元素内部提供了一个名为 getPySrc() 的方法,它能够获取当前 REPL 中所有已输入的 Python 代码内容。尽管这在当前被视为一个实现细节而非官方公共 API,但它在实践中表现出相当的稳定性,并且社区已经有关于将其提升为官方 API 的讨论和跟踪(例如,在 PyScript 的 GitHub 议题 #954 中)。

工作原理: 当用户在 py-repl 元素中输入多行代码后,调用 getPySrc() 方法会返回一个字符串,其中包含所有这些代码行,通常以换行符分隔。

示例代码:

假设您的 HTML 页面中有一个 py-repl 元素:




    
    
    PyScript REPL 会话保存
    
    


    

PyScript REPL 代码捕获示例