В этом материале описывается последний выпуск Интерфейса командной строки CodeQL. Дополнительные сведения об этом выпуске см. в разделе https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в более раннем выпуске, выполните команду с параметром в терминале --help
.
Краткий обзор
codeql resolve tests <options>... -- <test|dir>...
Описание
[Глубокая сантехника] Поиск модульных тестов QL в заданных каталогах.
Эта команда отвечает за расширение параметров командной строки подкоманды, выполняющих модульные тесты QL, до фактического списка отдельных QL- и QLREF-файлов, которые необходимо выполнить.
Основные параметры
<test|dir>...
Каждый аргумент является одним из следующих:
- Файл
.ql
или.qlref
, определяющий тест для запуска. - Каталог, в котором будет выполняться рекурсивный поиск тестов.
--slice=<N/M>
[Дополнительно] Разделите тестовые случаи на Срезы M примерно равного размера и обработайте только N-йиз них. Это можно использовать для параллелизации процесса тестирования вручную.
--[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>
[Дополнительно] Явно задайте уровень детализации для одной из ошибок, предупреждений, progress, progress+, progress++, progress+++. Переопределяет -v
и -q
.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющейся подкоманды.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого при необходимости предоставьте --log-to-stderr
и перенаправьте stderr.)