Aşağıdaki işlevler @bazel_tools//tools/build_defs/repo:utils.bzl üzerinden 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ındaki URL listesi için doğru kimlik doğrulama dosyasını almak için yardımcı program işlevi.
Varsa isteğe bağlı netrc ve auth_patterns özelliklerini destekler.
Parametreler
ctx |
gereklidir.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
urls |
gereklidir.
okunacak url'lerin listesi |
İlerlemeler
repository_ctx.download öğesine iletilebilecek kimlik doğrulama beyanı
belki
maybe(repo_rule, name, kwargs)
Kod deposunu yalnızca halihazırda mevcut değilse eklemek için yardımcı program işlevi.
Bunun amacı, https://bazel.build/rules/deploying#dependencies'te açıklanan güvenli depo.bzl makrosudur.
Parametreler
repo_rule |
gereklidir.
depo kuralı işlevine atanmıştır. |
name |
gereklidir.
deponun adını seçmelidir. |
kwargs |
isteğe bağlıdır.
repo_rule işlevine aktarılan kalan bağımsız değişkenleri ifade eder. |
İlerlemeler
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 yardımcı program işlevi.
Parametreler
contents |
gereklidir.
ayrıştırıcının girdisi. |
filename |
isteğe bağlıdır.
varsayılan değer: None
hata mesajlarında kullanılacak dosya adı (varsa) belirtin. |
İlerlemeler
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 depo kuralının uygulama işlevinde kullanılması amaçlanmıştır. patches, patch_tool,
patch_args, patch_cmds ve patch_cmds_win parametreleri belirtilmemişse bu parametreler ctx.attr kaynağından alınır.
Parametreler
ctx |
gereklidir.
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
Uygulanacak yama dosyaları. Dize, Etiket veya yol 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
Yama için çalıştırılacak Powershell komutları, powershell'e /c'ye tek tek iletilir. Dize listesi. Bu parametrenin Boole değeri false ise 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ı uygulamak için yürütülecek 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
Bazı URL'lerin kimlik doğrulama bilgilerini belirten isteğe bağlı bir metin. |
read_netrc
read_netrc(ctx, filename)
En azından temel bir .netrc dosyasını ayrıştırmak için yardımcı program işlevi.
Parametreler
ctx |
gereklidir.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
filename |
gereklidir.
okunacak .netrc dosyasının adı |
İlerlemeler
bir makine adını, onlar hakkında sağlanan bilgilerle bir dile eşleştirmesini söyle
read_user_netrc
read_user_netrc(ctx)
Kullanıcının varsayılan netrc dosyasını okur.
Parametreler
ctx |
gereklidir.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |
İlerlemeler
makine adlarını bunlar 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 yardımcı program.
Bu, bir kuralı tekrarlanabilir hale getirmek için kullanılır.
Parametreler
orig |
gereklidir.
belirli bir kural çağrısı tarafından gerçekte ayarlanmış özelliklerin (açık veya örtülü) kuralı |
keys |
gereklidir.
bu kuralda tanımlanan özelliklerin tamamı |
override |
gereklidir.
geçersiz kılınacak veya orijinale eklenecek özelliklerin talimatı |
İlerlemeler
geçersiz kılma eklenmiş/güncellenmiş anahtarlara sahip özelliklerin özeti
use_netrc
use_netrc(netrc, urls, patterns)
Ayrıştırılmış bir netrc dosyasından ve bir URL listesinden bir kimlik doğrulama kodu hesaplayın.
Parametreler
netrc |
gereklidir.
Halihazırda bir dict dosyasına ayrıştırılmış bir netrc dosyası (ör.read_netrc dosyasından elde edildiği şekilde) |
urls |
gereklidir.
bir URL listesidir. |
patterns |
gereklidir.
isteğe bağlı yetkilendirme kalıpları için url talimatı |
İlerlemeler
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 depo 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, ilk dördü muhtemelen Yok değerine sahip olduğunu varsayar.
Parametreler
ctx |
gereklidir.
Bu yardımcı program işlevini çağıran depo kuralının depo bağlamı. |