用法
查看我们在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上的堆栈溢出):
RustPython
$ cargo run –release demo_closures.py
Hello, RustPython !\”>
$ cd RustPython $ cargo run --release demo_closures.py Hello, RustPython !
或使用交互式外壳:
RustPython
>>>>> 2+2
4\”>
$ cargo run --release Welcome to RustPython >>>>> 2+2 4
注意:对于Windows用户,请将RustPython Path环境变量设置为项目目录中的LIB路径。 (例如,当RustPython目录为C时:\\ RustPython ,将RustPython路径设置为C:\\ RustPython \\ lib)
您还可以使用以下内容安装和运行RustPython :
RustPython
$ RustPython
Welcome to the magnificent Rust Python interpreter
>>>>>\”>
$ 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:
RustPython –features ssl
RustPython –install-pip\”>
cargo install --git https://*g*it*hub.com/RustPython/ RustPython --features ssl RustPython --install-pip
您也可以通过Conda软件包管理器安装RustPython ,尽管这不是正式支持,并且可能已经过时了:
RustPython -c conda-forge
RustPython \”>
conda install RustPython -c conda-forge RustPython
Wasi
您可以将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运营
RustPython
$ wapm run RustPython
>>>>> 2+2
4\”>
$ wapm install RustPython $ wapm run RustPython >>>>> 2+2 4
构建WASI文件
您可以使用以下方式构建WebAssembly WASI文件
cargo build --release --target wasm32-wasip1 --features= \" freeze-stdlib \"
注意:我们使用Freeze-STDLIB在二进制中包括标准库。一旦Rusup Target添加WASM32-WASIP1,您还必须运行。
JIT(及时)编译器
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
将RustPython嵌入您的生锈应用
有兴趣在用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来帮助查找任何未完成的方法。
编译到WebAssembly
请参阅此文档
社区
在不和谐上与我们聊天。
行为守则
我们的行为守则可以在这里找到。
信用
最初的工作是基于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许可获得许可。有关更多详细信息,请参见许可证文件。
