表示要在仓库中使用的文件的结构。
成员
基名
string path.basename指定文件基本名称的字符串。
dirname
path path.dirname此文件的父目录,如果此文件没有父目录,则为 None。 可能会返回
None
。
存在
bool path.exists如果此路径表示的文件或目录存在,则返回 true。
请注意,访问此字段不会导致需要监控该路径。如果您希望代码库规则或模块扩展对路径的存在敏感,请对上下文对象使用 watch()
方法。
get_child
path path.get_child(*relative_paths)返回通过将此路径与指定的相对路径相联接而获得的路径。
参数
参数 | 说明 |
---|---|
relative_paths
|
必需 要附加到此路径的零个或多个相对路径字符串,并根据需要添加路径分隔符。 |
is_dir
bool path.is_dir如果此路径指向某个目录,则返回 true。
请注意,访问此字段不会导致需要监控该路径。如果您希望代码库规则或模块扩展程序对路径是目录还是文件敏感,请对上下文对象使用 watch()
方法。
只读目录
list path.readdir(watch='auto')返回此路径表示的目录中的条目列表。每个条目本身就是一个
path
对象。
参数
参数 | 说明 |
---|---|
watch
|
默认值为 'auto' 是 Bazel 在下次检测到任何更改时应监控此目录中的条目列表并重新获取代码库,还是重新评估模块扩展程序。要检测的更改包括条目创建、删除和重命名。请注意,此操作不会查看目录中任何条目的内容。 可以是字符串“yes”、“no”或“auto”。如果设置为“auto”,则 Bazel 仅在合法时才会监控此目录(如需了解详情,请参阅 |
Realpath
path path.realpath通过反复将所有符号链接替换为其引用项,返回此路径的规范路径。