В этом материале описывается последний выпуск Интерфейса командной строки CodeQL. Дополнительные сведения об этом выпуске см. в разделе https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в более раннем выпуске, выполните команду с параметром в терминале --help
.
Краткий обзор
codeql test accept <options>... -- <test|dir>...
Описание
Примите результаты неудачных модульных тестов.
Это удобная команда, которая переименовывает файлы, оставленные .actual
при тестовом запуске codeql для неудачных тестов, в .expected
, так что будущие запуски тестов, которые дают те же выходные данные, будут считаться пройденными. То, что он делает, также может быть достигнуто обычными манипуляциями с файлами, но вы можете найти его синтаксис более полезным для этого специального случая.
Аргументы командной строки указывают один или несколько тестов , то есть файлы, .ql(ref)
и команда автоматически наследует имена .actual
файлов из них. Любой тест, у которого .actual
нет файла, игнорируется автоматически, что позволяет легко принимать только результаты неудачных тестов из предыдущего запуска.
Основные параметры
<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
файл не может быть не тестируемым.
Общие параметры
-h, --help
Показать этот текст справки.
-J=<opt>
[Дополнительно] Предоставьте параметр виртуальной машине Java, запустив команду .
(Остерегайтесь, что параметры, содержащие пробелы, будут обрабатываться неправильно.)
-v, --verbose
Добавочное увеличение числа выводемых сообщений о ходе выполнения.
-q, --quiet
Постепенно уменьшайте количество выводемых сообщений о ходе выполнения.
--verbosity=<level>
[Дополнительно] Явно задайте уровень детализации для одной из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет -v
и -q
.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в заданном каталоге с созданными именами, включая метки времени и имя выполняющейся подкоманды.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого при необходимости предоставьте --log-to-stderr
и перенаправьте stderr.)