속성

이 모듈은 규칙 또는 관점의 속성 스키마를 정의하는 최상위 모듈입니다. 각 함수는 단일 속성의 스키마를 나타내는 객체를 반환합니다. 이러한 객체는 rule() 및 aspect()의 attrs 사전 인수 값으로 사용됩니다.

속성 정의 및 사용에 대한 자세한 내용은 규칙 페이지를 참조하세요.

구성원

• bool
• int
• int_list
• label
• label_keyed_string_dict
• label_list
• 출력
• output_list
• 문자열
• string_dict
• string_list
• string_list_dict

bool

Attribute attr.bool(default=False, doc='', mandatory=False)

불리언 속성의 스키마를 만듭니다.

매개변수

매개변수	설명
default	default = False 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않은 경우 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).

int

Attribute attr.int(default=0, doc='', mandatory=False, values=[])

정수 속성의 스키마를 만듭니다. 값은 부호가 있는 32비트 범위 내에 있어야 합니다.

매개변수

매개변수	설명
default	기본값 = 0 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않으면 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
values	sequence of ints; default = [] 속성에 허용되는 값의 목록입니다. 다른 값이 제공되면 오류가 발생합니다.

int_list

Attribute attr.int_list(mandatory=False, allow_empty=True, *, default=[], doc='')

정수 목록 속성의 스키마를 만듭니다. 각 요소는 부호가 있는 32비트 범위 내에 있어야 합니다.

매개변수

매개변수	설명
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
default	sequence of ints; default = [] 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않으면 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.

라벨

Attribute attr.label(default=None, doc='', executable=False, allow_files=None, allow_single_file=None, mandatory=False, providers=[], allow_rules=None, cfg=None, aspects=[])

라벨 속성의 스키마를 만듭니다. 이는 종속 항목 속성입니다.

이 속성에는 고유한 Label 값이 포함됩니다. Label 대신 문자열이 제공된 경우 라벨 생성자를 사용하여 변환됩니다. (이름이 변경되었을 수 있는) 저장소를 비롯한 라벨 경로의 상대 부분은 인스턴스화된 대상의 패키지와 관련하여 확인됩니다.

규칙 구현 함수 내에서 분석 시 ctx.attr에서 속성 값을 가져올 때 라벨이 상응하는 Target로 교체됩니다. 이렇게 하면 현재 타겟의 종속 항목 제공업체에 액세스할 수 있습니다.

이러한 종류의 속성은 일반적인 소스 파일 외에도 컴파일러와 같은 도구를 참조하는 데 자주 사용됩니다. 이러한 도구는 소스 파일과 마찬가지로 종속 항목으로 간주됩니다. 사용자가 BUILD 파일에서 규칙을 사용할 때마다 도구의 라벨을 지정하지 않도록 하려면 표준 도구의 라벨을 이 속성의 default 값으로 하드 코딩하면 됩니다. 또한 사용자가 이 기본값을 재정의하지 못하게 하려면 밑줄로 시작하는 이름을 지정하여 속성을 비공개로 만들면 됩니다. 자세한 내용은 규칙 페이지를 참조하세요.

매개변수

매개변수	설명
default	Label; or string; or LateBoundDefault; or NativeComputedDefault; or function; or None; default = None 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않으면 사용할 기본값입니다.문자열 또는 Label 함수를 사용하여 기본값(예: attr.label(default = "//a:b"))을 지정하세요.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
executable	default = False 종속 항목이 실행 가능해야 하는 경우 true입니다. 즉, 라벨은 실행 파일 또는 실행 파일을 출력하는 규칙을 참조해야 합니다. ctx.executable.<attribute_name>로 라벨에 액세스합니다.
allow_files	bool; or sequence of strings; or None; default = None File 타겟의 허용 여부입니다. True, False (기본값) 또는 허용되는 파일 확장자 목록 (예: [".cc", ".cpp"])일 수 있습니다.
allow_single_file	default = None allow_files와 유사하지만 라벨이 단일 파일과 일치해야 한다는 제한사항이 있습니다. ctx.file.<attribute_name>를 통해 액세스합니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
providers	default = [] 이 속성에 나타나는 종속 항목에서 제공해야 하는 제공자입니다. 이 인수의 형식은 제공자 목록 목록입니다. 즉, provider()에서 반환된 *Info 객체 (기존 제공자의 경우 문자열 이름)입니다. 종속 항목은 내부 목록 중 하나 이상에서 언급된 모든 제공자를 반환해야 합니다. 편의를 위해 이 인수는 단일 수준의 제공자 목록일 수도 있으며, 이 경우 요소가 하나의 외부 목록에 래핑됩니다.
allow_rules	sequence of strings; or None; default = None 허용되는 규칙 대상 (클래스 이름)입니다. 이는 지원 중단되었으며 (호환성을 위해서만 유지됨) 대신 제공자를 사용하세요.
cfg	default = None 속성의 구성입니다. 이는 종속 항목이 execution platform용으로 빌드되었음을 나타내는 "exec" 또는 종속 항목이 target platform용으로 빌드되었음을 나타내는 "target"일 수 있습니다. 차이점의 일반적인 예로는 모바일 앱을 빌드할 때 target platform이 Android 또는 iOS이고 execution platform가 Linux, macOS 또는 Windows인 경우입니다. executable가 True인 경우 대상 구성에서 호스트 도구를 실수로 빌드하는 것을 방지하기 위해 이 매개변수가 필요합니다. "target"는 시맨틱 효과가 없으므로 의도를 명확히 하는 데 실제로 도움이 되지 않는다면 executable가 False인 경우 설정하지 마세요.
aspects	sequence of Aspects; default = [] 이 속성에 의해 지정된 종속 항목에 적용되어야 하는 관점입니다.

label_keyed_string_dict

Attribute attr.label_keyed_string_dict(allow_empty=True, *, default={}, doc='', allow_files=None, allow_rules=None, providers=[], flags=[], mandatory=False, cfg=None, aspects=[])

키는 라벨이고 값은 문자열인 사전을 보유한 속성에 대한 스키마를 만듭니다. 이는 종속 항목 속성입니다.

이 속성에는 고유한 Label 값이 포함됩니다. Label 대신 문자열이 제공된 경우 라벨 생성자를 사용하여 변환됩니다. (이름이 변경되었을 수 있는) 저장소를 비롯한 라벨 경로의 상대 부분은 인스턴스화된 대상의 패키지와 관련하여 확인됩니다.

규칙 구현 함수 내에서 분석 시 ctx.attr에서 속성 값을 가져올 때 라벨이 상응하는 Target로 교체됩니다. 이렇게 하면 현재 타겟의 종속 항목 제공업체에 액세스할 수 있습니다.

매개변수

매개변수	설명
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
default	dict; or function; default = {} 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않는 경우 사용할 기본값입니다.문자열이나 Label 함수를 사용하여 기본값을 지정합니다(예: attr.label_keyed_string_dict(default = {"//a:b": "value", "//a:c": "string"})).
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
allow_files	bool; or sequence of strings; or None; default = None File 타겟의 허용 여부입니다. True, False (기본값) 또는 허용되는 파일 확장자 목록 (예: [".cc", ".cpp"])일 수 있습니다.
allow_rules	sequence of strings; or None; default = None 허용되는 규칙 대상 (클래스 이름)입니다. 이는 지원 중단되었으며 (호환성을 위해서만 유지됨) 대신 제공자를 사용하세요.
providers	default = [] 이 속성에 나타나는 종속 항목에서 제공해야 하는 제공자입니다. 이 인수의 형식은 제공자 목록 목록입니다. 즉, provider()에서 반환된 *Info 객체 (기존 제공자의 경우 문자열 이름)입니다. 종속 항목은 내부 목록 중 하나 이상에서 언급된 모든 제공자를 반환해야 합니다. 편의를 위해 이 인수는 단일 수준의 제공자 목록일 수도 있으며, 이 경우 요소가 하나의 외부 목록에 래핑됩니다.
flags	sequence of strings; default = [] 지원 중단되며 삭제됩니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
cfg	default = None 속성의 구성입니다. 이는 종속 항목이 execution platform용으로 빌드되었음을 나타내는 "exec" 또는 종속 항목이 target platform용으로 빌드되었음을 나타내는 "target"일 수 있습니다. 차이점의 일반적인 예로는 모바일 앱을 빌드할 때 target platform이 Android 또는 iOS이고 execution platform가 Linux, macOS 또는 Windows인 경우입니다.
aspects	sequence of Aspects; default = [] 이 속성에 의해 지정된 종속 항목에 적용되어야 하는 관점입니다.

label_list

Attribute attr.label_list(allow_empty=True, *, default=[], doc='', allow_files=None, allow_rules=None, providers=[], flags=[], mandatory=False, cfg=None, aspects=[])

라벨 목록 속성의 스키마를 만듭니다. 이는 종속 항목 속성입니다.

이 속성에는 고유한 Label 값이 포함됩니다. Label 대신 문자열이 제공된 경우 라벨 생성자를 사용하여 변환됩니다. (이름이 변경되었을 수 있는) 저장소를 비롯한 라벨 경로의 상대 부분은 인스턴스화된 대상의 패키지와 관련하여 확인됩니다.

규칙 구현 함수 내에서 분석 시 ctx.attr에서 속성 값을 가져올 때 라벨이 상응하는 Target로 교체됩니다. 이렇게 하면 현재 타겟의 종속 항목 제공업체에 액세스할 수 있습니다.

매개변수

매개변수	설명
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
default	sequence of Labels; or function; default = [] 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않는 경우 사용할 기본값입니다.문자열 또는 Label 함수를 사용하여 기본값을 지정합니다(예: attr.label_list(default = ["//a:b", "//a:c"])).
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
allow_files	bool; or sequence of strings; or None; default = None File 타겟의 허용 여부입니다. True, False (기본값) 또는 허용되는 파일 확장자 목록 (예: [".cc", ".cpp"])일 수 있습니다.
allow_rules	sequence of strings; or None; default = None 허용되는 규칙 대상 (클래스 이름)입니다. 이는 지원 중단되었으며 (호환성을 위해서만 유지됨) 대신 제공자를 사용하세요.
providers	default = [] 이 속성에 나타나는 종속 항목에서 제공해야 하는 제공자입니다. 이 인수의 형식은 제공자 목록 목록입니다. 즉, provider()에서 반환된 *Info 객체 (기존 제공자의 경우 문자열 이름)입니다. 종속 항목은 내부 목록 중 하나 이상에서 언급된 모든 제공자를 반환해야 합니다. 편의를 위해 이 인수는 단일 수준의 제공자 목록일 수도 있으며, 이 경우 요소가 하나의 외부 목록에 래핑됩니다.
flags	sequence of strings; default = [] 지원 중단되며 삭제됩니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
cfg	default = None 속성의 구성입니다. 이는 종속 항목이 execution platform용으로 빌드되었음을 나타내는 "exec" 또는 종속 항목이 target platform용으로 빌드되었음을 나타내는 "target"일 수 있습니다. 차이점의 일반적인 예로는 모바일 앱을 빌드할 때 target platform이 Android 또는 iOS이고 execution platform가 Linux, macOS 또는 Windows인 경우입니다.
aspects	sequence of Aspects; default = [] 이 속성에 의해 지정된 종속 항목에 적용되어야 하는 관점입니다.

출력

Attribute attr.output(doc='', mandatory=False)

출력 (라벨) 속성의 스키마를 만듭니다.

이 속성에는 고유한 Label 값이 포함됩니다. Label 대신 문자열이 제공된 경우 라벨 생성자를 사용하여 변환됩니다. (이름이 변경되었을 수 있는) 저장소를 비롯한 라벨 경로의 상대 부분은 인스턴스화된 대상의 패키지와 관련하여 확인됩니다.

분석 시 ctx.outputs를 사용하여 상응하는 File를 가져올 수 있습니다.

매개변수

매개변수	설명
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).

output_list

Attribute attr.output_list(allow_empty=True, *, doc='', mandatory=False)

list-of-outputs 속성의 스키마를 만듭니다.

이 속성에는 고유한 Label 값이 포함됩니다. Label 대신 문자열이 제공된 경우 라벨 생성자를 사용하여 변환됩니다. (이름이 변경되었을 수 있는) 저장소를 비롯한 라벨 경로의 상대 부분은 인스턴스화된 대상의 패키지와 관련하여 확인됩니다.

분석 시 ctx.outputs를 사용하여 상응하는 File를 가져올 수 있습니다.

매개변수

매개변수	설명
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).

string

Attribute attr.string(default='', doc='', mandatory=False, values=[])

문자열 속성의 스키마를 만듭니다.

매개변수

매개변수	설명
default	string; or NativeComputedDefault; default = '' 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않으면 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
values	sequence of strings; default = [] 속성에 허용되는 값의 목록입니다. 다른 값이 제공되면 오류가 발생합니다.

string_dict

Attribute attr.string_dict(allow_empty=True, *, default={}, doc='', mandatory=False)

키와 값이 문자열인 사전을 보유하는 속성의 스키마를 만듭니다.

매개변수

매개변수	설명
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
default	default = {} 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않는 경우 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).

string_list

Attribute attr.string_list(mandatory=False, allow_empty=True, *, default=[], doc='')

문자열 목록 속성에 대한 스키마를 만듭니다.

매개변수

매개변수	설명
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
default	sequence of strings; or NativeComputedDefault; default = [] 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않으면 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.

string_list_dict

Attribute attr.string_list_dict(allow_empty=True, *, default={}, doc='', mandatory=False)

키는 문자열이고 값은 문자열 목록인 사전을 보유한 속성에 대한 스키마를 만듭니다.

매개변수

매개변수	설명
allow_empty	default = True 속성이 비어 있을 수 있는 경우 true입니다.
default	default = {} 규칙을 인스턴스화할 때 이 속성에 값을 지정하지 않는 경우 사용할 기본값입니다.
doc	default = '' 문서 생성 도구로 추출할 수 있는 속성의 설명입니다.
mandatory	default = False true인 경우 값을 명시적으로 지정해야 합니다 (default가 있는 경우에도).