docception

defmodule Mix.Tasks.Docception do
  use Mix.Task

  @moduledoc """
  Docception -- run doctests on arbitrary markdown files

  # Usage

      mix docception markdown-files

  """

  @shortdoc "Run doctests on arbitrary markdown files"

  def run(files) do
    # Compile first to ensure that all dependencies and parent project's module are available in
    # doctests.
    Mix.Task.run "compile"

    ExUnit.start(formatters: [])

    verbose? = true

    System.at_exit(fn
      0 -> :ok
      _ ->
        Process.sleep(1_000)
    end)

    Docception.run(files, verbose?)
  rescue
    e in Docception.Error ->
      Mix.raise("Docception: #{e.message}")
  end
end