Aşağıdaki işlevler @bazel_tools//tools/build_defs/repo:utils.bzl'ten yüklenebilir.
Getirildikten sonra harici depoları değiştirmeye yönelik yardımcılar.
Kurulum
Bu yardımcı programlar, diğer depo kuralları tarafından kullanılmak üzere tasarlanmıştır. Bunlar aşağıdaki gibi yüklenebilir.
load(
"@bazel_tools//tools/build_defs/repo:utils.bzl",
"workspace_and_buildfile",
"patch",
"update_attrs",
)
get_auth
get_auth(ctx, urls)
.netrc dosyasından URL listesi için doğru kimlik doğrulama sözlüğünü elde eden yardımcı program işlevi.
Varsa isteğe bağlı netrc ve auth_patterns özelliklerini destekleyin.
Parametreler
ctx |
zorunludur.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
urls |
zorunludur.
Okunacak URL'lerin listesi |
İadeler
repository_ctx.download öğesine iletilebilecek kimlik doğrulama beyanı
belki
maybe(repo_rule, name, kwargs)
Yalnızca mevcut değilse depo eklemek için kullanılan yardımcı program işlevi.
Bu, https://bazel.build/rules/deploying#dependencies adresinde açıklanan güvenli repositories.bzl makrosunu uygulamak içindir.
Parametreler
repo_rule |
gereklidir.
depo kuralı işlevi. |
name |
gereklidir.
Oluşturulacak deponun adı. |
kwargs |
isteğe bağlıdır.
repo_rule işlevine iletilen kalan bağımsız değişkenler. |
İadeler
Hiçbir şey, gerektiğinde yan etki olarak depoyu tanımlar.
parse_netrc
parse_netrc(contents, filename)
En azından temel bir .netrc dosyasını ayrıştırmak için kullanılan yardımcı program işlevi.
Parametreler
contents |
zorunludur.
ayrıştırıcı için giriş. |
filename |
isteğe bağlıdır.
Varsayılan değer None'tür.
hata mesajlarında kullanılacak dosya adını (varsa) belirtin. |
İadeler
bir makine adını, onlar hakkında sağlanan bilgilerle bir dile eşleştirmesini söyle
patch
patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)
Çıkarılmış bir depoya yama uygulama.
Bu kuralın, bir depolama alanı kuralının uygulama işlevinde kullanılması amaçlanmıştır. patches, patch_tool, patch_args, patch_cmds ve patch_cmds_win parametreleri belirtilmezse ctx.attr parametresinden alınır.
Parametreler
ctx |
zorunludur.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
patches |
isteğe bağlıdır.
Varsayılan değer None'tür.
Uygulanacak yama dosyaları. Dizelerin, etiketlerin veya yolların listesi. |
patch_cmds |
isteğe bağlıdır.
varsayılan değer: None
Yama için çalıştırılacak Bash komutları. bash -c komutuna teker teker iletilir. Dize listesi |
patch_cmds_win |
isteğe bağlıdır.
Varsayılan değer None'tür.
Yamalama için çalıştırılacak PowerShell komutları. Komutlar, powershell /c'ye tek tek iletilir. Dize listesi. Bu parametrenin doğru/yanlış değeri yanlışsa patch_cmds kullanılır ve bu parametre yoksayılır. |
patch_tool |
isteğe bağlıdır.
varsayılan değer: None
Yamaların uygulanması için çalıştırılacak yama aracının yolu. Dize. |
patch_args |
isteğe bağlıdır.
varsayılan değer: None
Yama aracına aktarılacak bağımsız değişkenler. Dize listesi. |
auth |
isteğe bağlıdır.
Varsayılan değer None'tür.
URL'lerin bazıları için kimlik doğrulama bilgilerini belirten isteğe bağlı bir sözlük. |
read_netrc
read_netrc(ctx, filename)
En azından temel bir .netrc dosyasını ayrıştırmak için kullanılan yardımcı program işlevi.
Parametreler
ctx |
zorunludur.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
filename |
gereklidir.
Okunan .netrc dosyasının adı |
İadeler
Makine adlarını, bunlarla ilgili bilgilerin yer aldığı bir diziye eşleyen sözlük
read_user_netrc
read_user_netrc(ctx)
Kullanıcının varsayılan netrc dosyasını okuma.
Parametreler
ctx |
zorunludur.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
İadeler
makine adlarını, onlar hakkında sağlanan bilgilerle bir dile eşleme dikte yazar.
update_attrs
update_attrs(orig, keys, override)
Belirtilen özellikleri belirli bir depo kural çağrısına eklemek ve değiştirmek için kullanılan yardımcı program işlevi.
Bu, bir kuralı yeniden uygulanabilir hale getirmek için kullanılır.
Parametreler
orig |
zorunludur.
Belirli bir kural çağrısı tarafından ayarlanan özelliklerin (açık veya örtülü olarak) sözlük biçiminde gösterimi |
keys |
zorunludur.
bu kuralda tanımlanan özelliklerin tamamı |
override |
zorunludur.
orijinal öğeyi geçersiz kılacak veya orijinale ekleyebilecek özellikler dizini |
İadeler
Üzerine yazma özelliğinin anahtarlarını içeren özellikler dizini eklendi/güncellendi
use_netrc
use_netrc(netrc, urls, patterns)
Ayrıştırılmış bir netrc dosyasından ve URL'lerin listesinden bir kimlik doğrulama dizini oluşturun.
Parametreler
netrc |
zorunludur.
read_netrc işlevinden elde edilen gibi, bir netrc dosyası (halihazırda bir dizeye ayrıştırılmış) |
urls |
zorunludur.
URL listesi. |
patterns |
zorunludur.
URL'den yetkilendirme kalıplarına yönelik isteğe bağlı sözlük |
İadeler
ctx.download için kimlik doğrulama bağımsız değişkeni olarak uygun olan bir komut dosyası oluşturur. Daha net ifade etmek gerekirse, Dikte, netrc dosyasının giriş ve şifre bilgilerini sağladığı tüm URL'leri, ilgili giriş, şifre ve isteğe bağlı yetkilendirme kalıbının yanı sıra "type"ın "temel" veya "desen" ile eşlenmesini de içeren bir dile eşler.
workspace_and_buildfile
workspace_and_buildfile(ctx)
WORKSPACE ve istenirse BUILD dosyası yazmak için yardımcı program.
Bu kuralın, bir depolama alanı kuralının uygulama işlevinde kullanılması amaçlanmıştır.
name, build_file, build_file_content, workspace_file ve workspace_file_content parametrelerinin ctx.attr içinde bulunduğu varsayılır. Son dört parametre, None değeriyle bulunabilir.
Parametreler
ctx |
zorunludur.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |