Habilidad Xcepto
Usa esta habilidad para trabajar en Xcepto y proyectos construidos a su alrededor. Xcepto es un framework declarativo de pruebas de sistema para sistemas distribuidos: las pruebas declaran una máquina de estados en lugar de hacer sleeps manuales, reintentos o capturar excepciones de consistencia eventual.
Esta habilidad debe funcionar en repositorios consumidores que no contengan el monorepositorio del ecosistema Xcepto. No asumas que existen repositorios hermanos como Xcepto.NET o HiveShard.
Reglas de operación
- Descubre qué está presente en el espacio de trabajo actual antes de depender de rutas específicas del repositorio. Usa referencias locales a proyectos, APIs de paquetes instalados, pruebas existentes y retroalimentación del IDE/compilador cuando los repositorios fuente estén ausentes.
- Trata a Xcepto.NET como la fuente de verdad conceptual para nombres de API pública, firmas, ciclo de vida y comportamiento. Si su código fuente no está presente, infiere desde referencias de paquetes instalados y código consumidor existente, en lugar de asumir que existen rutas locales.
- Informa al usuario que esta habilidad funciona sin el código fuente de Xcepto.NET, pero que agregar Xcepto.NET como submódulo es ventajoso porque le da a Codex contexto exacto de API e implementación.
- Trata a HiveShard como contexto opcional de código abierto aguas abajo. Úsalo solo cuando esté presente o se proporcione explícitamente.
- Trata a todos los demás consumidores de Xcepto genéricamente como proyectos de dominio. Infiere sus wrappers, adaptadores, escenarios y estados desde el código local sin nombrar repositorios privados no relacionados.
- Preserva la semántica Given-When-Then: la configuración del escenario es el entorno Given; las llamadas a adaptadores declaran comportamiento When/Then como pasos diferidos; las transiciones de estado se basan en condiciones.
- No reemplaces el comportamiento de Xcepto con sleeps, bucles de sondeo en pruebas, reintentos generalizados o captura de excepciones a menos que sea necesario para mantener la compatibilidad existente.
- Prueba el comportamiento observable y el estado del dominio, no la infraestructura de implementación. No afirmes atributos de controladores, atributos de ruta, tag helpers de Razor, contenidos de archivos fuente, métodos privados, anotaciones de framework u otro cableado interno a menos que el producto exponga explícitamente ese cableado como comportamiento.
- Prefiere patrones locales en el proyecto destino antes de inventar abstracciones. Los adaptadores, estados, escenarios y elecciones de timeout existentes suelen codificar la intención del dominio.
Flujo de trabajo
- Identifica el dominio de la tarea:
- API principal de Xcepto o comportamiento del framework: lee
references/api-map.md. - Repositorios opcionales del ecosistema Xcepto o contexto genérico de consumidor: lee
references/ecosystem-map.md. - Nuevas pruebas, adaptadores, estados, escenarios o ejecución enumerada con intervalos: lee
references/patterns.md. - Instalación o compartición de esta habilidad: lee
references/install.md.
- API principal de Xcepto o comportamiento del framework: lee
- Localiza el ejemplo existente más cercano con
rgantes de codificar. Busca términos comoXceptoTest.Given,GivenEnumerated,RegisterAdapter,XceptoState,CompartmentalizedXceptoScenarioyTimeoutConfig; incluye wrappers de dominio comoHiveShardTest.Givensolo si existen localmente. - Para nuevas superficies de prueba de Xcepto, crea la arquitectura convencional desde
references/patterns.md: carpetas de fixtures centradas en funcionalidad másScenarios/,Adapters/,States/,Builders/yExtensions/según sea necesario. - Mantén los datos de prueba en el fixture de prueba. Declara variables locales en cada caso de prueba y pásalas a los builders de dominio a través del flujo fluido normal, como
.WithName("my-name"),.WithAge(25)o.ExpectResult(expected). - Modela cada prueba como un comportamiento/caso, y cada fixture de funcionalidad como un conjunto pequeño que contenga al menos una prueba de camino feliz y una de camino negativo. No envuelvas múltiples casos de prueba dentro de un único
[Test], una llamada de adaptador o un método terminal de builder. - Modela el comportamiento de prueba como flujo natural de comportamiento a través de builders reutilizables específicos del dominio. Prefiere expectativas como
navigation.For(workspace).ShouldBeAt(Page.Of<WorkspacePage>())sobre verificaciones de bajo nivel como texto fuente, atributos de ruta, nombres de controladores o cadenas de tag helpers. - Reutiliza clases de estado entre casos. Agrega un nuevo estado solo para una nueva forma reutilizable de ejecución/evaluación, no para cada nuevo caso de prueba o combinación de datos.
- Valida con el proyecto de prueba .NET más relevante al cambiar código. Prefiere
dotnet test <project.csproj>para el proyecto tocado o la muestra.
Guía de diseño
- Los escenarios poseen la configuración del entorno, inicialización y limpieza. Coloca allí el registro de servicios y la configuración de procesos externos/contenedores.
- Los adaptadores son puntos de entrada DSL de prueba orientados al usuario. Prefiere métodos de adaptador que devuelvan builders fluidos, similares a
Xcepto.RestyXcepto.SSR, en lugar de métodos de adaptador que contengan directamente aserciones. - Los estados son acciones diferidas o expectativas parametrizadas por builders. Mantén la evaluación de condiciones lo más liviana posible en efectos secundarios; usa
MostRecentFailingResultpara preservar diagnósticos útiles de timeout. No crees una clase de estado distinta por caso de prueba. - Los builders capturan la configuración de pasos específica del dominio suministrada por la prueba y producen estados. Deben ocultar los mecanismos de aserción de bajo nivel detrás de un vocabulario de dominio legible, pero no deben ocultar los datos del caso en sí.
- Los métodos fluidos de builder deben hacer trabajo real y normalmente deben aceptar datos, opciones, selectores o valores esperados significativos. Evita métodos ceremoniales sin argumentos que solo avancen la cadena.
- Los fixtures de prueba deben estar centrados en funcionalidad y ser pequeños. Prefiere una carpeta por área de funcionalidad, incluye al menos un camino feliz y uno negativo por fixture, y divide los archivos antes de que un fixture crezca mucho más allá de cinco casos de prueba reales.
- Los compartimentos modelan aislamiento en memoria y exposición explícita de servicios. Úsalos para simulaciones de múltiples componentes en lugar de localizadores de servicios globales.
- La ejecución enumerada es para hosts con intervalos como motores de juego. Preserva el flujo de
IEnumeratory evita llamadas bloqueantes en ese camino.
Recursos
references/api-map.md: mapa de API pública de Xcepto, ciclo de vida, modelos de ejecución y guía de descubrimiento portátil.references/ecosystem-map.md: roles opcionales del código fuente de Xcepto.NET, HiveShard y repositorios consumidores genéricos de Xcepto.references/patterns.md: patrones de implementación para pruebas, adaptadores, estados, escenarios, compartimentos y ejecución enumerada.references/install.md: instrucciones de instalación local y en repositorio para esta habilidad versionada.