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

В этой статье

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

GitHub CodeQL лицензируется на уровне пользователя после установки. CodeQL можно использовать только для определенных задач в соответствии с лицензионными ограничениями. Дополнительные сведения см. в разделе Сведения о CodeQL CLI.

Если у вас есть учетная запись GitHub Enterprise и лицензия на GitHub Advanced Security, вы можете использовать CodeQL для автоматического анализа, непрерывной интеграции и непрерывной поставки. Вы можете создать корпоративную учетную запись, обратившись в отдел продаж. Дополнительные сведения см. в разделе Сведения о GitHub Advanced Security.

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

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

Краткий обзор

Shell

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