Packages

A lightweight OpenAPI-first routing, validation and documentation layer

Current section

Files

Jump to
openapi lib openapi.ex
Raw

lib/openapi.ex

defmodule Openapi do
# This can change at any time and only returns a string so just ignore it.
# coveralls-ignore-start
@doc """
Returns the bundled Swagger UI version used by the OpenAPI integration.
This value corresponds to the static Swagger UI assets shipped with the library
and is used for serving the documentation frontend.
"""
def swagger_ui_version, do: "5.32.0"
# coveralls-ignore-stop
def read_file!(path) do
path
|> Path.extname()
|> normalize_ext()
|> dispatch!(path)
end
defp normalize_ext("." <> ext), do: ext
defp normalize_ext(ext), do: ext
defp dispatch!(ext, path) when ext in ["yaml", "yml"], do: Openapi.Loader.Yaml.read_file(path)
defp dispatch!("json", path), do: Openapi.Loader.Json.read_file(path)
defp dispatch!(_ext, path), do: raise(Openapi.Error, "Unsupported file extention: #{path}")
def get_definition(server, default \\ %{}) do
:persistent_term.get({:openapi, :specs, server}, default)
end
def save_definition(server, definition) do
merged_definition =
server
|> get_definition()
|> Openapi.Definition.merge(definition)
:persistent_term.put({:openapi, :specs, server}, merged_definition)
end
end