Tipos de simulación

Todo lo que hay en esta documentación corre el mismo motor de mocks; lo que cambia es dónde vive una simulación y quién la despliega. Hay cuatro formas de correr una, y no son excluyentes: los equipos suelen desarrollar contra una simulación alojada, correr una copia portable en CI, y mantener un servicio codegen para la lógica propia.

Simulaciones de app

La opción por defecto. Se arman y configuran enteras en el navegador: agregas specs OpenAPI y endpoints estáticos, haces clic en Desplegar, y la simulación responde en su URL. Todo lo que hay en las secciones Crear, Configurar, Replays y Observar de estos docs funciona sobre una simulación de app.

Elígela cuando quieras un mock alojado al que llegue todo tu equipo, sin nada que instalar y con cada cambio hecho en la app.

Consulta Simulaciones de app.

Simulaciones desde GitHub

La misma simulación alojada, pero el repositorio es la fuente de verdad: las specs, los endpoints estáticos y la configuración viven como archivos, y un push los despliega con la GitHub Action, con una URL por rama y por pull request. La Action acepta las dos formas de proyecto: una carpeta portable servida tal cual, o un proyecto codegen construido desde el código. La app muestra estas simulaciones en solo lectura; cambiar una es cambiar el repo.

Elígela cuando los mocks deban revisarse como código y cada rama necesite su propio entorno.

Consulta Simulaciones desde GitHub.

Simulaciones portables

Una carpeta con specs, archivos estáticos y configuración que el motor sirve tal cual, donde sea que corra: en local con la CLI, en Docker, dentro de CI, o alojada con el modo portable de la GitHub Action. La estructura es la misma que empaquetan las simulaciones de app al desplegar, así que los formatos son intercambiables.

Elígela cuando el mock deba vivir como archivos planos: trabajo sin conexión, pipelines de CI, un repo que tu equipo revisa, o cualquier cosa que no pueda salir de tu red.

Consulta Simulaciones portables.

Simulaciones codegen

Un servidor Go generado: el motor convierte tu spec en handlers tipados que puedes abrir y editar, para que las respuestas lleven lógica real, estado y cálculos donde generar no alcanza. La spec nunca sale de tu repositorio, lo que además la libera de cualquier límite de subida.

Elígela cuando el mock necesite comportamiento que ninguna configuración expresa.

Consulta Simulaciones codegen.

Y la clase lista para usar

Los backends de pago e identidad también son simulaciones, corriendo el mismo motor con el comportamiento del proveedor ya construido: escenarios, fallas y datos realistas desde el primer momento. Tienen su propia sección.

Consulta Backends resilientes.

Cómo elegir

Elijas lo que elijas, el motor es el mismo: una spec genera las respuestas, los endpoints estáticos fijan las exactas, y los contextos dan forma a los datos. Pasar de un tipo a otro más adelante es empaquetar los mismos archivos de otra forma, nunca empezar de cero.