path

报告问题 查看源代码 每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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

成员

basename

string path.basename

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

dirname

path path.dirname

相应文件的父目录；如果相应文件没有父目录，则为 None。 可能会返回 None。

exists

bool path.exists

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

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

get_child

path path.get_child(*relative_paths)

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

参数

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

is_dir

bool path.is_dir

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

请注意，访问此字段不会导致系统监视相应路径。如果您希望代码库规则或模块扩展程序能够区分路径是目录还是文件，请对上下文对象使用 watch() 方法。

readdir

list path.readdir(watch='auto')

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

参数

参数 说明
watch string; default is 'auto'
whether Bazel should watch the list of entries in this directory and refetch the repository or re-evaluate the module extension next time when any changes are detected. 要检测的更改包括条目的创建、删除和重命名。请注意，此命令不会监控目录中任何条目的内容。

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

realpath

path path.realpath

通过反复将所有符号链接替换为它们所指向的对象，返回相应路径的规范路径。