lib/image/options/blur.ex

defmodule Image.Options.Blur do
  @moduledoc """
  Options and option validation for `Image.blur/2`.

  """

  @typedoc """
  Options applicable to Image.blur/2

  """
  @type blur_options ::
          [
            {:sigma, float()}
            | {:min_amplitude, float()}
          ]
          | map()

  @default_blur_sigma 5

  @doc false
  def default_blur_sigma do
    @default_blur_sigma
  end

  @doc """
  Validate the options for `Image.blur/2`.

  See `t:Image.Options.Blur.blur_options/0`.

  """
  def validate_options(options) when is_list(options) do
    options = Keyword.merge(default_options(), options)

    case Enum.reduce_while(options, options, &validate_option(&1, &2)) do
      {:error, value} ->
        {:error, value}

      options ->
        {:ok, Map.new(options)}
    end
  end

  def validate_options(%{} = options) do
    {:ok, options}
  end

  defp validate_option({:sigma, sigma}, options) when is_number(sigma) and sigma > 0 do
    {:cont, options}
  end

  defp validate_option({:min_amplitude, min_amplitude}, options) when is_float(min_amplitude) do
    options = Keyword.put(options, :min_amplitude, min_amplitude)

    {:cont, options}
  end

  defp validate_option(option, _options) do
    {:halt, {:error, invalid_option(option)}}
  end

  defp invalid_option(option) do
    "Invalid option or option value: #{inspect(option)}"
  end

  defp default_options do
    [
      sigma: @default_blur_sigma,
      min_amplitude: 0.2
    ]
  end
end