代表存放區中要使用的檔案的結構。
成員
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 只會在合法情況下監控這個目錄 (詳情請參閱 |
realpath
path path.realpath透過重複將所有符號連結替換為其參照,傳回此路徑的標準化路徑。