TeamWebQaUPT 1.1.0

Paquete para pruebas automatizadas de interfaces web

TeamWebQaUPT

TeamWebQaUPT es un paquete disenado para realizar pruebas automatizadas de interfaces web utilizando Selenium y pytest.
Proporciona herramientas reutilizables y faciles de usar para simplificar el proceso de pruebas.

Caracteristicas Principales

• Configuracion automatica de navegadores utilizando Selenium.
• Ejecucion de pruebas paralelas con pytest-xdist.
• Reportes de resultados en formato Allure.
• Funciones reutilizables para interacciones comunes como dropdowns, validaciones y navegacion.
• Soporte para pruebas en aplicaciones React, HTML estandar y otros frameworks modernos.

---

Instalacion

Requisitos Previos

1. Tener instalado Python 3.8 o superior.
2. Instalar pip (administrador de paquetes de Python).
3. Tener Selenium Grid configurado y en ejecucion (opcional para pruebas distribuidas).

Instalacion del Paquete

1. Instala el paquete desde PyPI:

   pip install TeamWebQaUPT
   

2. Verifica la instalacion:

   python -c "import TeamWebQaUPT; print('Instalacion exitosa')"
   

---

Ejecucion de Pruebas

Comando para Ejecutar Todas las Pruebas

El paquete incluye un script que ejecuta todas las pruebas automaticamente y genera un reporte Allure:

ejecutar_pruebas

Por defecto, el comando:

• Ejecuta pruebas en paralelo utilizando 3 procesos (-n 3).
• Genera resultados en el directorio allure-results.

Ver Resultados con Allure

Para visualizar los resultados en formato Allure:

1. Instala Allure:

   brew install allure  # En macOS
   sudo apt install allure  # En Linux
   

   Instrucciones de instalacion para Windows.

2. Visualizar los resultados generados:

   allure serve allure-results
   

---

Funciones Reutilizables

El paquete incluye una serie de funciones reutilizables en el modulo utils.py. Aqui hay una lista de las mas utiles:

1. Seleccionar Opcion en Dropdown

from TeamWebQaUPT.utils import select_dropdown_option

select_dropdown_option(driver, dropdown_selector="button[role='combobox']", option_text="Todas")

Descripcion:

• Selecciona una opcion en un combo box (dropdown) por texto visible.

Parametros:

• driver: Instancia de Selenium WebDriver.
• dropdown_selector: Selector CSS del dropdown.
• option_text: Texto visible de la opcion a seleccionar.

---

2. Validar Elementos en una Lista

from TeamWebQaUPT.utils import validate_elements_in_list

validate_elements_in_list(driver, "//h3[contains(text(), '{}')]", ["Elemento A", "Elemento B"])

Descripcion:

• Verifica que una lista de elementos este visible en la pagina.

Parametros:

• driver: Instancia de Selenium WebDriver.
• xpath_template: Plantilla de XPath para encontrar los elementos (usa {} para insertar el texto del elemento).
• items: Lista de textos a validar.

---

3. Navegar por Menus

from TeamWebQaUPT.utils import navigate_menu

navigate_menu(
    driver,
    menu_items={
        "Inicio": "http://161.132.50.153/",
        "Eventos": "http://161.132.50.153/eventos"
    },
    base_url="http://161.132.50.153/equipos"
)

Descripcion:

• Navega por un menu y valida la navegacion de URLs.

Parametros:

• driver: Instancia de Selenium WebDriver.
• menu_items: Diccionario con texto del menu como clave y URL esperada como valor.
• base_url: URL base para regresar despues de cada navegacion.

---

4. LinkLabels

from TeamWebQaUPT.utils import navigate_linklabel

navigate_linklabel(driver, "a[data-testid='link-label']", "http://161.132.50.153/nueva-pagina")

Descripcion:

• Redirige usando un LinkLabel y valida la URL resultante.

Parametros:

• driver: Instancia de Selenium WebDriver.
• link_selector: Selector CSS del LinkLabel.
• expected_url: URL esperada despues de hacer clic.

---

5. Procesar Tablas Gherkin

from TeamWebQaUPT.utils import process_table_data

table_data = [
    ["Columna1", "Columna2"],
    ["Valor1", "Valor2"]
]
processed_data = process_table_data(table_data)

Descripcion:

• Convierte datos de una tabla en un formato reutilizable.

Parametros:

• table_data: Lista de listas con los datos de la tabla (primera fila como encabezados).

Retorno:

• Una lista de diccionarios con claves basadas en la primera fila.

---

Pruebas Paralelas con Docker Compose

El paquete incluye un archivo docker-compose.yml para ejecutar pruebas en paralelo utilizando Selenium Grid.

Contenido del docker-compose.yml para las pruebas paralelas

version: "3"
services:
  selenium-hub:
    image: selenium/hub:4.25.0-20240922
    container_name: selenium-hub
    ports:
      - "4442:4442"
      - "4443:4443"
      - "4444:4444"
    networks:
      - selenium-grid

  chrome:
    image: selenium/node-chrome:4.25.0-20240922
    container_name: chrome
    shm_size: 2gb
    depends_on:
      - selenium-hub
    environment:
      - SE_EVENT_BUS_HOST=selenium-hub
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
      - SE_NODE_MAX_SESSIONS=3
    networks:
      - selenium-grid

  firefox:
    image: selenium/node-firefox:4.25.0-20240922
    container_name: firefox
    shm_size: 2gb
    depends_on:
      - selenium-hub
    environment:
      - SE_EVENT_BUS_HOST=selenium-hub
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
      - SE_NODE_MAX_SESSIONS=3
    networks:
      - selenium-grid

  edge:
    image: selenium/node-edge:4.25.0-20240922
    container_name: edge
    shm_size: 2gb
    depends_on:
      - selenium-hub
    environment:
      - SE_EVENT_BUS_HOST=selenium-hub
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
      - SE_NODE_MAX_SESSIONS=3
    networks:
      - selenium-grid

  chrome_video:
    image: selenium/video:ffmpeg-7.0.2-20240922
    container_name: chrome_video
    volumes:
      - ./videos:/videos
    depends_on:
      - chrome
    environment:
      - DISPLAY_CONTAINER_NAME=chrome
      - SE_NODE_GRID_URL=http://selenium-hub:4444
      - SE_VIDEO_FILE_NAME=auto
      - FFmpeg_Options=" -framerate 2 -video_size 1920x1080 -probesize 5000000 -analyzeduration 1000000 "
    networks:
      - selenium-grid

  edge_video:
    image: selenium/video:ffmpeg-7.0.2-20240922
    container_name: edge_video
    volumes:
      - ./videos:/videos
    depends_on:
      - edge
    environment:
      - DISPLAY_CONTAINER_NAME=edge
      - SE_NODE_GRID_URL=http://selenium-hub:4444
      - SE_VIDEO_FILE_NAME=auto
      - FFmpeg_Options=" -framerate 2 -video_size 1920x1080 -probesize 5000000 -analyzeduration 1000000 "
    networks:
      - selenium-grid

  firefox_video:
    image: selenium/video:ffmpeg-7.0.2-20240922
    container_name: firefox_video
    volumes:
      - ./videos:/videos
    depends_on:
      - firefox
    environment:
      - DISPLAY_CONTAINER_NAME=firefox
      - SE_NODE_GRID_URL=http://selenium-hub:4444
      - SE_VIDEO_FILE_NAME=auto
      - FFmpeg_Options=" -framerate 2 -video_size 1920x1080 -probesize 5000000 -analyzeduration 1000000 "
    networks:
      - selenium-grid

networks:
  selenium-grid:
    driver: bridge

Como Usarlo

1. Levanta el entorno Selenium Grid:

   docker-compose up -d
   

2. Ejecuta las pruebas en paralelo:

   pytest -n 3 --alluredir=allure-results
   

---

Contribuciones

Si deseas contribuir al desarrollo de TeamWebQaUPT, sigue estos pasos:

1. Clona el repositorio:

   git clone https://github.com/tu_usuario/TeamWebQaUPT
   cd TeamWebQaUPT
   

2. Instala las dependencias para desarrollo:

   pip install -r requirements.txt
   

3. Crea tus cambios y envia un pull request.

---

Licencia

Este proyecto esta licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para mas detalles.