Namelist Diff Configuration

Configuration for the namelist diff tool follows the XDG standard. The configuration should be stored in a YAML file.

You can use the function write_default_config to generate a configuration file with the hard-coded defaults. Command line access for this command is available via:

$ nmldiff --write-default-config

The default configuration will be written to ${XDG_CONFIG_HOME}/nmldiff/nmldiff.yaml

Order of Precedence

Configuration is loaded in the following order:

  1. Command line

  2. Config file thats name is declared on the command line.

  3. Environment vars

  4. Local config file (if exists)

  5. Global config file (if exists)

  6. Hard-coded defaults in the code

Configuration
Options
  • debug (bool) –

    Switch debug mode on and off.

    Defaults to 'false'.

  • color (bool) –

    Colorize output of the diff

    Defaults to 'true'.

  • keep_mvstream (bool) –

    Consider mvstream (relevant for namelist.echam) chapters in the diff

    Defaults to 'false'.

  • keep_set_stream (bool) –

    Consider set_stream chapters (relevant for namelist.echam) in the diff

    Defaults to 'false'.

  • keep_set_stream_element (bool) –

    Consider set_stream_element chapters (relevant for namelist.echam) in the diff

    Defaults to 'false'.

  • cleanup_paths (bool) –

    If the specified string is a path, duplicate slashes (//) will be replaced with single slashes (/)

    Defaults to 'true'.