Küresel

Üyeler

• tümü
• analysis_test_transition
• herhangi bir
• archive_override
• en boy
• bazel_dep
• bind
• bool
• configuration_field
• depset
• dict
• dir
• listele
• exec_group
• başarısız
• float
• getattr
• git_override
• hasattr
• karma
• int
• len
• list
• local_path_override
• maks
• dk.
• modül
• module_extension
• multiple_version_override
• yazdır
• sağlayıcı
• aralık
• register_execution_platforms()
• register_execution_platforms()
• register_toolchains()
• register_toolchains()
• repository_rule(uygulama, attrs, yerel, environ, yapılandır, uzaklaştır, doküman)
• repository_rule(uygulama, attrs, yerel, environ, yapılandır, uzaklaştır, doküman)
• repr
• ters
• kural
• seç
• single_version_override
• sıralı
• str
• tag_class
• tuple
• tür
• use_extension
• use_repo
• görünürlük
• çalışma alanı
• zip

tümü

bool all(elements)

all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parametreler

analysis_test_transition

transition analysis_test_transition(settings)

Analiz-test kuralının bağımlılıklarına uygulanacak bir yapılandırma geçişi oluşturur. Bu geçiş yalnızca analysis_test = True içeren kuralların özelliklerine uygulanabilir. Bu tür kuralların özellikleri kısıtlıdır (örneğin, bağımlılık ağaçlarının boyutu sınırlıdır). Bu nedenle, bu işlevi kullanarak oluşturulan geçişler, geçiş kullanılarak oluşturulan geçişlere kıyasla potansiyel kapsamla sınırlıdır.

Bu işlev, temel olarak Analysis Test Çerçevesi çekirdek kitaplığını kolaylaştırmak amacıyla tasarlanmıştır. En iyi uygulamalar için ürünün dokümanlarına (veya uygulamasına) bakın.

Parametreler

Tümü

bool any(elements)

any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parametreler

archive_override

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

Parametreler

ilişkili program

Aspect aspect(implementation, attr_aspects=[], attrs=None, required_providers=[], required_aspect_providers=[], provides=[], requires=[], fragments=[], host_fragments=[], toolchains=[], incompatible_use_toolchain_transition=False, doc='', *, apply_to_generating_rules=False, exec_compatible_with=[], exec_groups=None)

Parametreler

bazel_dep

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

Parametreler

bind

None bind(name, actual=None)

Uyarı: bind() kullanılması önerilmez. Sorunları ve alternatifleriyle ilgili uzun açıklamalar için Bağlamayı kaldırma bölümüne bakın.

//external paketinde bir hedefe takma ad verir.

Parametreler

bool

bool bool(x=False)

Parametreler

configuration_field

LateBoundDefault configuration_field(fragment, name)

Örnek kullanım:

Kural özelliği tanımlanıyor:

'_foo': attr.label(default=configuration_field(fragment='java', name='toolchain'))

Kural uygulamasında erişim:

  def _rule_impl(ctx):
    foo_info = ctx.attr._foo
    ...

Parametreler

bitirmek

depset depset(direct=None, order="default", *, transitive=None)

Depset'in tüm öğeleri (doğrudan ve dolaylı), type(x) ifadesiyle elde edilen aynı türde olmalıdır.

Yineleme sırasında yinelemeleri ortadan kaldırmak için karma tabanlı bir küme kullanıldığından, depset kümesinin tüm öğelerine karma oluşturma işlemi uygulanabilir. Ancak bu değişmez değer, şu anda tüm oluşturucularda tutarlı bir şekilde kontrol edilmemektedir. Tutarlı kontrol sağlamak için --incompatible_always_check_depset_elements işaretini kullanın. Bu, gelecekteki sürümlerde varsayılan davranış olacaktır. Sorun 10313'e bakın.

Ayrıca, öğeler şu anda sabit olmalıdır, ancak bu kısıtlama gelecekte gevşetilecektir.

Oluşturulan dep kümesinin sırası, transitive alt kümelerinin sıralamasıyla uyumlu olmalıdır. "default" siparişi diğer tüm siparişlerle uyumludur, diğer tüm siparişler yalnızca kendileriyle uyumludur.

Geriye-ileri uyumlulukla ilgili not alın. Bu işlev şu anda konumsal items parametresini kabul ediyor. Artık desteği sonlandırılmış olup ileride kaldırılacaktır. Ayrıca, direct kaldırıldıktan sonra depset işlevinin tek konum parametresi olacaktır. Bu nedenle, aşağıdaki çağrıların ikisi de eşdeğerdir ve geleceğe hazırdır:

depset(['a', 'b'], transitive = [...])
depset(direct = ['a', 'b'], transitive = [...])

Parametreler

dict

dict dict(pairs=[], **kwargs)

Parametreler

dir

list dir(x)

Parametreler

numaralandırmak

list enumerate(list, start=0)

enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parametreler

exec_group

exec_group exec_group(toolchains=[], exec_compatible_with=[], copy_from_rule=False)

Parametreler

başarısız

None fail(msg=None, attr=None, *args)

Parametreler

float

float float(x=unbound)

• x zaten bir kesirli sayıysa float bunu değiştirmeden döndürür.
• x bir Bool ise float, Doğru için 1.0 ve Yanlış için 0.0 döndürür.
• x bir tam sayıysa float, x'e en yakın sonlu kayan nokta değerini döndürür veya büyüklük çok büyükse hata döndürür.
• x bir dizeyse bu, geçerli bir kayan nokta sabit değeri olmalı veya NaN, Inf ya da Infinity ile eşit olmalıdır (büyük/küçük harfe duyarlı değil). İsteğe bağlı olarak öncesinde + veya - işareti olmalıdır.

Parametreler

Getattr

unknown getattr(x, name, default=unbound)

getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parametreler

git_override

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

Parametreler

Hasattr

bool hasattr(x, name)

hasattr(ctx.attr, "myattr")

Parametreler

hash

int hash(value)

s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]

Parametreler

int

int int(x, base=unbound)

• x zaten bir tam sayıysa int bunu değiştirmeden döndürür.
• x bir Bool ise int, Doğru için 1 ve Yanlış için 0 değerini döndürür.
• x bir dizeyse <sign><prefix><digits> biçiminde olmalıdır. <sign>, "+" ya da "-" değerine sahip veya boş (pozitif olarak yorumlanır). <digits>, 0'dan base - 1'e kadar olan bir sayı dizisidir. Burada, a-z (veya eşdeğer olarak A-Z) harfleri 10-35 için rakam olarak kullanılır. base değerinin 08.02.2016 olduğu durumda <prefix> isteğe bağlıdır ve sırasıyla 0b/0o/0x (veya eşdeğer olarak 0B/0O/0X) olabilir. base, bu tabanlar veya 0 özel değeri dışında başka bir değerse önek boş olmalıdır. base ifadesinin 0 olduğu durumda dize, kullanılan ön eke bağlı olarak 2/8/10/16 tabanlarından biri seçildiği için bir tam sayı olarak yorumlanır. base 0 ise, ön ek kullanılmaz ve birden fazla basamak varsa baştaki basamak 0 olamaz. Bunun amacı, sekizlik ve ondalık basamak arasında karışıklık olmasını önlemektir. Dizenin temsil ettiği sayının büyüklüğü, int türü için izin verilen aralıkta olmalıdır.
• x bir ondalık sayıysa int, sıfıra doğru yuvarlanarak ondalık değerinin tam sayı değerini döndürür. x sonlu değilse (NaN veya sonsuzsa) bir hatadır.

Örnekler:

int("123") == 123
int("-123") == -123
int("+123") == 123
int("FF", 16) == 255
int("0xFF", 16) == 255
int("10", 0) == 10
int("-0x10", 0) == -16
int("-0x10", 0) == -16
int("123.456") == 123

Parametreler

len

int len(x)

Parametreler

list

list list(x=[])

list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

Parametreler

local_path_override

None local_path_override(module_name, path)

Parametreler

maks.

unknown max(*args)

max(2, 5, 4) == 5
max([5, 6, 3]) == 6

Parametreler

dak

unknown min(*args)

min(2, 5, 4) == 2
min([5, 6, 3]) == 3

Parametreler

modül

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

En fazla bir kez çağrılmalıdır. Yalnızca bu modül kök modülse (başka bir modüle bağlı olmayacaksa) atlanabilir.

Parametreler

module_extension

unknown module_extension(implementation, *, tag_classes={}, doc='')

Parametreler

multiple_version_override

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

Parametreler

yazdır

None print(sep=" ", *args)

Kullanıcılar için oluşturduğu spam nedeniyle, üretim kodunda print kullanılması önerilmez. Kullanımdan kaldırma işlemleri için mümkünse fail() kullanılmasını tercih edin.

Parametreler

sağlayıcı

unknown provider(doc='', *, fields=None, init=None)

MyInfo = provider()
...
def _my_library_impl(ctx):
    ...
    my_info = MyInfo(x = 2, y = 3)
    # my_info.x == 2
    # my_info.y == 3
    ...

Sağlayıcıların nasıl kullanılacağıyla ilgili kapsamlı bir kılavuz için Kurallar (Sağlayıcılar) bölümüne bakın.

init belirtilmezse Provider çağrılabilir bir değer döndürür.

init belirtilirse 2 öğeden oluşan bir çift döndürür: Provider çağrılabilir değeri ve ham oluşturucu çağrılabilir değeri. Ayrıntılar için Kurallar (Özel sağlayıcıların özelleştirmesi) bölümüne ve aşağıdaki init parametresine ilişkin açıklamalara bakın.

Parametreler

MyInfo = provider()
m = MyInfo(foo = 1)

MyInfo, _new_myinfo = provider(init = ...)

aralık

sequence range(start_or_stop, stop_or_none=None, step=1)

range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

Parametreler

register_execution_platforms()

None register_execution_platforms(*platform_labels)

Parametreler

register_execution_platforms()

None register_execution_platforms(*platform_labels)

Parametreler

register_toolchains()

None register_toolchains(*toolchain_labels)

Parametreler

register_toolchains()

None register_toolchains(*toolchain_labels)

Parametreler

repository_rule(uygulama, attrs, yerel, environ, yapılandır, uzaklaştırılan, doküman)

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc='')

Parametreler

repository_rule(uygulama, attrs, yerel, environ, yapılandır, uzaklaştırılan, doküman)

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc='')

Parametreler

yy

string repr(x)

repr("ab") == '"ab"'

Parametreler

tersine çevrildi

list reversed(sequence)

reversed([3, 5, 4]) == [4, 5, 3]

Parametreler

kural

callable rule(implementation, test=False, attrs=None, outputs=None, executable=False, output_to_genfiles=False, fragments=[], host_fragments=[], _skylark_testable=False, toolchains=[], incompatible_use_toolchain_transition=False, doc='', *, provides=[], exec_compatible_with=[], analysis_test=False, build_setting=None, cfg=None, exec_groups=None, compile_one_filetype=None, name=None)

Kurallar, .bzl dosyası içindeki genel değişkenlere atanmalıdır. Genel değişkenin adı, kuralın adıdır.

Test kurallarının adı _test ile bitmelidir. Diğer kurallarda bu son ek bulunmamalıdır. (Bu kısıtlama yalnızca kurallar için geçerlidir, hedefleri için geçerli değildir.)

Parametreler

seçer

unknown select(x, no_match_error='')

Parametreler

single_version_override

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

Parametreler

sıralandı

list sorted(iterable, *, key=None, reverse=False)

sorted([3, 5, 4]) == [3, 4, 5]

Parametreler

str

string str(x)

str("ab") == "ab"
str(8) == "8"

Parametreler

tag_class

tag_class tag_class(attrs={}, *, doc='')

Parametreler

tuple

tuple tuple(x=())

tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

Parametreler

tür

string type(x)

type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"

if type(x) == type([]):  # if x is a list

Parametreler

use_extension

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

Parametreler

use_repo

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

Parametreler

görünürlük

None visibility(value)

Başlatılmakta olan .bzl modülünün yükleme görünürlüğünü ayarlar.

Bir modülün yük görünürlüğü, diğer BUILD ve .bzl dosyalarının onu yükleyip yükleyemeyeceğini belirler. (Bu, temel .bzl kaynak dosyasının hedef görünürlüğünden farklıdır. Bu kaynak, dosyanın diğer hedeflerin bağımlılığı olarak görünüp görünemeyeceğini belirler.) Yük görünürlüğü, paket düzeyinde çalışır: Bir modül yüklemek için, yüklemeyi yapan dosyanın, modülün görünürlüğüne izin verilen bir pakette bulunması gerekir. Bir modül, görünürlüğü ne olursa olsun her zaman kendi paketi içinde yüklenebilir.

visibility(), her .bzl dosyası için yalnızca bir kez ve yalnızca üst düzeyde çağrılabilir, bir işlevin içinde çağırılamaz. Tercih edilen stil, bu çağrının load() ifadelerinin ve bağımsız değişkeni belirlemek için gereken kısa mantığın hemen altına yerleştirilmesidir.

--check_bzl_visibility işareti false (yanlış) değerine ayarlanırsa yük görünürlüğü ihlalleri uyarı verir ancak derlemede başarısız olmaz.

Parametreler

çalışma alanı

None workspace(name)

Bu işlev yalnızca bir WORKSPACE dosyasında kullanılabilir ve WORKSPACE dosyasındaki diğer tüm işlevlerden önce bildirilmelidir. Her WORKSPACE dosyası bir workspace işlevine sahip olmalıdır.

Bu çalışma alanının adını ayarlar. Çalışma alanı adları, projenin Java paketi tarzında bir açıklaması olmalı ve ayırıcı olarak alt çizgi kullanılmalıdır. Örneğin, github.com/bazelbuild/bazel, com_github_bazelbuild_bazel kullanmalıdır.

Bu ad, deponun çalıştırma dosyalarının depolandığı dizin için kullanılır. Örneğin, yerel depoda çalıştırma dosyası foo/bar bulunuyorsa ve WORKSPACE dosyası workspace(name = 'baz') dosyası içeriyorsa çalıştırma dosyası mytarget.runfiles/baz/foo/bar altında kullanılabilir. Çalışma alanı adı belirtilmezse çalıştırma dosyası, bar.runfiles/foo/bar ile sembolik olarak bağlanır.

Uzak depo kural adları, geçerli çalışma alanı adları olmalıdır. Örneğin, maven_jar(name = 'foo') olabilir ancak maven_jar(name = 'foo%bar') olmayabilir. Çünkü Bazel, workspace(name = 'foo%bar') içeren maven_jar için bir WORKSPACE dosyası yazmaya çalışacaktır.

Parametreler

zip

list zip(*args)

zip()  # == []
zip([1, 2])  # == [(1,), (2,)]
zip([1, 2], [3, 4])  # == [(1, 3), (2, 4)]
zip([1, 2], [3, 4, 5])  # == [(1, 3), (2, 4)]

Parametreler