路徑

回報問題 查看原始碼 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 required
要附加至此路徑的零個或多個相對路徑字串,並視需要加入路徑分隔符。

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

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