31个版本 (2个稳定版)
1.0.1 | 2024年8月15日 |
---|---|
1.0.0 | 2024年7月25日 |
0.19.5 | 2024年7月15日 |
0.19.2 | 2024年3月15日 |
0.2.0 | 2023年3月24日 |
#657 in 开发工具
每月11,532次下载
在 17 个crate中(12个直接使用)使用
24KB
290 行
Rattler:用于快速处理conda包的Rust crate
Rattler是一个库,它提供了conda生态系统内常用的功能(见:什么是conda & conda-forge?)。该库的目标是使程序和其他库能够轻松地与conda生态系统交互,而不依赖于Python。其主要用例是作为一个库,您可以使用它在自己的工具中提供与conda相关的工作流程。
Rattler是用Rust编写的,并试图提供一个干净的API来访问其功能(见:组件)。考虑到主要目标,我们旨在提供不同语言的绑定,以便于将Rattler集成到非Rust项目中。
Rattler被pixi、rattler-build和https://prefix.dev后端等积极使用。
展示
此仓库还包含一个二进制文件(使用cargo run
尝试),展示了库的一些功能。这是一个从头开始安装包含cowpy
及其所有依赖项的环境的示例(包括Python!)
试试吧!
在开始之前,请确保您具备以下先决条件
按照以下步骤克隆、编译和运行rattler项目
# Clone the rattler repository along with its submodules:
git clone --recursive https://github.com/conda/rattler.git
cd rattler
# Compile and execute rattler to create a JupyterLab instance:
pixi run rattler create jupyterlab
上述命令将在发布模式下执行 rattler
可执行文件。它将下载并安装一个环境到 .prefix
文件夹中,其中包含 jupyterlab
以及运行它所需的全部依赖(例如 python
)。
运行以下命令以启动 jupyterlab。
# on windows
.\.prefix\Scripts\jupyter-lab.exe
# on linux or macOS
./.prefix/bin/jupyter-lab
哇!您已经在系统中安装了可用的 jupyterlab!您当然可以通过这种方式安装任何想要的包。试试吧!
贡献 😍
我们非常希望您能贡献!有关更多信息,请参阅 CONTRIBUTION.md。对于问题、请求或轻松聊天,我们在 discord 服务器上非常活跃。您可以通过此链接加入我们的 discord 服务器。
组件
Rattler 由几个提供不同功能的 crate 组成。
- rattler_conda_types:所有在 conda 生态系统中使用的数据结构的基类型。
- rattler_package_streaming:提供下载、提取和创建 conda 包归档的功能。
- rattler_repodata_gateway:从索引中下载、读取和处理现有 conda 包的信息。
- rattler_shell:用于激活现有环境并在其中运行程序的代码。
- rattler_solve:一个后端无关的库,用于解决包可满足性问题。
- rattler_virtual_packages:一个用于检测系统功能的 crate。
- rattler_index:从本地包创建本地 conda 通道。
- rattler:使用上面的 crate 从头创建完整环境的功能。
- rattler-lock:一个用于创建和解析 conda 环境锁文件的库。
- rattler-networking:网络功能,如身份验证、镜像等。
- rattler-bin:一个使用上述所有 crate 的包管理器的示例(见:展示)。
您可以在 crates
文件夹中找到这些 crate。
此外,我们为上述 crate 提供了大多数功能的 Python 绑定。一个名为 py-rattler
的 Python 包可在 conda-forge 和 PyPI 上找到。Python 绑定的文档可在 此处找到。
什么是 conda & conda-forge?
conda 生态系统提供了跨平台的、二进制包,您可以用任何编程语言使用它们。conda 是一个开源的包管理系统和环境管理系统,可以安装和管理多个版本的软件包及其依赖项。conda 用 Python 编写。Rattler 的目标是提供从 Rust 工作所需的全部 conda 生态系统功能。Rattler 不是 conda
的重实现。conda
是一个包管理工具。Rattler 是一个用于从不同语言和应用程序中与 conda 生态系统工作的 库。例如,它为 https://prefix.dev 的后端提供动力。
conda-forge
是一个社区驱动的努力,旨在将新的和现有的软件带入 conda 生态系统。它提供了由社区贡献者维护的 数以千计的更新 包。有关可用包的概述,请参阅 https://prefix.dev。
依赖项
~1.4–3MB
~66K SLoC