. BUILD hedef tanımlayıcısı.
Her Label örneği l için dize gösterimi str(l), Label() çağrısının nerede gerçekleştiğine bakılmaksızın Label(str(l)) == l özelliğine sahiptir.
Label, print() veya fail() işlevine konum bağımsız değişkenleri olarak iletildiğinde insan tarafından okunabilirlik için optimize edilmiş bir dize gösterimi kullanır. Bu gösterimde, mümkünse ana depo bakış açısından görünür bir depo adı kullanılır.
Üyeler
Şirket
Label Label(input)
.bzl çağrısı yapan kaynak dosyanın bulunduğu paketin bağlamında, bir etiket dizesini Label nesnesine dönüştürür. Verilen değer zaten Label ise değiştirilerek döndürülür.İlgili bir işlev olan native.package_relative_label(), makrolarda ise girişi şu anda oluşturulmakta olan paketin bağlamında Label biçimine dönüştürür. Etiket değerli kural özellikleri tarafından otomatik olarak yapılan dizeden etikete dönüşümü taklit etmek için bu işlevi kullanın.
Parametreler
| Parametre | Açıklama |
|---|---|
input
|
string; veya Etiket;
gerekli Giriş etiketi dizesi veya Etiket nesnesi. Bir Etiket nesnesi geçilirse olduğu gibi döndürülür. |
ad
string Label.nameBu etiketin atıfta bulunduğu hedefin adı. Örneğin:
Label("@@foo//pkg/foo:abc").name == "abc"
paket
string Label.packageBu etiket tarafından başvuruda bulunulan hedefi içeren paketin, depo adı olmadan adı. Örneğin:
Label("@@repo//pkg/foo:abc").package == "pkg/foo"
ilgili
Label Label.relative(relName)Deneysel. Bu API deneyseldir ve herhangi bir zamanda değişebilir. Lütfen bu metrikten yararlanmayın.
--+incompatible_enable_deprecated_label_apis Desteği sonlandırıldı ayarlanarak deneysel olarak etkinleştirilebilir. Bu yöntem, görünen bir depo adı içeren bir bağımsız değişkenle birlikte kullanıldığında beklenmedik şekilde davranır. Bunun yerine
Label.same_package_label(), native.package_relative_label() veya Label() tercih edin.Mutlak (// ile başlayan) veya mevcut paketle göreli bir etiketi çözümler. Bu etiket uzak bir depodaysa bağımsız değişken, o depoya göre çözümlenir. Bağımsız değişken bir depo adı içeriyorsa geçerli etiket yok sayılır ve bağımsız değişken olduğu gibi döndürülür. Tek fark, depo adı, geçerli depo eşlemesindeyse yeniden yazılır. Ayrılmış etiketler de olduğu gibi döndürülür.
Örneğin:
Label("//foo/bar:baz").relative(":quux") == Label("//foo/bar:quux")
Label("//foo/bar:baz").relative("//wiz:quux") == Label("//wiz:quux")
Label("@repo//foo/bar:baz").relative("//wiz:quux") == Label("@repo//wiz:quux")
Label("@repo//foo/bar:baz").relative("//visibility:public") == Label("//visibility:public")
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@other//wiz:quux")
{'@other' : '@remapped'} kod deposu eşlemesi iletildiyse aşağıdaki yeniden eşleme işlemi gerçekleşir:
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
Parametreler
| Parametre | Açıklama |
|---|---|
relName
|
string;
gerekli Buna göre çözümlenecek etiket. |
repo_name
string Label.repo_nameBu etiket tarafından başvuruda bulunulan hedefi içeren deponun, önde gelen işaret işaretleri (
@) olmadan standart adı. Örneğin, Label("@@foo//bar:baz").repo_name == "foo"
same_package_label
Label Label.same_package_label(target_name)Belirtilen hedef ada sahip bu etiketle aynı pakette bir etiket oluşturur.
Parametreler
| Parametre | Açıklama |
|---|---|
target_name
|
string;
gerekli Yeni etiketin hedef adı. |
workspace_name
string Label.workspace_nameDeneysel. Bu API deneyseldir ve herhangi bir zamanda değişebilir. Lütfen bu metrikten yararlanmayın.
--+incompatible_enable_deprecated_label_apis Desteği sonlandırıldı ayarlanarak deneysel olarak etkinleştirilebilir. Alan adı "çalışma alanı adı" "Burada yanlış anlaşılanlar var; bunun yerine benzer davranışa sahip
Label.repo_name kullanın.Bu etiket tarafından başvuruda bulunulan hedefi içeren deponun, önde gelen işaret işaretleri (@) olmadan standart adı. Örneğin,
Label("@@foo//bar:baz").workspace_name == "foo"
workspace_root
string Label.workspace_rootexecroot ile göreli olarak bu etiket tarafından başvuruda bulunulan hedefi içeren deponun yürütme kökünü döndürür. Örneğin:
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"