{"repo":"dolmen-go/openapi-preprocessor","free":true,"listed":false,"github":"https://github.com/dolmen-go/openapi-preprocessor","clone":"git clone https://github.com/dolmen-go/openapi-preprocessor.git","description":"An authoring tool for OpenAPI specifications","language":"Go","stars":39,"topics":["openapi","swagger","openapi-spec","openapi3","oasv3"],"license":"Apache-2.0","category":"api-integrations-sdks","readme_excerpt":"openapi-preprocessor openapi-preprocessor is an processing tool that gives flexibility to API documentation authors for writing OpenAPI 2.0/3.x specifications. Uses Cases - Author your OpenAPI spec in YAML but publish as JSON. - Split your OpenAPI spec source in multiple files for authoring, but publish a single file. - Build multiple specs from shared parts. - Merge spec generated from source code with your additional content created by hand. - Use advanced inlining ( $inline , $merge ) to remove duplication (source of inconsistencies). - Use advanced inlining ( $inline , $merge ) to produce complex schemas that share subset of properties. - Derivate a spec to build a new spec with altered servers settings for localhost/staging/preprod environments. - Derivate a spec for interoperability with processing tools (ex: apply a patch for downgrading the OpenAPI version for a code generation tool that doesn't support the latest standard). - Derivate a spec from a partner to fix interoperability issues: enable the maintenance of a set of patches to apply to the public spec releases before using them internally. - Submit yours... Features - Every valid OpenAPI 2.0/3.x specification is a valid input (so you can easily start refactoring gradually from an existing spec) - Allows to build a spec from multiple files; produces a single output file - YAML or JSON input - Produces an OpenAPI with maximum compatibility with consumming tools: - simplifies complex parts of the spec not supporte","default_branch":null,"files":null,"tree":[],"storefront":"/r/dolmen-go","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/dolmen-go/openapi-preprocessor/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}