[OpenAPI 3.1] Phase 0: test harness for paired 3.0/3.1 fixtures

Abierto
#948 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 5 días

@Inf1mum ya está trabajando en esto.

Desde el 16/11/2026.

  • #961 de @Inf1mum — abierto

Evaluación

Dificultad
3/5
Tiempo estimado
3-5 días
Aptitud para principiantes
62/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
java, openapi, yaml
Área
api, testing

Línea de trabajo

Start by reading the parent plan #942 to see which later phase consumes each fixture, then look at how the existing tests under core/src/test/resources and the parameterized test classes in core/src/test/java are wired so the new harness matches. Create core/src/test/resources/oas31/<rule>/ with the four 3.0/3.1 old/new YAML pairs, beginning with the type-change rule, and add the parameterized test asserting 3.0→3.0, 3.1→3.1 and 3.0→3.1 agree plus the equivalence test. Done means the build is green with today's 3.1 failures disabled and each one listed in the issue with the phase that fixes it.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

OpenAPI 3.1.0 Support

Part of the OpenAPI 3.1 plan: #942 (Stage 1, Phase 0)

Goal

The test setup that every later phase uses.

Scope
  • Fixture layout: core/src/test/resources/oas31/<rule>/ with old-3.0.yaml, new-3.0.yaml, old-3.1.yaml, new-3.1.yaml
  • A parameterized test that checks 3.0→3.0, 3.1→3.1 and 3.0→3.1 give the same verdict
  • An equivalence test: the same spec written in 3.0 and in 3.1 gives no changes
  • First fixtures: type change, null allowed, exclusive bounds, array items, allOf, oneOf
  • One Swagger 2.0 fixture
  • Today's 3.1 failures are marked as known (disabled with a reference to the phase that fixes them), so the build stays green
Done when
  • Harness and first fixtures merged, build green
  • Known failures are listed in this issue, each linked to the phase that fixes it
Lenguaje dominante
Java
Estrellas
1.1k
Forks
191
Merge medio
4 d 23 h
PR fusionados (30 d)
1

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de OpenAPITools/openapi-diff

Todos los issues de OpenAPITools/openapi-diff

Issues similares

Más issues de Java

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.