how use command line integration with newman postman
Aprenda a ejecutar colecciones de cartero con Newman:
En este tutorial, veremos cómo podemos integrar o ejecutar colecciones de Postman a través de la línea de comandos usando Newman, que es una herramienta de integración de línea de comandos para Postman.
Newman es una herramienta gratuita y de código abierto. Proporciona capacidades poderosas para ejecutar las colecciones de Postman, aprovechando capacidades súper útiles de Postman como pruebas, afirmaciones, scripts de solicitud previa, etc. y ejecutando la colección a través de la línea de comandos.
=> Consulte aquí para ver los tutoriales de capacitación de cartero de la A a la Z aquí.
Lo que vas a aprender:
¿Qué es Newman?
Newman es un corredor de línea de comandos para colecciones de Postman. En otras palabras, permite al usuario ejecutar una colección de Postman existente a través de la línea de comandos.
Espera o consume la versión JSON de la colección que se puede obtener simplemente exportando la colección en formato de colección JSON o la URL de la colección, que no es más que el mismo JSON que se obtiene mediante la exportación de la colección.
Aquí hay un tutorial en video:
Instalación de Newman
Newman es un módulo NodeJS y, por lo tanto, depende del sistema que tenga el nodo instalado. Para verificar si el nodo está instalado o no, simplemente verifique la versión del nodo en el sistema usando el siguiente comando.
|_+_|Si el comando devuelve algún resultado como el anterior, significa que el nodo está instalado y estamos listos para continuar con la instalación de Newman. De lo contrario, puede instalar el nodo consultando las instrucciones de instalación Aquí
Una vez que la instalación del nodo sea exitosa, simplemente puede instalar Newman como cualquier otro paquete de nodo usando el siguiente comando.
|_+_|Aquí '-g' denota instalación global, lo que significa que se podrá acceder al paquete Newman desde cualquier carpeta / ubicación en el sistema de archivos. Para realizar una instalación local, puede eliminar la marca '-g' de la anterior, donde el paquete Newman será accesible solo desde la ubicación o carpeta instalada.
Para validar la instalación exitosa de Newman, simplemente puede verificar su versión usando el siguiente comando.
|_+_|Ejecución de colecciones con Newman
Para ejecutar colecciones con Newman, debe tener cualquiera de los 2.
- La colección en formato JSON.
- URL de la colección alojada.
El comando usado para ejecutar la colección Postman usando Newman es:
qa gerente entrevista preguntas respuestas pdf|_+_|
Intentemos ejecutar una colección de muestra con Postman.
- Vaya a la aplicación Postman, use cualquier colección Postman existente y expórtela a formato JSON. (Crearemos una nueva colección con 3 solicitudes, es decir, registrar usuario, iniciar sesión y obtener usuario mediante el formulario de puntos finales de API Aquí ).
- Ahora exporte la colección a formato JSON.
- Una vez que se obtiene la colección JSON, abra un símbolo del sistema y ejecute la colección usando el comando de ejecución de Newman (suponga que la colección se exportó con el nombre - Postman_Newman_IntegrationCollection .json) y el usuario ha navegado al directorio de exportación de la colección, entonces la colección se puede ejecutar simplemente usando el siguiente comando.
Una vez que se ejecuta el comando anterior, se produce el siguiente resultado.
Integración de Newman con variables de entorno
Ahora veamos usos más avanzados de Newman. Para una colección que no depende de ninguna variable de entorno, la colección podría simplemente ejecutarse usando el comando de ejecución de Newman. Pero para las colecciones, utilizando las variables de entorno, necesitamos proporcionar la variable de entorno JSON también junto con la colección JSON.
Ejemplo: Usaremos la misma colección y usaremos una variable de entorno para el punto final del usuario GET, es decir, para la solicitud con punto final .
Usaremos userId de la colección de variables de entorno. Entonces, la solicitud resultante se convertirá en https://reqres.in/api/users/{{userId}}
Ahora, una vez creado el archivo de entorno, expórtelo como JSON siguiendo los pasos a continuación.
- Cree un entorno, con una variable denominada userId y el valor debe establecerse en '4'.
- Ahora, haga clic en el botón Configuración para abrir la ventana 'Administrar entornos'.
- Haga clic en el icono 'Descargar' del entorno creado para descargar el entorno como un archivo JSON (guarde el archivo con el nombre 'testEnv.json).
Exportemos la colección nuevamente con la solicitud modificada e intentemos ejecutar la misma colección junto con el archivo de entorno con el comando que se muestra a continuación:
|_+_|Una vez que se ejecuta el comando anterior, la salida sigue siendo la misma que la ejecución de recopilación directa, y el único cambio es la solicitud 'GET User' que ahora obtiene el valor del archivo JSON del entorno.
Resultados de afirmación con Newman
Como las solicitudes de Postman también pueden contener afirmaciones, ahora veremos cómo se muestran los resultados de la afirmación cuando las colecciones de Postman se ejecutan a través de un Newman.
El corredor de la colección Newman está en completa paridad con el corredor de la colección Postman y el ejecutor de solicitudes. Para las solicitudes que tienen aserciones, las aserciones se evalúan cuando se completa la ejecución de la solicitud y el resumen de la ejecución de la aserción se muestra en el resumen de la prueba al final de la ejecución de la prueba.
Para la colección anterior, agregamos una aserción de nivel de colección para verificar que el código de estado de la respuesta sea 200, es decir, para cada solicitud que sea parte de la colección, debe haber esta aserción asociada.
Entonces, si esta colección tenía 3 solicitudes, significa que debería haber un total de 3 afirmaciones que deberían haberse ejecutado.
Consulte la captura de pantalla siguiente para ver los resultados de ejecución resaltados y los resultados de afirmación.
Generación de informes con Newman
Hasta ahora sabemos que Newman puede ejecutar colecciones de Postman a través de la línea de comando y generar algunos registros de prueba y un resumen de ejecución de la prueba. Pero, ¿qué pasa con los informes formateados que podrían compartirse o publicarse en algún servidor?
Bueno, Newman también tiene soporte para esto. Hay algunos módulos de nodo personalizados disponibles para generar informes de ejecución de pruebas de Newman. Veremos un ejemplo usando un newman-html-reporter .
Este reportero es nuevamente un módulo de nodo y debe instalarse por separado usando el siguiente comando.
|_+_|Una vez instalado el módulo anterior, se puede utilizar junto con el comando de ejecución de Newman.
|_+_|La bandera '-r' indica el reportero que se utilizará con la ejecución de recopilación de Newman.
Con esta opción, hace uso del módulo o paquetes Newman-reporter-html y crea un informe basado en HTML para la ejecución de la prueba.
Consulte una de esas capturas de pantalla del informe HTML que se muestra a continuación:
Integración con herramientas de CI
Dado que Newman tiene la capacidad de ejecutarse como una línea de comando, reduce mucha dependencia de cualquier requisito previo en forma de consola o aplicación, es decir, la única dependencia que tiene Newman es un nodo (que generalmente está disponible como una ejecución entorno en todas las máquinas de CI como esclavos Jenkins o nodos Travis).
Esto permite que las colecciones de Postman se ejecuten como parte de las propias canalizaciones de compilación a través de la línea de comandos de Newman.
Dado que Newman también tiene la capacidad de enviar resultados en formato Html, esto es realmente útil y práctico y durante la ejecución de la canalización en sí, los resultados HTML pueden enviarse a un servidor o pueden enviarse a través de un correo electrónico a los usuarios deseados, etc. las capacidades son infinitas ya que las dependencias son mínimas.
Para obtener un ejemplo de ejecución detallado de extremo a extremo de la integración con Jenkins, consulte este ejemplo del blog oficial de Postman Aquí .
Más opciones con Newman
Todo lo que hemos cubierto es un subconjunto de la funcionalidad que proporciona Newman. Para obtener detalles completos de los comandos e interruptores que admite Newman, simplemente abra la ayuda de la línea de comandos para Newman usando el siguiente comando.
|_+_|Aquí está el resultado del comando anterior, con detalles sobre todos los interruptores y sus significados.
También hay otros recursos de información para referencia de la API de Newman. Consulte Aquí para la documentación oficial.
Conclusión
En este tutorial, analizamos la integración de la línea de comandos de Postman llamada Newman, que permite ejecutar colecciones de Postman a través de una interfaz de línea de comandos.
Es simplemente un paquete de nodos y cualquier línea de comando que tenga un nodo instalado junto con Newman debería poder ejecutar la colección Postman y generar informes atractivos de la ejecución de la colección.
La integración de la línea de comandos también es de gran ayuda para la integración de las pruebas de colección basadas en Postman con herramientas de CI como Jenkins, Travis, etc., ya que la ejecución a través de la línea de comandos no tiene ninguna dependencia en el sistema operativo o la aplicación y simplemente necesita un entorno de nodo para ejecutar el colección.
=> Visite aquí para ver la serie exclusiva de tutoriales de capacitación para carteros
Lectura recomendada
- Cortar comando en Unix con ejemplos
- Sintaxis del comando Unix Cat, opciones con ejemplos
- Comando Ls en Unix con ejemplos
- ¿Cómo y cuándo utilizar los scripts de solicitud previa y posterior de Postman?
- Comando Grep en Unix con ejemplos simples
- Argumentos de la línea de comandos en C ++
- Comando de ordenación de Unix con sintaxis, opciones y ejemplos
- Argumentos de la línea de comandos en un script de shell de Unix con ejemplo