전역

회원

• all
• analysis_test_transition
• 모두
• archive_override
• aspect
• bazel_dep
• bind
• 부울
• configuration_field
• depset
• dict
• dir
• enumerate
• exec_group
• 실패
• float
• getattr
• git_override
• hasattr
• 해시
• int
• len
• list
• local_path_override
• max
• min
• module
• module_extension
• multiple_version_override
• print
• 제공자
• range
• register_execution_platforms()
• register_execution_platforms(dev_dependency)
• register_toolchains()
• register_toolchains(dev_dependency)
• repository_rule
• repr
• 취소됨
• rule
• select
• single_version_override
• 정렬됨
• str
• tag_class
• 튜플
• type
• use_extension
• use_repo
• 가시성
• workspace
• zip

모두

bool all(elements)

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

매개변수

analysis_test_transition

transition analysis_test_transition(settings)

분석 테스트 규칙의 종속 항목에 적용할 구성 전환을 만듭니다. 이 전환은 analysis_test = True가 있는 규칙의 속성에만 적용할 수 있습니다. 이러한 규칙은 기능이 제한되어 있으므로 (예: 종속 항목 트리의 크기가 제한됨) 이 함수를 사용하여 만든 전환은 transition을 사용하여 만든 전환에 비해 잠재적 범위가 제한됩니다.

이 함수는 주로 분석 테스트 프레임워크 핵심 라이브러리를 지원하도록 설계되었습니다. 권장사항은 문서 (또는 구현)를 참고하세요.

매개변수

모두

bool any(elements)

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

매개변수

archive_override

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

매개변수

관점

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)

매개변수

bazel_dep

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

매개변수

바인드

None bind(name, actual=None)

경고: bind() 사용은 권장되지 않습니다. 문제와 대안을 자세히 알아보려면 bind 삭제 고려를 참고하세요.

//external 패키지에서 타겟에 별칭을 지정합니다.

매개변수

bool

bool bool(x=False)

매개변수

configuration_field

LateBoundDefault configuration_field(fragment, name)

사용 예:

규칙 속성 정의:

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

규칙 구현에서 액세스:

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

매개변수

depset

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

depset의 모든 요소 (직접 및 간접)는 type(x) 표현식으로 얻은 것과 동일한 유형이어야 합니다.

해시 기반 세트는 반복 중에 중복을 제거하는 데 사용되므로 depset의 모든 요소는 해싱 가능해야 합니다. 그러나 이 불변식은 현재 모든 생성자에서 일관되게 검사되지 않습니다. --incompatible_always_check_depset_elements 플래그를 사용하여 일관된 검사를 사용 설정합니다. 이는 향후 출시에서 기본 동작이 될 예정입니다. 문제 10313을 참고하세요.

또한 현재 요소는 변경 불가해야 하지만 향후 이 제한이 완화될 예정입니다.

생성된 depset의 순서는 transitive depset의 순서와 호환되어야 합니다. "default" 순서는 다른 순서와 호환되며 다른 모든 순서는 자체적으로만 호환됩니다.

이전/향후 호환성에 관한 참고사항 이 함수는 현재 위치 기반 items 매개변수를 허용합니다. 이 매개변수는 지원 중단되었으며 향후 삭제될 예정입니다. 삭제 후 direct는 depset 함수의 유일한 위치 매개변수가 됩니다. 따라서 다음 두 호출은 모두 동일하며 향후에도 사용할 수 있습니다.

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

매개변수

dict

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

매개변수

dir

list dir(x)

매개변수

enumerate

list enumerate(list, start=0)

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

매개변수

exec_group

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

매개변수

fail

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

매개변수

float

float float(x=unbound)

• x가 이미 부동 소수점 수인 경우 float는 변경되지 않은 값을 반환합니다.
• x가 불리언인 경우 float는 True의 경우 1.0을, False의 경우 0.0을 반환합니다.
• x가 int인 경우 float는 x에 가장 가까운 유한 부동 소수점 값을 반환하거나 크기가 너무 큰 경우 오류를 반환합니다.
• x가 문자열인 경우 유효한 부동 소수점 리터럴이거나 NaN, Inf 또는 Infinity와 같아야 하며 (대소문자 구분 안 함) 원하는 경우 + 또는 - 부호가 앞에 올 수 있습니다.

매개변수

getattr

unknown getattr(x, name, default=unbound)

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

매개변수

git_override

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

매개변수

hasattr

bool hasattr(x, name)

hasattr(ctx.attr, "myattr")

매개변수

해시

int hash(value)

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

매개변수

int

int int(x, base=unbound)

• x가 이미 int인 경우 int는 변경되지 않은 상태로 반환합니다.
• x가 불리언인 경우 int는 True의 경우 1을, False의 경우 0을 반환합니다.
• x가 문자열인 경우 <sign><prefix><digits> 형식이어야 합니다. <sign>는 "+", "-" 또는 비어 있습니다 (양수로 해석됨). <digits>는 0에서 base - 1까지의 숫자 시퀀스이며, 여기서 a~z (또는 A~Z) 문자가 10~35의 숫자로 사용됩니다. base가 2/8/16인 경우 <prefix>는 선택사항이며 각각 0b/0o/0x (또는 이에 상응하는 0B/0O/0X)일 수 있습니다. base가 이러한 기반 외의 다른 값이거나 특수 값 0인 경우 접두사는 비어 있어야 합니다. base이 0인 경우 문자열은 정수 리터럴로 해석됩니다. 즉, 사용되는 접두사(있는 경우)에 따라 2/8/10/16 중 하나가 선택됩니다. base이 0이면 접두사가 사용되지 않으며 숫자가 2개 이상인 경우 선행 숫자가 0이 될 수 없습니다. 이는 8진수와 10진수 간의 혼동을 방지하기 위함입니다. 문자열로 표현된 숫자의 크기는 int 유형에 허용되는 범위 내에 있어야 합니다.
• x이 부동 소수점 수인 경우 int는 0으로 반올림하여 부동 소수점 수의 정수 값을 반환합니다. x가 유한하지 않은 경우 (NaN 또는 무한대) 오류가 발생합니다.

예:

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

매개변수

len

int len(x)

매개변수

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]

매개변수

local_path_override

None local_path_override(module_name, path)

매개변수

최대

unknown max(*args)

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

매개변수

분

unknown min(*args)

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

매개변수

모듈

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

최대 한 번만 호출해야 합니다. 이 모듈이 루트 모듈인 경우에만 생략할 수 있습니다 (즉, 다른 모듈에서 종속되지 않는 경우).

매개변수

module_extension

unknown module_extension(implementation, *, tag_classes={}, doc='', environ=[], os_dependent=False, arch_dependent=False)

매개변수

multiple_version_override

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

매개변수

출력하다

None print(sep=" ", *args)

프로덕션 코드에서 print를 사용하면 사용자에게 스팸이 생성되므로 권장하지 않습니다. 지원 중단의 경우 가능하면 fail()를 사용하는 하드 오류를 사용하는 것이 좋습니다.

매개변수

provider

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
    ...

제공자 사용 방법에 관한 포괄적인 가이드는 규칙 (제공자)을 참고하세요.

init가 지정되지 않은 경우 호출 가능한 Provider 값을 반환합니다.

init가 지정되면 2개의 요소(Provider 호출 가능 값 및 원시 생성자 호출 가능 값)로 구성된 튜플을 반환합니다. 자세한 내용은 규칙 (맞춤 제공업체의 맞춤 초기화) 및 아래의 init 매개변수에 관한 설명을 참고하세요.

매개변수

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

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

범위

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]

매개변수

register_execution_platforms()

None register_execution_platforms(*platform_labels)

매개변수

register_execution_platforms(dev_dependency)

None register_execution_platforms(dev_dependency=False, *platform_labels)

매개변수

register_toolchains()

None register_toolchains(*toolchain_labels)

매개변수

register_toolchains(dev_dependency)

None register_toolchains(dev_dependency=False, *toolchain_labels)

매개변수

repository_rule

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

매개변수

repr

string repr(x)

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

매개변수

reversed

list reversed(sequence)

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

매개변수

규칙

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)

규칙은 .bzl 파일의 전역 변수에 할당되어야 합니다. 전역 변수의 이름은 규칙의 이름입니다.

테스트 규칙의 이름은 _test로 끝나야 하지만 다른 모든 규칙의 이름은 이 접미사가 없어야 합니다. 이 제한은 타겟이 아닌 규칙에만 적용됩니다.

매개변수

select

unknown select(x, no_match_error='')

매개변수

single_version_override

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

매개변수

정렬됨

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

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

매개변수

str

string str(x)

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

매개변수

tag_class

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

매개변수

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)

매개변수

유형

string type(x)

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

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

매개변수

use_extension

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

매개변수

use_repo

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

매개변수

공개 상태

None visibility(value)

현재 초기화 중인 .bzl 모듈의 로드 공개 상태를 설정합니다.

모듈의 로드 공개 상태에 따라 다른 BUILD 및 .bzl 파일이 모듈을 로드할 수 있는지 여부가 결정됩니다. 이는 파일이 다른 타겟의 종속 항목으로 표시될 수 있는지를 지정하는 기본 .bzl 소스 파일의 타겟 공개 상태와는 다릅니다. 로드 공개 상태는 패키지 수준에서 작동합니다. 모듈을 로드하려면 로드를 실행하는 파일이 모듈에 공개 상태가 부여된 패키지에 있어야 합니다. 모듈은 공개 상태와 관계없이 항상 자체 패키지 내에 로드될 수 있습니다.

visibility()는 .bzl 파일당 한 번만 호출할 수 있으며 함수 내부가 아닌 최상위 수준에서만 호출할 수 있습니다. 이 호출은 load() 문과 인수를 결정하는 데 필요한 간단한 로직 바로 아래에 배치하는 것이 좋습니다.

플래그 --check_bzl_visibility가 false로 설정되면 로드 공개 상태 위반으로 인해 경고가 발생하지만 빌드가 실패하지는 않습니다.

매개변수

작업공간

None workspace(name)

이 함수는 WORKSPACE 파일에서만 사용할 수 있으며 WORKSPACE 파일의 다른 모든 함수보다 먼저 선언해야 합니다. 각 WORKSPACE 파일에는 workspace 함수가 있어야 합니다.

이 워크스페이스의 이름을 설정합니다. 워크스페이스 이름은 밑줄을 구분자로 사용하여 프로젝트의 Java 패키지 스타일 설명이어야 합니다. 예를 들어 github.com/bazelbuild/bazel은 com_github_bazelbuild_bazel을 사용해야 합니다.

이 이름은 저장소의 런파일이 저장되는 디렉터리에 사용됩니다. 예를 들어 로컬 저장소에 runfile foo/bar이 있고 WORKSPACE 파일에 workspace(name = 'baz')가 포함되어 있으면 mytarget.runfiles/baz/foo/bar에서 runfile을 사용할 수 있습니다. 워크스페이스 이름을 지정하지 않으면 runfile이 bar.runfiles/foo/bar에 심볼릭 링크됩니다.

원격 저장소 규칙 이름은 유효한 워크스페이스 이름이어야 합니다. 예를 들어 Bazel이 workspace(name = 'foo%bar')가 포함된 maven_jar의 WORKSPACE 파일을 작성하려고 시도하므로 maven_jar(name = 'foo')는 있지만 maven_jar(name = 'foo%bar')는 없을 수 있습니다.

매개변수

우편번호

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)]

매개변수