blue_bird

defmodule Mix.Tasks.Bird.Gen.Docs do
  @moduledoc """
  Generates HTML API Docs from api.apib using aglio.

  This task uses [Aglio](https://github.com/danielgtaylor/aglio) to render the
  file. To install, run `npm install aglio -g`.
  """
  use Mix.Task

  alias Mix.Project

  @doc false
  def run(_args) do
    if System.find_executable("aglio") == nil do
      raise "Install Aglio to convert Blueprint API to HTML: " <>
            "\"npm install aglio -g\""
    end

    docs_path = Application.get_env(:blue_bird, :docs_path, "docs")
    docs_theme = Application.get_env(:blue_bird, :docs_theme, "triple")

    path = Project.build_path()
    |> String.split("_build")
    |> Enum.at(0)
    |> Path.join(docs_path)

    System.cmd(
      "aglio",
      [
        "--theme-template",
        docs_theme,
        "-i",
        Path.join(path, "api.apib"),
        "-o",
        Path.join(path, "index.html")
      ]
    )
  end
end