testproject python sdk tutorial
Tutorial de TestProject Python SDK: Potencie sus pruebas existentes basadas en Selenium y AppiumEste tutorial lo ayudará a comenzar con TestProject Python SDK. Aprenda a instalar, configurar y utilizar las funciones más poderosas del SDK:
Selenium y Appium han estado entre los marcos de prueba de código abierto más populares para navegadores de escritorio y pruebas basadas en dispositivos móviles durante años.
los TestProject Python SDK se basa en estas herramientas y le brindan el poder de la plataforma TestProject, brindándole hermosos informes HTML y PDF en sus plataformas de informes, detección automática del navegador, configuración de controladores y mucho más.
Y lo mejor es que usar la plataforma TestProject y el SDK es totalmente gratis para siempre. El SDK también es de código abierto, por lo que si desea contribuir al proyecto, ¡puede hacerlo!
Lo que vas a aprender:
¿Qué es TestProject Python SDK?
En este tutorial, verá cómo comenzar con TestProject Python SDK, cómo aprovechar la plataforma TestProject con sus pruebas existentes basadas en Selenium y Appium, y cómo usar algunas de las funciones más poderosas del SDK.
Nota : ¿Están sus pruebas escritas en un lenguaje que no sea Python? No se preocupe, TestProject también ofrece SDK para Java y C #, y próximamente habrá más lenguajes.
Instalacion y configuracion
=> Visite esta página para registrarse gratis en TestProjectPython SDK está disponible en PyPI , el índice del paquete de Python. Aquí, asumimos que tiene una instalación de Python en funcionamiento, todo lo que necesita hacer es instalar el SDK y para eso, necesita ejecuta el siguiente comando:
|_+_|Esto instalará el SDK y sus dependencias requeridas, incluidos Selenium y el cliente Python Appium.
Antes de que podamos comenzar a usar el SDK, debemos hacer dos cosas más.
# 1) Instale y configure TestProject Agent en su máquina:
TestProject Agent es responsable de la instalación y configuración del controlador del navegador, así como de enviar informes generados por el SDK a la plataforma TestProject.
Después de haber creado una cuenta en el Proyecto de prueba plataforma (nuevamente, esto es gratis), puede descargar su Agente.
Después de la descarga, deberá instalarlo e iniciarlo. De forma predeterminada, el agente se ejecuta en http: // localhost: 8585. Si desea ejecutar el Agente en un puerto diferente, o incluso en una máquina completamente diferente, no hay problema. En este caso, todo lo que necesita hacer es especificar la dirección correcta del Agente en una variable de entorno TP_AGENT_URL para que el SDK sepa dónde se está ejecutando.
# 2) Obtenga y configure un token de desarrollador:
Para comunicarse con el Agente, también necesitará un token de desarrollador. Después de instalar el agente, puede obtener su token de desarrollo del sitio de la plataforma TestProject como se muestra en la imagen a continuación.
Especifique su token de desarrollador en una variable de entorno TP_DEV_TOKEN para que el SDK lo sepa. Alternativamente, puede especificarlo como un argumento cuando crea una nueva sesión de controlador, como veremos esto en un momento.
Una vez que haya descargado el SDK, instalado, configurado e iniciado el Agente, obtenido y configurado su token de desarrollador, estará listo para comenzar.
Creación de nuestra primera prueba de selenio basada en proyectos de prueba
Supongamos que tenemos una prueba basada en selenio que navega a la aplicación web de demostración TestProject. Proporciona credenciales de inicio de sesión y comprueba que nos saludan para indicar que la acción de inicio de sesión se ha completado correctamente. Supongamos también que usamos el marco de pruebas unitarias de Pytest para ejecutar esta prueba y ejecutar las afirmaciones.
Una prueba de este tipo podría verse así:
|_+_|El ejemplo anterior usa Chrome como navegador. Además de Chrome, el SDK también es compatible con los siguientes navegadores de escritorio:
- Firefox
- Borde
- explorador de Internet
- Safari
Para este ejemplo, no hemos utilizado ninguno de los patrones de abstracción que son comunes en las pruebas basadas en Selenium, como los Objetos de página, pero si los usa, no hay ningún problema. De hecho, lo recomendamos, ya que esto crea una clara separación entre su flujo de prueba (acciones, datos de prueba) y los detalles de implementación de sus páginas web (localizadores de elementos).
Después de completar todos los pasos de instalación y configuración que se muestran arriba, todo lo que necesita hacer para convertir esta prueba en una prueba impulsada por TestProject es reemplazar la declaración de importación como se explica a continuación.
|_+_|Relájate con este:
|_+_|¡Eso es! Una vez que ejecute la prueba ahora, el SDK solicitará una instancia de controlador del TestProject Agent y la usará para ejecutar la prueba. También enviará instrucciones de informes a la plataforma TestProject, que luego se utilizan para crear informes HTML. ¡Echemos un vistazo a esos!
Inspección de informes en la plataforma TestProject
Al ir al Proyecto de prueba y seleccionar las opciones 'Informes' del menú, puede ver que se ha creado un nuevo informe para la prueba que acabamos de ejecutar. Consulte la imagen a continuación.
vr que funciona con xbox one
Como puede ver, el SDK ha inferido automáticamente un nombre de proyecto ( software_testing_help ), un nombre de trabajo ( ejemplos ) y un nombre de prueba ( test_login_to_testproject_example_app ) y los usó al crear el informe. Esto es compatible tanto con Pytest como Unittest, así como con las pruebas que no se ejecutan con un marco de prueba de unidad dedicado.
Veremos cómo especificar los nombres personalizados de proyectos, trabajos y pruebas, así como otras opciones de informes útiles en la siguiente sección.
Todos los comandos del conductor que se han ejecutado durante la prueba se agregan automáticamente al informe, junto con su resultado. TestProject también genera descripciones generales y paneles de control listos para usar.
Opciones de personalización de informes con TestProject
Si bien TestProject genera informes completos y utilizables listos para usar, hay varias formas en que puede personalizarlos para que se ajusten aún mejor a sus requisitos de información.
Como hemos visto en el ejemplo anterior, TestProject puede inferir automáticamente nombres de proyectos, trabajos y pruebas para los marcos de pruebas unitarios de Python más populares. Sin embargo, si desea utilizar nombres personalizados en sus informes, también puede hacerlo de dos formas diferentes.
# 1) Usando un decorador
El TestProject SDK también incluye un @reporte decorador que puede usar para decorar sus métodos de prueba y que puede usar para especifique los nombres personalizados de proyectos, trabajos y pruebas como se muestra a continuación:
|_+_|Cuando ejecutamos este método de prueba decorado e inspeccionamos los informes, podemos ver que los nombres especificados se han utilizado en el informe generado, en lugar de los inferidos automáticamente.
# 2) Especificar nombres de proyectos y trabajos en el constructor del controlador e informar una prueba manualmente:
Los nombres de proyectos y trabajos también se pueden anular especificándolos en el constructor del objeto controlador. Esto puede hacerse de la siguiente manera:
|_+_|Si desea anular el nombre de prueba inferido automáticamente, puede informar una prueba manualmente al final de la prueba, así:
|_+_|Si opta por utilizar la opción de informe manual, debe desactivar el informe automático de pruebas (que está habilitado de forma predeterminada) para asegurarse de que las pruebas no se informen dos veces, lo que dañaría su informe y sus paneles.
Puede deshabilitar los informes automáticos con el siguiente comando:
|_+_|Esto hará que el informe se vea exactamente igual que la última captura de pantalla anterior.
# 3) Desactivación de informes de comandos del conductor
Si no desea que su informe contenga todos los comandos de controlador individuales que se ejecutaron durante la prueba, puede deshabilitar el informe automático de ellos de esta manera:
|_+_|También puede volver a habilitar los informes de comandos del controlador más adelante en sus pruebas llamando al mismo método nuevamente pero con el argumento disabled = False.
Si aún desea informar algunos pasos intermedios durante su prueba, también puede hacerlo:
|_+_|Como puede ver, incluso puede agregar capturas de pantalla a los pasos de su informe personalizado. Estos se integrarán en el informe HTML en la plataforma TestProject automáticamente.
TestProject SDK ofrece más opciones para personalizar aún más sus informes. Consulte la documentación oficial en el sitio web de TestProject, GitHub o PyPI para obtener una descripción general completa.
Ejecución de pruebas basadas en Appium mediante TestProject
Además de las pruebas basadas en Selenium, TestProject SDK también puede ejecutar pruebas en dispositivos móviles utilizando Appium. Considere este ejemplo, que se ejecuta en una aplicación nativa de Android en un emulador:
|_+_|Para usar el poder de la plataforma TestProject aquí, nuevamente, solo necesitamos cambiar
|_+_|A:
|_+_|Y estamos listos para irnos. TestProject Agent también actúa como el servidor de Appium, por lo que ya no es necesario ejecutarlo usted mismo en la máquina que está ejecutando sus pruebas.
Todas las funciones de informes descritas anteriormente también están disponibles para pruebas basadas en Appium.
SDK admite la ejecución de pruebas móviles:
- Tanto para Android como para iOS.
- Tanto en emuladores como en dispositivos reales.
- Tanto en aplicaciones nativas como en navegadores móviles
Se pueden encontrar ejemplos de todos estos en el repositorio de código SDK en GitHub.
Conclusión
Como ha visto en este tutorial, TestProject Python SDK puede ayudarlo a potenciar sus pruebas existentes basadas en Selenium y Appium al eliminar las tareas de configurar los controladores de su navegador y el servidor Appium, y genera excelentes informes y paneles HTML para usted en la plataforma TestProject.
Lo mejor de todo es que TestProject Python SDK es absolutamente gratuito.
=> Dirígete a TestProject para probarlo usted mismo !
Biografía del autor: Bas Dijkstra
El autor enseña a empresas de todo el mundo cómo mejorar sus esfuerzos de prueba mediante la automatización de pruebas. Es un formador, consultor y desarrollador independiente que vive en los Países Bajos. En su tiempo libre, le gusta pasear en bicicleta, salir a correr o leer un buen libro.
Lectura recomendada
- Tutorial de revisión práctica de la herramienta de automatización de pruebas TestProject
- Proceso de introducción e instalación de Python
- Cree pruebas de Appium para una aplicación de Android
- Tutorial de Python para principiantes (entrenamiento práctico de Python GRATIS)
- Ejecución de sus pruebas de Appium en paralelo con Appium Studio para Eclipse
- Creación de pruebas de epochs con epochs Studio para Eclipse
- Cómo ejecutar la ejecución a gran escala de pruebas de Appium en paralelo
- Intégrelo en su IDE para ejecutar sus pruebas de Appium