Сведения о справочных файлах запросов
Файл ссылки на запрос — это текстовый файл, определяющий расположение одного запроса для тестирования.
Вы используете файл ссылки на запрос, если вы хотите сообщить test run
подкомандам выполнить запрос, который не является частью тестового каталога.
Существует два способа указать запросы, которые необходимо выполнить в качестве тестов:
- Используйте файл ссылки на запрос, чтобы указать расположение запроса для тестирования. Это полезно при создании тестов для запросов оповещений и путей, предназначенных для выявления проблем в реальных базах кода. Вы можете создать несколько каталогов тестового кода, каждый из которых фокусируется на различных аспектах запроса. Затем вы добавите файл ссылки на запрос в каждый каталог тестового кода, чтобы указать запрос для тестирования.
- Добавьте запрос непосредственно в каталог тестов.
Обычно это полезно при написании запросов явным образом для тестирования поведения библиотек QL. Часто эти запросы содержат всего несколько вызовов предикатов библиотеки, упаковав их в
select
инструкцию, чтобы их выходные данные можно было проверить.
Определение ссылочного файла запроса
Каждый файл .qlref
ссылки на запрос содержит одну строку, которая определяет, где найти один запрос. Расположение должно быть определено относительно корневого каталога пакета CodeQL, содержащего запрос.
Обычно это пакет CodeQL, содержащий .qlref
пакет CodeQL , указанный в dependencies
блоке для тестового пакета, или транзитивную зависимость пакета CodeQL .
Для обеспечения совместимости между системами следует использовать косую черту в пути ко всем операционным системам.
Пример
Файл ссылки на запрос для тестирования запроса оповещения JavaScript: DeadAngularJSEventListener.qlref
Файл qlpack.yml
, https://github.com/github/codeql/blob/main/javascript/ql/test/qlpack.ymlдля пакета CodeQL определяется javascript/ql/test
codeql/javascript-queries
как зависимость. Поэтому файл ссылки на запрос определяет расположение запроса относительно codeql/javascript-queries
пакета CodeQL:
AngularJS/DeadAngularJSEventListener.ql
Другой пример см. в разделе "Тестирование пользовательских запросов".