The condition to determine which messages to be consumed by a sink.

The messages which satisfy severity (default is debug) and are sent from the specified location will be consumed.

The location is specified by application and module (OR condition).

NOTE: The modules which does not belong to any application are forbidden.

Examples

iex> Logi.Condition.is_condition(%{:application => :stdlib})                             # application
iex> Logi.Condition.is_condition(%{:application => [:stdlib, :kernel]})                  # applications
iex> Logi.Condition.is_condition(%{:module => :lists})                                   # module
iex> Logi.Condition.is_condition(%{:module => [:lists, :dict]})                          # modules
iex> Logi.Condition.is_condition(%{:application => :kernel, :module => [:lists, :dict]}) # application and modules
iex> Logi.Condition.is_condition(%{:severity => [:info, :alert], :module => :lists})     # severity and module

The normalized form of a condition/0.

Examples

iex> normalize = fn (c) -> :lists.sort(Logi.Condition.normalize c) end

iex> normalize.(:info)
[:alert, :critical, :emergency, :error, :info, :notice, :warning]

iex> normalize.({:info, :alert})
[:alert, :critical, :error, :info, :notice, :warning]

iex> normalize.(%{:severity => [:info], :application => [:kernel, :stdlib]})
[info: :kernel, info: :stdlib]

iex> normalize.(%{:severity => [:info], :module => [:lists, Logi]})
[{:info, :logi_ex, Logi}, {:info, :stdlib, :lists}]

iex> normalize.(%{:severity => [:info], :application => :kernel, :module => [:lists, Logi]})
[{:info, :kernel}, {:info, :logi_ex, Logi}, {:info, :stdlib, :lists}]

Condition based on the specified severity pattern.

min

• The messages with min or higher severity will be consumed.

{min, max}

• The messages with severity between min and max will be consumed.

severities

• The messages with severity included in severities will be consumed.

Examples

iex> [:emergency, :alert]       = Logi.Condition.normalize(:alert)                  # level
iex> [:warning, :notice, :info] = Logi.Condition.normalize({:info, :warning})       # range
iex> [:alert, :debug, :info]    = Logi.Condition.normalize([:debug, :info, :alert]) # list