[OpenAPI 3.1] Phase 1: 3.0→3.1 converter
Les mainteneurs répondent en général sous 5 jours
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 38/100
Piste de recherche
Start from the plan in #942, then look at how org.openapitools.openapidiff.core currently parses specs and where swagger-core's mapper and JsonSchema are already used. The new normalize package must walk components, parameters, headers, bodies, callbacks and nested schemas, applying the listed rules on a deep copy. Compare converted 3.0 output against natively parsed 3.1 for the paired fixtures under the test resources as serialized JSON; also add the Swagger 2.0 fixture and a test asserting the input objects are unchanged.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Part of the OpenAPI 3.1 plan: #942 (Stage 1, Phase 1)
Goal
A converter that turns Swagger 2.0 / OpenAPI 3.0 objects into the 3.1 form. Not wired in yet.
Scope
- New package
org.openapitools.openapidiff.core.normalize, called once per spec - Walks every schema: components, parameters, headers, request/response bodies, callbacks, and nested (properties, items, additionalProperties, allOf/anyOf/oneOf, not)
- Rules:
type→types;nullable: true→"null"intypes(not when there is notype); booleanexclusiveMinimum/Maximum→ numeric;example→examples; typed classes →JsonSchema - Works on a copy (JSON round-trip with swagger-core's mapper), so the input objects are never modified
Done when
- Converted 3.0 == natively parsed 3.1 (compared as serialized JSON) for all paired fixtures
- Swagger 2.0 fixture converts correctly
- Copy test: input objects are unchanged after conversion
- Langage dominant
- Java
- Étoiles
- 1.1k
- Forks
- 191
- Merge moyen
- 4 j 23 h
- PR mergées (30 j)
- 1
Préparer son environnement
- Fournit un Dockerfile ou un fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de OpenAPITools/openapi-diff
-
enhancement
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
OpenAPITools/openapi-diff#506 ·
Les mainteneurs répondent en général sous 5 jours
-
HtmlRender: Notes of Parameters shows always the new descriptionPeut-être pris @Inf1mum l’a pris il y a 6 jours. Ouvertegood first issue help wanted
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
OpenAPITools/openapi-diff#364 ·
Les mainteneurs répondent en général sous 5 jours
-
Render capabilities
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 20/100
OpenAPITools/openapi-diff#959 ·
Les mainteneurs répondent en général sous 5 jours
-
Render capabilities
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 18/100
OpenAPITools/openapi-diff#958 ·
Les mainteneurs répondent en général sous 5 jours
-
Render capabilities
Difficulté 3/5 1-2 jours Accessibilité débutants 55/100
OpenAPITools/openapi-diff#957 ·
Les mainteneurs répondent en général sous 5 jours
Toutes les issues de OpenAPITools/openapi-diff
Issues similaires
-
Difficulté 2/5 1-3 heures Accessibilité débutants 62/100
eclipse-tradista/tradista#371 ·
Les mainteneurs répondent en général sous 1 jour
-
Failed to start Rescue missionOuvertecritical
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
mars-sim/mars-sim#2199 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
[BUG-02] Endpoints /assistente/relatorio/*/preview retornam 404 ("Ver na tela" dos relatórios)Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
projeto-ong-amar/projeto-ong-amar-backend#26 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
primefaces/primefaces#15568 ·
Les mainteneurs répondent en général sous 1 jour
-
崩溃日志只按 CRLF 分行Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
PCL-Community/PCL-CE#3872 ·
Les mainteneurs répondent en général sous 1 jour