전역

회원

• 전체
• analysis_test_Transition
• 모두
• archive_override
• 평가
• bazel_dep
• 결합
• bool
• 구성_필드
• Depset
• dict
• dir로 변경
• 열거하기
• 실행_그룹
• 실패
• float
• getattr
• git_override
• 해커트
• 해시
• 정수
• 렌
• list
• local_path_override
• max
• 분
• module
• 모듈_확장 프로그램
• multiple_version_override
• print
• 제공업체
• range
• register_execution_platforms()
• register_execution_platforms()
• register_toolchains()입니다.
• register_toolchains()입니다.
• repository_rule(구현, attr, 로컬, environ, 구성, 원격, 문서)
• repository_rule(구현, attr, 로컬, environ, 구성, 원격, 문서)
• repr
• 반전
• 규칙
• 선택
• single_version_override
• 정렬됨
• str
• 태그_클래스
• 튜플
• 유형
• use_extension
• use_repo
• 공개 상태
• 작업공간
• zip

모두

bool all(elements)

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

매개변수

분석_테스트_전환

transition analysis_test_transition(settings)

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

이 함수는 주로 Analysis Test Framework 핵심 라이브러리를 용이하게 하기 위해 설계되었습니다. 권장사항은 문서 (또는 구현)를 참조하세요.

매개변수

모두

bool any(elements)

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

매개변수

보관_재정의

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

매개변수

bind

None bind(name, actual=None)

경고: bind()는 사용하지 않는 것이 좋습니다. 문제 및 대안에 관한 자세한 내용은 바인딩 삭제 고려를 참고하세요.

//external 패키지의 대상에 별칭을 제공합니다.

매개변수

bool

bool bool(x=False)

매개변수

구성_필드

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)

종속 요소의 모든 요소 (직접 및 간접)는 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)

매개변수

열거

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은 참에 1.0을 반환하고 거짓에 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는 int를 반환합니다.
• x가 부울이면 int은 True를 1, False를 반환합니다.
• x가 문자열이면 <sign><prefix><digits> 형식이어야 합니다. <sign>는 "+", "-"이거나 비어 있습니다 (양성으로 해석됨). <digits>는 0에서 base - 1 사이의 숫자 시퀀스이며 문자 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이고 접두사가 사용되지 않고 두 자릿수가 넘는 경우 선행 숫자는 0이 될 수 없습니다. 이는 8진수와 십진수의 혼동을 방지하기 위함입니다. 문자열로 표시되는 숫자의 크기는 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)

매개변수

max

unknown max(*args)

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

매개변수

min

unknown min(*args)

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

매개변수

모듈

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

최대 한 번만 호출됩니다. 다른 모듈이 종속되지 않는 경우처럼 모듈이 루트 모듈인 경우에만 생략할 수 있습니다.

매개변수

모듈_확장 프로그램

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

매개변수

여러_버전_재정의

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

매개변수

출력하다

None print(sep=" ", *args)

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

매개변수

제공업체

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가 지정되면 두 요소의 튜플(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()

None register_execution_platforms(*platform_labels)

매개변수

register_toolchains()

None register_toolchains(*toolchain_labels)

매개변수

register_toolchains()

None register_toolchains(*toolchain_labels)

매개변수

repository_rule(구현, attr, 로컬, environ, 구성, 원격, 문서)

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

매개변수

repository_rule(구현, attr, 로컬, environ, 구성, 원격, 문서)

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]

매개변수

문자열

string str(x)

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

매개변수

태그_클래스

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)

매개변수

저장소 사용

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 함수가 있어야 합니다.

이 작업공간의 이름을 설정합니다. 작업공간 이름은 밑줄을 구분자로 사용하는 프로젝트에 대한 자바 패키지 스타일의 설명이어야 합니다. 예를 들어 github.com/bazelbuild/bazel은 com_github_bazelbuild_bazel을 사용해야 합니다.

이 이름은 저장소의 runfile이 저장된 디렉터리에 사용됩니다. 예를 들어 로컬 저장소에 foo/bar 실행 파일이 있고 WORKSPACE 파일에 workspace(name = 'baz')가 포함된 경우 실행 파일을 mytarget.runfiles/baz/foo/bar에서 사용할 수 있습니다. 작업공간 이름이 지정되지 않으면 런파일이 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)]

매개변수