luminous v1.3.2

View Source Luminous.Variable behaviour (luminous v1.3.2)

A variable is defined at compile time and its values are determined at runtime. It also stores a current value that can be updated. A variable value is descriptive in that it contains a label (for display purposes) and the actual value.

Link to this section Summary

Types

descriptive_value()
simple_value()
t()

Callbacks

variable(atom, map)

A module must implement this behaviour to be passed as an argument to define/3.

Functions

define(id, label, mod)

Defines a new variable and returns the struct does not calculate the values yet (see populate/1). The module must implement the Luminous.Variable behaviour.

extract_label(arg1)

Extracts and returns the label from the descriptive variable value.

extract_value(arg1)

Extract and returns the value from the descriptive variable value.

find(variables, id)

Find and return the variable with the specified id in the supplied variables.

get_current(arg1)

Returns the variable's current (descriptive) value or nil.

get_current_and_extract_value(variables, variable_id)

Find the variable with the supplied id in the supplied variables and return its current extracted value.

populate(var, params)

Uses the query to populate the variables's values and returns the new struct. Additionally, it sets the current value to be the first of the calculated values.

update_current(var, new_value)

Replaces the variables current value with the new value and returns the new struct. It performs a check whether the supplied value is a valid value (i.e. exists in values). If it's not, then it returns the struct unchanged.

Link to this section Types

Link to this type

descriptive_value()

View Source 
@type descriptive_value() :: %{label: binary(), value: binary()}
Link to this type

simple_value()

View Source 
@type simple_value() :: binary()
Link to this type

t()

View Source 
@type t() :: %Luminous.Variable{
  current: descriptive_value() | nil,
  id: atom(),
  label: binary(),
  mod: module(),
  values: [descriptive_value()]
}

Link to this section Callbacks

Link to this callback

variable(atom, map)

View Source 
@callback variable(atom(), map()) :: [simple_value() | descriptive_value()]

A module must implement this behaviour to be passed as an argument to define/3.

Link to this section Functions

Link to this function

define(id, label, mod)

View Source 
@spec define(atom(), binary(), module()) :: t()

Defines a new variable and returns the struct does not calculate the values yet (see populate/1). The module must implement the Luminous.Variable behaviour.

Link to this function

extract_label(arg1)

View Source 
@spec extract_label(descriptive_value()) :: binary()

Extracts and returns the label from the descriptive variable value.

Link to this function

extract_value(arg1)

View Source 
@spec extract_value(descriptive_value()) :: binary()

Extract and returns the value from the descriptive variable value.

Link to this function

find(variables, id)

View Source 
@spec find([t()], atom()) :: t() | nil

Find and return the variable with the specified id in the supplied variables.

Link to this function

get_current(arg1)

View Source 
@spec get_current(t()) :: descriptive_value() | nil

Returns the variable's current (descriptive) value or nil.

Link to this function

get_current_and_extract_value(variables, variable_id)

View Source 
@spec get_current_and_extract_value([t()], atom()) :: binary()

Find the variable with the supplied id in the supplied variables and return its current extracted value.

Link to this function

populate(var, params)

View Source 
@spec populate(t(), map()) :: t()

Uses the query to populate the variables's values and returns the new struct. Additionally, it sets the current value to be the first of the calculated values.

Link to this function

update_current(var, new_value)

View Source 
@spec update_current(t(), binary()) :: t()

Replaces the variables current value with the new value and returns the new struct. It performs a check whether the supplied value is a valid value (i.e. exists in values). If it's not, then it returns the struct unchanged.