이 페이지는 bazel query
를 사용하여 빌드 종속 항목을 분석할 때 사용되는 Bazel 쿼리 언어에 관한 참조 설명서입니다. 또한 bazel query
에서 지원하는 출력 형식을 설명합니다.
실용적인 사용 사례는 Bazel 쿼리 방법을 참고하세요.
추가 쿼리 참조
로드 후 단계 타겟 그래프에서 실행되는 query
외에도 Bazel에는 작업 그래프 쿼리 및 구성 가능한 쿼리가 포함되어 있습니다.
작업 그래프 쿼리
작업 그래프 쿼리 (aquery
)는 분석 후 구성된 타겟 그래프에서 작동하며 작업, 아티팩트, 그리고 이들의 관계에 관한 정보를 노출합니다. aquery
는 구성된 타겟 그래프에서 생성된 작업/아티팩트의 속성에 관심이 있는 경우에 유용합니다.
예를 들어 실행되는 실제 명령어와 입력, 출력, 니모닉이 여기에 포함됩니다.
자세한 내용은 aquery 참조를 참고하세요.
구성 가능한 쿼리
기존 Bazel 쿼리는 로드 후 단계 대상 그래프에서 실행되므로 구성 및 관련 개념이 없습니다. 특히 select 문을 올바르게 확인하지 않고 대신 select의 가능한 모든 확인 결과를 반환합니다. 그러나 구성 가능한 쿼리 환경인 cquery
는 구성을 올바르게 처리하지만 이 원본 쿼리의 일부 기능은 제공하지 않습니다.
자세한 내용은 cquery 참조를 참고하세요.
예
bazel query
은 어떻게 사용하나요? 다음은 일반적인 예입니다.
//foo
트리가 //bar/baz
에 종속되는 이유는 무엇인가요?
경로 표시:
somepath(foo/..., //bar/baz:all)
모든 foo
테스트가 종속되는 C++ 라이브러리 중 foo_bin
타겟이 종속되지 않는 라이브러리는 무엇인가요?
kind("cc_library", deps(kind(".*test rule", foo/...)) except deps(//foo:foo_bin))
토큰: 어휘 문법
쿼리 언어의 표현식은 다음 토큰으로 구성됩니다.
let
과 같은 키워드 키워드는 언어의 예약된 단어이며 각 키워드는 아래에 설명되어 있습니다. 전체 키워드 집합은 다음과 같습니다.단어: '
foo/...
', '.*test rule
', '//bar/baz:all
'와 같은 단어입니다. 문자 시퀀스가 '따옴표로 묶여' 있으면(작은따옴표 '로 시작하고 끝나거나 큰따옴표 "로 시작하고 끝나는 경우) 단어입니다. 문자 시퀀스가 따옴표로 묶이지 않으면 단어로 파싱될 수 있습니다. 따옴표가 없는 단어는 알파벳 문자 A-Za-z, 숫자 0~9, 특수 문자*/@.-_:$~[]
(별표, 포워드 슬래시, 골뱅이, 마침표, 하이픈, 밑줄, 콜론, 달러 기호, 물결표, 왼쪽 대괄호, 오른쪽 대괄호)에서 가져온 문자 시퀀스입니다. 그러나 상대 타겟 이름이 이러한 문자로 시작할 수 있더라도 따옴표로 묶지 않은 단어는 하이픈-
또는 별표*
로 시작할 수 없습니다. 외부 저장소를 참조하는 라벨의 처리를 간소화하기 위한 특별한 규칙으로,@@
로 시작하는 따옴표가 없는 단어에는+
문자가 포함될 수 있습니다.따옴표로 묶지 않은 단어에는 이러한 문자가 대상 이름에 허용되더라도 더하기 기호
+
또는 등호 기호=
가 포함되지 않을 수도 있습니다. 쿼리 표현식을 생성하는 코드를 작성할 때는 대상 이름을 따옴표로 묶어야 합니다.사용자 제공 값에서 Bazel 쿼리 표현식을 구성하는 스크립트를 작성할 때는 따옴표를 사용해야 합니다.
//foo:bar+wiz # WRONG: scanned as //foo:bar + wiz. //foo:bar=wiz # WRONG: scanned as //foo:bar = wiz. "//foo:bar+wiz" # OK. "//foo:bar=wiz" # OK.
이 따옴표는 셸에서 필요로 하는 따옴표(예:
bazel query ' "//foo:bar=wiz" ' # single-quotes for shell, double-quotes for Bazel.
키워드와 연산자는 따옴표로 묶으면 일반 단어로 취급됩니다. 예를 들어
some
는 키워드이지만 'some'은 단어입니다.foo
와 'foo'는 모두 단어입니다.하지만 타겟 이름에 작은따옴표나 큰따옴표를 사용할 때는 주의해야 합니다. 하나 이상의 대상 이름을 따옴표로 묶을 때는 한 가지 유형의 따옴표 (모두 작은 따옴표 또는 모두 큰 따옴표)만 사용합니다.
다음은 Java 쿼리 문자열의 예입니다.
'a"'a' # WRONG: Error message: unclosed quotation. "a'"a" # WRONG: Error message: unclosed quotation. '"a" + 'a'' # WRONG: Error message: unexpected token 'a' after query expression '"a" + ' "'a' + "a"" # WRONG: Error message: unexpected token 'a' after query expression ''a' + ' "a'a" # OK. 'a"a' # OK. '"a" + "a"' # OK "'a' + 'a'" # OK
대부분의 경우 따옴표가 필요하지 않도록 이 문법을 선택했습니다. (비정상적인)
".*test rule"
예에는 따옴표가 필요합니다. 마침표로 시작하고 공백을 포함합니다."cc_library"
를 따옴표로 묶는 것은 불필요하지만 무해합니다.괄호
()
, 마침표.
, 쉼표,
와 같은 구두점 구두점을 포함하는 단어 (위에 나열된 예외 제외)는 따옴표로 묶어야 합니다.
따옴표로 묶인 단어 외부의 공백 문자는 무시됩니다.
Bazel 쿼리 언어 개념
Bazel 쿼리 언어는 표현식의 언어입니다. 모든 표현식은 타겟의 부분 순서 집합 또는 이에 상응하는 타겟의 그래프 (DAG)로 평가됩니다. 유일한 데이터 유형입니다.
집합과 그래프는 동일한 데이터 유형을 참조하지만 서로 다른 측면을 강조합니다. 예를 들면 다음과 같습니다.
- 세트: 타겟의 부분 순서는 중요하지 않습니다.
- 그래프: 타겟의 부분 순서가 중요합니다.
종속 항목 그래프의 순환
빌드 종속 항목 그래프는 비순환 그래프여야 합니다.
쿼리 언어에서 사용하는 알고리즘은 비순환 그래프에서 사용하도록 설계되었지만 순환에 강합니다. 주기가 처리되는 방식에 관한 세부정보는 지정되지 않으며 이를 의존해서는 안 됩니다.
암시적 종속 항목
Bazel은 BUILD
파일에 명시적으로 정의된 빌드 종속 항목 외에도 규칙에 암시적 종속 항목을 추가합니다. 암시적 종속 항목은 다음으로 정의할 수 있습니다.
기본적으로 bazel query
는 쿼리 결과를 계산할 때 암시적 종속 항목을 고려합니다. 이 동작은 --[no]implicit_deps
옵션으로 변경할 수 있습니다.
쿼리는 구성을 고려하지 않으므로 잠재적인 도구 모음 구현은 종속 항목이 아니라 필요한 도구 모음 유형으로만 간주됩니다. 툴체인 문서를 참고하세요.
건전성
Bazel 쿼리 언어 표현식은 모든 BUILD
파일의 모든 규칙 선언에 의해 암시적으로 정의된 그래프인 빌드 종속 항목 그래프를 통해 작동합니다. 이 그래프는 다소 추상적이며 빌드의 모든 단계를 실행하는 방법에 관한 완전한 설명을 구성하지 않는다는 점을 이해하는 것이 중요합니다. 빌드를 실행하려면 구성도 필요합니다. 자세한 내용은 사용자 가이드의 구성 섹션을 참고하세요.
Bazel 쿼리 언어로 표현식을 평가한 결과는 모든 구성에 대해 true입니다. 즉, 정확하지 않고 보수적인 오버추적일 수 있습니다. 쿼리 도구를 사용하여 빌드 중에 필요한 모든 소스 파일 집합을 계산하면 실제로 필요한 것보다 더 많은 항목이 보고될 수 있습니다. 예를 들어 빌드에서 이 기능을 사용하지 않을 의도라 하더라도 쿼리 도구에는 메시지 번역을 지원하는 데 필요한 모든 파일이 포함되기 때문입니다.
그래프 순서 보존
연산은 하위 표현식에서 상속된 모든 순서 제약 조건을 유지합니다. 이를 '부분 순서 보존 법칙'이라고 생각할 수 있습니다. 예를 들어 특정 타겟의 종속 항목의 전이 폐쇄를 확인하는 쿼리를 실행하면 결과 집합이 종속 항목 그래프에 따라 정렬됩니다. 이 집합을 필터링하여 file
유형의 타겟만 포함하도록 하면 결과 하위 집합의 모든 타겟 쌍 간에 동일한 전이 부분 순서 관계가 적용됩니다. 이러한 쌍 중 어느 것도 원래 그래프에서 실제로 직접 연결되어 있지 않더라도 마찬가지입니다.
빌드 종속 항목 그래프에는 파일 간 연결이 없습니다.
그러나 모든 연산자는 순서를 보존하지만 집합 연산과 같은 일부 연산은 자체 순서 제약 조건을 도입하지 않습니다. 다음 표현식을 생각해 보세요.
deps(x) union y
최종 결과 집합의 순서는 하위 표현식의 모든 순서 제약 조건, 즉 x
의 모든 전이 종속 항목이 서로에 대해 올바르게 순서가 지정되도록 보장합니다. 그러나 쿼리는 y
의 타겟 순서나 y
의 타겟과 관련하여 deps(x)
의 타겟 순서에 대해 아무것도 보장하지 않습니다 (y
의 타겟이 deps(x)
에 있는 경우는 예외).
순서 제약 조건을 도입하는 연산자는 allpaths
, deps
, rdeps
, somepath
, 대상 패턴 와일드 카드 package:*
, dir/...
등입니다.
Sky 쿼리
Sky 쿼리는 지정된 유니버스 범위에서 작동하는 쿼리 모드입니다.
SkyQuery에서만 사용할 수 있는 특수 함수
Sky Query 모드에는 추가 쿼리 함수 allrdeps
및 rbuildfiles
가 있습니다. 이러한 함수는 전체 유니버스 범위에서 작동하므로 일반 쿼리에는 적합하지 않습니다.
유니버스 범위 지정
Sky Query 모드는 다음 두 플래그(--universe_scope
또는 --infer_universe_scope
)와 --order_output=no
를 전달하여 활성화됩니다.
--universe_scope=<target_pattern1>,...,<target_patternN>
는 쿼리에게 대상 패턴으로 지정된 타겟 패턴의 전이 폐쇄를 미리 로드하도록 지시합니다. 전이 폐쇄는 덧셈과 뺄셈 모두 가능합니다. 그러면 모든 쿼리가 이 '범위'에서 평가됩니다. 특히 allrdeps
및 rbuildfiles
연산자는 이 범위의 결과만 반환합니다.
--infer_universe_scope
는 Bazel에 쿼리 표현식에서 --universe_scope
의 값을 추론하도록 지시합니다. 이 추론된 값은 쿼리 표현식의 고유한 타겟 패턴 목록이지만 원하는 값이 아닐 수 있습니다. 예를 들면 다음과 같습니다.
bazel query --infer_universe_scope --order_output=no "allrdeps(//my:target)"
이 쿼리 표현식의 고유한 타겟 패턴 목록은 ["//my:target"]
이므로 Bazel은 이를 호출과 동일하게 취급합니다.
bazel query --universe_scope=//my:target --order_output=no "allrdeps(//my:target)"
하지만 --universe_scope
를 사용한 쿼리의 결과는 //my:target
뿐입니다. //my:target
의 역 종속 항목은 생성 시 유니버스에 없습니다. 반면 다음 사항을 고려하세요.
bazel query --infer_universe_scope --order_output=no "tests(//a/... + b/...) intersect allrdeps(siblings(rbuildfiles(my/starlark/file.bzl)))"
이는 정의가 특정 .bzl
파일을 사용하는 타겟에 전이적으로 종속되는 일부 디렉터리 아래의 타겟의 tests
확장에서 테스트 타겟을 계산하려는 의미 있는 쿼리 호출입니다. 여기서 --infer_universe_scope
는 편의 기능입니다. 특히 --universe_scope
을 선택하면 쿼리 표현식을 직접 파싱해야 하는 경우에 유용합니다.
따라서 allrdeps
및 rbuildfiles
와 같은 유니버스 범위 연산자를 사용하는 쿼리 표현식의 경우 원하는 동작이 발생하는 경우에만 --infer_universe_scope
를 사용하세요.
Sky 쿼리에는 기본 쿼리와 비교하여 몇 가지 장단점이 있습니다. 주요 단점은 그래프 순서에 따라 출력을 정렬할 수 없으므로 특정 출력 형식이 금지된다는 점입니다. 이 방법의 장점은 기본 쿼리에서 사용할 수 없는 두 가지 연산자 (allrdeps
및 rbuildfiles
)를 제공한다는 것입니다.
또한 Sky Query는 기본 구현에서 하는 것처럼 새 그래프를 만드는 대신 Skyframe 그래프를 검사하여 작업을 실행합니다. 따라서 더 빠르고 메모리를 덜 사용하는 경우도 있습니다.
표현식: 문법의 구문 및 의미론
다음은 EBNF 표기법으로 표현된 Bazel 쿼리 언어의 문법입니다.
expr ::= word
| let name = expr in expr
| (expr )
| expr intersect expr
| expr ^ expr
| expr union expr
| expr + expr
| expr except expr
| expr - expr
| set(word *)
| word '(' int | word | expr ... ')'
다음 섹션에서는 이 문법의 각 생성을 순서대로 설명합니다.
타겟 패턴
expr ::= word
문법적으로 타겟 패턴은 단어에 불과합니다. 순서가 지정되지 않은 타겟 집합으로 해석됩니다. 가장 간단한 타겟 패턴은 단일 타겟 (파일 또는 규칙)을 식별하는 라벨입니다. 예를 들어 타겟 패턴 //foo:bar
는 하나의 요소인 타겟, bar
규칙이 포함된 집합으로 평가됩니다.
타겟 패턴은 패키지와 타겟에 와일드 카드를 포함하도록 라벨을 일반화합니다. 예를 들어 foo/...:all
(또는 foo/...
)는 foo
디렉터리 아래의 모든 패키지에 있는 모든 규칙을 포함하는 집합으로 평가되는 타겟 패턴입니다. bar/baz:all
는 bar/baz
패키지의 모든 규칙을 포함하는 집합으로 평가되지만 하위 패키지는 포함하지 않는 타겟 패턴입니다.
마찬가지로 foo/...:*
는 foo
디렉터리 아래의 모든 패키지에 있는 모든 타겟 (규칙 및 파일)을 포함하는 집합으로 평가되는 타겟 패턴입니다. bar/baz:*
는 bar/baz
패키지의 모든 타겟을 포함하는 집합으로 평가되지만 하위 패키지는 포함하지 않습니다.
:*
와일드 카드는 규칙뿐만 아니라 파일과도 일치하므로 쿼리에서 :all
보다 유용한 경우가 많습니다. 반대로 :all
와일드 카드 (foo/...
과 같은 타겟 패턴에 암시적으로 포함됨)는 일반적으로 빌드에 더 유용합니다.
bazel query
타겟 패턴은 bazel build
빌드 타겟과 동일하게 작동합니다. 자세한 내용은 타겟 패턴을 참고하거나 bazel help target-syntax
을 입력하세요.
타겟 패턴은 싱글톤 세트(라벨의 경우), 많은 요소가 포함된 세트(수천 개의 요소가 있는 foo/...
의 경우) 또는 빈 세트(타겟 패턴이 타겟과 일치하지 않는 경우)로 평가될 수 있습니다.
타겟 패턴 표현식의 결과에 있는 모든 노드는 종속 관계에 따라 서로 상대적으로 올바르게 정렬됩니다. 따라서 foo:*
의 결과는 foo
패키지의 대상 집합일 뿐만 아니라 이러한 대상에 대한 그래프이기도 합니다. 결과 노드와 다른 노드 간의 상대 순서에 대해서는 보장되지 않습니다. 자세한 내용은 그래프 순서 섹션을 참고하세요.
변수
expr ::= let name = expr 1 in expr 2
| $name
Bazel 쿼리 언어는 변수의 정의 및 참조를 허용합니다. let
표현식의 평가 결과는 expr2의 결과와 동일하며, name 변수가 자유롭게 발생하는 모든 위치가 expr1 값으로 대체됩니다.
예를 들어 let v = foo/... in allpaths($v, //common) intersect $v
는 allpaths(foo/...,//common) intersect foo/...
와 동일합니다.
괄호로 묶인 let name = ...
표현식 이외의 위치에 변수 참조 name
가 있으면 오류입니다. 즉, 최상위 쿼리 표현식에는 자유 변수가 있을 수 없습니다.
위의 문법 프로덕션에서 name
는 word와 비슷하지만 C 프로그래밍 언어에서 유효한 식별자여야 한다는 추가 제약조건이 있습니다. 변수 참조 앞에는 '$' 문자가 있어야 합니다.
각 let
표현식은 단일 변수만 정의하지만 중첩할 수 있습니다.
타겟 패턴과 변수 참조는 단일 토큰인 단어로만 구성되어 있어 구문 모호성을 야기합니다. 그러나 유효한 변수 이름인 단어의 하위 집합은 유효한 타겟 패턴인 단어의 하위 집합과 일치하지 않으므로 의미상 모호하지 않습니다.
기술적으로 let
표현식은 쿼리 언어의 표현력을 높이지 않습니다. 언어로 표현할 수 있는 모든 쿼리는 let
표현식 없이도 표현할 수 있습니다. 그러나 이러한 연산자는 많은 쿼리의 간결성을 개선하고 더 효율적인 쿼리 평가로 이어질 수 있습니다.
괄호로 묶인 표현식
expr ::= (expr )
괄호는 평가 순서를 강제하기 위해 하위 표현식을 연결합니다. 괄호로 묶인 표현식은 인수의 값으로 평가됩니다.
대수적 집합 연산: 교집합, 합집합, 차집합
expr ::= expr intersect expr
| expr ^ expr
| expr union expr
| expr + expr
| expr except expr
| expr - expr
이 세 개의 연산자는 인수에 대해 일반적인 집합 연산을 계산합니다.
각 연산자는 두 가지 형식, 즉 intersect
와 같은 명목적 형식과 ^
와 같은 기호 형식을 갖습니다. 두 형식은 동일합니다. 기호 형식은 더 빠르게 입력할 수 있습니다. 명확성을 위해 이 페이지의 나머지 부분에서는 명사형을 사용합니다.
예를 들면 다음과 같습니다.
foo/... except foo/bar/...
foo/...
와 일치하지만 foo/bar/...
와는 일치하지 않는 타겟 집합으로 평가됩니다.
다음과 같이 동일한 쿼리를 작성할 수 있습니다.
foo/... - foo/bar/...
intersect
(^
) 및 union
(+
) 연산은 교환법칙이 적용됩니다 (대칭). except
(-
)는 비대칭입니다. 파서는 세 가지 연산자를 모두 왼쪽 결합 연산자이고 우선순위가 동일한 것으로 취급하므로 괄호를 사용하는 것이 좋습니다. 예를 들어 다음 표현식 중 처음 두 개는 동일하지만 세 번째는 다릅니다.
x intersect y union z
(x intersect y) union z
x intersect (y union z)
외부 소스에서 타겟 읽기: set
expr ::= set(word *)
set(a b c ...)
연산자는 공백 (쉼표 없음)으로 구분된 0개 이상의 타겟 패턴 집합의 합집합을 계산합니다.
Bourne 셸의 $(...)
기능과 함께 set()
는 하나의 쿼리 결과를 일반 텍스트 파일에 저장하고, 다른 프로그램 (예: 표준 UNIX 셸 도구)을 사용하여 이 텍스트 파일을 조작한 다음, 결과를 추가 처리를 위한 값으로 쿼리 도구에 다시 도입하는 수단을 제공합니다. 예를 들면 다음과 같습니다.
bazel query deps(//my:target) --output=label | grep ... | sed ... | awk ... > foo
bazel query "kind(cc_binary, set($(<foo)))"
다음 예에서는 awk
프로그램을 사용하여 maxrank
값을 필터링하여 kind(cc_library, deps(//some_dir/foo:main, 5))
를 계산합니다.
bazel query 'deps(//some_dir/foo:main)' --output maxrank | awk '($1 < 5) { print $2;} ' > foo
bazel query "kind(cc_library, set($(<foo)))"
이 예시에서 $(<foo)
는 $(cat foo)
의 약어이지만 cat
이외의 셸 명령어(예: 이전 awk
명령어)도 사용할 수 있습니다.
함수
expr ::= word '(' int | word | expr ... ')'
쿼리 언어는 여러 함수를 정의합니다. 함수의 이름에 따라 필요한 인수의 개수와 유형이 결정됩니다. 다음 함수를 사용할 수 있습니다.
allpaths
attr
buildfiles
rbuildfiles
deps
filter
kind
labels
loadfiles
rdeps
allrdeps
same_pkg_direct_rdeps
siblings
some
somepath
tests
visible
종속 항목의 전이 폐쇄: deps
expr ::= deps(expr )
| deps(expr , depth )
deps(x)
연산자는 인수 집합 x의 종속 항목의 전이 폐쇄로 형성된 그래프로 평가됩니다. 예를 들어 deps(//foo)
의 값은 모든 종속 항목을 포함하여 단일 노드 foo
에 루팅된 종속 항목 그래프입니다. deps(foo/...)
의 값은 루트가 foo
디렉터리 아래의 모든 패키지에 있는 모든 규칙인 종속 항목 그래프입니다. 이 맥락에서 '종속 항목'은 규칙 및 파일 타겟만을 의미하므로 이러한 타겟을 만드는 데 필요한 BUILD
및 Starlark 파일은 여기에 포함되지 않습니다. 이를 위해 buildfiles
연산자를 사용해야 합니다.
결과 그래프는 종속 항목 관계에 따라 정렬됩니다. 자세한 내용은 그래프 순서 섹션을 참고하세요.
deps
연산자는 검색 깊이의 상한값을 지정하는 정수 리터럴인 선택적 두 번째 인수를 허용합니다. 따라서 deps(foo:*, 0)
는 foo
패키지의 모든 타겟을 반환하고 deps(foo:*, 1)
는 foo
패키지의 모든 타겟의 직접적인 기본 요건을 추가로 포함하며 deps(foo:*, 2)
는 deps(foo:*, 1)
의 노드에서 직접 연결할 수 있는 노드를 추가로 포함합니다. 이 숫자는 minrank
출력 형식에 표시된 순위에 해당합니다.
depth 매개변수를 생략하면 검색이 무제한이 됩니다. 즉, 기본 요건의 리플렉시브 전이 폐쇄를 계산합니다.
역방향 종속 항목의 전이 폐쇄: rdeps
expr ::= rdeps(expr , expr )
| rdeps(expr , expr , depth )
rdeps(u, x)
연산자는 범위 집합 u의 전이 폐쇄 내에서 인수 집합 x의 역 종속 항목으로 평가됩니다.
결과 그래프는 종속 항목 관계에 따라 정렬됩니다. 자세한 내용은 그래프 순서 섹션을 참고하세요.
rdeps
연산자는 검색 깊이의 상한값을 지정하는 정수 리터럴인 세 번째 인수(선택사항)를 허용합니다. 결과 그래프에는 인수 세트의 노드에서 지정된 깊이의 거리 내에 있는 노드만 포함됩니다. 따라서 rdeps(//foo, //common, 1)
는 //common
에 직접 종속되는 //foo
의 전이 폐쇄의 모든 노드로 평가됩니다. 이 숫자는 minrank
출력 형식에 표시된 순위에 해당합니다. depth 매개변수를 생략하면 검색이 무제한으로 진행됩니다.
모든 역 종속 항목의 전이 폐쇄: allrdeps
expr ::= allrdeps(expr )
| allrdeps(expr , depth )
allrdeps
연산자는 rdeps
연산자와 동일하게 작동합니다. 단, '유니버스 집합'은 별도로 지정되는 대신 --universe_scope
플래그가 평가된 값입니다. 따라서 --universe_scope=//foo/...
가 전달된 경우 allrdeps(//bar)
는 rdeps(//foo/..., //bar)
와 같습니다.
동일한 패키지의 직접 역종속 항목: same_pkg_direct_rdeps
expr ::= same_pkg_direct_rdeps(expr )
same_pkg_direct_rdeps(x)
연산자는 인수 세트의 타겟과 동일한 패키지에 있고 이 타겟에 직접 종속되는 전체 타겟 세트로 평가됩니다.
타겟의 패키지 처리: 형제/자매
expr ::= siblings(expr )
siblings(x)
연산자는 인수 집합의 타겟과 동일한 패키지에 있는 전체 타겟 집합으로 평가됩니다.
임의 선택: 일부
expr ::= some(expr )
| some(expr , count )
some(x, k)
연산자는 인수 집합 x에서 최대 k개의 대상을 임의로 선택하고 이러한 대상만 포함된 집합으로 평가됩니다. 매개변수 k는 선택사항입니다. 누락된 경우 결과는 임의로 선택된 하나의 타겟만 포함하는 싱글톤 세트가 됩니다. 인수 집합 x의 크기가 k보다 작으면 전체 인수 집합 x이 반환됩니다.
예를 들어 some(//foo:main union //bar:baz)
표현식은 //foo:main
또는 //bar:baz
중 하나를 포함하는 싱글톤 세트로 평가되지만 어느 쪽이든 정의되지는 않습니다. some(//foo:main union //bar:baz, 2)
또는 some(//foo:main union //bar:baz, 3)
표현식은 //foo:main
와 //bar:baz
를 모두 반환합니다.
인수가 싱글톤인 경우 some
는 항등 함수를 계산합니다. some(//foo:main)
는 //foo:main
와 같습니다.
지정된 인수 집합이 비어 있으면 오류입니다(예: some(//foo:main intersect //bar:baz)
표현식).
경로 연산자: somepath, allpaths
expr ::= somepath(expr , expr )
| allpaths(expr , expr )
somepath(S, E)
및 allpaths(S, E)
연산자는 두 대상 집합 간의 경로를 계산합니다. 두 쿼리 모두 두 개의 인수, 즉 시작점 집합 S과 끝점 집합 E을 허용합니다. somepath
는 S의 타겟에서 E의 타겟으로 이어지는 일부 임의 경로의 노드 그래프를 반환합니다. allpaths
는 S의 모든 타겟에서 E의 모든 타겟으로 이어지는 모든 경로의 노드 그래프를 반환합니다.
결과 그래프는 종속 항목 관계에 따라 정렬됩니다. 자세한 내용은 그래프 순서 섹션을 참고하세요.
대상 종류 필터링: 종류
expr ::= kind(word , expr )
kind(pattern, input)
연산자는 일련의 타겟에 필터를 적용하고 예상되는 종류가 아닌 타겟은 삭제합니다. pattern 매개변수는 일치시킬 대상의 종류를 지정합니다.
예를 들어 아래에 표시된 BUILD
파일(패키지 p
용)에 의해 정의된 네 가지 타겟의 종류는 표에 나와 있습니다.
코드 | 타겟 | 종류 |
---|---|---|
genrule( name = "a", srcs = ["a.in"], outs = ["a.out"], cmd = "...", ) |
//p:a |
genrule 규칙 |
//p:a.in |
소스 파일 | |
//p:a.out |
생성된 파일 | |
//p:BUILD |
소스 파일 |
따라서 kind("cc_.* rule", foo/...)
는 foo
아래의 모든 cc_library
, cc_binary
등의 규칙 타겟 집합으로 평가되고 kind("source file", deps(//foo))
는 //foo
타겟의 종속 항목의 전이 폐쇄에 있는 모든 소스 파일 집합으로 평가됩니다.
pattern 인수를 따옴표로 묶는 것이 필요한 경우가 많습니다. 따옴표가 없으면 source
file
및 .*_test
와 같은 많은 정규 표현식이 파서에서 단어로 간주되지 않기 때문입니다.
package group
와 일치하는 경우 :all
로 끝나는 타겟은 결과를 반환하지 않을 수 있습니다. 대신 :all-targets
를 사용하세요.
대상 이름 필터링: 필터
expr ::= filter(word , expr )
filter(pattern, input)
연산자는 일련의 타겟에 필터를 적용하고 라벨 (절대 형식)이 패턴과 일치하지 않는 타겟을 삭제합니다. 입력의 하위 집합으로 평가됩니다.
첫 번째 인수 pattern는 타겟 이름에 대한 정규 표현식이 포함된 단어입니다. filter
표현식은 x가 input 세트의 구성원이고 x의 라벨(절대 형식(예: //foo:bar
))에 정규 표현식 pattern의 (앵커링되지 않은) 일치가 포함되도록 모든 타겟 x를 포함하는 세트로 평가됩니다. 모든 타겟 이름은 //
로 시작하므로 ^
정규 표현식 앵커의 대안으로 사용할 수 있습니다.
이 연산자는 종종 intersect
연산자에 대한 훨씬 더 빠르고 강력한 대안을 제공합니다. 예를 들어 //foo:foo
타겟의 모든 bar
종속 항목을 보려면 다음을 평가할 수 있습니다.
deps(//foo) intersect //bar/...
그러나 이 문은 bar
트리의 모든 BUILD
파일을 파싱해야 하므로 속도가 느리고 관련 없는 BUILD
파일에서 오류가 발생하기 쉽습니다. 대안은 다음과 같습니다.
filter(//bar, deps(//foo))
먼저 //foo
종속 항목 집합을 계산한 다음 제공된 패턴과 일치하는 타겟만 필터링합니다. 즉, 이름에 //bar
가 하위 문자열로 포함된 타겟입니다.
filter(pattern,
expr)
연산자의 또 다른 일반적인 용도는 이름이나 확장자를 기준으로 특정 파일을 필터링하는 것입니다. 예를 들면 다음과 같습니다.
filter("\.cc$", deps(//foo))
//foo
빌드에 사용된 모든 .cc
파일의 목록을 제공합니다.
규칙 속성 필터링: attr
expr ::= attr(word , word , expr )
attr(name, pattern, input)
연산자는 필터를 일련의 타겟에 적용하고 규칙이 아닌 타겟, 속성 name가 정의되지 않은 규칙 타겟 또는 속성 값이 제공된 정규식 pattern과 일치하지 않는 규칙 타겟을 삭제합니다. 입력의 하위 집합으로 평가됩니다.
첫 번째 인수 name는 제공된 정규 표현식 패턴과 일치해야 하는 규칙 속성의 이름입니다. 두 번째 인수인 pattern는 속성 값에 대한 정규 표현식입니다. attr
표현식은 모든 대상 x이 포함된 집합으로 평가되며, 여기서 x는 input 집합의 구성원이며, 정의된 속성 name이 있는 규칙이며, 속성 값에 정규 표현식 pattern의 (앵커링되지 않은) 일치가 포함됩니다. name가 선택적 속성이고 규칙에서 명시적으로 지정하지 않으면 비교에 기본 속성 값이 사용됩니다. 예를 들면 다음과 같습니다.
attr(linkshared, 0, deps(//foo))
linkshared 속성을 가질 수 있고 (예: cc_binary
규칙) 명시적으로 0으로 설정되어 있거나 전혀 설정되지 않았지만 기본값이 0인 (예: cc_binary
규칙) 모든 //foo
종속 항목을 선택합니다.
목록 유형 속성 (예: srcs
, data
등)은 [
대괄호로 시작하고 ]
대괄호로 끝나며 ',
' (쉼표, 공백)를 사용하여 여러 값을 구분하는 [value<sub>1</sub>, ..., value<sub>n</sub>]
형식의 문자열로 변환됩니다.
라벨은 라벨의 절대 형식을 사용하여 문자열로 변환됩니다. 예를 들어 속성 deps=[":foo",
"//otherpkg:bar", "wiz"]
는 문자열 [//thispkg:foo, //otherpkg:bar, //thispkg:wiz]
로 변환됩니다.
대괄호는 항상 있으므로 빈 목록은 일치 목적으로 문자열 값 []
를 사용합니다. 예를 들면 다음과 같습니다.
attr("srcs", "\[\]", deps(//foo))
빈 srcs
속성이 있는 //foo
종속 항목 중에서 모든 규칙을 선택하고
attr("data", ".{3,}", deps(//foo))
data
속성에서 하나 이상의 값을 지정하는 //foo
종속 항목 중에서 모든 규칙을 선택합니다 (//
및 :
로 인해 모든 라벨의 길이는 3자 이상임).
목록 유형 속성에서 특정 value
가 있는 //foo
종속 항목 중에서 모든 규칙을 선택하려면 다음을 사용하세요.
attr("tags", "[\[ ]value[,\]]", deps(//foo))
value
앞의 문자가 [
또는 공백이고 value
뒤의 문자가 쉼표 또는 ]
이기 때문에 이렇게 작동합니다.
규칙 공개 상태 필터링: 표시됨
expr ::= visible(expr , expr )
visible(predicate, input)
연산자는 일련의 타겟에 필터를 적용하고 필요한 공개 상태가 없는 타겟은 삭제합니다.
첫 번째 인수인 predicate는 출력의 모든 타겟에 표시되어야 하는 타겟 집합입니다. visible 표현식은 x가 input 세트의 구성원이며 predicate의 모든 타겟 y에 대해 x가 y에 표시되는 모든 타겟 x를 포함하는 세트로 평가됩니다. 예를 들면 다음과 같습니다.
visible(//foo, //bar:*)
//foo
가 공개 범위 제한을 위반하지 않고 종속될 수 있는 //bar
패키지의 모든 타겟을 선택합니다.
유형 라벨의 규칙 속성 평가: 라벨
expr ::= labels(word , expr )
labels(attr_name, inputs)
연산자는 inputs 세트의 일부 규칙에서 '라벨' 또는 '라벨 목록' 유형의 속성 attr_name에 지정된 타겟 집합을 반환합니다.
예를 들어 labels(srcs, //foo)
는 //foo
규칙의 srcs
속성에 표시되는 타겟 집합을 반환합니다. inputs 세트에 srcs
속성이 있는 규칙이 여러 개 있는 경우 srcs
의 합집합이 반환됩니다.
test_suites: tests 펼치기 및 필터링
expr ::= tests(expr )
tests(x)
연산자는 x 세트의 모든 테스트 규칙 세트를 반환하여 test_suite
규칙을 참조하는 개별 테스트 세트로 확장하고 tag
및 size
를 사용하여 필터링을 적용합니다.
기본적으로 쿼리 평가는 모든 test_suite
규칙에서 테스트 대상이 아닌 모든 대상을 무시합니다. 이는 --strict_test_suite
옵션을 사용하여 오류로 변경할 수 있습니다.
예를 들어 쿼리 kind(test, foo:*)
는 foo
패키지의 모든 *_test
및 test_suite
규칙을 나열합니다. 모든 결과는 정의상 foo
패키지의 구성원입니다. 반면 쿼리 tests(foo:*)
는 bazel test
foo:*
에 의해 실행될 모든 개별 테스트를 반환합니다. 여기에는 test_suite
규칙을 통해 직접 또는 간접적으로 참조되는 다른 패키지에 속한 테스트가 포함될 수 있습니다.
패키지 정의 파일: buildfiles
expr ::= buildfiles(expr )
buildfiles(x)
연산자는 x 집합에서 각 타겟의 패키지를 정의하는 파일 집합을 반환합니다. 즉, 각 패키지의 BUILD
파일과 load
를 통해 참조하는 모든 .bzl 파일을 반환합니다. 이렇게 하면 이러한 load
처리된 파일이 포함된 패키지의 BUILD
파일도 반환됩니다.
이 연산자는 일반적으로 지정된 타겟을 빌드하는 데 필요한 파일 또는 패키지를 결정할 때 사용되며, 종종 아래의 --output package
옵션과 함께 사용됩니다. 예를 들면 다음과 같습니다.
bazel query 'buildfiles(deps(//foo))' --output package
//foo
가 전이적으로 종속되는 모든 패키지 집합을 반환합니다.
패키지 정의 파일: rbuildfiles
expr ::= rbuildfiles(word , ...)
rbuildfiles
연산자는 쉼표로 구분된 경로 프래그먼트 목록을 사용하고 이러한 경로 프래그먼트에 전이적으로 종속되는 BUILD
파일 집합을 반환합니다. 예를 들어 //foo
가 패키지인 경우 rbuildfiles(foo/BUILD)
는 //foo:BUILD
타겟을 반환합니다. foo/BUILD
파일에 load('//bar:file.bzl'...
가 포함된 경우 rbuildfiles(bar/file.bzl)
는 //foo:BUILD
타겟과 //bar:file.bzl
를 로드하는 다른 모든 BUILD
파일의 타겟을 반환합니다.
--universe_scope
플래그로 지정된 범위입니다. BUILD
파일 및 .bzl
파일과 직접 일치하지 않는 파일은 결과에 영향을 미치지 않습니다. 예를 들어 foo.cc
와 같은 소스 파일은 BUILD
파일에 명시적으로 언급되더라도 무시됩니다. 그러나 심볼릭 링크는 고려되므로 foo/BUILD
가 bar/BUILD
의 심볼릭 링크인 경우 rbuildfiles(bar/BUILD)
는 결과에 //foo:BUILD
를 포함합니다.
rbuildfiles
연산자는 거의 도덕적으로 buildfiles
연산자의 역입니다. 그러나 이 도덕적 역전은 한쪽 방향으로 더 강하게 적용됩니다. rbuildfiles
의 출력은 buildfiles
의 입력과 같습니다. 전자는 패키지에 BUILD
파일 타겟만 포함하고 후자는 이러한 타겟을 포함할 수 있습니다. 반대 방향의 상관성은 더 약합니다. buildfiles
연산자의 출력은 모든 패키지 및 에 해당하는 타겟입니다 .특정 입력에 필요한 bzl
파일 그러나 rbuildfiles
연산자의 입력은 이러한 타겟이 아니라 이러한 타겟에 해당하는 경로 프래그먼트입니다.
패키지 정의 파일: loadfiles
expr ::= loadfiles(expr )
loadfiles(x)
연산자는 x 세트의 각 타겟 패키지를 로드하는 데 필요한 Starlark 파일 집합을 반환합니다. 즉, 각 패키지의 경우 BUILD
파일에서 참조되는 .bzl 파일을 반환합니다.
출력 형식
bazel query
는 그래프를 생성합니다.
--output
명령줄 옵션을 사용하여 bazel query
가 이 그래프를 표시하는 콘텐츠, 형식, 순서를 지정합니다.
Sky Query로 실행하는 경우 순서가 지정되지 않은 출력과 호환되는 출력 형식만 허용됩니다. 구체적으로 graph
, minrank
, maxrank
출력 형식은 금지됩니다.
일부 출력 형식은 추가 옵션을 허용합니다. 각 출력 옵션의 이름 앞에는 적용되는 출력 형식이 접두사로 추가되므로 --graph:factored
는 --output=graph
가 사용 중일 때만 적용됩니다. graph
이외의 출력 형식이 사용되는 경우에는 영향을 미치지 않습니다. 마찬가지로 --xml:line_numbers
는 --output=xml
가 사용 중인 경우에만 적용됩니다.
결과 정렬
쿼리 표현식은 항상 '그래프 순서 보존 법칙'을 따르지만 결과를 표시하는 방법은 종속 항목 순서대로 또는 순서 없이 할 수 있습니다. 이는 결과 집합의 타겟이나 쿼리가 계산되는 방식에 영향을 미치지 않습니다. 결과가 stdout에 출력되는 방식에만 영향을 미칩니다. 또한 종속 항목 순서에서 동일한 노드는 알파벳순으로 정렬되거나 정렬되지 않을 수 있습니다.
--order_output
플래그를 사용하면 이 동작을 제어할 수 있습니다.
--[no]order_results
플래그에는 --order_output
플래그의 기능 중 일부가 포함되어 있으며 지원 중단되었습니다.
이 플래그의 기본값은 auto
이며, 이는 결과를 사전순으로 출력합니다. 그러나 somepath(a,b)
를 사용하면 결과가 deps
순서로 출력됩니다.
이 플래그가 no
이고 --output
가 build
, label
, label_kind
, location
, package
, proto
또는 xml
중 하나인 경우 출력이 임의의 순서로 출력됩니다. 일반적으로 가장 빠른 옵션입니다. 단, --output
이 graph
, minrank
또는 maxrank
중 하나인 경우에는 지원되지 않습니다. 이러한 형식을 사용하면 Bazel은 항상 종속 항목 순서 또는 순위에 따라 정렬된 결과를 출력합니다.
이 플래그가 deps
이면 Bazel은 종속 항목이 먼저 출력되고 종속 항목이 나중에 출력되는 등 어떤 종류의 순서도에 따라 결과를 출력합니다. 그러나 종속 항목 순서에 따라 순서가 지정되지 않은 노드 (둘 중 하나에서 다른 하나로 연결되는 경로가 없기 때문에)는 어떤 순서든 출력될 수 있습니다.
이 플래그가 full
이면 Bazel은 완전히 결정론적 (전체) 순서로 노드를 출력합니다.
먼저 모든 노드가 알파벳순으로 정렬됩니다. 그런 다음 목록의 각 노드는 방문하지 않은 노드로 향하는 발신 가장자리가 후속 노드의 알파벳순으로 탐색되는 후위 순서 깊이 우선 탐색의 시작으로 사용됩니다. 마지막으로 노드는 방문된 순서의 역순으로 출력됩니다.
이 순서로 노드를 출력하면 속도가 느려질 수 있으므로 결정론이 중요한 경우에만 사용해야 합니다.
BUILD에 표시되는 것처럼 타겟의 소스 양식 출력
--output build
이 옵션을 사용하면 각 타겟의 표현은 마치 BUILD 언어로 직접 작성한 것처럼 보입니다. 모든 변수와 함수 호출(예: glob, 매크로)이 확장되므로 Starlark 매크로의 효과를 확인하는 데 유용합니다. 또한 각 유효 규칙은 generator_name
및/또는 generator_function
값을 보고하여 유효 규칙을 생성하기 위해 평가된 매크로의 이름을 제공합니다.
출력은 BUILD
파일과 동일한 문법을 사용하지만 유효한 BUILD
파일을 생성할 수 있는 것은 아닙니다.
각 타겟의 라벨 인쇄
--output label
이 옵션을 사용하면 결과 그래프의 각 타겟에 대한 이름 (또는 라벨) 집합이 토폴로지 순서로 한 행에 하나씩 라벨이 출력됩니다 (--noorder_results
가 지정된 경우는 예외, 결과 순서에 관한 메모 참고).
(토폴로지 순서는 그래프 노드가 모든 후속 노드보다 먼저 표시되는 순서입니다.) 물론 그래프의 가능한 순서는 많습니다 (역 후순서는 그중 하나일 뿐). 어떤 순서가 선택되는지는 지정되지 않습니다.
somepath
쿼리의 출력을 출력할 때 노드가 출력되는 순서는 경로의 순서입니다.
주의: 경우에 따라 동일한 라벨을 가진 두 개의 고유한 타겟이 있을 수 있습니다. 예를 들어 sh_binary
규칙과 유일한 (암시적) srcs
파일이 모두 foo.sh
라고 불릴 수 있습니다. 쿼리 결과에 이러한 타겟이 모두 포함된 경우 출력 (label
형식)에 중복이 포함된 것처럼 보입니다. label_kind
(아래 참고) 형식을 사용하면 구분이 명확해집니다. 두 타겟의 이름은 동일하지만 하나는 종류가 sh_binary rule
이고 다른 하나는 종류가 source file
입니다.
각 타겟의 라벨 및 종류를 출력합니다.
--output label_kind
이 출력 형식은 label
와 마찬가지로 결과 그래프에서 각 타겟의 라벨을 순서대로 출력하지만, 라벨 앞에 타겟의 종류를 추가로 표시합니다.
프로토콜 버퍼 형식으로 타겟 인쇄
--output proto
쿼리 출력을 QueryResult
프로토콜 버퍼로 출력합니다.
길이로 구분된 프로토콜 버퍼 형식으로 타겟 인쇄
--output streamed_proto
Target
프로토콜 버퍼의 길이로 구분된 스트림을 출력합니다. 이는 (i) 단일 QueryResult
에 맞출 수 없을 만큼 타겟이 너무 많은 경우 프로토콜 버퍼의 크기 제한을 우회하거나 (ii) Bazel이 아직 출력 중일 때 처리를 시작하는 데 유용합니다.
텍스트 proto 형식으로 타겟 인쇄
--output textproto
--output proto
와 유사하지만 QueryResult
프로토콜 버퍼를 텍스트 형식으로 출력합니다.
ndjson 형식으로 타겟 인쇄
--output streamed_jsonproto
--output streamed_proto
와 유사하지만 Target
프로토콜 버퍼의 스트림을 ndjson 형식으로 출력합니다.
각 타겟의 라벨을 순위순으로 출력
--output minrank --output maxrank
label
와 마찬가지로 minrank
및 maxrank
출력 형식은 결과 그래프에 각 타겟의 라벨을 출력하지만, 순서가 순서대로 표시되는 대신 순위 번호가 앞에 표시된 순위 순으로 표시됩니다. 이는 결과 순서 지정 --[no]order_results
플래그의 영향을 받지 않습니다 (결과 순서에 관한 참고사항 참고).
이 형식에는 두 가지 변형이 있습니다. minrank
는 루트 노드에서 해당 노드까지의 최단 경로 길이에 따라 각 노드를 순위 지정합니다.
'루트' 노드 (인바운드 에지가 없는 노드)는 순위가 0이고 후속 노드는 순위가 1입니다. (항상 그렇듯이 에지는 타겟에서 그 타겟이 종속되는 기본 요건인 타겟으로 향합니다.)
maxrank
는 루트 노드에서 해당 노드까지의 가장 긴 경로의 길이에 따라 각 노드의 순위를 매깁니다. 다시 말해 '루트'는 순위가 0이고 다른 모든 노드는 모든 전신의 최대 순위보다 1 더 큰 순위를 갖습니다.
순환의 모든 노드는 동일한 순위로 간주됩니다. 대부분의 그래프는 비순환이지만 BUILD
파일에 잘못된 순환이 포함되어 있기 때문에 순환이 발생합니다.
이러한 출력 형식은 그래프의 깊이를 파악하는 데 유용합니다. deps(x)
, rdeps(x)
또는 allpaths
쿼리의 결과에 사용되는 경우 순위 번호는 x
에서 해당 순위의 노드까지의 가장 짧은 경로 (minrank
사용) 또는 가장 긴 경로(maxrank
사용)의 길이와 같습니다. maxrank
는 타겟을 빌드하는 데 필요한 가장 긴 빌드 단계 시퀀스를 결정하는 데 사용할 수 있습니다.
예를 들어 왼쪽 그래프는 --output minrank
및 --output maxrank
가 각각 지정된 경우 오른쪽의 출력을 생성합니다.
minrank 0 //c:c 1 //b:b 1 //a:a 2 //b:b.cc 2 //a:a.cc |
maxrank 0 //c:c 1 //b:b 2 //a:a 2 //b:b.cc 3 //a:a.cc |
각 타겟의 위치 출력
--output location
label_kind
와 마찬가지로 이 옵션은 결과의 각 타겟에 대해 타겟의 종류와 라벨을 출력하지만, 타겟의 위치를 파일 이름과 줄 번호로 설명하는 문자열이 접두사로 추가됩니다. 형식은 grep
의 출력과 유사합니다. 따라서 후자를 파싱할 수 있는 도구 (예: Emacs 또는 vi)는 쿼리 출력을 사용하여 일련의 일치를 단계별로 살펴볼 수 있으므로 Bazel 쿼리 도구를 종속 항목 그래프 인식 'BUILD 파일용 grep'으로 사용할 수 있습니다.
위치 정보는 대상 종류에 따라 다릅니다 (kind 연산자 참고). 규칙의 경우 BUILD
파일 내 규칙 선언의 위치가 출력됩니다.
소스 파일의 경우 실제 파일의 1번 행 위치가 출력됩니다. 생성된 파일의 경우 이를 생성하는 규칙의 위치가 출력됩니다. 쿼리 도구에는 생성된 파일의 실제 위치를 찾을 만큼 충분한 정보가 없으며, 어쨌든 빌드가 아직 실행되지 않은 경우 파일이 존재하지 않을 수도 있습니다.
패키지 집합 출력
--output package
이 옵션은 결과 집합의 일부 타겟이 속한 모든 패키지의 이름을 출력합니다. 이름은 사전순으로 출력되며 중복되는 이름은 제외됩니다. 엄밀히 말하자면 이는 라벨 집합 (패키지, 타겟)에서 패키지로의 프로젝션입니다.
외부 저장소의 패키지는 @repo//foo/bar
형식이지만 기본 저장소의 패키지는 foo/bar
형식입니다.
이 출력 옵션은 deps(...)
쿼리와 함께 사용하여 지정된 타겟 집합을 빌드하기 위해 체크아웃해야 하는 패키지 집합을 찾을 수 있습니다.
결과 그래프 표시
--output graph
이 옵션을 사용하면 쿼리 결과가 널리 사용되는 AT&T GraphViz 형식의 지향 그래프로 출력됩니다. 일반적으로 결과는 .png
또는 .svg
와 같은 파일에 저장됩니다.
dot
프로그램이 워크스테이션에 설치되어 있지 않으면 sudo apt-get install graphviz
명령어를 사용하여 설치할 수 있습니다. 샘플 호출은 아래 예시 섹션을 참고하세요.
이 출력 형식은 --output label
와 같이 선형 형식으로 렌더링할 때 쉽게 시각화할 수 없는 경로 세트가 결과에 포함된 allpaths
, deps
또는 rdeps
쿼리에 특히 유용합니다.
기본적으로 그래프는 분해된 형식으로 렌더링됩니다. 즉, 위상적으로 동일한 노드가 여러 라벨이 있는 단일 노드로 병합됩니다. 이렇게 하면 그래프가 더 컴팩트하고 읽기 쉬워집니다. 일반적인 결과 그래프에는 반복되는 패턴이 많이 포함되어 있기 때문입니다. 예를 들어 java_library
규칙은 모두 동일한 genrule
로 생성된 수백 개의 Java 소스 파일에 종속될 수 있습니다. 분해 그래프에서 이러한 모든 파일은 단일 노드로 표시됩니다. 이 동작은 --nograph:factored
옵션을 사용하여 사용 중지할 수 있습니다.
--graph:node_limit n
이 옵션은 출력의 그래프 노드에 대한 라벨 문자열의 최대 길이를 지정합니다. 라벨이 더 길면 잘립니다. -1은 잘림을 사용 중지합니다. 그래프가 일반적으로 인쇄되는 분해된 형식 때문에 노드 라벨이 매우 길 수 있습니다. GraphViz는 이 옵션의 기본값인 1, 024자(영문 기준)를 초과하는 라벨을 처리할 수 없습니다. --output=graph
가 사용되지 않는 한 이 옵션은 효과가 없습니다.
--[no]graph:factored
기본적으로 그래프는 위에 설명된 대로 분해된 형태로 표시됩니다.
--nograph:factored
가 지정되면 그래프가 분해 없이 출력됩니다. 따라서 GraphViz를 사용한 시각화는 실용적이지 않지만, 더 간단한 형식은 다른 도구 (예: grep)의 처리를 용이하게 할 수 있습니다. --output=graph
가 사용되지 않는 한 이 옵션은 효과가 없습니다.
XML
--output xml
이 옵션을 사용하면 결과 타겟이 XML 형식으로 출력됩니다. 출력은 다음과 같은 XML 헤더로 시작합니다.
<?xml version="1.0" encoding="UTF-8"?>
<query version="2">
그런 다음 순서가 지정되지 않은 결과가 요청되지 않는 한 결과 그래프의 각 타겟에 관한 XML 요소를 순서대로 계속해서 추가한 후 종료 태그로 마무리합니다.
</query>
file
종류의 타겟에 대해 간단한 항목이 내보내집니다.
<source-file name='//foo:foo_main.cc' .../>
<generated-file name='//foo:libfoo.so' .../>
그러나 규칙의 경우 XML은 구조화되어 있으며 규칙의 BUILD
파일에 값이 명시적으로 지정되지 않은 속성을 비롯한 규칙의 모든 속성 정의가 포함됩니다.
또한 결과에는 rule-input
및 rule-output
요소가 포함되므로, 예를 들어 srcs
속성의 요소가 전방 종속 항목 (선행 조건)이고 outs
속성의 콘텐츠가 후방 종속 항목 (소비자)인지 알 필요 없이 종속 항목 그래프의 토폴로지를 재구성할 수 있습니다.
--noimplicit_deps
가 지정된 경우 암시적 종속 항목의 rule-input
요소가 억제됩니다.
<rule class='cc_binary rule' name='//foo:foo' ...>
<list name='srcs'>
<label value='//foo:foo_main.cc'/>
<label value='//foo:bar.cc'/>
...
</list>
<list name='deps'>
<label value='//common:common'/>
<label value='//collections:collections'/>
...
</list>
<list name='data'>
...
</list>
<int name='linkstatic' value='0'/>
<int name='linkshared' value='0'/>
<list name='licenses'/>
<list name='distribs'>
<distribution value="INTERNAL" />
</list>
<rule-input name="//common:common" />
<rule-input name="//collections:collections" />
<rule-input name="//foo:foo_main.cc" />
<rule-input name="//foo:bar.cc" />
...
</rule>
타겟의 모든 XML 요소에는 값이 타겟의 라벨인 name
속성과 값이 --output location
에 의해 출력된 타겟의 위치인 location
속성이 포함됩니다.
--[no]xml:line_numbers
기본적으로 XML 출력에 표시되는 위치에는 줄 번호가 포함됩니다.
--noxml:line_numbers
가 지정된 경우 행 번호가 출력되지 않습니다.
--[no]xml:default_values
기본적으로 XML 출력에는 값이 해당 유형의 속성의 기본값인 규칙 속성이 포함되지 않습니다 (예: BUILD
파일에 지정되지 않았거나 기본값이 명시적으로 제공된 경우). 이 옵션을 사용하면 이러한 속성 값이 XML 출력에 포함됩니다.
정규 표현식
쿼리 언어의 정규 표현식은 Java 정규식 라이브러리를 사용하므로 java.util.regex.Pattern
의 전체 문법을 사용할 수 있습니다.
외부 저장소로 쿼리
빌드가 외부 저장소의 규칙에 종속되는 경우 쿼리 결과에 이러한 종속 항목이 포함됩니다. 예를 들어 //foo:bar
가 @other-repo//baz:lib
에 종속되는 경우 bazel query 'deps(//foo:bar)'
는 @other-repo//baz:lib
를 종속 항목으로 표시합니다.