5 *salomeTools* uses files with **.pyconf** extension to store its configuration parameters.
6 These pyconf configuration files are provided by the salomeTool projects that are set by sat init command.
8 When executing a command, sat will load several configuration files in a specific order.
9 When all the files are loaded a *config* object is created.
10 Then, this object is passed to all command scripts.
15 The configuration files use a python-like structure format
16 (see `config module <http://www.red-dove.com/config-doc/>`_ for a complete description).
18 * **{}** define a dictionary,
19 * **[]** define a list,
20 * **@** can be used to include a file,
21 * **$prefix** reference to another parameter (ex: ``$PRODUCT.name``),
24 .. note:: in this documentation a reference to a configuration parameter will be noted ``XXX.YYY``.
33 | This section is dynamically created by salomeTools at run time.
34 | It contains information about the environment: date, time, OS, architecture etc.
38 # to get the current setting
39 sat config --value VARS
43 | This section is defined in the application pyconf file.
44 | It contains instructions on how to build a version of SALOME (list of products and versions, compilation options, etc.)
48 # to get the current setting
49 sat config SALOME-xx --value APPLICATION
54 * name : the name of the application
55 * workdir : the directory in which the application is produced
56 * tag : the default tag to use for the git bases
57 * dev : activate the dev mode. in dev mode git bases are checked out only one time, to avoid risks of removing developments.
58 * verbose : activate verbosity in the compilation
59 * debug : activate debug mode in the compilation, i.e -g option
60 * python3 : 'yes/no' tell sat that the application uses python3
61 * base : 'yes/no/name'
66 | This section contains all the information required to build the products contained in the application.
67 | It is build from the products configuration files.
71 # to get the current setting
72 sat config SALOME-xx --value PRODUCT
79 This section is defined by the user configuration file,
80 ``~/.salomeTools/SAT.pyconf``.
82 The ``USER`` section defines some parameters (not exhaustive):
84 * **pdf_viewer** : the pdf viewer used to read pdf documentation
86 * **browser** : The web browser to use (*firefox*).
88 * **editor** : The editor to use (*vi, pluma*).
90 * and other user preferences.
94 # to get the current setting
95 sat config SALOME-xx --value USER
97 # to edit your personal configuration file
104 * **PROJECTs** : This section contains the configuration of the projects loaded in salomeTool by sat init --add_project command.
105 * **PATHS** : This section contains paths used by saloeTools.
106 * **LOCAL** : contains information relative to the local installation of salomeTool.
107 * **INTERNAL** : contains internal salomeTool information
109 All these sections can be printed with sat config command:
113 # It is possible to use sat completion mode to print available sections.
114 sat config SALOME-xx --value <TAB> <TAB>
115 > APPLICATION. INTERNAL. LOCAL. PATHS.
116 > PRODUCTS. PROJECTS. USER. VARS.
118 # get paths used by sat
119 sat config SALOME-xx --value PATHS
121 It is possible to use sat completion mode to print available sections.