В этом материале описывается последний выпуск Интерфейса командной строки 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.)