Passing in options: Maps vs. Keyword lists

function_options.ex

# https://elixirforum.com/t/passing-in-options-maps-vs-keyword-lists/1963

@doc """
do foo operation

## Options

- `:option1` - option 1
- `:option2` - option 2
"""
@spec foo_operation(Foo.t(), [option]) :: {:ok, Foo.t()} | :error
      when option: {:option1, atom} | {:option2, integer}
def foo_operation(foo, opts \\ []) do
  opts = Enum.into(opts, %{option1: :default, option2: 15})
  do_foo_operation(foo, opts)
end

@spec do_foo_operation(Foo.t(), map) :: {:ok, Foo.t()} | :error
defp do_foo_operation(foo, %{option1: option1, option2: option2}) do
end