[OpenAPI 3.1] Phase 1: 3.0→3.1 converter
Mantenedores costumam responder em até 5 dias
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Facilidade para iniciantes
- 38/100
Direção de pesquisa
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.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- Java
- Estrelas
- 1.1k
- Forks
- 191
- Merge médio
- 4d 23h
- PRs com merge (30d)
- 1
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de OpenAPITools/openapi-diff
-
enhancement
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
OpenAPITools/openapi-diff#506 ·
Mantenedores costumam responder em até 5 dias
-
HtmlRender: Notes of Parameters shows always the new descriptionTalvez já em andamento @Inf1mum assumiu há 6 dias. Abertagood first issue help wanted
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
OpenAPITools/openapi-diff#364 ·
Mantenedores costumam responder em até 5 dias
-
Render capabilities
Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 20/100
OpenAPITools/openapi-diff#959 ·
Mantenedores costumam responder em até 5 dias
-
Render capabilities
Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 18/100
OpenAPITools/openapi-diff#958 ·
Mantenedores costumam responder em até 5 dias
-
Render capabilities
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 55/100
OpenAPITools/openapi-diff#957 ·
Mantenedores costumam responder em até 5 dias
Todas as issues de OpenAPITools/openapi-diff
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100
eclipse-tradista/tradista#371 ·
Mantenedores costumam responder em até 1 dia
-
critical
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
mars-sim/mars-sim#2199 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
[BUG-02] Endpoints /assistente/relatorio/*/preview retornam 404 ("Ver na tela" dos relatórios)Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
projeto-ong-amar/projeto-ong-amar-backend#26 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
primefaces/primefaces#15568 ·
Mantenedores costumam responder em até 1 dia
-
崩溃日志只按 CRLF 分行Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
PCL-Community/PCL-CE#3872 ·
Mantenedores costumam responder em até 1 dia