@spec atomize(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

'Atomize' a valid Types.data_type according to the protocol implementation

By default, atomizing a string that has no corresponding existing atom creates a new one via String.to_atom/1, which is safe for trusted input but can exhaust the atom table if used on untrusted/external data (atoms are never garbage collected).

Pass existing: true to atomize via String.to_existing_atom/1 instead: strings that already have a matching atom are converted as usual, and strings that don't are left as the original string rather than raising or creating a new atom.

Examples

iex> Digger.atomize(%{"user" => %{"name" => "Ada"}})
%{user: %{name: "Ada"}}

iex> Digger.atomize(%{"ok" => 1, "no_such_atom_xyz" => 2}, existing: true)
%{:ok => 1, "no_such_atom_xyz" => 2}

@spec camel_case(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

Camel case a valid Types.data_type according to the protocol implementation

The default is UpperCamelCase; pass key_transform: :lower for the lowerCamelCase convention used in JavaScript APIs.

Examples

iex> Digger.camel_case(%{user_id: 1})
%{UserId: 1}

iex> Digger.camel_case(
...>   %{user_id: 1},
...>   type: :key, key_transform: :lower, value_transform: :none
...> )
%{userId: 1}

@spec dasherize(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

'Dasherize' a valid Types.data_type according to the protocol implementation

Examples

iex> Digger.dasherize(%{"foo_bar" => 1})
%{"foo-bar" => 1}

@spec lowercase_first(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

Lower case first letter of a valid Types.data_type according to the protocol implementation

Examples

iex> Digger.lowercase_first(%{"FooBar" => 1})
%{"fooBar" => 1}

@spec snake_case(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

snake_case a valid Types.data_type according to the protocol implementation

Only keys are transformed by default — string values pass through unchanged.

Examples

iex> Digger.snake_case(%{"userId" => 1, "displayName" => "johnDoe"})
%{"user_id" => 1, "display_name" => "johnDoe"}

@spec stringify(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

'Stringify' a valid Types.data_type according to the protocol implementation

Examples

iex> Digger.stringify(%{user: %{name: "Ada"}})
%{"user" => %{"name" => "Ada"}}

@spec upcase_first(
  Digger.Types.data_type(),
  keyword()
) :: Digger.Types.valid_return_type()

Upper case the first letter of a valid Types.data_type according to the protocol implementation

Examples

iex> Digger.upcase_first(%{"fooBar" => 1})
%{"FooBar" => 1}