Output configuration

Configuration

Specification

  • Output configuration is available

    • For avail sub-command, on regular and --terse modes
    • For list sub-command, on regular and --terse modes

  • Output configuration is not available (but could be added later on)

  • Output configuration defines the content of the output not its format

  • These configurations are set by default with the elements reported by default

    • avail_output: modulepath:alias:dirwsym:sym:tag:key
    • avail_terse_output: modulepath:alias:dirwsym:sym:tag
    • list_output: header:idx:sym:tag:key
    • list_terse_output: header

  • The above default value could be superseded:

  • Accepted elements in value lists are:

    • For avail options: modulepath, alias, dirwsym, sym, tag, key
    • For list options: header, idx, sym, tag, key

  • If the -o/--output options are wronly specified

    • An error is raised and evaluation terminates

    • It may happen in the following situations

      • No value set after the option
      • Option set on unsupported module sub-command
      • Element set in option value unsupported by module sub-command
      • Elements set in option value not separated by colon character (:)
      • Option set on unsupported output format (--long or --json)
      • The above situations apply whether command is called from the terminal or within a modulefile

  • For all these new configuration options

    • accepted value is a list of strings separated by colon character (:)
    • order of elements in the list does not matter
    • an empty string is a valid value (means only the modulefile name has to be reported)

  • If the MODULES_AVAIL_OUTPUT/MODULES_AVAIL_TERSE_OUTPUT/MODULES_LIST_OUTPUT/MODULES_LIST_TERSE_OUTPUT env vars are wrongly specified

    • Their value is ignored

    • So the default value takes precedence, unless a -o/--output option is specified

    • Value in environment variable is wronly specified for instance in the following situations

      • Element set in option value unsupported by module sub-command
      • Elements set in option value not separated by colon character (:)

  • avail_output supersedes avail_report_dir_sym and avail_report_mfile_sym configurations

    • Enabled avail_report_dir_sym corresponds to adding dirsym value to avail_output

    • Enabled avail_report_mfile_sym corresponds to adding sym value to avail_output

    • Both avail_report_dir_sym and avail_report_mfile_sym could be removed safely as:

      • it was not possible to define them at configure time
      • or change default value with an environment variable

  • Some output content cannot be controlled at the moment with the output options:

    • Hidden modules is exclusively controlled by --all option to get these modules unveiled
    • Indepth/no-indepth output is exclusively controlled by --no-indepth/--indepth and related configuration option

  • When modulepath element is removed from an avail-related option

    • all the modulefiles returned from all searched modulepaths are merged and sorted as a single set
    • a module appearing in several modulepaths is only reported once
    • tags or symbols applying to a lower priority module with same name are still reported

Output key

  • An output key is added to print a legend explaining the output

    • Meaning of () or <> is explained
    • Default version is colored specifically
    • Every tag shortened to a defined abbreviation
    • Every tag colored specifically
    • Legend entries only concern elements that can be found in reported output
    • Legend entries are not reported on JSON output mode

  • Output key is enabled by default on avail and list sub-command output

    • Key is reported at the end of the output
    • No key section is reported if no element need to be described (no color, no symbol, no tag, etc)