En este contenido se describe la versión más reciente de la CLI de CodeQL. Para obtener más información sobre esta versión, consulta https://github.com/github/codeql-cli-binaries/releases.
Para ver detalles de las opciones disponibles para este comando en una versión anterior, ejecuta el comando con la opción --help en el terminal.
Sinopsis
codeql resolve tests <options>... -- <test|dir>...Descripción
[Asociación profunda] Busca pruebas unitarias de QL en los directorios dados.
Este comando de asociación es responsable de expandir los parámetros de línea de comandos de los subcomandos que ejecutan pruebas unitarias de QL a una lista real de archivos .ql y .qlref individuales que se van a ejecutar.
Opciones principales
<test|dir>...
Cada argumento es uno de los siguientes:
- Un archivo
.qlo.qlrefque define una prueba que se va a ejecutar. - Directorio en el que se buscarán de forma recursiva las pruebas que se van a ejecutar.
--slice=<N/M>
[Avanzado] Divide los casos de prueba en un número M de segmentos de un tamaño igual aproximado y procesa solo una parte N de ellos. Esto se puede usar para la paralelización manual del proceso de prueba.
--[no-]strict-test-discovery
[Avanzado] Usa solo consultas que se puedan identificar de forma segura como pruebas.
Este modo intenta distinguir entre los archivos .ql que definen pruebas unitarias y los archivos .ql destinados a ser consultas útiles. Esta opción la usan herramientas (como los IDE) que necesitan identificar todas las pruebas unitarias de un árbol de directorio sin que esto dependa de saber previamente cómo se organizan los archivos en este.
Dentro de un paquete de QL cuyo objeto qlpack.yml declara un directorio tests, todos los .ql archivos de ese directorio se consideran pruebas y los archivos .ql fuera de él se omiten. En un paquete de QL que no declare un directorio tests, un archivo .ql se identifica como prueba solo si tiene un archivo .expected correspondiente.
Para mantener la coherencia, los archivos .qlref están limitados por las mismas reglas que los archivos .ql, aunque un archivo .qlref solo puede ser de prueba.
--format=<fmt>
Selecciona el formato de salida, ya sea text (predeterminado) o json.
Opciones comunes
-h, --help
Muestra este texto de ayuda.
-J=<opt>
[Avanzado] Asigna la opción a la JVM que ejecuta el comando.
(Ten en cuenta que las opciones que contienen espacios no se administrarán correctamente).
-v, --verbose
Aumenta incrementalmente el número de mensajes de progreso impresos.
-q, --quiet
Reduce incrementalmente el número de mensajes de progreso impresos.
--verbosity=<level>
[Avanzado] Establece explícitamente el nivel de detalle en errores, advertencias, progreso, progreso+, progreso++, progreso++, progreso+++. Invalida -v y -q.
--logdir=<dir>
[Avanzado] Escribe registros detallados en uno o varios archivos del directorio especificado, con nombres generados que incluyen marcas de tiempo y el nombre del subcomando en ejecución.
(Para escribir un archivo de registro con un nombre sobre el que tienes control total, proporciona --log-to-stderr y redirige stderr como quieras).