3 # Copyright (C) 2010-2013 CEA/DEN
5 # This library is free software; you can redistribute it and/or
6 # modify it under the terms of the GNU Lesser General Public
7 # License as published by the Free Software Foundation; either
8 # version 2.1 of the License.
10 # This library is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 # Lesser General Public License for more details.
15 # You should have received a copy of the GNU Lesser General Public
16 # License along with this library; if not, write to the Free Software
17 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 import src.debug as DBG
32 Class to manage the environment context
34 def __init__(self, environ=None):
35 """Initialization. If the environ argument is passed, the environment
36 will be add to it, else it is the external environment.
40 if environ is not None:
41 self.environ = environ
43 self.environ = os.environ
46 """easy non exhaustive quick resume for debug print"""
47 return "%s(\n%s\n)" % (self.__class__.__name__, PP.pformat(self.environ))
49 def _expandvars(self, value):
51 replace some $VARIABLE into its actual value in the environment
53 :param value str: the string to be replaced
54 :return: the replaced variable
57 if src.architecture.is_windows():
62 # The string.Template class is a string class
63 # for supporting $-substitutions
64 zt = string.Template(value)
67 value = zt.substitute(self.environ)
68 except KeyError as exc:
70 #raise src.SatException(_("Missing definition "
71 # "in environment: %s") % str(exc))
74 def append_value(self, key, value, sep=os.pathsep):
76 append value to key using sep,
77 if value contains ":" or ";" then raise error
79 :param key str: the environment variable to append
80 :param value str: the value to append to key
81 :param sep str: the separator string
83 # check that value so no contain the system separator
85 if separator in value:
86 raise Exception("Environ append key '%s' value '%s' contains forbidden character '%s'" % (key, value, separator))
88 # check if the key is already in the environment
89 if key in self.environ:
90 value_list = self.environ[key].split(sep)
91 # Check if the value is already in the key value or not
92 if not value in value_list:
93 value_list.append(value)
95 value_list.append(value_list.pop(value_list.index(value)))
96 self.set(key, sep.join(value_list))
100 def append(self, key, value, sep=os.pathsep):
102 Same as append_value but the value argument can be a list
104 :param key str: the environment variable to append
105 :param value str or list: the value(s) to append to key
106 :param sep str: the separator string
108 if isinstance(value, list):
110 self.append_value(key, v, sep)
112 self.append_value(key, value, sep)
114 def prepend_value(self, key, value, sep=os.pathsep):
116 prepend value to key using sep,
117 if value contains ":" or ";" then raise error
119 :param key str: the environment variable to prepend
120 :param value str: the value to prepend to key
121 :param sep str: the separator string
123 # check that value so no contain the system separator
125 if separator in value:
126 raise Exception("Environ append key '%s' value '%s' contains forbidden character '%s'" % (key, value, separator))
128 # check if the key is already in the environment
129 if key in self.environ:
130 value_list = self.environ[key].split(sep)
131 if not value in value_list:
132 value_list.insert(0, value)
134 value_list.insert(0, value_list.pop(value_list.index(value)))
135 self.set(key, sep.join(value_list))
139 def prepend(self, key, value, sep=os.pathsep):
141 Same as prepend_value but the value argument can be a list
143 :param key str: the environment variable to prepend
144 :param value str or list: the value(s) to prepend to key
145 :param sep str: the separator string
147 if isinstance(value, list):
148 for v in reversed(value): # prepend list, first item at last to stay first
149 self.prepend_value(key, v, sep)
151 self.prepend_value(key, value, sep)
153 def is_defined(self, key):
155 Check if the key exists in the environment
157 :param key str: the environment variable to check
159 return key in self.environ.keys()
161 def set(self, key, value):
163 Set the environment variable "key" to value "value"
165 :param key str: the environment variable to set
166 :param value str: the value
168 self.environ[key] = self._expandvars(value)
172 Get the value of the environment variable "key"
174 :param key str: the environment variable
176 if key in self.environ:
177 return self.environ[key]
181 def get_value(self, key):
183 Get the value of the environment variable "key"
184 This method is added for API compatibility with FileEnviron class
186 :param key str: the environment variable
194 Class to manage the environment of SALOME.
201 enable_simple_env_script = True):
205 :param cfg Config: the global config
206 :param environ Environ: the Environ instance where
207 to store the environment variables
208 :param forBuild bool: If true, it is a launch environment,
210 :param for_package str: If not None, produce a relative environment
211 designed for a package.
213 self.environ = environ
215 self.forBuild = forBuild
216 self.for_package = for_package
217 self.enable_simple_env_script = enable_simple_env_script
219 self.has_python = False
220 self.__set_sorted_products_list()
223 """easy almost exhaustive quick resume for debug print"""
225 "environ" : self.environ,
226 "forBuild" : self.forBuild,
227 "for_package" : self.for_package,
229 return "%s(\n%s\n)" % (self.__class__.__name__, PP.pformat(res))
231 def __set_sorted_products_list(self):
232 from compile import get_dependencies_graph, depth_first_topo_graph
233 all_products_infos = src.product.get_products_infos(
234 self.cfg.APPLICATION.products,
237 all_products_graph=get_dependencies_graph(all_products_infos)
240 for n in all_products_graph:
241 if n not in visited_nodes:
242 visited_nodes,sorted_nodes=depth_first_topo_graph(
247 self.sorted_product_list=sorted_nodes
250 def append(self, key, value, sep=os.pathsep):
252 append value to key using sep
254 :param key str: the environment variable to append
255 :param value str: the value to append to key
256 :param sep str: the separator string
258 return self.environ.append(key, value, sep)
260 def prepend(self, key, value, sep=os.pathsep):
262 prepend value to key using sep
264 :param key str: the environment variable to prepend
265 :param value str: the value to prepend to key
266 :param sep str: the separator string
268 return self.environ.prepend(key, value, sep)
270 def is_defined(self, key):
272 Check if the key exists in the environment
274 :param key str: the environment variable to check
276 return self.environ.is_defined(key)
280 Get the value of the environment variable "key"
282 :param key str: the environment variable
284 return self.environ.get(key)
286 def get_value(self, key):
288 Get the real value of the environment variable "key"
289 This method is added for API compatibility with FileEnviron class
291 :param key str: the environment variable
293 if key in self.environ:
294 return self.environ[key]
298 def set(self, key, value):
300 Set the environment variable "key" to value "value"
302 :param key str: the environment variable to set
303 :param value str: the value
305 # check if value needs to be evaluated
306 if value is not None and value.startswith("`") and value.endswith("`"):
307 res = subprocess.Popen("echo %s" % value,
309 stdout=subprocess.PIPE).communicate()
310 value = res[0].strip()
312 return self.environ.set(key, value)
316 Write the environment to out
318 :param out file: the stream where to write the environment
320 for k in self.environ.environ.keys():
325 out.write("%s=%s\n" % (k, value))
327 def add_line(self, nb_line):
329 Add empty lines to the out stream (in case of file generation)
331 :param nb_line int: the number of empty lines to add
333 if 'add_line' in dir(self.environ):
334 self.environ.add_line(nb_line)
336 def add_comment(self, comment):
338 Add a commentary to the out stream (in case of file generation)
340 :param comment str: the commentary to add
342 if 'add_comment' in dir(self.environ):
343 self.environ.add_comment(comment)
345 def add_warning(self, warning):
347 Add a warning to the out stream (in case of file generation)
349 :param warning str: the warning to add
351 if 'add_warning' in dir(self.environ):
352 self.environ.add_warning(warning)
356 Add a final instruction in the out file (in case of file generation)
358 :param required bool: Do nothing if required is False
360 if 'finish' in dir(self.environ):
361 self.environ.add_line(1)
363 # self.environ.add_comment("clean all the path")
364 self.environ.finish()
366 def set_python_libdirs(self):
367 """Set some generic variables for python library paths"""
368 ver = self.get('PYTHON_VERSION')
369 self.set('PYTHON_LIBDIR', os.path.join('lib',
372 self.python_lib = self.get('PYTHON_LIBDIR')
373 self.has_python = True
375 def set_application_env(self, logger):
377 Sets the environment defined in the APPLICATION file.
379 :param logger Logger: The logger instance to display messages
383 self.set("PRODUCT_ROOT_DIR", "out_dir_Path")
385 self.cfg.APPLICATION.environ.PRODUCT_ROOT_DIR = src.pyconf.Reference(self.cfg, src.pyconf.DOLLAR, "workdir")
387 # these sensitive variables are reset to avoid bad environment interactions
389 self.add_comment("reset these sensitive variables to avoid bad environment interactions")
390 self.add_comment("comment these to lines if you wish a different behaviour")
391 if not src.architecture.is_windows():
392 self.set("LD_LIBRARY_PATH", "")
393 self.set("PYTHONPATH", "")
396 # Set the variables defined in the "environ" section
397 if 'environ' in self.cfg.APPLICATION:
398 # we write PRODUCT environment it in order to conform to
400 self.add_comment("PRODUCT environment")
401 self.load_cfg_environment(self.cfg.APPLICATION.environ)
402 if self.forBuild and "build" in self.cfg.APPLICATION.environ:
403 self.load_cfg_environment(self.cfg.APPLICATION.environ.build)
404 if not self.forBuild and "launch" in self.cfg.APPLICATION.environ:
405 self.load_cfg_environment(self.cfg.APPLICATION.environ.launch)
409 def set_salome_minimal_product_env(self, product_info, logger):
411 Sets the minimal environment for a SALOME product.
412 xxx_ROOT_DIR and xxx_SRC_DIR
414 :param product_info Config: The product description
415 :param logger Logger: The logger instance to display messages
418 DBG.write("set_salome_minimal_product_env", product_info)
419 root_dir = product_info.name + "_ROOT_DIR"
420 if 'install_dir' in product_info and product_info.install_dir:
421 self.set(root_dir, product_info.install_dir)
422 elif not self.silent:
423 logger.write(" " + _("No install_dir for product %s\n") %
424 product_info.name, 5)
426 source_in_package = src.get_property_in_product_cfg(product_info,
427 "sources_in_package")
428 if not self.for_package or source_in_package == "yes":
429 # set source dir, unless no source dir
430 if not src.product.product_is_fixed(product_info):
431 src_dir = product_info.name + "_SRC_DIR"
432 if not self.for_package:
433 self.set(src_dir, product_info.source_dir)
435 self.set(src_dir, os.path.join("out_dir_Path",
437 os.path.basename(product_info.source_dir)))
439 def expand_salome_modules(self, pi):
440 if 'component_name' in pi:
441 compo_name = pi.component_name
444 self.append('SALOME_MODULES', compo_name, ',')
447 def set_salome_generic_product_env(self, pi):
449 Sets the generic environment for a SALOME product.
451 :param pi Config: The product description
453 # Construct XXX_ROOT_DIR
454 env_root_dir = self.get(pi.name + "_ROOT_DIR")
455 l_binpath_libpath = []
456 # create additional ROOT_DIR for CPP components
457 if 'component_name' in pi:
458 compo_name = pi.component_name
459 if compo_name + "CPP" == pi.name:
460 compo_root_dir = compo_name + "_ROOT_DIR"
461 envcompo_root_dir = os.path.join(
462 self.cfg.TOOLS.common.install_root, compo_name )
463 self.set(compo_root_dir , envcompo_root_dir)
464 bin_path = os.path.join(envcompo_root_dir, 'bin', 'salome')
465 lib_path = os.path.join(envcompo_root_dir, 'lib', 'salome')
466 l_binpath_libpath.append( (bin_path, lib_path) )
469 if src.get_property_in_product_cfg(pi, "fhs"):
470 lib_path = os.path.join(env_root_dir, 'lib')
471 bin_path = os.path.join(env_root_dir, 'bin')
473 # if the application doesn't include python, we don't need these two lines
474 pylib_path = os.path.join(env_root_dir, self.python_lib)
476 lib_path = os.path.join(env_root_dir, 'lib', 'salome')
477 bin_path = os.path.join(env_root_dir, 'bin', 'salome')
479 # if the application doesn't include python, we don't need these two lines
480 pylib_path = os.path.join(env_root_dir, self.python_lib, 'salome')
482 # Construct the paths to prepend to PATH and LD_LIBRARY_PATH and
484 l_binpath_libpath.append( (bin_path, lib_path) )
486 for bin_path, lib_path in l_binpath_libpath:
487 if not self.forBuild:
488 self.prepend('PATH', bin_path)
489 if src.architecture.is_windows():
490 self.prepend('PATH', lib_path)
492 self.prepend('LD_LIBRARY_PATH', lib_path)
494 l = [ bin_path, lib_path ]
495 if not src.product.product_is_wheel(pi):
498 self.prepend('PYTHONPATH', l)
500 def set_cpp_env(self, product_info):
502 Sets the generic environment for a SALOME cpp product.
504 :param product_info Config: The product description
506 # Construct XXX_ROOT_DIR
507 env_root_dir = self.get(product_info.name + "_ROOT_DIR")
508 l_binpath_libpath = []
510 # Construct the paths to prepend to PATH and LD_LIBRARY_PATH and
512 bin_path = os.path.join(env_root_dir, 'bin')
513 lib_path = os.path.join(env_root_dir, 'lib')
514 l_binpath_libpath.append( (bin_path, lib_path) )
516 for bin_path, lib_path in l_binpath_libpath:
517 if not self.forBuild:
518 self.prepend('PATH', bin_path)
519 if src.architecture.is_windows():
520 self.prepend('PATH', lib_path)
522 self.prepend('LD_LIBRARY_PATH', lib_path)
524 l = [ bin_path, lib_path ]
526 l.append(os.path.join(env_root_dir, self.python_lib))
527 self.prepend('PYTHONPATH', l)
529 def load_cfg_environment(self, cfg_env):
531 Loads environment defined in cfg_env
533 :param cfg_env Config: A config containing an environment
535 # Loop on cfg_env values
536 for env_def in cfg_env:
537 val = cfg_env[env_def]
539 # if it is env_script, do not do anything (reserved keyword)
540 if env_def == "env_script":
543 # if it is a dict, do not do anything
544 if isinstance(val, src.pyconf.Mapping):
547 # if it is a list, loop on its values
548 if isinstance(val, src.pyconf.Sequence):
549 # transform into list of strings
555 # "_" means that the value must be prepended
556 if env_def.startswith("_"):
557 # separator exception for PV_PLUGIN_PATH
558 if env_def[1:] == 'PV_PLUGIN_PATH':
559 self.prepend(env_def[1:], val, ';')
561 self.prepend(env_def[1:], val)
562 elif env_def.endswith("_"):
563 # separator exception for PV_PLUGIN_PATH
564 if env_def[:-1] == 'PV_PLUGIN_PATH':
565 self.append(env_def[:-1], val, ';')
567 self.append(env_def[:-1], val)
569 self.set(env_def, val)
571 def set_a_product(self, product, logger):
573 Sets the environment of a product.
575 :param product str: The product name
576 :param logger Logger: The logger instance to display messages
579 # Get the informations corresponding to the product
580 pi = src.product.get_product_config(self.cfg, product)
581 # skip compile time products at run time
582 if not self.forBuild:
583 if src.product.product_is_compile_time(pi):
586 # skip pip products when pip is activated and installation is done in python
587 #if (src.appli_test_property(self.cfg,"pip", "yes") and
588 # src.product.product_test_property(pi,"pip", "yes") and
589 # src.appli_test_property(self.cfg,"pip_install_dir", "python") ):
592 # skip mesa products (if any) at run time,
593 # unless use_mesa property was activated
594 if not self.forBuild:
595 if not ("APPLICATION" in self.cfg and
596 "properties" in self.cfg.APPLICATION and
597 "use_mesa" in self.cfg.APPLICATION.properties and
598 self.cfg.APPLICATION.properties.use_mesa == "yes") :
599 if ("properties" in pi and
600 "is_mesa" in pi.properties and
601 pi.properties.is_mesa == "yes") :
602 logger.write(_("Skip mesa product %s\n") % pi.name, 4)
607 pi.install_dir = os.path.join(
610 os.path.basename(pi.install_dir))
613 logger.write(_("Setting environment for %s\n") % product, 4)
616 self.add_comment('setting environ for ' + product)
618 # Do not define environment if the product is native
619 if src.product.product_is_native(pi):
620 if src.product.product_has_env_script(pi):
621 self.run_env_script(pi, native=True)
624 # Set an additional environment for SALOME products
625 if src.product.product_is_salome(pi):
626 # set environment using definition of the product
627 self.set_salome_minimal_product_env(pi, logger)
628 self.set_salome_generic_product_env(pi)
631 # Expand SALOME_MODULES variable for products which have a salome gui
632 if src.product.product_has_salome_gui(pi):
633 self.expand_salome_modules(pi)
635 # use variable LICENCE_FILE to communicate the licence file name to the environment script
636 licence_file_name = src.product.product_has_licence(pi, self.cfg.PATHS.LICENCEPATH)
637 if licence_file_name:
638 logger.write("licence file found for product %s : %s\n" % (pi.name, licence_file_name), 5)
639 self.set("LICENCE_FILE", licence_file_name)
641 if src.product.product_is_cpp(pi):
642 # set a specific environment for cpp modules
643 self.set_salome_minimal_product_env(pi, logger)
646 if src.product.product_is_generated(pi):
647 if "component_name" in pi:
648 # hack the source and install directories in order to point
649 # on the generated product source install directories
650 install_dir_save = pi.install_dir
651 source_dir_save = pi.source_dir
653 pi.install_dir = os.path.join(self.cfg.APPLICATION.workdir,
654 self.cfg.INTERNAL.config.install_dir,
657 pi.install_dir = os.path.join("out_dir_Path",
660 pi.source_dir = os.path.join(self.cfg.APPLICATION.workdir,
663 pi.name = pi.component_name
664 self.set_salome_minimal_product_env(pi, logger)
665 self.set_salome_generic_product_env(pi)
667 # Put original values
668 pi.install_dir = install_dir_save
669 pi.source_dir = source_dir_save
672 # Put the environment define in the configuration of the product
674 self.load_cfg_environment(pi.environ)
675 if self.forBuild and "build" in pi.environ:
676 self.load_cfg_environment(pi.environ.build)
677 if not self.forBuild and "launch" in pi.environ:
678 self.load_cfg_environment(pi.environ.launch)
679 # if product_info defines a env_scripts, load it
680 if 'env_script' in pi.environ:
681 self.run_env_script(pi, logger)
686 def run_env_script(self, product_info, logger=None, native=False):
688 Runs an environment script.
690 :param product_info Config: The product description
691 :param logger Logger: The logger instance to display messages
692 :param native Boolean: if True load set_native_env instead of set_env
694 env_script = product_info.environ.env_script
695 # Check that the script exists
696 if not os.path.exists(env_script):
697 raise src.SatException(_("Environment script not found: %s") %
700 if not self.silent and logger is not None:
701 logger.write(" ** load %s\n" % env_script, 4)
703 # import the script and run the set_env function
706 pyproduct = imp.load_source(product_info.name + "_env_script",
709 if self.forBuild and "set_env_build" in dir(pyproduct):
710 pyproduct.set_env_build(self,
711 product_info.install_dir,
712 product_info.version)
713 elif (not self.forBuild) and "set_env_launch" in dir(pyproduct):
714 pyproduct.set_env_launch(self,
715 product_info.install_dir,
716 product_info.version)
718 # at least this one is mandatory,
719 # if set_env_build and set_env_build are not defined
720 pyproduct.set_env(self,
721 product_info.install_dir,
722 product_info.version)
724 # not mandatory, if set_nativ_env not defined, we do nothing
725 if "set_nativ_env" in dir(pyproduct):
726 pyproduct.set_nativ_env(self)
728 __, exceptionValue, exceptionTraceback = sys.exc_info()
729 print(exceptionValue)
731 traceback.print_tb(exceptionTraceback)
732 traceback.print_exc()
734 def set_products(self, logger, src_root=None):
736 Sets the environment for all the products.
738 :param logger Logger: The logger instance to display messages
739 :param src_root src: the application working directory
742 self.add_comment('setting environ for all products')
744 # Make sure that the python lib dirs are set after python
745 if "Python" in self.sorted_product_list:
746 self.set_a_product("Python", logger)
747 self.set_python_libdirs()
749 # The loop on the products
750 for product in self.sorted_product_list:
751 if product == "Python":
753 self.set_a_product(product, logger)
755 def set_full_environ(self, logger, env_info):
757 Sets the full environment for products
758 specified in env_info dictionary.
760 :param logger Logger: The logger instance to display messages
761 :param env_info list: the list of products
763 DBG.write("set_full_environ for", env_info)
764 # DBG.write("set_full_environ config", self.cfg.APPLICATION.environ, True)
765 # set product environ
766 self.set_application_env(logger)
768 # use the sorted list of all products to sort the list of products
770 sorted_product_list=[]
771 for n in self.sorted_product_list:
773 sorted_product_list.append(n)
775 if "Python" in sorted_product_list:
776 self.set_a_product("Python", logger)
777 self.set_python_libdirs()
780 for product in sorted_product_list:
781 if product == "Python":
783 self.set_a_product(product, logger)
787 Class to dump the environment to a file.
789 def __init__(self, config, logger, out_dir, src_root, env_info=None):
793 :param cfg Config: the global config
794 :param logger Logger: The logger instance to display messages
795 :param out_dir str: The directory path where t put the output files
796 :param src_root str: The application working directory
797 :param env_info str: The list of products to add in the files.
801 self.out_dir = out_dir
802 self.src_root= src_root
804 self.env_info = env_info
806 def write_tcl_files(self,
811 additional_env = {}):
813 Create tcl environment files for environment module.
815 :param forBuild bool: if true, the build environment
816 :param shell str: the type of file wanted (.sh, .bat)
817 :param for_package bool: if true do specific stuff for required for packages
818 :param no_path_init bool: if true generate a environ file that do not reinitialise paths
819 :param additional_env dict: contains sat_ prefixed variables to help the génération,
820 and also variables to add in the environment.
821 :return: The path to the generated file
825 # get the products informations
826 all_products=self.config.APPLICATION.products
827 products_infos = src.product.get_products_infos(all_products, self.config)
829 # set a global environment (we need it to resolve variable references
830 # between dependent products
831 global_environ = src.environment.SalomeEnviron(self.config,
832 src.environment.Environ(additional_env),
834 global_environ.set_products(self.logger)
836 # The loop on the products
837 for product in all_products:
838 # create one file per product
839 pi = src.product.get_product_config(self.config, product)
840 if "base" not in pi: # we write tcl files only for products in base
843 # get the global environment, and complete it with sat_ prefixed
844 # prefixed variables which are used to transfer info to
845 # TclFileEnviron class
846 product_env = copy.deepcopy(global_environ.environ)
847 product_env.environ["sat_product_name"] = pi.name
848 product_env.environ["sat_product_version"] = pi.version
849 product_env.environ["sat_product_base_path"] = src.get_base_path(self.config)
850 product_env.environ["sat_product_base_name"] = pi.base
852 # store infos in sat_product_load_depend to set dependencies in tcl file
853 sat_product_load_depend=""
854 for p_name,p_info in products_infos:
855 if p_name in pi.depend:
856 sat_product_load_depend+="module load %s/%s/%s;" % (pi.base,
859 if len(sat_product_load_depend)>0:
860 # if there are dependencies, store the module to load (get rid of trailing ;)
861 product_env.environ["sat_product_load_depend"]=sat_product_load_depend[0:-1]
864 env_file_name = os.path.join(product_env.environ["sat_product_base_path"],
866 product_env.environ["sat_product_base_name"],
867 product_env.environ["sat_product_name"],
868 product_env.environ["sat_product_version"])
869 prod_dir_name=os.path.dirname(env_file_name)
870 if not os.path.isdir(prod_dir_name):
871 os.makedirs(prod_dir_name)
873 env_file = open(env_file_name, "w")
874 file_environ = src.fileEnviron.get_file_environ(env_file,
876 env = SalomeEnviron(self.config,
879 for_package=for_package)
880 if "Python" in pi.depend:
881 # short cut, env.python_lib is required by set_a_product for salome modules
882 env.has_python="True"
883 env.python_lib=global_environ.get("PYTHON_LIBDIR")
884 env.set_a_product(product, self.logger)
887 self.logger.write(_(" Create tcl module environment file %s\n") %
888 src.printcolors.printcLabel(env_file_name), 3)
891 def write_env_file(self,
897 additional_env = {}):
899 Create an environment file.
901 :param filename str: the file path
902 :param forBuild bool: if true, the build environment
903 :param shell str: the type of file wanted (.sh, .bat)
904 :param for_package bool: if true do specific stuff for required for packages
905 :param no_path_init bool: if true generate a environ file that do not reinitialise paths
906 :param additional_env dict: contains sat_ prefixed variables to help the génération,
907 and also variables to add in the environment.
908 :return: The path to the generated file
912 self.logger.write(_("Create environment file %s\n") %
913 src.printcolors.printcLabel(filename), 3)
914 # create then env object
915 env_file = open(os.path.join(self.out_dir, filename), "w")
917 # we duplicate additional_env, and transmit it to fileEnviron, which will use its sat_ prefixed variables.
918 # the other variables of additional_env are added to the environement file at the end of this function.
919 salome_env = copy.deepcopy(additional_env)
920 file_environ = src.fileEnviron.get_file_environ(env_file,
922 src.environment.Environ(salome_env))
924 # specify we don't want to reinitialise paths
925 # path will keep the inherited value, which will be appended with new values.
926 file_environ.set_no_init_path()
928 env = SalomeEnviron(self.config,
931 for_package=for_package)
933 env.silent = self.silent
935 # Set the environment
936 if self.env_info is not None:
937 env.set_full_environ(self.logger, self.env_info)
939 # set env from the APPLICATION
940 env.set_application_env(self.logger)
942 env.set_products(self.logger,
943 src_root=self.src_root)
944 # Add the additional environment if it is not empty
945 if len(additional_env) != 0:
947 env.add_comment("[APPLI variables]")
948 for variable in additional_env:
949 if not variable.startswith("sat_"):
950 # by convention variables starting with sat_ are used to transfer information,
951 # not to be written in env
952 env.set(variable, additional_env[variable])
954 # finalise the writing and close the file
963 Definition of a Shell.
965 def __init__(self, name, extension):
969 :param name str: the shell name
970 :param extension str: the shell extension
973 self.extension = extension
975 def load_environment(config, build, logger):
977 Loads the environment (used to run the tests, for example).
979 :param config Config: the global config
980 :param build bool: build environement if True
981 :param logger Logger: The logger instance to display messages
983 environ = SalomeEnviron(config, Environ(os.environ), build)
984 environ.set_application_env(logger)
985 environ.set_products(logger)