# `Moar.Tuple`
[🔗](https://github.com/synchronal/moar/blob/main/lib/tuple.ex#L1)

Tuple-related functions.

# `from_list!`

```elixir
@spec from_list!([any()]) :: {any(), [any()]}
```

Converts a list of tuples to a single tuple whose first element is the first element of each tuple in
the list (which must all be the same), and whose second element is a list containing the second elements
of each tuple in the list.

Raises if the list contains tuples whose first elements are not all the same.

```elixir
iex> Moar.Tuple.from_list!([{:ok, :a}, {:ok, :b}])
{:ok, [:a, :b]}

iex> Moar.Tuple.from_list!([{:a, 1}, {:a, 2}, {:a, 3}])
{:a, [1, 2, 3]}

iex> Moar.Tuple.from_list!([{:a, 1}, {:b, 2}, {:a, 3}])
** (RuntimeError) Expected all items in the list to have have the same first element, but got: [:a, :b]
```

# `reduce`

```elixir
@spec reduce([any()], [any()]) :: map()
```

Reduces a list of tuples to map where values are consolidated by the first element of each input tuple.
Optionally accepts a list of default keys, whose values will be `[]` if not found in the input.

```elixir
iex> Moar.Tuple.reduce([{:ok, 1}, {:ok, 2}])
%{ok: [1, 2]}

iex> Moar.Tuple.reduce([{:ok, 1}, {:ok, 2}, {:error, 3}, {:ok, 4}])
%{ok: [1, 2, 4], error: [3]}

iex> Moar.Tuple.reduce([{:ok, 1}, {:ok, 2}], [:ok, :warning, :error])
%{ok: [1, 2], warning: [], error: []}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*