路径

7.3 · 7.2 · 7.1 · 7.0 · 6.5

表示要在代码库中使用的文件的结构。

成员

string path.basename

用于提供文件基本名称的字符串。

path path.dirname

此文件的父级目录，如果此文件没有父级，则为 None。可以返回 None。

bool path.exists

如果此路径表示的文件或目录存在，则返回 true。

请注意，访问此字段不会导致系统监控该路径。如果您希望代码库规则或模块扩展对路径的存在情况敏感，请对上下文对象使用 watch() 方法。

path path.get_child(*relative_paths)

返回通过将此路径与给定的相对路径联接而获得的路径。

参数	说明
`relative_paths`	必需要附加到此路径的零个或多个相对路径字符串，并根据需要添加路径分隔符。

bool path.is_dir

如果此路径指向目录，则返回 true。

请注意，访问此字段不会导致系统监控该路径。如果您希望代码库规则或模块扩展对路径是目录还是文件敏感，请对上下文对象使用 watch() 方法。

list path.readdir(watch='auto')

返回由此路径表示的目录中的条目列表。每个条目本身就是一个 path 对象。

参数说明

参数	说明
`watch`	默认值为 `'auto'` 确定 Bazel 应监控此目录中的条目列表并重新提取代码库，还是在下次检测到任何更改时重新评估模块扩展。要检测的更改包括条目创建、删除和重命名。请注意，这不会监控目录中任何条目的内容。可以是字符串“yes”“no”或“auto”。如果设置为“auto”，则 Bazel 仅在合法的情况下才会监控此目录（如需了解详情，请参阅 `repository_ctx.watch()` 文档）。

watch

默认值为 'auto'
确定 Bazel 应监控此目录中的条目列表并重新提取代码库，还是在下次检测到任何更改时重新评估模块扩展。要检测的更改包括条目创建、删除和重命名。请注意，这不会监控目录中任何条目的内容。

可以是字符串“yes”“no”或“auto”。如果设置为“auto”，则 Bazel 仅在合法的情况下才会监控此目录（如需了解详情，请参阅 repository_ctx.watch() 文档）。

path path.realpath

通过反复将所有符号链接替换为其引用项，返回此路径的规范路径。