RustPython

查看我们在WebAssembly上运行的在线演示。

RustPython需要锈最新稳定版本（例如2023年2月7日，例如1.67.1）。如果您目前没有在系统上安装Rust，则可以按照Rustup.rs的说明进行操作。

要检查您当前正在运行的Rust版本，请使用Rustc -version。如果您想更新，Rusup Update Stable将更新您的Rust安装到最新的稳定版本。

要在本地构建RustPython ，请首先克隆源代码：

git clone https://*g*it*hub.com/RustPython/ RustPython

RustPython使用符号链接来管理lib/的Python库。如果在Windows上，请运行以下帮助：

git config core.symlinks true

然后，您可以更改为RustPython目录并运行演示（注意： - 需要释放以防止Windows上的堆栈溢出）：

$ cd RustPython
$ cargo run --release demo_closures.py
Hello, RustPython !

或使用交互式外壳：

$ cargo run --release
Welcome to RustPython
>>>>> 2+2
4

注意：对于Windows用户，请将RustPython Path环境变量设置为项目目录中的LIB路径。 （例如，当RustPython目录为C时：\ RustPython ，将RustPython路径设置为C：\ RustPython \ lib）

您还可以使用以下内容安装和运行RustPython ：

$ cargo install --git https://*g*it*hub.com/RustPython/ RustPython RustPython
$ RustPython
Welcome to the magnificent Rust Python interpreter
>>>>>

如果您想提出HTTPS请求，则可以启用SSL功能，这也使您可以安装PIP软件包管理器。请注意，在Windows上，您可能需要安装OpenSSL，也可以启用SSL-dendor功能，该功能为您编译OpenSSL，但需要C编译器，Perl和Make。 OpenSSL版本3是可以预期的，并在CI中进行了测试。较旧的版本可能行不通。

一旦安装了SSL支持的RustPython ，您可以通过运行安装PIP：

cargo install --git https://*g*it*hub.com/RustPython/ RustPython --features ssl
RustPython --install-pip

您也可以通过Conda软件包管理器安装RustPython ，尽管这不是正式支持，并且可能已经过时了：

conda install RustPython -c conda-forge
RustPython

您可以将RustPython编译到独立的WebAssembly WASI模块中，以便它可以在任何地方运行。

建造

cargo build --target wasm32-wasip1 --no-default-features --features freeze-stdlib,stdlib --release

由Wasmer经营

wasmer run --dir ` pwd ` -- target/wasm32-wasip1/release/ RustPython .wasm ` pwd ` /extra_tests/snippets/stdlib_random.py

由WAPM运营

$ wapm install RustPython
$ wapm run RustPython
>>>>> 2+2
4

您可以使用以下方式构建WebAssembly WASI文件

cargo build --release --target wasm32-wasip1 --features= " freeze-stdlib "

注意：我们使用Freeze-STDLIB在二进制中包括标准库。一旦Rusup Target添加WASM32-WASIP1，您还必须运行。

RustPython有一个非常实验性的JIT编译器，该编译器将Python的功能编译到本机代码中。

默认情况下，未启用JIT编译器，它已使用JIT货物功能启用。

cargo run --features jit

这需要安装AutoConf，Automake，Libtool和Clang。

要编译函数，请在其上调用__jit __（）。

 def foo ():
    a = 5
    return 10 + a

foo . __jit__ ()  # this will compile foo to native code and subsequent calls will execute that native code
assert foo () == 15 

有兴趣在用Rust编写的应用程序中揭露Python脚本，也许是为了快速调整Rust的编译时间会抑制的逻辑？然后示例/hello_embed.rs和示例/mini_repl.rs可能会有所帮助。

RustPython正在开发中，虽然口译员肯定可以在有趣的用例中使用，例如在WASM中运行Python并嵌入Rust Project，但请注意， RustPython并未完全准备好生产。

贡献非常欢迎！有关此信息的更多信息，请参见我们的贡献部分。

结帐有关会议的谈话：

• Fosdem 2019
• Europython 2018

尽管RustPython是一个相当年轻的项目，但一些人使用它来制作很酷的项目：

• GREPTIMEDB：开源，云原生，分布式时间序列数据库。使用RustPython进行嵌入式脚本。
• Pyckitup：用Rust编写的游戏引擎。
• 机器人隆隆声：基于竞技场的AI竞赛平台
• ruff：一个非常快的python linter，用锈蚀写

• 完整的Python-3环境完全在生锈（不是Cpython绑定）中
• 没有兼容性黑客的清洁实现

目前与项目的其他领域一起，文档仍处于早期阶段。

您可以阅读在线文档以获取最新版本或用户指南。

您还可以通过运行在本地生成文档：

cargo doc # Including documentation for all dependencies
cargo doc --no-deps --all # Excluding all dependencies

然后可以在目标/DOC目录中找到文档HTML文件，也可以附加到以前的命令上，以在默认浏览器上自动打开文档。

有关组件的高级概述，请参见架构文档。

贡献非常受欢迎，在许多情况下，我们很乐意通过PRS或Discord指导贡献者。请参阅《开发指南》，以获取有关开发的提示。

考虑到这一点，请注意此项目由志愿者维护，一些最好的入门方法如下：

大多数任务在问题跟踪器中列出。如果您想开始编码，请检查标有良好第一期的问题。

为了增强CPYTHON的兼容性，请尝试通过检查本文来增加UNITSEST覆盖范围：如何为Cpython Unittest贡献RustPython

另一种方法是检查源代码：内置功能和对象方法通常是最简单，最简单的贡献方法。

您也可以简单地运行Python -i whats_left.py来帮助查找任何未完成的方法。

请参阅此文档

在不和谐上与我们聊天。

我们的行为守则可以在这里找到。

最初的工作是基于Windelbouwman/ rspython和Shandeu/ RustPython

这些是与相关项目的一些有用链接：

• https://gith*u*b.co*m/progval/pythonvm-rust
• https://g*ith**ub.com/shinglyu/rustpython
• https://gi*thu*b.c*om/windelbouwman/rspython

该项目已根据MIT许可获得许可。请参阅许可证文件以获取更多详细信息。

该项目徽标已根据CC-BY-4.0许可获得许可。有关更多详细信息，请参见许可证文件。