PyScript

PyScript 是什么

摘要

PyScript 是一个框架，允许用户使用 HTML 接口和 Pyodide、MicroPython 以及 WASM 的能力，结合现代 Web 技术在浏览器中创建丰富的 Python 应用程序。

要开始使用，请参阅 PyScript 入门教程。

示例请查看这里。

其他有用的资源：

官方技术文档。
我们当前的网络主页。
用于尝试 PyScript 的免费在线编辑器。
我们的社区 Discord 频道，保持联系。

每周二 15:30 UTC 在 Zoom 上有 PyScript 社区通话，我们可以公开讨论 PyScript 的开发。大多数维护者都定期参与通话，欢迎所有人加入。

每隔一周的周四 16:00 UTC 有 PyScript FUN 通话：这是一个鼓励每个人展示他们用 PyScript 做了什么的通话。

有关如何加入通话和最新日程的更多详情，请查阅官方日历：

UTC 时间的 Google 日历；
iCal 格式。

详细版本

PyScript 是一个元项目，旨在将多种开放技术结合成一个框架，使用户能够用 Python 创建复杂的浏览器应用程序。它与浏览器中 DOM 的工作方式无缝集成，允许用户以对 Web 开发人员和 Python 开发人员都感觉自然的方式添加 Python 逻辑。

尝试 PyScript

要尝试 PyScript，请在 HTML 页面的 <head> 标签中导入适当的 pyscript 文件：

<head>
    <link
        rel="stylesheet"
        href="https://pyscript.net/releases/2024.6.2/core.css"
    />
    <script
        type="module"
        src="https://pyscript.net/releases/2024.6.2/core.js"
    ></script>
</head>
<body>
    <script type="py" terminal>
        from pyscript import display
        display("Hello World!") # 这会显示在 DOM 中
        print("Hello terminal") # 这会显示在终端中
    </script>
</body>

然后，您可以在 HTML 页面中使用 PyScript 组件。PyScript 目前提供了多种运行 Python 代码的方式：

<script type="py">：可用于定义在网页中可执行的 Python 代码。
<script type="py" src="hello.py">：与上面相同，但 Python 源代码从给定的 URL 获取。
<script type="py" terminal>：与上面相同，但还创建一个终端来显示标准输出和标准错误（例如，print() 的输出）；input() 不起作用。
<script type="py" terminal worker>：在 Web Worker 中运行 Python：终端功能完整，input() 可以工作。
<py-script>：与 <script type="py"> 相同，但不推荐使用，因为如果代码包含 HTML 标签，可能会被错误解析。
<script type="mpy">：与上面相同，但使用 MicroPython 而不是 Python。

查看官方文档以获取更详细的文档。

如何贡献

阅读贡献指南，了解我们的开发过程、报告 bug 和改进、创建问题和提出问题。

查看开发过程文档，了解如何设置开发环境的更多信息。

治理

PyScript 组织治理在单独的存储库中有文档记录。

发布

要发布 PyScript 的新版本，只需添加一个新版本，记得写一个全面的更新日志。一个 GitHub 操作将启动，确保版本被描述并部署到以下模式的 URL：https://pyscript.net/releases/YYYY.M.v/（年/月/版本 - 按照我们的 CalVer 版本方案）。

然后，需要更新以下三个单独的存储库：

文档 - 更改目录根目录中的 version.json 文件，然后运行 node version-update.js。
主页 - 确保 index.html 中引用的版本是最新版本。
PSDC - 使用 Discord 或 Anaconda Slack（如果您在 Anaconda 工作）让 PSDC 团队知道有新版本，以便他们可以更新项目模板。