defmodule Quenya.Plug.SwaggerPlug do
@moduledoc """
Plug for swagger static UI. You must use Plug.Static to serve static files in priv/swagger
Example:
# in your router file
# before anything
plug Plug.static, at: "/swagger/main.yml", from: {:app, "priv/spec/main.yml"}
plug Plug.static, at: "/public", from: {:quenya, "priv/swagger"}
# after dispatch
get "/swagger", to: Quenya.Plug.SwaggerPlug, init_opts: [spec: "/swagger/main.json"]
get "/swagger/main.json", to: Quenya.Plug.SwaggerPlug, init_opts: [app: :todo]
"""
import Plug.Conn
@behaviour Plug
@template """
Swagger UI
"""
@spec init(keyword()) :: keyword()
def init(opts) do
opts
end
@spec call(Plug.Conn.t(), keyword()) :: Plug.Conn.t()
def call(conn, opts) do
case String.ends_with?(conn.request_path, "main.json") do
true ->
filename = Path.join(Application.app_dir(opts[:app]), "priv/spec/main.yml.json")
body = File.read!(filename)
etag = :crypto.hash(:md5, body) |> Base.encode16(case: :lower)
conn
|> put_resp_header("etag", etag)
|> send_resp(200, body)
_ ->
spec = opts[:spec]
body = EEx.eval_string(@template, spec: spec)
send_resp(conn, 200, body)
end
end
end