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 modules/methods Digger gives you:
1 - Digger.Atomizer
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.Atomizer
Digger.Atomizer drills down into a nested map and converts (most) keys which are not atoms into atoms.
2 - Digger.Stringifier
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.Stringifier
Digger.Stringifier drills down into a nested map and converts (most) keys which are not strings into strings.
3 - Digger.CamelCaser
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.CamelCaser
Digger.CamelCaser "camel cases" your valid data type according to the rules defined by its protocol.
4 - Digger.SnakeCaser
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.SnakeCaser
Digger.SnakeCaser "snake cases" your valid data type according to the rules defined by its protocol.
5 - Digger.Dasher
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
Digger.Dasher "dasherizes" your valid data type according to the rules defined by its protocol.
6 - Digger.LowerCaser
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.LowerCaser
Digger.Dasher "lowercases" your valid data type according to the rules defined by its protocol.
7 - Digger.UpperCaser
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.UpperCaser
Digger.Dasher "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.