Küresel

Üyeler

• tümü
• analysis_test_transition
• herhangi biri
• archive_override
• aspect
• bazel_dep
• bağla
• bool
• configuration_field
• depset
• dict
• dir
• enumerate
• exec_group
• başarısız
• float
• getattr
• git_override
• hasattr
• hash
• int
• len
• list
• local_path_override
• max
• dk.
• module
• module_extension
• multiple_version_override
• print
• sağlayıcı
• aralık
• register_execution_platforms()
• register_execution_platforms(dev_dependency)
• register_toolchains()
• register_toolchains(dev_dependency)
• repository_rule(APPLICATION, attrs, local, environ, configuration, remotable, doc)
• repository_rule(implementation, attrs, local, environ, configure, remotable, doc)
• repr
• ters
• rule
• seç
• single_version_override
• sıralı
• str
• tag_class
• tuple
• type
• use_extension
• use_repo
• visibility
• workspace
• 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)

Bir 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 işlevleri sınırlıdır (örneğin, bağımlılık ağacının boyutu sınırlıdır). Bu nedenle, bu işlev kullanılarak oluşturulan geçişler, geçiş kullanılarak oluşturulan geçişlere kıyasla potansiyel kapsam açısından sınırlıdır.

Bu işlev, temel olarak Analysis Test Framework temel kitaplığını kolaylaştırmak için tasarlanmıştır. En iyi uygulamalar için dokümanlarına (veya uygulanmasına) bakın.

Parametreler

herhangi

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='', max_compatibility_level=-1, repo_name='', dev_dependency=False)

Parametreler

bind

None bind(name, actual=None)

Uyarı: bind() kullanılması önerilmez. Sorunları ve alternatifleri hakkında ayrıntılı bilgi için bind işlevini kaldırmayı düşünün başlıklı makaleyi inceleyin.

Bir hedefe //external paketinde bir takma ad verir.

Parametreler

bool

bool bool(x=False)

Parametreler

configuration_field

LateBoundDefault configuration_field(fragment, name)

Örnek kullanım:

Kural özelliğini tanımlama:

'_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

depset

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

Bir depsetteki tüm öğeler (doğrudan ve dolaylı), type(x) ifadesiyle elde edilen türde olmalıdır.

Yineleme sırasında yinelemeleri ortadan kaldırmak için karma oluşturmaya dayalı bir küme kullanıldığından, depset'in tüm öğeleri karma oluşturmaya uygun olmalıdır. Ancak bu değişmez özellik şu anda tüm kurucularda tutarlı bir şekilde kontrol edilmemektedir. Tutarlı kontrolü etkinleştirmek için --incompatible_always_check_depset_elements işaretini kullanın. Bu, gelecekteki sürümlerde varsayılan davranış olacaktır. Sayı 10313 sorununa bakın.

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

Oluşturulan depsetin sırası, transitive depsetlerinin sırası ile 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 dönük/ileri dönük uyumlulukla ilgili not. Bu işlev şu anda konumsal bir items parametresini kabul etmektedir. Bu işlev için destek sonlandırılmış olup gelecekte kaldırılacaktır. Kaldırıldıktan sonra direct, depset işlevinin tek konumsal parametresi haline gelecektir. Bu nedenle, aşağıdaki çağrıların ikisi de eşdeğerdir ve gelecekte de geçerli olacaktı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

kayan noktalı

float float(x=unbound)

• x zaten kayan noktalı bir değerse float, değeri değiştirmeden döndürür.
• x bir bool ise float, Doğru için 1,0, Yanlış için 0,0 döndürür.
• x bir int ise float, x'e en yakın sonlu kayan nokta değerini döndürür veya büyüklük çok büyükse bir hata döndürür.
• x bir dize ise geçerli bir kayan noktalı değişmez değer veya NaN, Inf ya da Infinity ile eşit (büyük/küçük harf duyarlılığı yoksayılır) olmalıdır. Dilerseniz + veya - işareti de ekleyebilirsiniz.

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ı ise int bunu değiştirmeden döndürür.
• x bir boole ise int, True için 1 ve False için 0 değerini döndürür.
• x bir dizeyse <sign><prefix><digits> biçiminde olmalıdır. <sign>, "+", "-" veya boştur (pozitif olarak yorumlanır). <digits>, 0 ile base - 1 arasındaki bir basamak dizisidir. Bu dizede, 10-35 için a-z harfleri (veya eşdeğeri olarak A-Z) basamak olarak kullanılır. base 2/8/16 ise <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 dışında başka bir değer veya özel değer 0 ise ön ek boş olmalıdır. base değerinin 0 olduğu durumda dize, kullanılan ön eke bağlı olarak 2/8/10/16 tabanlarından birinin seçilmesi anlamında tam sayı sabit değeri olarak yorumlanır. base değeri 0 ise, herhangi bir ön ek kullanılmaz ve birden fazla basamak varsa baştaki basamak 0 olamaz. Bunun amacı, sekizlik ve ondalık arasında karışıklık olmasını önlemektir. Dizeyle temsil edilen sayının büyüklüğü, int türü için izin verilen aralık içinde olmalıdır.
• x bir kayan noktalı sayıysa int, sıfıra yuvarlanarak kayan noktalı değerin tam sayı değerini döndürür. x sonlu değilse (NaN veya sonsuzluk) 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

dk

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 aranmalıdır. Yalnızca bu modül kök modülse (yani başka bir modül tarafından bağımlı 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 spam oluşturduğundan, üretim kodunda print kullanılması önerilmez. Desteği sonlandırılan özellikler için mümkün olduğunda fail() kullanarak kesin hata 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) başlıklı makaleyi inceleyin.

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

init belirtilirse 2 öğeden oluşan bir öğe döndürür: bir Provider çağrılabilir değer ve ham oluşturucu çağrılabilir değer. Ayrıntılar için Kurallar (Özel sağlayıcıların özel başlatılması) bölümüne ve init parametresiyle ilgili açıklamaya 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(dev_dependency)

None register_execution_platforms(dev_dependency=False, *platform_labels)

Parametreler

register_toolchains()

None register_toolchains(*toolchain_labels)

Parametreler

register_toolchains(dev_dependency)

None register_toolchains(dev_dependency=False, *toolchain_labels)

Parametreler

repository_rule(implementation, attrs, local, environ, configure, remotable, doc)

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

Parametreler

repository_rule(implementation, attrs, local, environ, configure, remotable, doc)

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

Parametreler

yir

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ındaki genel değişkenlere atanmalıdır. Genel değişkenin adı, kuralın adıdır.

Test kurallarının adının _test ile bitmesi gerekir. Diğer tüm kuralların adında bu son ek bulunmamalıdır. (Bu kısıtlama yalnızca kurallar için geçerli olup hedeflerinin kapsamına girmez.)

Parametreler

seç

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ıralanmış

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, isolate=False)

Parametreler

use_repo

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

Parametreler

görünürlük

None visibility(value)

Şu anda başlatılmakta olan .bzl modülünün yük görünürlüğünü ayarlar.

Bir modülün yükleme görünürlüğü, diğer BUILD ve .bzl dosyalarının bu modülü yükleyip yükleyemeyeceğini belirler. (Bu, dosyanın diğer hedeflerin bağımlılığı olarak görünüp görünmeyeceğini yöneten temel .bzl kaynak dosyasının hedef görünürlüğünden farklıdır.) Yükleme görünürlüğü, paket düzeyinde çalışır: Bir modülü yüklemek için yüklemeyi yapan dosya, modüle görünürlüğü verilen bir pakette bulunmalıdır. Bir modül, görünürlüğünden bağımsız olarak her zaman kendi paketi içinde yüklenebilir.

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

--check_bzl_visibility işareti yanlış değerine ayarlanırsa yük görünürlüğü ihlalleri uyarı verir ancak derleme 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 tanımlanmalıdır. Her WORKSPACE dosyasında bir workspace işlevi olmalıdır.

Bu çalışma alanının adını belirler. Workspace adları, ayırıcı olarak alt çizgilerin kullanıldığı, projenin Java paketi tarzında bir açıklaması olmalıdır. Örneğin, github.com/bazelbuild/bazel için com_github_bazelbuild_bazel kullanılmalıdır.

Bu ad, deponun çalıştırma dosyalarının depolandığı dizin için kullanılır. Örneğin, yerel depoda foo/bar adlı bir çalıştırma dosyası varsa ve WORKSPACE dosyası workspace(name = 'baz') içeriyorsa çalıştırma dosyası mytarget.runfiles/baz/foo/bar altında kullanılabilir. Workspace adı belirtilmezse çalıştırma dosyası bar.runfiles/foo/bar ile sembolik bağlantı oluşturur.

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

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