В этом материале описывается последний выпуск Интерфейса командной строки CodeQL. Дополнительные сведения об этом выпуске см. в разделе https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в более раннем выпуске, выполните команду с параметром в терминале --help .
Краткий обзор
codeql resolve files <options>... -- <dir>
codeql resolve files <options>... -- <dir>
Описание
[Глубокая сантехника] Расширение набора файлов включения или исключения шаров.
Эта команда сантехнирования отвечает за расширение параметров командной строки подкоманды, которые работают с несколькими файлами, определенными по их путям. По умолчанию включены все файлы, поэтому выполнение этой команды без аргументов фильтра приведет к сбору всех файлов в каталоге.
Параметры --include, --excludeи --prune принимают шаблоны glob, которые могут использовать следующие подстановочные знаки:
- Один символ "?" соответствует любому символу, отличному от косой черты вперед или назад;
- Один символ "*" соответствует любому количеству символов, кроме косой черты вперед или назад;
- Шаблон "**" соответствует нулю или более полным компонентам каталога.
Основные параметры
<dir>
Каталог, в котором необходимо выполнить поиск.
--format=<fmt>
Выберите формат вывода (textпо умолчанию) или json.
Параметры ограничения набора собранных файлов
--include-extension=<.ext>
Включите все файлы в дерево каталогов поиска с заданным расширением. Как правило, следует добавить точку перед расширением.
Например, передача --include-extension .xml будет включать все файлы с расширением ".xml". Этот параметр несовместим с отрицательными параметрами --include .
--include=<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>
Требовать, чтобы все результаты также соответствовали заданному объекту, используя относительный путь к каждому файлу и каталогу из каталога поиска. Этот параметр имеет ту же структуру и ту же интерпретацию, что --include и , но задает отдельную последовательность шаров, которые применяются в сочетании с --include.
--exclude=<glob>
Исключите все файлы и каталоги, соответствующие заданному объекту, используя относительный путь каждого файла и каталога из каталога поиска. Этот параметр переопределяет все включаемые параметры. Этот параметр несовместим с отрицательными параметрами --include .
--prune=<glob>
Исключите все файлы и каталоги, соответствующие заданному объекту, используя относительный путь каждого файла и каталога из каталога поиска. Этот параметр переопределяет все включаемые параметры. Этот параметр несовместим с отрицательными параметрами --include .
--size-limit=<bytes>
Исключите все файлы, размер которых превышает заданное ограничение. Предельный размер : в байтах или в кибибайтах (КиБ) с суффиксом "k", в мебибайтах (МиБ) с суффиксом "m" и в гибибайтах (ГиБ) с суффиксом "g". Этот параметр переопределяет все включаемые параметры.
--total-size-limit=<bytes>
Если совокупный размер всех разрешенных файлов превысит заданное ограничение, команда завершится с ошибкой. Предельный размер : в байтах или в кибибайтах (КиБ) с суффиксом "k", в мебибайтах (МиБ) с суффиксом "m" и в гибибайтах (ГиБ) с суффиксом "g".
--[no-]follow-symlinks
Перейдите по любым символьным ссылкам на целевые объекты.
--[no-]find-any
Найти не более одного совпадения (в отличие от всех совпадений).
Доступно начиная с v2.11.3.
Общие параметры
-h, --help
Показать этот текст справки.
-J=<opt>
[Дополнительно] Предоставьте параметр виртуальной машине JVM, выполняющую команду .
(Остерегайтесь, что параметры, содержащие пробелы, будут обрабатываться неправильно.)
-v, --verbose
Постепенно увеличивать количество выводемых сообщений о ходе выполнения.
-q, --quiet
Постепенно уменьшайте количество выводемых сообщений о ходе выполнения.
--verbosity=<level>
[Дополнительно] Явно задайте уровень детализации для одной из ошибок, предупреждений, progress, progress+, progress++, progress+++. Переопределяет -v и -q.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющейся подкоманды.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого при необходимости предоставьте --log-to-stderr и перенаправьте stderr.)