本文详细介绍了如何在 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 元素：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>PyScript REPL 会话保存</title>
<link rel="stylesheet" href="https://pyscript.net/latest/pyscript.css" />
<script defer src="https://pyscript.net/latest/pyscript.js"></script>
</head>
<body>
<h1>PyScript REPL 代码捕获示例</h1>
<py-repl id="my-repl" auto-create></py-repl>
<button onclick="saveReplContent()">保存 REPL 内容</button>
<pre id="output-area"></pre>
<script>
function saveReplContent() {
const replElement = document.getElementById('my-repl');
if (replElement && typeof replElement.getPySrc === 'function') {
const replCode = replElement.getPySrc();
document.getElementById('output-area').textContent = "捕获到的代码:\n" + replCode;
console.log("捕获到的 REPL 代码:", replCode);
// 在这里可以将 replCode 发送到后端、保存到本地文件或集成到其他服务
} else {
document.getElementById('output-area').textContent = "错误: 无法获取 REPL 元素或 getPySrc() 方法不存在。";
console.error("无法获取 REPL 元素或 getPySrc() 方法不存在。");
}
}
</script>
</body>
</html>在上述示例中，当用户点击“保存 REPL 内容”按钮时，JavaScript 函数 saveReplContent() 会获取 ID 为 my-repl 的 py-repl 元素，并调用其 getPySrc() 方法来提取用户输入的 Python 代码。这些代码随后会被显示在一个 <pre> 标签中，并且打印到控制台。
注意事项：
- 此方法获取的是 REPL 中当前可见的所有代码，不区分是否已执行。
- 由于 getPySrc() 是内部实现，未来版本可能会有变动，但其稳定性较高。
方法二：利用 PyScript 插件钩子 (beforePyReplExec, afterPyReplExec)
PyScript 的新版本（例如，从 Release Candidate 2 及更高版本）引入了强大的插件机制，其中包括 beforePyReplExec() 和 afterPyReplExec() 这两个钩子。这些钩子在 py-repl 中的 Python 代码执行之前和之后被调用，并且它们接收的参数中包含即将执行或刚刚执行的源代码 (src)。
工作原理： 通过创建一个自定义 PyScript 插件，并实现这两个钩子，您可以在每次 REPL 单元格执行时捕获其对应的源代码。这允许您实现更精细的控制，例如记录每次执行的代码块、跟踪执行历史或进行实时代码分析。
插件钩子参数：beforePyReplExec() 和 afterPyReplExec() 接收的参数包括：
- src: 当前 REPL 单元格中即将执行（或已执行）的 Python 源代码字符串。
- repl: 对应的 py-repl 元素实例。
- 其他上下文信息。
概念性示例（需要 PyScript 插件知识）：
要使用此方法，您需要创建一个 PyScript 插件。以下是一个概念性的插件代码片段，展示如何捕获 src：
# my_pyscript_plugin.py
from pyscript import document
class MyReplTracker:
def __init__(self):
self.executed_code_history = []
def beforePyReplExec(self, repl, src, **kwargs):
print(f"即将执行的代码: {src}")
# 可以在此处对代码进行预处理或记录
pass
def afterPyReplExec(self, repl, src, **kwargs):
print(f"已执行的代码: {src}")
self.executed_code_history.append(src)
# 可以在此处将 src 发送到后端或更新 UI
# 例如，将历史记录显示在页面上
output_elem = document.getElementById("executed-code-history")
if output_elem:
output_elem.innerText = "\n".join(self.executed_code_history)
# 注册插件
pyscript.plugins.register("repl-tracker", MyReplTracker())然后，在您的 HTML 中，您需要加载此插件并使用 py-repl：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>PyScript 插件代码捕获</title>
<link rel="stylesheet" href="https://pyscript.net/latest/pyscript.css" />
<script defer src="https://pyscript.net/latest/pyscript.js"></script>
<py-config>
[[plugins]]
src = "./my_pyscript_plugin.py"
</py-config>
</head>
<body>
<h1>PyScript 插件代码捕获示例</h1>
<py-repl id="my-repl" auto-create></py-repl>
<h3>执行历史:</h3>
<pre id="executed-code-history"></pre>
</body>
</html>在这个插件示例中，afterPyReplExec 钩子将每次执行的 REPL 单元格代码添加到 executed_code_history 列表中，并更新页面上的显示区域。这提供了一种跟踪用户每次输入并执行代码的强大机制。
注意事项：
- 此方法要求 PyScript 版本支持插件机制。请查阅 PyScript 官方文档以确认版本兼容性。
- 实现插件需要对 PyScript 的插件开发流程有一定的了解。
- 这种方法捕获的是每次执行的单个代码块，而不是整个 REPL 会话的累积内容，除非您在插件中手动积累。
总结与选择
选择哪种方法取决于您的具体需求：
- 如果需要获取 py-repl 中所有可见的、用户输入的代码（不区分是否已执行），并且对版本兼容性要求不高，或者需要一个快速简单的解决方案， 那么 getPySrc() 方法是首选。它直接、简洁，并且在当前 PyScript 版本中表现稳定。
- 如果需要精确地跟踪每次 REPL 单元格的执行，捕获每次执行的代码块，或者需要更深入地集成自定义逻辑（例如，在代码执行前后进行验证、转换或记录）， 那么 PyScript 的插件钩子 beforePyReplExec() 和 afterPyReplExec() 是更强大、更具扩展性的选择。这适用于需要构建复杂交互或教学系统的场景，但需要 PyScript 新版本支持并涉及插件开发。
无论选择哪种方法，捕获到的代码字符串都可以进一步处理，例如发送到后端服务器进行存储、集成到学生作业提交系统（如 Google Classroom）、或者进行代码分析。理解这些机制将帮助您更好地利用 PyScript 构建功能丰富的 Web 应用程序。
