데이터 재사용 코드ql-cli.man-pages-version-note %}
개요
codeql resolve files <options>... -- <dir>
codeql resolve files <options>... -- <dir>
Description
\[심층 연결] 파일 포함/제외 패턴 집합 확장하기.
이 내부 처리 명령은 경로로 식별된 여러 파일을 처리하는 하위 명령의 명령줄 매개변수를 확장하는 역할을 합니다. 기본적으로 모든 파일이 포함되므로, 필터 인수 없이 이 명령을 실행하면 디렉터리 내의 모든 파일이 수집됩니다.
`--include`, `--exclude` 및 `--prune` 옵션은 모두 글롭 패턴을 사용하며, 다음 와일드카드 문자를 활용할 수 있습니다.
- 단일 "?"는 슬래시(/ 또는 )를 제외한 임의의 문자 하나와 일치합니다.
- 단일 "*"는 슬래시/백슬래시를 제외한 모든 문자 수와 일치합니다.
- 패턴 "**"는 0개 이상의 전체 디렉터리 구성 요소와 일치합니다.
Options
기본 옵션
<dir>
검색할 디렉터리입니다.
--format=<fmt>
`text`
_(기본값)_ 또는 `json` 중에서 출력 형식을 선택합니다.
수집할 파일 집합을 제한하는 옵션입니다.
--include-extension=<.ext>
검색 디렉터리 트리에서 지정된 확장자를 가진 모든 파일을 포함합니다. 일반적으로 확장자 앞에 점(.)을 포함해야 합니다.
예를 들어, --include-extension .xml을 전달하면 ".xml" 확장자를 가진 모든 파일이 포함됩니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.
--include=<glob>
검색 디렉터리 트리에서 지정된 글롭과 일치하는 모든 파일과 디렉터리를 포함하며, 각 파일과 디렉터리의 경로는 검색 디렉터리를 기준으로 한 상대 경로를 사용합니다. GLOB가 ! 문자로 시작하는 경우 일치하는 파일 및 디렉터리는 제외됩니다.
`--include` 옵션은 순서대로 처리되며, 이후 옵션이 이전 옵션을 재정의할 수 있습니다. 예를 들어 `--include ** --include !sub/*.ts --include sub/main.*`는 `sub/main.ts`를 포함하고(`sub/main.*`에 의해 포함되기 때문), `sub/index.ts`를 제외하며(`!sub/*.ts`에 의해 제외되기 때문) `sub/test.js`를 포함합니다(이후에 제외되지 않고 `**`에 의해 포함되기 때문).
--also-match=<glob>
검색 디렉터리에서 각 파일과 디렉터리의 상대 경로를 기준으로, 모든 결과가 지정된 GLOB 패턴과 일치하도록 요구합니다. 이 옵션은 --include와 구조 및 해석이 동일하지만 --include와 함께 적용되는 별도의 GLOB 시퀀스를 지정합니다.
--exclude=<glob>
검색 디렉터리에서 지정된 GLOB 패턴과 일치하는 모든 파일 및 디렉터리를 각 항목의 상대 경로를 기준으로 제외합니다. 이 옵션은 모든 포함 옵션을 무시합니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.
--prune=<glob>
검색 디렉터리에서 지정된 GLOB 패턴과 일치하는 모든 파일 및 디렉터리를 각 항목의 상대 경로를 기준으로 제외합니다. 이 옵션은 모든 포함 옵션을 무시합니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.
--size-limit=<bytes>
지정된 크기를 초과하는 모든 파일은 제외합니다. 크기 제한은 바이트 단위 또는 ‘k’ 접미사를 사용하는 KiB(키비바이트), ‘m’ 접미사를 사용하는 MiB(메비바이트), ‘g’ 접미사를 사용하는 GiB(기비바이트)로 표시됩니다. 이 옵션은 모든 포함 옵션을 무시합니다.
--total-size-limit=<bytes>
확인된 모든 파일의 총 크기가 지정된 제한을 초과할 경우 명령이 오류와 함께 종료됩니다. 크기 제한은 바이트 단위 또는 ‘k’ 접미사를 사용하는 KiB(키비바이트), ‘m’ 접미사를 사용하는 MiB(메비바이트), ‘g’ 접미사를 사용하는 GiB(기비바이트)로 표시됩니다.
--[no-]follow-symlinks
대상에 대한 바로 가기 링크를 따라갑니다.
--[no-]find-any
모든 일치 항목이 아니라 최대 한 개의 일치 항목만 찾습니다.
`v2.11.3`부터 사용할 수 있습니다.
일반 옵션
-h, --help
이 도움말 텍스트를 표시합니다.
-J=<opt>
\[고급] 명령을 실행하는 JVM에 옵션을 제공합니다.
(옵션에 공백이 포함되면 제대로 처리되지 않을 수 있는 점에 유의해야 합니다.)
-v, --verbose
출력되는 진행률 메시지 수를 점차적으로 늘립니다.
-q, --quiet
출력되는 진행률 메시지 수를 점차적으로 줄입니다.
--verbosity=<level>
\[고급] 세부 정보 표시 수준을 명시적으로 오류, 경고, 진행률, 진행률+, 진행률++, 진행률+++ 중 하나로 설정합니다.
`-v` 및 `-q`를 재정의합니다.
--logdir=<dir>
\[고급] 지정한 디렉터리에 상세 로그를 하나 이상의 파일로 작성하며, 생성된 이름에는 타임스탬프와 실행 중인 하위 명령 이름을 포함합니다.
(로그 파일 이름을 직접 작성하려면 대신 --log-to-stderr을(를) 지정하고 stderr를 원하는 위치로 리디렉션합니다.)
--common-caches=<dir>
\[고급] 다운로드한 QL 팩 및 컴파일된 쿼리 계획 등 CLI를 여러 번 실행해도 지속되는 디스크의 캐시된 데이터의 위치를 제어합니다. 명시적으로 설정하지 않으면, 기본적으로 사용자의 홈 디렉터리에 이름이 지정된 `.codeql` 디렉터리로 설정됩니다. 디렉터리가 아직 없는 경우에는 만들어집니다.
`v2.15.2`부터 사용할 수 있습니다.