路徑

回報問題 查看原始碼 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

代表存放區中要使用的檔案的結構。

成員

basename

string path.basename

提供檔案基底名稱的字串。

目錄名稱

path path.dirname

這個檔案的父項目錄;如果這個檔案沒有父項目錄,則傳回 None。可能會傳回 None

存在

bool path.exists

如果這個路徑所代表的檔案或目錄存在,則傳回「是」。

請注意,存取這個欄位並不會導致系統監控路徑。如果您希望存放區規則或模組擴充功能能根據路徑的存在與否做出反應,請在內容物件上使用 watch() 方法。

get_child

path path.get_child(*relative_paths)

傳回將此路徑與指定的相對路徑結合所取得的路徑。

參數

參數 說明
relative_paths 必要
零或多個要附加至這個路徑的相對路徑字串,可視需要新增路徑分隔符。

is_dir

bool path.is_dir

如果此路徑指向目錄,則傳回「是」。

請注意,存取這個欄位「不會」導致路徑受到監控。如果您希望存放區規則或模組擴充功能能判斷路徑是目錄或檔案,請在結構定義物件上使用 watch() 方法。

readdir

list path.readdir(watch='auto')

傳回這個路徑所指向目錄中的項目清單。每個項目本身都是 path 物件。

參數

參數 說明
watch 字串;預設值為 'auto'
。是否應在 Bazel 偵測到任何變更時,監控這個目錄中的項目清單並重新擷取存放區,或重新評估模組擴充功能。偵測變更包括項目建立、刪除和重新命名。請注意,這不會監控目錄中任何項目的內容

可以是「yes」、「no」或「auto」字串。如果設為「auto」,Bazel 只會在合法情況下監控這個目錄 (詳情請參閱 repository_ctx.watch() 文件)。

realpath

path path.realpath

透過重複將所有符號連結替換為其參照項目,傳回此路徑的標準路徑。