Aşağıdaki işlevler @bazel_tools//tools/build_defs/repo:utils.bzl konumundan yüklenebilir.
Harici depoları getirildikten sonra değiştirmek için kullanılan yardımcı programlar.
Kurulum
Bu yardımcı programlar, diğer depo kuralları tarafından kullanılmak üzere tasarlanmıştır. Bunlar aşağıdaki şekilde yüklenebilir.
load(
"@bazel_tools//tools/build_defs/repo:utils.bzl",
"workspace_and_buildfile",
"patch",
"update_attrs",
)
download_remote_files
load("@bazel//tools/build_defs/repo:utils.bzl", "download_remote_files")
download_remote_files(ctx, auth)
Uzak dosyaları indirmek için kullanılan yardımcı işlev.
Bu kural, bir depo kuralının uygulama işlevinde kullanılmak üzere tasarlanmıştır. remote_file_urls ve remote_file_integrity parametrelerinin ctx.attr içinde bulunduğunu varsayar.
Mevcut dosyaların üzerine yazılır.
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |
auth |
isteğe bağlı.
varsayılan değer None
Bazı URL'ler için kimlik doğrulama bilgilerini belirten isteğe bağlı bir sözlük. |
İadeler
İndirme bilgileriyle eşlenen dosya yollarını içeren sözlük.
get_auth
load("@bazel//tools/build_defs/repo:utils.bzl", "get_auth")
get_auth(ctx, urls)
.netrc dosyasından bir URL listesi için doğru kimlik doğrulama sözlüğünü elde etmeye yarayan hizmet işlevi.
Varsa isteğe bağlı netrc ve auth_patterns özelliklerini destekleyin.
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |
urls |
bu, masraflı bir seçenek olabilir.
Okunacak URL'lerin listesi |
İadeler
repository_ctx.download'a iletilebilen kimlik doğrulama sözlüğü
belki
load("@bazel//tools/build_defs/repo:utils.bzl", "maybe")
maybe(repo_rule, name, **kwargs)
Yalnızca mevcut olmayan bir depoyu eklemek için kullanılan yardımcı işlev.
Bu, https://bazel.build/rules/deploying#dependencies adresinde belgelenen safe_repositories.bzl makrosunu uygulamak içindir.
Parametreler
repo_rule |
bu, masraflı bir seçenek olabilir.
depo kuralı işlevi. |
name |
bu, masraflı bir seçenek olabilir.
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. Gerekirse depoyu yan etki olarak tanımlar.
parse_netrc
load("@bazel//tools/build_defs/repo:utils.bzl", "parse_netrc")
parse_netrc(contents, filename)
En azından temel bir .netrc dosyasını ayrıştırmak için kullanılan yardımcı işlev.
Parametreler
contents |
bu, masraflı bir seçenek olabilir.
ayrıştırıcı için giriş. |
filename |
isteğe bağlı.
varsayılan değer "a .netrc file"
Hata mesajlarında kullanılacak dosya adı (varsa) |
İadeler
Makine adlarını, bunlar hakkında sağlanan bilgileri içeren bir sözlüğe eşleyen sözlük
patch
load("@bazel//tools/build_defs/repo:utils.bzl", "patch")
patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)
Zaten çıkarılmış bir depoya yama uygulama.
Bu kural, bir depo kuralının uygulama işlevinde kullanılmak üzere tasarlanmıştır. patches, patch_tool, patch_args, patch_cmds ve patch_cmds_win parametreleri belirtilmemişse ctx.attr parametresinden alınır.
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |
patches |
isteğe bağlı.
varsayılan değer None
Uygulanacak yama dosyaları. Dize, etiket veya yol listesi. |
patch_cmds |
isteğe bağlı.
varsayılan değer None
Yama için çalıştırılacak Bash komutları, bash -c'ye tek tek aktarılır. Dize listesi |
patch_cmds_win |
isteğe bağlı.
varsayılan değer None
Yama için çalıştırılacak Powershell komutları, Powershell /c'ye tek tek iletilir. Dize listesi. Bu parametrenin boolean değeri yanlışsa patch_cmds kullanılır ve bu parametre yoksayılır. |
patch_tool |
isteğe bağlı.
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ı.
varsayılan değer None
Yama aracına aktarılacak bağımsız değişkenler. Dize listesi. |
auth |
isteğe bağlı.
varsayılan değer None
Bazı URL'ler için kimlik doğrulama bilgilerini belirten isteğe bağlı bir sözlük. |
İadeler
Uzak yama URL'lerini indirme bilgilerine eşleyen sözlük.
read_netrc
load("@bazel//tools/build_defs/repo:utils.bzl", "read_netrc")
read_netrc(ctx, filename)
En azından temel bir .netrc dosyasını ayrıştırmak için kullanılan yardımcı işlev.
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |
filename |
bu, masraflı bir seçenek olabilir.
Okunacak .netrc dosyasının adı |
İadeler
Makine adlarını, bunlar hakkında sağlanan bilgileri içeren bir sözlüğe eşleyen sözlük
read_user_netrc
load("@bazel//tools/build_defs/repo:utils.bzl", "read_user_netrc")
read_user_netrc(ctx)
Kullanıcının varsayılan netrc dosyasını okuma
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |
İadeler
Makine adlarını, bunlar hakkında sağlanan bilgileri içeren bir sözlüğe eşleyen sözlük.
symlink_files
load("@bazel//tools/build_defs/repo:utils.bzl", "symlink_files")
symlink_files(ctx)
Yerel dosyaları sembolik olarak bağlamak için kullanılan yardımcı işlev.
Bu, bir depo kuralının uygulama işlevinde kullanılmak üzere tasarlanmıştır. files parametresinin ctx.attr içinde bulunduğunu varsayar.
Mevcut dosyaların üzerine yazılır.
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |
update_attrs
load("@bazel//tools/build_defs/repo:utils.bzl", "update_attrs")
update_attrs(orig, keys, override)
Belirtilen özellikleri belirli bir depo kuralı çağrısına değiştirmek ve eklemek için kullanılan hizmet işlevi.
Bu, bir kuralın yeniden üretilebilir olmasını sağlamak için kullanılır.
Parametreler
orig |
bu, masraflı bir seçenek olabilir.
Belirli bir kural çağrısıyla açıkça veya örtülü olarak ayarlanan özelliklerin sözlüğü |
keys |
bu, masraflı bir seçenek olabilir.
Bu kuralda tanımlanan özelliklerin tamamı |
override |
bu, masraflı bir seçenek olabilir.
orig öğesine eklenecek veya orig öğesinde geçersiz kılınacak özelliklerin sözlüğü |
İadeler
Geçersiz kılma işleminden eklenen/güncellenen anahtarlara sahip özelliklerin sözlüğü
use_netrc
load("@bazel//tools/build_defs/repo:utils.bzl", "use_netrc")
use_netrc(netrc, urls, patterns)
Ayrıştırılmış bir netrc dosyasından ve URL listesinden bir kimlik doğrulama sözlüğü hesaplayın.
Parametreler
netrc |
bu, masraflı bir seçenek olabilir.
netrc dosyası zaten sözlüğe ayrıştırılmış olmalıdır (ör. read_netrc'den alınmış gibi) |
urls |
bu, masraflı bir seçenek olabilir.
URL listesi |
patterns |
bu, masraflı bir seçenek olabilir.
URL'den yetkilendirme kalıplarına isteğe bağlı sözlük |
İadeler
ctx.download için kimlik doğrulama bağımsız değişkeni olarak uygun sözlük; daha doğrusu sözlük, netrc dosyasının giriş ve şifre sağladığı tüm URL'leri, ilgili giriş, şifre ve isteğe bağlı yetkilendirme kalıbını içeren bir sözlüğe ve "tür"ün "basic" veya "pattern" ile eşlenmesine eşler.
workspace_and_buildfile
load("@bazel//tools/build_defs/repo:utils.bzl", "workspace_and_buildfile")
workspace_and_buildfile(ctx)
BUILD dosyası yazmak için kullanılan yardımcı işlev.
Bu kural, bir depo kuralının uygulama işlevinde kullanılmak üzere tasarlanmıştır.
name, build_file ve build_file_content parametrelerinin ctx.attr içinde bulunduğunu varsayar. Son iki parametre, None değeriyle birlikte olabilir.
Parametreler
ctx |
bu, masraflı bir seçenek olabilir.
Bu yardımcı işlevi çağıran depo kuralının depo bağlamı. |