Это содержимое описывает последний выпуск данных CodeQL CLI. Дополнительные сведения об этом выпуске см. в статье https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в предыдущем выпуске, выполните команду с --help
параметром в терминале.
Краткие сведения
codeql resolve tests <options>... -- <test|dir>...
codeql resolve tests <options>... -- <test|dir>...
Description
[Глубокий сантехника] Поиск модульных тестов QL в указанных каталогах.
Эта команда сантехники отвечает за расширение параметров командной строки вложенных команд, выполняющих модульные тесты QL, в фактический список отдельных файлов .ql и .qlref для выполнения.
Параметры
Основные параметры
<test|dir>...
Каждый аргумент является одним из следующих:
- Файл
.ql
или.qlref
файл, определяющий тест для выполнения. - Каталог, который будет выполняться рекурсивно для выполнения тестов.
--slice=<N/M>
[Дополнительно] Разделите тестовые случаи на куски примерно равных размеров и обработайте только _N_th из них. Это можно использовать для параллелизации процесса тестирования вручную.
--[no-]strict-test-discovery
[Дополнительно] Используйте только запросы, которые можно строго определить как тесты.
Этот режим пытается различать .ql
файлы, определяющие модульные тесты и .ql
файлы, которые должны быть полезными запросами. Этот параметр используется средствами, такими как идентификаторы, которые должны определять все модульные тесты в дереве каталогов без учета предыдущих знаний о том, как файлы в нем упорядочены.
В пакете QL, который qlpack.yml
объявляет tests
каталог, все .ql
файлы в этом каталоге считаются тестами, а .ql
файлы вне него игнорируются. В пакете QL, который не объявляет tests
каталог, файл определяется как тест только в том случае, .ql
если он имеет соответствующий .expected
файл.
Для согласованности файлы ограничены теми же правилами, что .ql
и файлы, .qlref
даже если .qlref
файл не может быть не тестируемым.
--format=<fmt>
Выберите выходной формат либо (по умолчанию),_ либо text
_json
.
Распространенные параметры
-h, --help
Отображение этого текста справки.
-J=<opt>
[Дополнительно] Укажите параметр JVM, выполняя команду.
(Убедитесь, что параметры, содержащие пробелы, не будут обрабатываться правильно.)
-v, --verbose
Постепенно увеличьте число отображаемых сообщений о ходе выполнения.
-q, --quiet
Постепенно уменьшайте количество отображаемых сообщений о ходе выполнения.
--verbosity=<level>
[Дополнительно] Явным образом задайте уровень детализации на одну из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет -v
и -q
.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющегося подкоманда.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого предоставьте --log-to-stderr
и перенаправите stderr по мере необходимости.)
--common-caches=<dir>
[Дополнительно] Управляет расположением кэшированных данных на диске, которые будут сохраняться между несколькими запусками интерфейса командной строки, такими как скачанные пакеты QL и скомпилированные планы запросов. Если этот параметр не задан явным образом, по умолчанию используется каталог с именем .codeql
в домашнем каталоге пользователя; он будет создан, если он еще не существует.
Доступно с момента v2.15.2
.