senfgurke

Senfgurke

Senfgurke es un marco de prueba basado en ejemplos para VBA. ¿Qué quiere decir esto? Con Senfgurke puedes convertir ejemplos dados en lenguaje natural en pruebas automatizadas ejecutadas por VBA (Visual Basic para Aplicaciones).

• Introducción
• Configuración
• Diseño funcional
• Arquitectura

¡TENER CUIDADO! Este es un trabajo en progreso. ¡Las versiones futuras podrían romper el código de automatización de pruebas de versiones anteriores!

Introducción

Imagina que alguien te pide que escribas una nueva función de suma "especial" para Excel que agregue el valor de 1 al resultado, brindándote este ejemplo:

 Example: add +1 to sum
  Given a is 2
    And b is 3
   When sum+1 is applied to a and b
   Then the result is 6

Ahora puede agregar este ejemplo a una función y guardar todo en el archivo llamado 'sum_plus_one.feature' en un directorio llamado 'features'. El directorio debe estar en la misma ubicación que el archivo de Office que contiene el código VBA.

Si ejecuta Senfgurke la primera vez, le sugerirá que agregue una nueva función como esta:

 Public Sub Given_a_is_INT_C722764574FB(step_parameters As Collection)
    'Given a is 2

End Sub

No se confunda con la parte C722764574FB del nombre de la función. Este valor hash ayuda a Senfgurke a hacer coincidir la función con el paso original del ejemplo. Ahora depende de usted completar la función con código, para que pueda probar su nueva función y asegurarse de que suma+1 devuelva los resultados correctos.

Cuando haya repetido esto para cada paso del ejemplo y ejecute Senfgurke, es posible que reciba esto en la consola:

 Feature: sum plus one


  Rule: add one to sum results

    Example: add +1 to sum
     OK       Given a is 2
     OK       And b is 3
     OK       When sum+1 is applied to a and b
     OK       Then the result is 6

De esta manera Senfgurke le dice si su código fue exitoso o causó algún error.

Configuración

Senfgurke se proporciona como un complemento específico de la aplicación. De esta manera puede separar fácilmente la aplicación bajo prueba y el marco de prueba de Senfgurke. Para iniciar una nueva aplicación VBA, siga estos pasos:

1. Active el complemento Senfgurke para su aplicación
2. Cree un nuevo documento para su código (por ejemplo: un nuevo archivo xlm para Excel)
3. Importe el módulo TRun desde step_definitions/TRun.bas a su aplicación
4. Agregue una referencia al complemento Senfgurke para su aplicación en el IDE de VBA
5. Cree un nuevo directorio llamado "características" en el mismo directorio de su aplicación (el documento que contiene su código VBA)
6. Cree su primer archivo de características de Gherkin en características (agregue al menos 1 ejemplo)
7. Ejecute TRun.test desde la ventana Inmediato en su IDE de VBA
8. Agregue una nueva clase "Step_" a su aplicación
9. Copie el código sugerido para las funciones de paso desde la ventana Inmediato a su clase de paso
10. Registre su clase Step extendiendo la propiedad StepImplementations en el módulo TRun

Diseño funcional

El siguiente mapa de eventos explicará lo que sucederá cuando le pida a Senfgurke que ejecute sus funciones.

ejecutar una prueba

Las pruebas normalmente se inician desde la ventana de la consola VBA. De esta manera, puede agregar etiquetas o filtros (para nombres de archivos) para restringir la ejecución de la prueba a etiquetas o archivos de características específicos.

Cargar archivos de características

Lo primero que hará Senfgurke es buscar archivos de características y cargarlos en la memoria para su posterior procesamiento.

Analizar características

Tener todas las funciones en la memoria facilita que Senfgurke traduzca (analice) el lenguaje Gherkin en instrucciones detalladas para su posterior ejecución. Por ejemplo, los ejemplos sin etiquetas coincidentes establecidas al inicio de la prueba podrían ignorarse para una ejecución posterior o se agregarán pasos en segundo plano de una característica a cada ejemplo (también conocido como escenario) en esta característica.

Ejecutar funciones

Obviamente, el siguiente paso consiste en ejecutar todas las instrucciones de ejecución detalladas del paso anterior. Esto también incluirá devolver todos los resultados de la ejecución.

Informar resultados

Paralelamente a la ejecución de las funciones mencionadas anteriormente, los resultados se informarán en diferentes formatos. El formato predeterminado es detallado que escribe las funciones de Gherkin en la ventana de la consola VBA simplemente agregando el resultado de la ejecución a cada paso de los ejemplos.

Reportar estadísticas

Al final de cada ejecución de prueba, Senfgurke agregará algunas estadísticas, por ejemplo, la duración y el número de pasos de ejemplo ejecutados.

una cosa mas

Para obtener documentación más detallada, consulte los archivos de funciones de Senfgurke comenzando con el índice generado por el indexador de funciones.

Arquitectura

El diagrama de bloques FMC muestra que la configuración típica consta de tres capas:

1. El sistema operativo proporcionará el almacenamiento de los archivos de funciones.
2. El complemento Senfgurke incluye toda la funcionalidad para hacer coincidir pasos de ejemplo (también conocidos como escenarios) de archivos de características con funciones de pasos coincidentes.
3. La capa superior está representada por la aplicación bajo prueba (normalmente un documento de Office que contiene código VBA).

Decisiones generales

Consulte el registro de decisiones de arquitectura para conocer algunas decisiones generales.

Objetivos

Separaciones de interés

La arquitectura en capas garantizará que la funcionalidad proporcionada por Senfgurke esté separada de la lógica de la aplicación.

por confirmar