Skip to main content

Enterprise Server 3.15 в настоящее время доступен в качестве кандидата на выпуск.

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

[Глубокая сантехника] Найдите модульные тесты QL в указанных каталогах.

Кто может использовать эту функцию?

CodeQL доступен для следующих типов репозитория:

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

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

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

Shell
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.