路徑

回報問題 查看來源 Nightly

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

成員

basename

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() 方法。

Readdir

list path.readdir(watch='auto')

傳回目錄中以此路徑表示的項目清單。每個項目本身都是 path 物件。

參數

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

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

Realpath

path path.realpath

重複將所有符號連結替換為參照項目，藉此傳回這個路徑的標準路徑。