简体   繁体   English

是否可以通过稍加修改从另一个规范生成 Openapi 规范文件?

[英]Is it possible to generate Openapi spec file from the another spec with slight modifications?

Suppose I have Openapi specification file (api-docs.yml).假设我有 Openapi 规范文件 (api-docs.yml)。 I need to create a copy of it with:我需要创建它的副本:

  1. different servers block不同的servers
  2. filtered paths by tag (with removing unnecessary schemas)按标签过滤paths (删除不必要的模式)

Do any solutions exist to make such things, or it's only possible to write your own parser?是否存在任何解决方案来制作此类东西,或者只能编写自己的解析器?

I'm using Java so Java-based solutions (maven plugins etc.) are preferred.我正在使用 Java,因此首选基于 Java 的解决方案(maven 插件等)。

Do any solutions exist to make such things, or it's only possible to write your own parser?是否存在任何解决方案来制作此类东西,或者只能编写自己的解析器?

There are OpenAPI parsers for various programming languages.适用于各种编程语言的OpenAPI 解析器 In Java, you can use Swagger Parser - use version 2.x for OpenAPI 3.0.x or v. 1.x for OpenAPI 2.0 ( swagger: '2.0' ).在 Java 中,您可以使用Swagger Parser - 对于 OpenAPI 3.0.x 使用 2.x 版或对于 OpenAPI 2.0 使用 v. 1.x ( swagger: '2.0' )。

I think openapi-filter can filter content by tags, among other things.我认为openapi-filter可以通过标签过滤内容等。

You can also try using a YAML parser/processor such as yq .您还可以尝试使用 YAML 解析器/处理器,例如yq

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM