2 .. include:: ../../rst_prolog.rst
9 The **config** command manages sat configuration.
10 It allows display, manipulation and operation on configuration files
14 * Edit the user personal configuration file ``$HOME/.salomeTools/SAT.pyconf``. It is used to store the user personal choices, like the favorite editor, browser, pdf viewer: ::
18 * List the available applications (they come from the sat projects defined in ``data/local.pyconf``): ::
22 * Edit the configuration of an application: ::
24 sat config <application> --edit
26 * Check the system dependencies (if any) used by the application: ::
28 sat config <application> --check_system
30 * Copy an application configuration file into the user personal directory: ::
32 sat config <application> --copy [new_name]
34 * | Print the value of a configuration parameter.
35 | Use the automatic completion to get recursively the parameter names.
36 | Use *--no_label* option to get *only* the value, *without* label (useful in automatic scripts).
37 | Examples (with *SALOME-xx* as *SALOME-8.4.0* ):
41 # sat config --value <parameter_path>
42 sat config --value . # all the configuration
43 sat config --value LOCAL
44 sat config --value LOCAL.workdir
46 # sat config <application> --value <parameter_path>
47 sat config SALOME-xx --value APPLICATION.workdir
48 sat config SALOME-xx --no_label --value APPLICATION.workdir
50 * | Print in one-line-by-value mode the value of a configuration parameter,
51 | with its source *expression*, if any.
52 | This is a debug mode, useful for developers.
53 | Prints the parameter path, the source expression if any, and the final value:
57 sat config SALOME-xx -g USER
59 .. note:: And so, *not only for fun*, to get **all expressions** of configuration
63 sat config SALOME-xx -g . | grep -e "-->"
66 * Print the patches that are applied: ::
68 sat config SALOME-xx --show_patchs
70 * Print the properties available for an application: ::
72 sat config SALOME-xx show_properties
74 * Get information on a product configuration:
78 # sat config <application> --info <product>
79 sat config SALOME-xx --info KERNEL
80 sat config SALOME-xx --info qt
82 Some useful configuration paths
83 =================================
85 Exploring a current configuration.
87 * **PATHS**: To get list of directories where to find files.
89 * **USER**: To get user preferences (editor, pdf viewer, web browser, default working dir).
93 sat config SALOME-xx -v PATHS
94 sat config SALOME-xx -v USERS