provep - Online en la nube

PROGRAMA:

NOMBRE

probar: ejecutar pruebas a través de un arnés TAP.

USO

probar [opciones] [archivos o directorios]

OPCIONES

Opciones booleanas:

-v, --verbose Imprime todas las líneas de prueba.
-l, --lib Agrega 'lib' a la ruta de tus pruebas (-Ilib).
-b, --blib Agrega 'blib / lib' y 'blib / arch' a la ruta para
tus pruebas
-s, --shuffle Ejecuta las pruebas en orden aleatorio.
-c, --color Salida de prueba coloreada (predeterminado).
--nocolor No color de salida de prueba.
--count Muestra el recuento de la prueba X / Y cuando no es detallado
(Por defecto)
--nocount Deshabilita el recuento de prueba X / Y.
-D - Dry Run en seco. Muestre la prueba que se habría ejecutado.
-f, --failures Muestra las pruebas fallidas.
-o, --comentarios Mostrar comentarios.
--ignore-exit Ignora el estado de salida de los scripts de prueba.
-m, --merge Fusiona el STDERR de los scripts de prueba con su STDOUT.
-r, --recurse Desciende recursivamente a directorios.
--reverse Ejecuta las pruebas en orden inverso.
-q, --quiet Suprime algunos resultados de prueba mientras se ejecutan pruebas.
-Q, --QUIET Solo imprime resultados de resumen.
-p, --parse Muestra la lista completa de errores de análisis de TAP, si los hubiera.
--directives Solo muestra resultados con directivas TODO o SKIP.
--timer Imprime el tiempo transcurrido después de cada prueba.
--trap Trampa Ctrl-C e imprime resumen al interrumpir.
--normalize Normaliza la salida TAP en salida detallada
-T Habilitar comprobaciones de contaminación.
-t Habilita las advertencias de contaminación.
-W Habilita las advertencias fatales.
-w Habilita las advertencias.
-h, --help Muestra esta ayuda
- ?, Mostrar esta ayuda
-V, --version Muestra la versión
-H, --man Página de manual más larga para probar
--norc No procesa el .proverc predeterminado

Opciones que toman argumentos:

-I Rutas de biblioteca a incluir.
-P Load plugin (busca App :: Prove :: Plugin :: *.)
-M Cargar un módulo.
-e, --exec Intérprete para ejecutar las pruebas ('' para compilado
pruebas.)
--ext Establece la extensión para las pruebas (por defecto '.t')
- arnés Define el arnés de prueba que se utilizará. Consulte TAP :: Arnés.
--formateador Formateador de resultados a utilizar. Ver FORMATADORES.
--source Carga y / o configura un SourceHandler. Ver
MANIPULADORES DE FUENTES.
-a, --archive out.tgz Almacena el TAP resultante en un archivo de almacenamiento.
-j, --jobs N Ejecuta N trabajos de prueba en paralelo (prueba 9.)
--state = opts Controla el estado persistente de la prueba.
--rc = rcfile Opciones de proceso de rcfile
--reglas Reglas para procesamiento paralelo vs secuencial.

NOTAS

~ / .proverc / ./.proverc
If ~ / .proverc or ./.proverc existen serán leídos y cualquier opción que contengan procesada
antes de las opciones de la línea de comandos. Opciones en .proverc se especifican de la misma forma que
opciones de línea de comando:

# .proverc
--state = caliente, rápido, guardar
-j9

Se pueden especificar archivos de opciones adicionales con la opción "--rc". Archivo de opciones predeterminado
el procesamiento está deshabilitado por la opción "--norc".

En Windows y VMS, el archivo de opciones se denomina _provercio más bien que .proverc y se busca
solo en el directorio actual.

Reading obtenidos de "STDIN"
Si tiene una lista de pruebas (o URL, o cualquier otra cosa que desee probar) en un archivo,
puede agregarlos a sus pruebas usando un '-':

probar - <mi_lista_de_cosas_para_prueba.txt

Consulte el "README" en el directorio de "ejemplos" de esta distribución.

Predeterminado Prueba Directory
Si no se proporcionan archivos o directorios, "probar" busca todos los archivos que coincidan con el patrón
"t / *. t".

De colores Prueba Salida
La salida de prueba coloreada usando TAP :: Formatter :: Color es el valor predeterminado, pero si la salida no es
terminal, el color está desactivado. Puede anular esto agregando el modificador "--color".

El soporte de color requiere Term :: ANSIColor en plataformas similares a Unix y Win32 :: Console en
ventanas. Si el módulo necesario no está instalado, la salida de color no estará disponible.

Exit Código
Si las pruebas fallan, "probar" saldrá con un estado distinto de cero.

Argumentos a Examenes
Es posible proporcionar argumentos a las pruebas. Para hacerlo, sepárelos de los propios de prueba.
argumentos con el arisdottle, '::'. Por ejemplo

probar -vt / mytest.t :: --url http://example.com

correría t / mytest.t con las opciones '--url http://example.com'. Al ejecutar múltiples
pruebas, cada uno de ellos recibirá los mismos argumentos.

"--exec"
Normalmente, puede pasar una lista de pruebas de Perl y el arnés sabrá cómo ejecutar
ellos. Sin embargo, si sus pruebas no están escritas en Perl o si desea invocar todas las pruebas
exactamente de la misma manera, use el modificador "-e" o "--exec":

probar --exec '/ usr / bin / ruby -w 't /
probar --exec '/ usr / bin / perl -Tw -mstrict -Ilib 't /
probar --exec '/ ruta / a / mi / cliente / exec'

"--unir"
Si necesita asegurarse de que sus diagnósticos se muestren en el orden correcto en relación con
resultados de la prueba, puede utilizar la opción "--merge" para fusionar el STDERR de los scripts de prueba en su
SALIDA ESTÁNDAR.

Esto garantiza que STDOUT (donde aparecen los resultados de la prueba) y STDERR (donde el
aparecen los diagnósticos) permanecerán sincronizados. El arnés mostrará los diagnósticos de sus pruebas.
emitir en STDERR.

Advertencia: esto es un poco torpe. En particular, tenga en cuenta que si algo que aparece en
STDERR parece un resultado de prueba, el arnés de prueba se confundirá. Use esta opción solamente
si comprende las consecuencias y puede vivir con el riesgo.

"--trampa"
La opción "--trap" intentará atrapar SIGINT (Ctrl-C) durante una ejecución de prueba y mostrará el
resumen de la prueba incluso si se interrumpe la ejecución

"--estado"
Puede pedir "probar" para recordar el estado de las ejecuciones de prueba anteriores y seleccionar y / o pedir
las pruebas que se ejecutarán en función de ese estado guardado.

El modificador "--state" requiere un argumento que debe ser una lista separada por comas de uno o
más de las siguientes opciones.

"último"
Ejecute las mismas pruebas que la última vez que se guardó el estado. Esto hace posible, para
ejemplo, para recrear el orden de una prueba aleatoria.

# Ejecute todas las pruebas en orden aleatorio
$ probar -b --state = guardar --shuffle

# Ejecútelos de nuevo en el mismo orden
$ probar -b --state = last

"fallido"
Ejecute solo las pruebas que fallaron en la última ejecución.

# Ejecutar todas las pruebas
$ probar -b --state = guardar

# Ejecutar fallas
$ prueba -b --state = fallido

Si también especifica la opción "guardar", las pruebas que pasen recientemente se excluirán de
ejecuciones posteriores.

# Repetir hasta que no haya más fallas
$ probar -b --state = fallido, guardar

"aprobado"
Ejecute solo las pruebas aprobadas de la última vez. Útil para asegurarse de que no haya nuevos problemas
ha sido introducido.

"todas"
Ejecute todas las pruebas en orden normal. Se pueden especificar varias opciones, por lo que para ejecutar todas las pruebas
con las fallas de la última vez primero:

$ probar -b --state = fallado, todos, guardar

"caliente"
Ejecute primero las pruebas que fallaron más recientemente. El último tiempo de falla de cada prueba es
almacenado. La opción "caliente" hace que las pruebas se ejecuten en el orden de falla más reciente.

$ probar -b --state = hot, save

No se seleccionarán las pruebas que nunca hayan fallado. Para ejecutar todas las pruebas con la mayor
primer uso fallido recientemente

$ probar -b --state = hot, all, save

Esta combinación de opciones también se puede especificar así

$ probar -b --state = adrian

"hacer"
Ejecute cualquier prueba con todos.

"lento"
Ejecute las pruebas en el orden más lento al más rápido. Esto es útil junto con el "-j"
interruptor de prueba en paralelo para asegurarse de que las pruebas más lentas comiencen a ejecutarse primero.

$ prueba -b --state = lento -j9

"rápido"
Ejecute pruebas de prueba en el orden más rápido al más lento.

"nuevo"
Ejecute las pruebas en el orden más reciente al más antiguo según los tiempos de modificación de la prueba
scripts.

"antiguo"
Ejecute las pruebas en el orden más antiguo al más nuevo.

"Fresco"
Ejecute los scripts de prueba que se han modificado desde la última ejecución de prueba.

"ahorrar"
Salva el estado al salir. El estado se almacena en un archivo llamado .probar (_ en Windows
y VMS) en el directorio actual.

El interruptor "--state" se puede usar más de una vez.

$ probar -b --state = hot --state = all, save

--normas
La opción "--rules" se utiliza para controlar qué pruebas se ejecutan secuencialmente y cuáles se ejecutan
en paralelo, si se especifica la opción "--jobs". La opción se puede especificar múltiples
veces, y el orden importa.

Es probable que el uso más práctico especifique que algunas pruebas no están "preparadas en paralelo".
Dado que mencionar un archivo con --rules no hace que se seleccione para ejecutarlo como prueba,
puede "establecer y olvidar" algunas preferencias de reglas en su archivo .proverc. Entonces podrás
aprovechar al máximo los beneficios de rendimiento de las pruebas en paralelo, mientras que algunos
las excepciones todavía se ejecutan en paralelo.

--normas ejemplos

# Todas las pruebas pueden ejecutarse en paralelo, excepto las que comienzan con "p"
--rules = 'seq = t / p * .t' --rules = 'par = **'

# Todas las pruebas deben ejecutarse en secuencia, excepto las que comienzan con "p", que deben ejecutarse en paralelo
--rules = 'par = t / p * .t'

--normas resolución

· De forma predeterminada, todas las pruebas pueden ejecutarse en paralelo. Especificando cualquiera de los suyos
reglas elimina este.

· "El primer partido gana". La primera regla que coincida con una prueba será la que se aplique.

· Cualquier prueba que no coincida con una regla se ejecutará en secuencia al final de la ejecución.

· La existencia de una regla no implica seleccionar una prueba. Aún debe especificar el
pruebas para ejecutar.

· Especificar una regla para permitir que las pruebas se ejecuten en paralelo no hace que se ejecuten en
paralelo. Aún necesita especificar el número de "trabajos" paralelos en su objeto Harness.

--normas Estilo glob patrón pareo

Implementamos nuestra propia coincidencia de patrones de estilo glob para --rules. Aquí están los apoyados
patrones:

** es cualquier número de caracteres, incluido /, dentro de un nombre de ruta
* es cero o más caracteres dentro de un nombre de archivo / nombre de directorio
? es exactamente un carácter dentro de un nombre de archivo / nombre de directorio
{foo, bar, baz} es cualquiera de foo, bar o baz.
\ es un personaje de escape

Más avanzado Especificaciones for paralelo vs secuencia run reglas

Si necesita una administración más avanzada de lo que se ejecuta en paralelo o en secuencia, consulte la
documentación de 'reglas' asociada en TAP :: Harness y TAP :: Parser :: Scheduler. Si que es
posible directamente a través de "probar" no es suficiente, puede escribir su propio arnés para
acceder a estas funciones directamente.

@C ª
probar introduce una separación entre "opciones pasadas al perl que ejecuta probar" y
"opciones pasadas al perl que ejecuta pruebas"; esta distinción es por diseño. Por lo tanto, la
perl que está ejecutando una prueba comienza con el @INC predeterminado. Directorios de bibliotecas adicionales
se puede agregar mediante la variable de entorno "PERL5LIB", mediante -Ifoo en "PERL5OPT" o mediante el
Opción "-Ilib" para .

Mancha Moda
Normalmente, cuando un programa Perl se ejecuta en modo corrupto, el contenido de "PERL5LIB"
La variable de entorno no aparece en @INC.

Porque "PERL5LIB" se usa a menudo durante las pruebas para agregar directorios de compilación a @INC probar
pasa los nombres de los directorios que se encuentran en "PERL5LIB" como -I cambia. El efecto neto de
esto es que "PERL5LIB" se respeta incluso cuando se ejecuta la prueba en modo taint.

Formateadores

Puede cargar un TAP :: Parser :: Formatter personalizado:

probar --formateador MyFormatter

FUENTE MANIPULADORES

Puede cargar TAP :: Parser :: SourceHandlers personalizados, para cambiar la forma en que el analizador interpreta
particular fuentes de TAP.

probar --source MyHandler --source YetAnother t

Si desea proporcionar la configuración a la fuente, puede usar:

probar --source MyCustom \
--source Perl --perl-option 'foo = bar baz' --perl-option avg = 0.278 \
--file de origen --file-option extensions = .txt --file-option extensions = .tmp t
--source pgTAP --pgtap-option pset = format = html --pgtap-option pset = border = 2

Cada opción "- $ source-option" debe especificar un par clave / valor separado por un "=". Si una
La opción puede tomar varios valores, simplemente especifíquela varias veces, como con "extensions ="
ejemplos anteriores. Si la opción debe ser una referencia hash, especifique el valor como un segundo
par separado por un "=", como en los ejemplos de "pset =" anteriores (escape "=" con una barra invertida).

Todos los "--sources" se combinan en un hash y se pasan a "new" en TAP :: Harness's "sources"
parámetro.

Consulte TAP :: Parser :: IteratorFactory para obtener más detalles sobre cómo se pasa la configuración a
Controladores de origen.

PLUGINS

Los complementos se pueden cargar usando el "-Penchufar" sintaxis, por ejemplo:

probar -PMyPlugin

Esto buscará un módulo llamado "App :: Prove :: Plugin :: MyPlugin", o en su defecto,
"MyPlugin". Si no se puede encontrar el complemento, "probar" se quejará y saldrá.

Puede pasar argumentos a su complemento agregando "= arg1, arg2, etc." al nombre del complemento:

probar -PMyPlugin = fou, du, fafa

Consulte la documentación del complemento individual para obtener más detalles.

Disponibles Plugins
Para obtener una lista actualizada de complementos disponibles, consulte CPAN:

<http://search.cpan.org/search? query = App% 3A% 3AProve + Plugin>

Escribiendo Plugins
Consulte "PLUGINS" en App :: Prove.

Utilice provep en línea utilizando los servicios de onworks.net