# casual configuration

[//]: # (Attention! this is a generated markdown from casual-administration-cli-documentation - do not edit this file!)

```console
host# casual --help configuration

configuration [0..1]
     configuration utility - does NOT actively configure anything
                    
     Used to check and normalize configuration

   SUB OPTIONS:

      --get [0..1]  (json, yaml, xml, ini) [0..1]
           get current configuration

      --post [0..1]  (json, yaml, xml, ini) [1]
           reads configuration from stdin and replaces the domain configuration
           
           casual will try to conform to the new configuration as smooth as possible. Although, there could be some "noise"
           depending on what parts are updated.

      --put [0..1]  (json, yaml, xml, ini) [1]
           reads configuration from stdin and adds or updates parts
           
           The semantics are similar to http PUT:
           * every key that is found is treated as an update of that _entity_
           * every key that is NOT found is treated as a new _entity_ and added to the current state 

      --edit [0..1]  (json, yaml, xml, ini) [0..1]
           get current configuration, starts an editor, on quit the edited configuration is posted.
           
           The editor is deduced from the following environment variables, in this order:
           * CASUAL_TERMINAL_EDITOR
           * VISUAL
           * EDITOR
           
           If none is set, `vi` is used.
           
           If no changes are detected, no update will take place.

      --enable-groups [0..1]  (<name>..) [1..*]
           INCUBATION enables groups
           Enables groups that provided group names matches.
           
           This effects entities that has memberships to enabled groups
           (domain:Server, domain:Executable, queue::Forward)
           
           @attention INCUBATION - might change during, or in between minor version.

      --disable-groups [0..1]  (<name>..) [1..*]
           INCUBATION disables groups
           Disables groups that provided group names matches.
           
           This effects entities that has memberships to enabled groups
           (domain:Server, domain:Executable, queue::Forward)
           
           @attention INCUBATION - might change during, or in between minor version.

      --normalize [0..1]  (<value>) [1..*]
           normalizes the supplied configuration glob pattern to stdout
           
           The format is default yaml, but could be supplied via the --format option

      --validate [0..1]  (<value>) [1..*]
           validates configuration from supplied glob patterns
           
           On success exit with 0, on error not 0, and message printed to stderr

      --format [0..1]  (yaml, json, ini, xml) [1]
           defines what format should be used

      --union [0..1]  (<value>) [0..*]
           union of configuration from stdin(lhs) and supplied glob pattern(rhs), outputs to stdout
              rhs has precedence over lhs
                                   
              The format is default yaml, but could be supplied via the --format option

      --difference [0..1]  (<value>) [0..*]
           difference of configuration from stdin(lhs) and supplied glob pattern(rhs), outputs to stdout
              lhs has precedence over rhs
                                   
              The format is default yaml, but could be supplied via the --format option

      --intersection [0..1]  (<value>) [0..*]
           intersection of configuration from stdin(lhs) and supplied glob pattern(rhs), outputs to stdout
              lhs has precedence over rhs
                                   
              The format is default yaml, but could be supplied via the --format option

```