Map Sorter v0.1.19 MapSorter View Source

Sorts a list of maps as per a list of sort specs (ascending/descending keys).

Also supports:

  • keywords
  • structs implementing the Access behaviour
  • nested maps, keywords or structs implementing the Access behaviour

Link to this section Summary

Functions

Allows to change the log level at compile time

Sorts maps as per the given sort specs (compile time or runtime)

Link to this section Functions

Link to this macro log_level(level) View Source (macro)

Allows to change the log level at compile time.

Link to this macro sort(maps, sort_specs) View Source (macro)

Sorts maps as per the given sort specs (compile time or runtime).

Examples of sort specs for flattened data structures:

  • implicit: [:dob, :name] ≡ [asc: :dob, asc: :name]
  • mixed: [:dob, desc: :name] ≡ [asc: :dob, desc: :name]
  • explicit: [asc: :dob, desc: :name]

Examples of sort specs for nested data structures:

  • implicit: [[:birth, :date], :name]
  • mixed: [[:birth, :date], desc: :name]
  • explicit: [asc: [:birth, :date], desc: :name]

Examples

iex> require MapSorter
iex> people = [
...>   %{name: "Mike", likes: "movies" , dob: "1992-04-15"},
...>   %{name: "Mary", likes: "travels", dob: "1992-04-15"},
...>   %{name: "Bill", likes: "karate" , dob: "1977-08-28"},
...>   %{name: "Joe" , likes: "boxing" , dob: "1977-08-28"},
...>   %{name: "Jill", likes: "cooking", dob: "1976-09-28"}
...> ]
iex> sort_specs = [:dob, desc: :likes]
iex> sorted_people = %{
...>   explicit: MapSorter.sort(people, asc: :dob, desc: :likes),
...>   mixed:    MapSorter.sort(people, [:dob, desc: :likes]),
...>   runtime:  MapSorter.sort(people, sort_specs)
...> }
iex> sorted_people.explicit == sorted_people.mixed and
...> sorted_people.explicit == sorted_people.runtime and
...> sorted_people.explicit
[
  %{name: "Jill", likes: "cooking", dob: "1976-09-28"},
  %{name: "Bill", likes: "karate" , dob: "1977-08-28"},
  %{name: "Joe" , likes: "boxing" , dob: "1977-08-28"},
  %{name: "Mary", likes: "travels", dob: "1992-04-15"},
  %{name: "Mike", likes: "movies" , dob: "1992-04-15"}
]