Openapi.Definition (Openapi v0.1.0)

Copy Markdown View Source

Summary

Functions

Deep merges two OpenAPI/Swagger definition maps.

Converts an OpenAPI/Swagger paths definition into a list of Phoenix-compatible routes.

Functions

merge(def1, def2)

Deep merges two OpenAPI/Swagger definition maps.

Rules:

  • paths are merged per path + method
  • components are deeply merged
  • tags are concatenated (deduped by name)
  • servers are concatenated (deduped by url)
  • everything else: right side overrides left

phoenix_routes(definition)

Converts an OpenAPI/Swagger paths definition into a list of Phoenix-compatible routes.

This function extracts HTTP operations from the OpenAPI document and transforms them into Openapi.Route structs that can later be used to generate Phoenix router entries or dispatch metadata.