Note
Это содержимое описывает последний выпуск данных CodeQL CLI. Дополнительные сведения об этом выпуске см. в статье https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в предыдущем выпуске, выполните команду с --help параметром в терминале.
Краткие сведения
codeql test accept <options>... -- <test|dir>...
codeql test accept <options>... -- <test|dir>...
Description
Примите результаты неудачных модульных тестов.
Это удобная команда, которая переименовывает .actual файлы, оставленные тестом codeql для неудачных тестов .expected, таким образом, что будущие запуски на тестах, которые дают те же выходные данные, будут считаться пройденными. То, что он делает, также можно достичь обычными манипуляциями с файлами, но его синтаксис может оказаться более полезным для этого специального случая.
Аргументы командной строки указывают один или несколько тестов , то есть .ql(ref) файлы, и команда автоматически наследует имена .actual файлов из них. Любой тест, у которого .actual нет файла, будет автоматически игнорироваться, что позволяет легко принимать только результаты неудачных тестов из предыдущего запуска.
Параметры
Основные параметры
<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 файл не может быть не тестируемым.
Распространенные параметры
-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.