разрешение тестов

Note

Это содержимое описывает последний выпуск данных CodeQL CLI. Дополнительные сведения об этом выпуске см. в статье https://github.com/github/codeql-cli-binaries/releases.

Чтобы просмотреть сведения о параметрах, доступных для этой команды в предыдущем выпуске, выполните команду с --help параметром в терминале.

Краткие сведения

Shell

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.