添加

将 Python 包添加到此项目中。该命令接受一个 PEP 508 需求字符串，但提供额外的辅助参数，使此过程更易于使用。例如，而不是在需求字符串中传递 git 引用，可以使用 --git 参数。

如果自动同步被禁用，则在添加依赖项后不会自动安装它。要执行此操作，您需要调用 sync 命令或传递 --sync。要再次移除依赖项，请使用 remove 命令。

新功能在 **0.26.0** 中

添加了对自动同步和 --sync / --no-sync 标志的支持。

示例

添加与配置的 Python 版本兼容的最新版本的依赖项

$ rye add flask
Added flask>=3.0.1 as regular dependency

添加依赖项，但添加可选的额外功能

$ rye add flask --features dotenv
Added flask[dotenv]>=3.0.1 as regular dependency

添加 git 依赖项

$ rye add flask --git https://github.com/pallets/flask
Added flask @ git+https://github.com/pallets/flask as regular dependency

添加本地依赖项

$ rye add packagename --path path/to/packagename
Added packagename @ file:///path/to/packagename as regular dependency

参数

• <REQUIREMENTS>...: 要添加的包作为 PEP 508 需求字符串。例如 'flask==2.2.3'

选项

• --git <GIT>: 从此 git 仓库安装给定的包

• --url <URL>: 从此 URL 安装给定的包

• --path <PATH>: 从此本地路径安装给定的包

• --absolute: 强制使用非插值的绝对路径

• --tag <TAG>: 安装特定标签

• --rev <REV>: 更新到特定的 git 版本

• --branch <BRANCH>: 更新到特定的 git 分支

• --features <FEATURES>: 添加具有特定功能的依赖项

• --dev: 将其添加为开发依赖项

• --excluded: 将其添加为排除的依赖项，即使它是子依赖项也不会被安装

• --optional <OPTIONAL>: 将其添加到可选的依赖项组

• --pre: 在查找包版本时包含预发布版本

• --pin <PIN>: 覆盖锁定运算符 [可能的取值：equal, tilde-equal, greater-than-equal]

• --sync: 即使自动同步被禁用，也会自动运行 sync。

• --no-sync: 即使自动同步已启用，也不会自动运行 sync。

• -v, --verbose: 启用详细诊断信息

• -q, --quiet: 关闭所有输出

• -h, --help: 打印帮助 (使用 -h 查看摘要)