[OpenAPI 3.1] Phase 1: 3.0→3.1 converter
維護者通常 5 天內回覆
還沒有人認領這個 Issue。
評估
研究方向
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.
由索引模型根據 Issue 內容生成。
描述
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
- 主要語言
- Java
- 星號
- 1.1k
- 分支
- 191
- 平均合併
- 4 天 23 小時
- 30 天內合併 PR
- 1
環境準備
- 提供 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
OpenAPITools/openapi-diff 的其他 Issue
-
enhancement
難度 2/5 1-3 小時 新手友好度 68/100
OpenAPITools/openapi-diff#506 ·
維護者通常 5 天內回覆
-
HtmlRender: Notes of Parameters shows always the new description可能已有人在做 @Inf1mum 於 6 天前認領。 未關閉good first issue help wanted
難度 2/5 1-3 小時 新手友好度 68/100
OpenAPITools/openapi-diff#364 ·
維護者通常 5 天內回覆
-
Render capabilities
難度 5/5 一週以上 新手友好度 20/100
OpenAPITools/openapi-diff#959 ·
維護者通常 5 天內回覆
-
Render capabilities
難度 5/5 一週以上 新手友好度 18/100
OpenAPITools/openapi-diff#958 ·
維護者通常 5 天內回覆
-
Render capabilities
難度 3/5 1-2 天 新手友好度 55/100
OpenAPITools/openapi-diff#957 ·
維護者通常 5 天內回覆
查看 OpenAPITools/openapi-diff 的全部 Issue
相似的 Issue
-
難度 2/5 1-3 小時 新手友好度 62/100
eclipse-tradista/tradista#371 ·
維護者通常 1 天內回覆
-
critical
難度 2/5 1-3 小時 新手友好度 68/100
mars-sim/mars-sim#2199 · 2 則留言 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 65/100
projeto-ong-amar/projeto-ong-amar-backend#26 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 72/100
primefaces/primefaces#15568 ·
維護者通常 1 天內回覆
-
崩溃日志只按 CRLF 分行未關閉
難度 2/5 1-3 小時 新手友好度 72/100
PCL-Community/PCL-CE#3872 ·
維護者通常 1 天內回覆