Remotes API

警告

此功能是实验性的，可能会有破坏性更改。有关更多信息，请参见Conan 稳定性部分。

class Remote(name, url, verify_ssl=True, disabled=False, allowed_packages=None, remote_type=None)

Remote 类表示包的远程注册表。它是一个只读的不透明对象，不应直接创建，而应从相关的 RemotesAPI 子api 方法中获取。

class RemotesAPI(conan_api)

RemotesAPI 管理 remotes 的定义，包含在 Conan home 中的 “remotes.json” 文件中，支持 remotes 的添加、删除、更新、重命名、启用、禁用。这些操作根本不联系服务器，也不检查它们是否存在。如果它们不可用，则在使用它们时稍后将失败。

user_xxx 方法执行与身份验证相关的任务，其中一些方法将联系服务器以执行此类身份验证

list(pattern=None, only_enabled=True)

获取与模式匹配的 Remote 对象列表。

参数:

• pattern – None, 单个 str 或 str 列表。如果为 None，将返回所有 remotes（等效于 pattern="*"）。

• only_enabled – boolean，默认情况下仅返回已启用的 remotes

返回:

Remote 对象的列表

disable(pattern)

禁用与 pattern 匹配的所有 remotes

参数:

pattern – 单个 str 或 str 列表。如果该模式是一个没有像“*”这样的通配符的精确名称，并且没有找到与该精确名称匹配的 remote，它将引发一个错误。

返回:

已禁用的 Remote 对象列表（即使它们已被禁用）

enable(pattern)

启用与 pattern 匹配的所有 remotes。

参数:

pattern – 单个 str 或 str 列表。如果该模式是一个没有像“*”这样的通配符的精确名称，并且没有找到与该精确名称匹配的 remote，它将引发一个错误。

返回:

已启用的 Remote 对象列表（即使它们已被启用）

get(remote_name)

获取 Remote 对象

参数:

remote_name – 要返回的 remote 的确切名称

返回:

Remote 对象，如果 remote 不存在，则引发异常。

add(remote: Remote, force=False, index=None)

将新的 Remote 对象添加到现有的对象

参数:

• remote – 要添加的 Remote 对象

• force – 如果 remote 已经存在，则不要失败（但默认情况下会失败）

• index – 如果未定义，则新的 remote 将是最后一个。传递一个整数，将 remote 插入到该位置，而不是最后一个位置

remove(pattern)

删除与 pattern 匹配的 remotes

参数:

pattern – 单个 str 或 str 列表。如果该模式是一个没有像“*”这样的通配符的精确名称，并且没有找到与该精确名称匹配的 remote，它将引发一个错误。

返回:

已删除的 Remote 对象列表

update(remote_name: str, url=None, secure=None, disabled=None, index=None, allowed_packages=None)

更新现有的 remote

参数:

• remote_name – 要更新的 remote 的名称，必须存在

• url – 要更新的可选 url，如果未定义，则不会更新

• secure – 可选的 ssl 安全连接以进行更新

• disabled – 可选的禁用状态

• index – 用于更改 remote 顺序的可选整数

• allowed_packages – 允许从此 remote 获取的包的可选列表

rename(remote_name: str, new_name: str)

更改现有 remote 的名称

参数:

• remote_name – 以前存在的名称

• new_name – 新名称

user_login(remote: Remote, username: str, password: str)

使用提供的用户名和密码针对给定的 remote 执行用户身份验证

参数:

• remote – Remote 对象

• username – 用户登录名，类型为 str

• password – 密码 str

user_logout(remote: Remote)

从给定的 Remote 注销

参数:

remote – 要注销的 Remote 对象