Digger
Description
Digger is a collection of helpers to help you operate on nested maps (it will also work on non-nested maps). Elixir gives you a great collection of map methods, but sometimes I find myself having to rewrite the same operations specifically for nested maps.
This library is intended to help your code stay DRY.
Possible Future Work
This library is a work in progress. I'm thinking about extending it to lists and/or tuples.
Here is a list of helper methods Digger gives you:
1 - Digger.atomize/2
The Problem
You have a valid data type that needs to be "atomized" This can be a string, number, or nested map with string keys.
The Solution
Digger.atomize/2 drills down into a nested map and converts (most) keys which are not atoms into atoms.
2 - Digger.stringify/2
The Problem
You have a nested map (or a struct that you converted to a nested map) with keys that are atoms and you want to convert those keys to strings.
You have a valid data type that needs to be "stringified" This can be an atom, number, or nested map with atom keys.
The Solution
Digger.stringify/2 drills down into a nested map and converts (most) keys which are not strings into strings.
3 - Digger.camel_case/2
The Problem
You have a valid data type that needs to be camel-cased. This can be an atom, string, or nested map (or a struct that you converted to a nested map) with string or atom keys.
The Solution
Digger.camel_case/2 "camel cases" your valid data type according to the rules defined by its protocol.
4 - Digger.snake_case/2
The Problem
You have a valid data type that needs to be snake-cased. This can be an atom, string, or nested map (or a struct that you converted to a nested map) with string or atom keys.
The Solution
Digger.snake_case/2 "snake cases" your valid data type according to the rules defined by its protocol.
5 - Digger.dasher/2
The Problem
You have a valid data type that needs the underscores transformed to dashes. This can be a string, or nested map (or a struct that you converted to a nested map) with string keys.
The Solution
Digger.dasher/2 "dasherizes" your valid data type according to the rules defined by its protocol.
6 - Digger.lowercase_first/2
The Problem
You have a valid data type that needs the first letter to be lowercase. This can be a string or atom or nested map with string or atom keys.
The Solution
Digger.lowercase_first/2 "lowercases" your valid data type according to the rules defined by its protocol.
7 - Digger.upcase_first/2
The Problem
You have a valid data type that needs the first letter to be upper case. This can be a string or atom or nested map with string or atom keys.
The Solution
Digger.upcase_first/2 "upcases" your valid data type according to the rules defined by its protocol.
Questions?
The tests in the test folder show you the data types that are handled. The protocol implementations in lib/impl also show you the various data types are handled.
Installation
If available in Hex, the package can be installed
by adding digger
to your list of dependencies in mix.exs
:
def deps do
[
{:digger, "~> 3.0.0"}
]
end
Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/digger.