MODULE.bazel dosyaları

Sorun bildir Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

MODULE.bazel dosyalarında kullanılabilen yöntemler.

Üyeler

archive_override

None archive_override(module_name, urls, integrity='', strip_prefix='', patches=[], patch_cmds=[], patch_strip=0)

Bu bağımlılığın, kayıt defterinden değil, belirli bir konumdaki bir arşiv dosyasından (zip, gzip vb.) gelmesi gerektiğini belirtir. Bu yönerge yalnızca kök modülde geçerli olur. Başka bir deyişle, bir modül başkaları tarafından bağımlılık olarak kullanılıyorsa kendi geçersiz kılmaları yok sayılır.

Parametreler

Parametre Açıklama
module_name gerekli
Bu geçersiz kılmanın uygulanacağı Bazel modülü bağımlılığının adı.
urls string veya string yinelemesi; zorunlu
Arşivin URL'leri; http(s):// veya file:// URL'leri olabilir.
integrity Varsayılan değer ''
'dir. Arşiv dosyasının, alt kaynak bütünlüğü biçimindeki beklenen sağlama toplamı.
strip_prefix Varsayılan değer ''
Çıkarılan dosyalardan kaldırılacak bir dizin öneki.
patches Dize yinelemesi; varsayılan değer []
Bu modüle uygulanacak yama dosyalarını gösteren etiketlerin listesi. Yama dosyaları, üst düzey projenin kaynak ağacında bulunmalıdır. Listelenen sırayla uygulanır.
patch_cmds Dize yineleyicisi; varsayılan değer []
Yamalar uygulandıktan sonra Linux/macOS'te uygulanacak Bash komutlarının sırası.
patch_strip Varsayılan değer 0
Unix patch'in --strip bağımsız değişkeniyle aynıdır.

bazel_dep

None bazel_dep(name, version='', max_compatibility_level=-1, repo_name='', dev_dependency=False)

Başka bir Bazel modülüne doğrudan bağımlılık bildirir.

Parametreler

Parametre Açıklama
name zorunlu
Doğrudan bağımlılık olarak eklenecek modülün adı.
version varsayılan değer ''
Doğrudan bağımlılık olarak eklenecek modülün sürümü.
max_compatibility_level Varsayılan değer -1
'dir. Modülün doğrudan bağımlılık olarak eklenmesi için desteklenen maksimum compatibility_level. Modülün sürümü, desteklenen minimum compatibility_level'ı ve bu özellik belirtilmemişse maksimum değeri ifade eder.
repo_name Varsayılan değer ''
'dir. Bu bağımlılığı temsil eden harici deponun adı. Bu, varsayılan olarak modülün adıdır.
dev_dependency Varsayılan değer False
'dir. Doğruysa mevcut modül kök modül değilse veya `--ignore_dev_dependency` etkinse bu bağımlılık yoksayılır.

git_override

None git_override(module_name, remote, commit='', patches=[], patch_cmds=[], patch_strip=0, init_submodules=False, strip_prefix='')

Bir bağımlılığın, Git deposunun belirli bir commit'inden gelmesi gerektiğini belirtir. Bu yönerge yalnızca kök modülde geçerli olur. Başka bir deyişle, bir modül başkaları tarafından bağımlılık olarak kullanılıyorsa kendi geçersiz kılmaları yok sayılır.

Parametreler

Parametre Açıklama
module_name gerekli
Bu geçersiz kılmanın uygulanacağı Bazel modülü bağımlılığının adı.
remote zorunlu
Uzak Git deposunun URL'si.
commit varsayılan değer ''
Kontrol edilmesi gereken commit.
patches Dize yinelemesi; varsayılan değer []
Bu modüle uygulanacak yama dosyalarını gösteren etiketlerin listesi. Yama dosyaları, üst düzey projenin kaynak ağacında bulunmalıdır. Listelenen sırayla uygulanır.
patch_cmds Dize yineleyicisi; varsayılan değer []
Yamalar uygulandıktan sonra Linux/macOS'te uygulanacak Bash komutlarının sırası.
patch_strip Varsayılan değer 0
Unix patch'in --strip bağımsız değişkeniyle aynıdır.
init_submodules varsayılan değer False
Getirilen depodaki Git alt modüllerinin yinelemeli olarak başlatılıp başlatılmayacağı.
strip_prefix Varsayılan değer ''
Çıkarılan dosyalardan kaldırılacak bir dizin öneki. Bu, git deposunun bir alt dizinini hedeflemek için kullanılabilir. Alt dizinin, bu `git_override` işlevine iletilen `module_name` bağımsız değişkeniyle aynı modül adına sahip kendi `MODULE.bazel` dosyası olması gerektiğini unutmayın.

dahil et

None include(label)

Başka bir MODULE.bazel benzeri dosyanın içeriğini içerir. include(), dahil edilen dosya metin olarak include() çağrısının konumuna yerleştirilmiş gibi davranır. Ancak değişken bağlamaları (ör. use_extension için kullanılanlar) yalnızca bulundukları dosyada görünür, dahil edilen veya dahil eden dosyalarda görünmez.

Yalnızca kök modül include() kullanabilir. Bir bazel_dep'nin MODULE dosyası include() kullanırsa hata oluşur.

Yalnızca ana depodaki dosyalar eklenebilir.

include(), büyük bir MODULE.bazel dosyanızın olmasını önlemek veya tek tek anlamsal segmentler için erişim kontrolünü daha iyi yönetmek amacıyla kök modül dosyasını birden fazla parçaya bölmenize olanak tanır.

Parametreler

Parametre Açıklama
label required
Eklenecek dosyayı gösteren etiket. Etiket, ana depodaki bir dosyayı işaret etmelidir. Diğer bir deyişle, çift eğik çizgiyle (//) başlamalıdır.

local_path_override

None local_path_override(module_name, path)

Bir bağımlılığın yerel diskteki belirli bir dizinden gelmesi gerektiğini belirtir. Bu yönerge yalnızca kök modülde geçerli olur. Başka bir deyişle, bir modül başkaları tarafından bağımlılık olarak kullanılıyorsa kendi geçersiz kılmaları yok sayılır.

Parametreler

Parametre Açıklama
module_name gerekli
Bu geçersiz kılmanın uygulanacağı Bazel modülü bağımlılığının adı.
path required
Bu modülün bulunduğu dizinin yolu.

modül

None module(name='', version='', compatibility_level=0, repo_name='', bazel_compatibility=[])

Geçerli Bazel deposu tarafından temsil edilen Bazel modülünün belirli özelliklerini bildirir. Bu özellikler, modülün temel meta verileridir (ör. ad ve sürüm) veya mevcut modülün ve bağımlılarının davranışını etkiler.

En fazla bir kez çağrılmalıdır ve çağrılırsa MODULE.bazel dosyasındaki ilk yönerge olmalıdır. Yalnızca bu modül kök modülse (yani başka bir modül tarafından kullanılmayacaksa) atlanabilir.

Parametreler

Parametre Açıklama
name varsayılan değer ''
Modülün adı. Yalnızca bu modül kök modülse (yani başka bir modül tarafından kullanılmayacaksa) atlanabilir. Geçerli bir modül adı: 1) yalnızca küçük harf (a-z), rakam (0-9), nokta (.), kısa çizgi (-) ve alt çizgi (_) içermelidir; 2) küçük harfle başlamalıdır; 3) küçük harf veya rakamla bitmelidir.
version varsayılan değer ''
Modülün sürümü. Yalnızca bu modül kök modülse (yani başka bir modül tarafından kullanılmayacaksa) atlanabilir. Sürüm, gevşek bir SemVer biçiminde olmalıdır. Daha fazla ayrıntı için belgeleri inceleyin.
compatibility_level Varsayılan değer 0
'dir. Modülün uyumluluk düzeyi. Bu değer, uyumsuz büyük bir değişiklik yapıldığında her zaman değiştirilmelidir. Bu, SemVer açısından modülün "ana sürümü"dür. Ancak sürüm dizesine yerleştirilmez ve ayrı bir alan olarak bulunur. Farklı uyumluluk düzeylerine sahip modüller, farklı adlara sahip modüller gibi sürüm çözümlemeye katılır. Ancak son bağımlılık grafiği, aynı ada ancak farklı uyumluluk düzeylerine sahip birden fazla modül içeremez (multiple_version_override geçerli olmadığı sürece). Daha fazla ayrıntı için belgeleri inceleyin.
repo_name Varsayılan değer ''
'dir. Bu modülü temsil eden deponun, modülün kendisi tarafından görülen adı. Varsayılan olarak, depodaki modülün adı kullanılır. Bu, modül adından farklı bir depo adı kullanan projelerin taşınmasını kolaylaştırmak için belirtilebilir.
bazel_compatibility Dize yinelemesi; varsayılan değer []
Kullanıcıların hangi Bazel sürümlerinin bu modülle uyumlu olduğunu bildirmesine olanak tanıyan Bazel sürümlerinin listesi. Bu bilgi, bağımlılık çözümlemesini ETKİLEMEZ ancak bzlmod, mevcut Bazel sürümünüzün uyumlu olup olmadığını kontrol etmek için bu bilgiyi kullanır. Bu değerin biçimi, virgülle ayrılmış bazı kısıtlama değerlerinden oluşan bir dizedir. Üç kısıtlama desteklenir: <=X.X.X: Bazel sürümü, X.X.X sürümüne eşit veya daha eski olmalıdır. Daha yeni bir sürümde bilinen bir uyumsuz değişiklik olduğunda kullanılır. >=X.X.X: Bazel sürümü, X.X.X'e eşit veya daha yeni olmalıdır.Yalnızca X.X.X'ten itibaren kullanılabilen bazı özelliklere bağlı olduğunuzda kullanılır. -X.X.X: Bazel sürümü X.X.X uyumlu değildir. X.X.X sürümünde sizi etkileyen ancak sonraki sürümlerde düzeltilen bir hata olduğunda kullanılır.

multiple_version_override

None multiple_version_override(module_name, versions, registry='')

Bir bağımlılığın yine bir kayıt defterinden gelmesi gerektiğini ancak birden fazla sürümünün birlikte bulunmasına izin verilmesi gerektiğini belirtir. Daha fazla ayrıntı için belgeleri inceleyin. Bu yönerge yalnızca kök modülde geçerli olur. Başka bir deyişle, bir modül başkaları tarafından bağımlılık olarak kullanılıyorsa kendi geçersiz kılmaları yok sayılır.

Parametreler

Parametre Açıklama
module_name gerekli
Bu geçersiz kılmanın uygulanacağı Bazel modülü bağımlılığının adı.
versions Dize yinelemesi; zorunlu
Birlikte bulunmasına izin verilen sürümleri açıkça belirtir. Bu sürümler, bağımlılık grafiği ön seçiminde zaten mevcut olmalıdır. Bu modüldeki bağımlılıklar, aynı uyumluluk düzeyinde izin verilen en yakın yüksek sürüme "yükseltilirken", aynı uyumluluk düzeyinde izin verilen sürümlerden daha yüksek bir sürüme sahip bağımlılıklar hataya neden olur.
registry Varsayılan değer ''
'dir. Bu modül için kayıt defterini geçersiz kılar. Bu modül, varsayılan kayıt defteri listesinden bulunmak yerine belirtilen kayıt defteri kullanılmalıdır.

register_execution_platforms

None register_execution_platforms(dev_dependency=False, *platform_labels)

Bu modül seçildiğinde kaydedilecek, önceden tanımlanmış yürütme platformlarını belirtir. Mutlak hedef kalıpları olmalıdır (ör. @ veya // ile başlamalıdır). Daha fazla bilgi için toolchain resolution (araç zinciri çözümü) bölümüne bakın.

Parametreler

Parametre Açıklama
dev_dependency varsayılan değer False
'dir. Doğruysa mevcut modül kök modül değilse veya `--ignore_dev_dependency` etkinse yürütme platformları kaydedilmez.
platform_labels sequence of strings; required
Kaydedilecek platformların etiketleri.

register_toolchains

None register_toolchains(dev_dependency=False, *toolchain_labels)

Bu modül seçildiğinde kaydedilecek, önceden tanımlanmış araç zincirlerini belirtir. Mutlak hedef kalıpları olmalıdır (ör. @ veya // ile başlamalıdır). Daha fazla bilgi için toolchain resolution (araç zinciri çözümü) bölümüne bakın.

Parametreler

Parametre Açıklama
dev_dependency Varsayılan değer False
'dir. Doğruysa mevcut modül kök modül değilse veya `--ignore_dev_dependency` etkinse araç zincirleri kaydedilmez.
toolchain_labels sequence of strings; required
Kaydedilecek araç zincirlerinin etiketleri. Etiketler :all içerebilir. Bu durumda, paketteki tüm araç zinciri sağlayan hedefler ada göre sözlük sırasına göre kaydedilir.

single_version_override

None single_version_override(module_name, version='', registry='', patches=[], patch_cmds=[], patch_strip=0)

Bağımlılığın yine bir sicilden gelmesi gerektiğini ancak sürümünün sabitlenmesi, sicilinin geçersiz kılınması veya bir yama listesinin uygulanması gerektiğini belirtir. Bu yönerge yalnızca kök modülde geçerli olur. Başka bir deyişle, bir modül başkaları tarafından bağımlılık olarak kullanılıyorsa kendi geçersiz kılmaları yok sayılır.

Parametreler

Parametre Açıklama
module_name gerekli
Bu geçersiz kılmanın uygulanacağı Bazel modülü bağımlılığının adı.
version Varsayılan değer ''
'dir. Bağımlılık grafiğinde bu modülün bildirilen sürümünü geçersiz kılar. Yani bu modül, bu geçersiz kılma sürümüne "sabitlenir". Yalnızca kayıt otoritesi veya yamalar geçersiz kılınmak isteniyorsa bu özellik atlanabilir.
registry Varsayılan değer ''
'dir. Bu modül için kayıt defterini geçersiz kılar. Bu modül, varsayılan kayıt defteri listesinden bulunmak yerine belirtilen kayıt defteri kullanılmalıdır.
patches Dize yinelemesi; varsayılan değer []
Bu modüle uygulanacak yama dosyalarını gösteren etiketlerin listesi. Yama dosyaları, üst düzey projenin kaynak ağacında bulunmalıdır. Listelenen sırayla uygulanır.
patch_cmds Dize yineleyicisi; varsayılan değer []
Yamalar uygulandıktan sonra Linux/macOS'te uygulanacak Bash komutlarının sırası.
patch_strip Varsayılan değer 0
Unix patch'in --strip bağımsız değişkeniyle aynıdır.

use_extension

module_extension_proxy use_extension(extension_bzl_file, extension_name, *, dev_dependency=False, isolate=False)

Bir modül uzantısını temsil eden bir proxy nesnesi döndürür. Modül uzantısı etiketleri oluşturmak için yöntemleri çağrılabilir.

Parametreler

Parametre Açıklama
extension_bzl_file required
Modül uzantısını tanımlayan Starlark dosyasının etiketi.
extension_name zorunlu
Kullanılacak modül uzantısının adı. Bu ada sahip bir sembol, Starlark dosyası tarafından dışa aktarılmalıdır.
dev_dependency varsayılan değer False
Doğruysa mevcut modül kök modül değilse veya `--ignore_dev_dependency` etkinse modül uzantısının bu kullanımı yoksayılır.
isolate Varsayılan değer False
Deneysel'dir. Bu parametre deneyseldir ve herhangi bir zamanda değişebilir. Lütfen bu bilgileri kullanmayın. ---experimental_isolated_extension_usages
ayarlanarak deneysel olarak etkinleştirilebilir. Doğruysa modül uzantısının bu kullanımı, hem bu modüldeki hem de diğer modüllerdeki tüm diğer kullanımlardan izole edilir. Bu kullanım için oluşturulan etiketler diğer kullanımları etkilemez ve uzantı tarafından bu kullanım için oluşturulan depolar, uzantı tarafından oluşturulan diğer tüm depolardan farklıdır.

Bu parametre şu anda deneyseldir ve yalnızca --experimental_isolated_extension_usages işaretiyle kullanılabilir.

use_repo

None use_repo(extension_proxy, *args, **kwargs)

Belirtilen modül uzantısı tarafından oluşturulan bir veya daha fazla depoyu mevcut modülün kapsamına aktarır.

Parametreler

Parametre Açıklama
extension_proxy required
Bir use_extension çağrısı tarafından döndürülen bir modül uzantısı proxy nesnesi.
args gerekli
İçe aktarılacak depoların adları.
kwargs gerekli
Belirli depoların, farklı adlarla mevcut modülün kapsamına aktarılacağını belirtir. Anahtarlar, geçerli kapsamda kullanılacak ad olmalı, değerler ise modül uzantısı tarafından dışa aktarılan orijinal adlar olmalıdır.

use_repo_rule

repo_rule_proxy use_repo_rule(repo_rule_bzl_file, repo_rule_name)

MODULE.bazel dosyasında bir veya daha fazla kez doğrudan çağrılabilen bir proxy değeri döndürür. Bu şekilde oluşturulan depolar yalnızca mevcut modül tarafından, proxy'de name özelliği kullanılarak belirtilen ad altında görünür. Belirli bir deponun yalnızca mevcut modül kök modül olduğunda oluşturulacağını belirtmek için proxy'de örtülü Boole dev_dependency özelliği de kullanılabilir.

Parametreler

Parametre Açıklama
repo_rule_bzl_file required
Depo kuralını tanımlayan Starlark dosyasına yönelik bir etiket.
repo_rule_name required
Kullanılacak depo kuralının adı. Bu ada sahip bir sembol, Starlark dosyası tarafından dışa aktarılmalıdır.