一種結構,代表要在存放區中使用的檔案。
成員
基地名
string path.basename提供檔案基礎名稱的字串。
目錄名稱
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()
方法。
Readdir
list path.readdir(watch='auto')傳回目錄中以此路徑表示的項目清單。每個項目都是
path
物件本身。
參數
參數 | 說明 |
---|---|
watch
|
預設值為 'auto' Bazel 是否應查看這個目錄中的項目清單,並在偵測到任何變更時,重新擷取存放區或重新評估模組擴充功能。偵測變更包括項目建立、刪除和重新命名。請注意,這不會觀察目錄中任何項目的內容。 可以是「yes」、「no」或「auto」字串。如果設為「auto」,Bazel 只會在合法的情況下監控這個目錄 (詳情請參閱 |
Realpath
path path.realpath重複將所有符號連結替換為參照項目,藉此傳回這個路徑的標準路徑。