依赖项

依赖项在 pyproject.toml 中声明，但是使用 rye add 命令可以简化添加过程。在最简单的调用中，它添加了一个常规依赖项，但可以进行自定义。

添加基本依赖项

要添加一个常规依赖项，只需使用 Python 包的名称调用 rye add

rye add Flask

如果你还想要定义一个版本，可以使用 PEP 508 需求

rye add "Flask>=2.0"

对于额外/特性依赖项，你可以使用 PEP 508 语法或使用 --features

rye add "Flask[dotenv]"
rye add Flask --features=dotenv

这些依赖项存储在 project.dependencies 中。

关于预发布版本的说明

默认情况下，add 不会考虑预发布版本。这意味着，如果你添加一个依赖项，它的版本号中包含 .dev 或类似的字符，你将无法找到匹配项。要考虑它们，请使用 --pre 添加它们

rye add "Flask==2.0.0rc2" --pre

开发依赖项

对于仅在开发期间安装的依赖项，请传递 --dev

rye add --dev black

这些依赖项存储在非标准的 tool.rye.dev-dependencies 键中。

要运行以这种方式添加的工具，而不启用虚拟环境，请使用 rye run

rye run black

Git / 本地依赖项

要添加本地或 git 依赖项，你可以传递其他参数，如 --path 或 --git

rye add Flask --git=https://github.com/pallets/flask
rye add My-Utility --path ./my-utility

请注意，在添加此类依赖项时，还需要提供包的名称。此外，对于 git 依赖项，所有类型的额外参数，如 --tag、--rev 或 --branch 都受支持。

在使用本地依赖项时，强烈建议配置一个 工作区。