src/environment.py

   1 #!/usr/bin/env python
   2 #-*- coding:utf-8 -*-
   3 #  Copyright (C) 2010-2013  CEA/DEN
   4 #
   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.
   9 #
  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.
  14 #
  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
  18
  19 import os
  20 import subprocess
  21 import string
  22 import sys
  23
  24 import src
  25
  26 class Environ:
  27     '''Class to manage the environment context
  28     '''
  29     def __init__(self, environ=None):
  30         '''Initialization. If the environ argument is passed, the environment
  31            will be add to it, else it is the external environment.
  32
  33         :param environ dict:
  34         '''
  35         if environ is not None:
  36             self.environ = environ
  37         else:
  38             self.environ = os.environ
  39
  40     def __repr__(self):
  41         """easy non exhaustive quick resume for debug print
  42         """
  43         res={}
  44         res["environ"]=self.environ
  45         return self.__class__.__name__ + str(res)[0:-1] + " ...etc...}"
  46
  47     def _expandvars(self, value):
  48         '''replace some $VARIABLE into its actual value in the environment
  49
  50         :param value str: the string to be replaced
  51         :return: the replaced variable
  52         :rtype: str
  53         '''
  54         if "$" in value:
  55             # The string.Template class is a string class
  56             # for supporting $-substitutions
  57             zt = string.Template(value)
  58             try:
  59                 value = zt.substitute(self.environ)
  60             except KeyError as exc:
  61                 raise src.SatException(_("Missing definition "
  62                                          "in environment: %s") % str(exc))
  63         return value
  64
  65     def append_value(self, key, value, sep=os.pathsep):
  66         '''append value to key using sep
  67
  68         :param key str: the environment variable to append
  69         :param value str: the value to append to key
  70         :param sep str: the separator string
  71         '''
  72         # check if the key is already in the environment
  73         if key in self.environ:
  74             value_list = self.environ[key].split(sep)
  75             # Check if the value is already in the key value or not
  76             if not value in value_list:
  77                 value_list.append(value)
  78             else:
  79                 value_list.append(value_list.pop(value_list.index(value)))
  80             self.set(key, sep.join(value_list))
  81         else:
  82             self.set(key, value)
  83
  84     def append(self, key, value, sep=os.pathsep):
  85         '''Same as append_value but the value argument can be a list
  86
  87         :param key str: the environment variable to append
  88         :param value str or list: the value(s) to append to key
  89         :param sep str: the separator string
  90         '''
  91         if isinstance(value, list):
  92             for v in value:
  93                 self.append_value(key, v, sep)
  94         else:
  95             self.append_value(key, value, sep)
  96
  97     def prepend_value(self, key, value, sep=os.pathsep):
  98         '''prepend value to key using sep
  99
 100         :param key str: the environment variable to prepend
 101         :param value str: the value to prepend to key
 102         :param sep str: the separator string
 103         '''
 104         if key in self.environ:
 105             value_list = self.environ[key].split(sep)
 106             if not value in value_list:
 107                 value_list.insert(0, value)
 108             else:
 109                 value_list.insert(0, value_list.pop(value_list.index(value)))
 110             self.set(key, sep.join(value_list))
 111         else:
 112             self.set(key, value)
 113
 114     def prepend(self, key, value, sep=os.pathsep):
 115         '''Same as prepend_value but the value argument can be a list
 116
 117         :param key str: the environment variable to prepend
 118         :param value str or list: the value(s) to prepend to key
 119         :param sep str: the separator string
 120         '''
 121         if isinstance(value, list):
 122             for v in value:
 123                 self.prepend_value(key, v, sep)
 124         else:
 125             self.prepend_value(key, value, sep)
 126
 127     def is_defined(self, key):
 128         '''Check if the key exists in the environment
 129
 130         :param key str: the environment variable to check
 131         '''
 132         return key in self.environ.keys()
 133
 134     def set(self, key, value):
 135         '''Set the environment variable "key" to value "value"
 136
 137         :param key str: the environment variable to set
 138         :param value str: the value
 139         '''
 140         self.environ[key] = self._expandvars(value)
 141
 142     def get(self, key):
 143         '''Get the value of the environment variable "key"
 144
 145         :param key str: the environment variable
 146         '''
 147         if key in self.environ:
 148             return self.environ[key]
 149         else:
 150             return ""
 151
 152     def command_value(self, key, command):
 153         '''Get the value given by the system command "command"
 154            and put it in the environment variable key
 155
 156         :param key str: the environment variable
 157         :param command str: the command to execute
 158         '''
 159         value = subprocess.Popen(command,
 160                                  shell=True,
 161                                  stdout=subprocess.PIPE,
 162                                  env=self.environ).communicate()[0]
 163         self.environ[key] = value
 164
 165
 166 class SalomeEnviron:
 167     """Class to manage the environment of SALOME.
 168     """
 169
 170     def __init__(self,
 171                  cfg,
 172                  environ,
 173                  forBuild=False,
 174                  for_package=None,
 175                  enable_simple_env_script = True):
 176         '''Initialization.
 177
 178         :param cfg Config: the global config
 179         :param environ Environ: the Environ instance where
 180                                 to store the environment variables
 181         :param forBuild bool: If true, it is a launch environment,
 182                               else a build one
 183         :param for_package str: If not None, produce a relative environment
 184                                 designed for a package.
 185         '''
 186         self.environ = environ
 187         self.cfg = cfg
 188         self.forBuild = forBuild
 189         self.for_package = for_package
 190         self.enable_simple_env_script = enable_simple_env_script
 191         self.silent = False
 192
 193     def __repr__(self):
 194         """easy non exhaustive quick resume for debug print"""
 195         res={}
 196         res["environ"]=str(self.environ)
 197         res["forBuild"]=self.forBuild
 198         return self.__class__.__name__ + str(res)[0:-1] + " ...etc...}"
 199
 200     def append(self, key, value, sep=os.pathsep):
 201         '''append value to key using sep
 202
 203         :param key str: the environment variable to append
 204         :param value str: the value to append to key
 205         :param sep str: the separator string
 206         '''
 207         return self.environ.append(key, value, sep)
 208
 209     def prepend(self, key, value, sep=os.pathsep):
 210         '''prepend value to key using sep
 211
 212         :param key str: the environment variable to prepend
 213         :param value str: the value to prepend to key
 214         :param sep str: the separator string
 215         '''
 216         return self.environ.prepend(key, value, sep)
 217
 218     def is_defined(self, key):
 219         '''Check if the key exists in the environment
 220
 221         :param key str: the environment variable to check
 222         '''
 223         return self.environ.is_defined(key)
 224
 225     def get(self, key):
 226         '''Get the value of the environment variable "key"
 227
 228         :param key str: the environment variable
 229         '''
 230         return self.environ.get(key)
 231
 232     def set(self, key, value):
 233         '''Set the environment variable "key" to value "value"
 234
 235         :param key str: the environment variable to set
 236         :param value str: the value
 237         '''
 238         # check if value needs to be evaluated
 239         if value is not None and value.startswith("`") and value.endswith("`"):
 240             res = subprocess.Popen("echo %s" % value,
 241                                    shell=True,
 242                                    stdout=subprocess.PIPE).communicate()
 243             value = res[0].strip()
 244
 245         return self.environ.set(key, value)
 246
 247     def dump(self, out):
 248         """Write the environment to out
 249
 250         :param out file: the stream where to write the environment
 251         """
 252         for k in self.environ.environ.keys():
 253             try:
 254                 value = self.get(k)
 255             except:
 256                 value = "?"
 257             out.write("%s=%s\n" % (k, value))
 258
 259     def add_line(self, nb_line):
 260         """Add empty lines to the out stream (in case of file generation)
 261
 262         :param nb_line int: the number of empty lines to add
 263         """
 264         if 'add_line' in dir(self.environ):
 265             self.environ.add_line(nb_line)
 266
 267     def add_comment(self, comment):
 268         """Add a commentary to the out stream (in case of file generation)
 269
 270         :param comment str: the commentary to add
 271         """
 272         if 'add_comment' in dir(self.environ):
 273             self.environ.add_comment(comment)
 274
 275     def add_warning(self, warning):
 276         """Add a warning to the out stream (in case of file generation)
 277
 278         :param warning str: the warning to add
 279         """
 280         if 'add_warning' in dir(self.environ):
 281             self.environ.add_warning(warning)
 282
 283     def finish(self, required):
 284         """Add a final instruction in the out file (in case of file generation)
 285
 286         :param required bool: Do nothing if required is False
 287         """
 288         if 'finish' in dir(self.environ):
 289             self.environ.add_line(1)
 290             self.environ.add_comment("clean all the path")
 291             self.environ.finish(required)
 292
 293     def set_python_libdirs(self):
 294         """Set some generic variables for python library paths
 295         """
 296         ver = self.get('PYTHON_VERSION')
 297         self.set('PYTHON_LIBDIR0', os.path.join('lib',
 298                                                 'python' + ver,
 299                                                 'site-packages'))
 300         self.set('PYTHON_LIBDIR1', os.path.join('lib64',
 301                                                 'python' + ver,
 302                                                 'site-packages'))
 303
 304         self.python_lib0 = self.get('PYTHON_LIBDIR0')
 305         self.python_lib1 = self.get('PYTHON_LIBDIR1')
 306
 307     def get_names(self, lProducts):
 308         """Get the products name to add in SALOME_MODULES environment variable
 309            It is the name of the product, except in the case where the is a
 310            component name. And it has to be in SALOME_MODULES variable only
 311            if the product has the property has_salome_hui = "yes"
 312
 313         :param lProducts list: List of products to potentially add
 314         """
 315         lProdHasGui = [p for p in lProducts if 'properties' in
 316             src.product.get_product_config(self.cfg, p) and
 317             'has_salome_gui' in
 318             src.product.get_product_config(self.cfg, p).properties and
 319             src.product.get_product_config(self.cfg,
 320                                            p).properties.has_salome_gui=='yes']
 321         lProdName = []
 322         for ProdName in lProdHasGui:
 323             pi = src.product.get_product_config(self.cfg, ProdName)
 324             if 'component_name' in pi:
 325                 lProdName.append(pi.component_name)
 326             else:
 327                 lProdName.append(ProdName)
 328         return lProdName
 329
 330     def set_application_env(self, logger):
 331         """Sets the environment defined in the APPLICATION file.
 332
 333         :param logger Logger: The logger instance to display messages
 334         """
 335
 336         # Set the variables defined in the "environ" section
 337         if 'environ' in self.cfg.APPLICATION:
 338             self.add_comment("APPLICATION environment")
 339             for p in self.cfg.APPLICATION.environ:
 340                 val = self.cfg.APPLICATION.environ[p]
 341                 # "_" means that the value must be prepended
 342                 if p.startswith("_"):
 343                     # separator exception for PV_PLUGIN_PATH
 344                     if p[1:] == 'PV_PLUGIN_PATH':
 345                         self.prepend(p[1:], val, ';')
 346                     else:
 347                         self.prepend(p[1:], val)
 348                 elif p.endswith("_"):
 349                     # separator exception for PV_PLUGIN_PATH
 350                     if p[:-1] == 'PV_PLUGIN_PATH':
 351                         self.append(p[:-1], val, ';')
 352                     else:
 353                         self.append(p[:-1], val)
 354                 else:
 355                     self.set(p, val)
 356             self.add_line(1)
 357
 358         # If there is an "environ_script" section, load the scripts
 359         if 'environ_script' in self.cfg.APPLICATION:
 360             for pscript in self.cfg.APPLICATION.environ_script:
 361                 self.add_comment("script %s" % pscript)
 362                 sname = pscript.replace(" ", "_")
 363                 self.run_env_script("APPLICATION_%s" % sname,
 364                                 self.cfg.APPLICATION.environ_script[pscript],
 365                                 logger)
 366                 self.add_line(1)
 367
 368     def set_salome_minimal_product_env(self, product_info, logger):
 369         """Sets the minimal environment for a SALOME product.
 370            xxx_ROOT_DIR and xxx_SRC_DIR
 371
 372         :param product_info Config: The product description
 373         :param logger Logger: The logger instance to display messages
 374         """
 375         # set root dir
 376         root_dir = product_info.name + "_ROOT_DIR"
 377         if not self.is_defined(root_dir):
 378             if 'install_dir' in product_info and product_info.install_dir:
 379                 self.set(root_dir, product_info.install_dir)
 380             elif not self.silent:
 381                 logger.write("  " + _("No install_dir for product %s\n") %
 382                               product_info.name, 5)
 383
 384         source_in_package = src.get_property_in_product_cfg(product_info,
 385                                                            "sources_in_package")
 386         if not self.for_package or source_in_package == "yes":
 387             # set source dir, unless no source dir
 388             if not src.product.product_is_fixed(product_info):
 389                 src_dir = product_info.name + "_SRC_DIR"
 390                 if not self.is_defined(src_dir):
 391                     if not self.for_package:
 392                         self.set(src_dir, product_info.source_dir)
 393                     else:
 394                         self.set(src_dir, os.path.join("out_dir_Path",
 395                                                        "SOURCES",
 396                                                        product_info.name))
 397
 398     def set_salome_generic_product_env(self, pi):
 399         """Sets the generic environment for a SALOME product.
 400
 401         :param pi Config: The product description
 402         """
 403         # Construct XXX_ROOT_DIR
 404         env_root_dir = self.get(pi.name + "_ROOT_DIR")
 405         l_binpath_libpath = []
 406
 407         # create additional ROOT_DIR for CPP components
 408         if 'component_name' in pi:
 409             compo_name = pi.component_name
 410             if compo_name + "CPP" == pi.name:
 411                 compo_root_dir = compo_name + "_ROOT_DIR"
 412                 envcompo_root_dir = os.path.join(
 413                             self.cfg.TOOLS.common.install_root, compo_name )
 414                 self.set(compo_root_dir ,  envcompo_root_dir)
 415                 bin_path = os.path.join(envcompo_root_dir, 'bin', 'salome')
 416                 lib_path = os.path.join(envcompo_root_dir, 'lib', 'salome')
 417                 l_binpath_libpath.append( (bin_path, lib_path) )
 418
 419         appliname = 'salome'
 420         if (src.get_cfg_param(pi, 'product_type', 'SALOME').upper()
 421                             not in [ "SALOME", "SMESH_PLUGIN", "SAMPLE" ]):
 422             appliname = ''
 423
 424         # Construct the paths to prepend to PATH and LD_LIBRARY_PATH and
 425         # PYTHONPATH
 426         bin_path = os.path.join(env_root_dir, 'bin', appliname)
 427         lib_path = os.path.join(env_root_dir, 'lib', appliname)
 428         l_binpath_libpath.append( (bin_path, lib_path) )
 429
 430         for bin_path, lib_path in l_binpath_libpath:
 431             if not self.forBuild:
 432                 self.prepend('PATH', bin_path)
 433                 if src.architecture.is_windows():
 434                     self.prepend('PATH', lib_path)
 435                 else :
 436                     self.prepend('LD_LIBRARY_PATH', lib_path)
 437
 438             l = [ bin_path, lib_path,
 439                   os.path.join(env_root_dir, self.python_lib0, appliname),
 440                   os.path.join(env_root_dir, self.python_lib1, appliname)
 441                 ]
 442             self.prepend('PYTHONPATH', l)
 443
 444     def set_cpp_env(self, product_info):
 445         """Sets the generic environment for a SALOME cpp product.
 446
 447         :param product_info Config: The product description
 448         """
 449         # Construct XXX_ROOT_DIR
 450         env_root_dir = self.get(product_info.name + "_ROOT_DIR")
 451         l_binpath_libpath = []
 452
 453         # Construct the paths to prepend to PATH and LD_LIBRARY_PATH and
 454         # PYTHONPATH
 455         bin_path = os.path.join(env_root_dir, 'bin')
 456         lib_path = os.path.join(env_root_dir, 'lib')
 457         l_binpath_libpath.append( (bin_path, lib_path) )
 458
 459         for bin_path, lib_path in l_binpath_libpath:
 460             if not self.forBuild:
 461                 self.prepend('PATH', bin_path)
 462                 if src.architecture.is_windows():
 463                     self.prepend('PATH', lib_path)
 464                 else :
 465                     self.prepend('LD_LIBRARY_PATH', lib_path)
 466
 467             l = [ bin_path, lib_path,
 468                   os.path.join(env_root_dir, self.python_lib0),
 469                   os.path.join(env_root_dir, self.python_lib1)
 470                 ]
 471             self.prepend('PYTHONPATH', l)
 472
 473     def load_cfg_environment(self, cfg_env):
 474         """Loads environment defined in cfg_env
 475
 476         :param cfg_env Config: A config containing an environment
 477         """
 478         # Loop on cfg_env values
 479         for env_def in cfg_env:
 480             val = cfg_env[env_def]
 481
 482             # if it is env_script, do not do anything (reserved keyword)
 483             if env_def == "env_script":
 484                 continue
 485
 486             # if it is a dict, do not do anything
 487             if isinstance(val, src.pyconf.Mapping):
 488                 continue
 489
 490             # if it is a list, loop on its values
 491             if isinstance(val, src.pyconf.Sequence):
 492                 # transform into list of strings
 493                 l_val = []
 494                 for item in val:
 495                     l_val.append(item)
 496                 val = l_val
 497
 498             # "_" means that the value must be prepended
 499             if env_def.startswith("_"):
 500                 # separator exception for PV_PLUGIN_PATH
 501                 if env_def[1:] == 'PV_PLUGIN_PATH':
 502                     self.prepend(env_def[1:], val, ';')
 503                 else:
 504                     self.prepend(env_def[1:], val)
 505             elif env_def.endswith("_"):
 506                 # separator exception for PV_PLUGIN_PATH
 507                 if env_def[:-1] == 'PV_PLUGIN_PATH':
 508                     self.append(env_def[:-1], val, ';')
 509                 else:
 510                     self.append(env_def[:-1], val)
 511             else:
 512                 self.set(env_def, val)
 513
 514     def set_a_product(self, product, logger):
 515         """Sets the environment of a product.
 516
 517         :param product str: The product name
 518         :param logger Logger: The logger instance to display messages
 519         """
 520
 521         # Get the informations corresponding to the product
 522         pi = src.product.get_product_config(self.cfg, product)
 523
 524         if self.for_package:
 525             pi.install_dir = os.path.join("out_dir_Path",
 526                                           self.for_package,
 527                                           pi.name)
 528
 529         if not self.silent:
 530             logger.write(_("Setting environment for %s\n") % product, 4)
 531
 532         self.add_line(1)
 533         self.add_comment('setting environ for ' + product)
 534
 535         # Do not define environment if the product is native
 536         if src.product.product_is_native(pi):
 537             if src.product.product_has_env_script(pi):
 538                 self.run_env_script(pi, native=True)
 539             return
 540
 541         # Set an additional environment for SALOME products
 542         if src.product.product_is_salome(pi):
 543             # set environment using definition of the product
 544             self.set_salome_minimal_product_env(pi, logger)
 545             self.set_salome_generic_product_env(pi)
 546
 547         if src.product.product_is_cpp(pi):
 548             # set a specific environment for cpp modules
 549             self.set_salome_minimal_product_env(pi, logger)
 550             self.set_cpp_env(pi)
 551
 552             if src.product.product_is_generated(pi):
 553                 if "component_name" in pi:
 554                     # hack the source and install directories in order to point
 555                     # on the generated product source install directories
 556                     install_dir_save = pi.install_dir
 557                     source_dir_save = pi.source_dir
 558                     name_save = pi.name
 559                     pi.install_dir = os.path.join(self.cfg.APPLICATION.workdir,
 560                                                   "INSTALL",
 561                                                   pi.component_name)
 562                     if self.for_package:
 563                         pi.install_dir = os.path.join("out_dir_Path",
 564                                                       self.for_package,
 565                                                       pi.component_name)
 566                     pi.source_dir = os.path.join(self.cfg.APPLICATION.workdir,
 567                                                   "GENERATED",
 568                                                   pi.component_name)
 569                     pi.name = pi.component_name
 570                     self.set_salome_minimal_product_env(pi, logger)
 571                     self.set_salome_generic_product_env(pi)
 572
 573                     # Put original values
 574                     pi.install_dir = install_dir_save
 575                     pi.source_dir = source_dir_save
 576                     pi.name = name_save
 577
 578         # Put the environment define in the configuration of the product
 579         if "environ" in pi:
 580             self.load_cfg_environment(pi.environ)
 581             if self.forBuild and "build" in pi.environ:
 582                 self.load_cfg_environment(pi.environ.build)
 583             if not self.forBuild and "launch" in pi.environ:
 584                 self.load_cfg_environment(pi.environ.launch)
 585             # if product_info defines a env_scripts, load it
 586             if 'env_script' in pi.environ:
 587                 self.run_env_script(pi, logger)
 588
 589
 590
 591
 592     def run_env_script(self, product_info, logger=None, native=False):
 593         """Runs an environment script.
 594
 595         :param product_info Config: The product description
 596         :param logger Logger: The logger instance to display messages
 597         :param native Boolean: if True load set_native_env instead of set_env
 598         """
 599         env_script = product_info.environ.env_script
 600         # Check that the script exists
 601         if not os.path.exists(env_script):
 602             raise src.SatException(_("Environment script not found: %s") %
 603                                    env_script)
 604
 605         if not self.silent and logger is not None:
 606             logger.write("  ** load %s\n" % env_script, 4)
 607
 608         # import the script and run the set_env function
 609         try:
 610             import imp
 611             pyproduct = imp.load_source(product_info.name + "_env_script",
 612                                         env_script)
 613             if not native:
 614                 pyproduct.set_env(self,
 615                                   product_info.install_dir,
 616                                   product_info.version)
 617             else:
 618                 if "set_nativ_env" in dir(pyproduct):
 619                     pyproduct.set_nativ_env(self)
 620         except:
 621             __, exceptionValue, exceptionTraceback = sys.exc_info()
 622             print(exceptionValue)
 623             import traceback
 624             traceback.print_tb(exceptionTraceback)
 625             traceback.print_exc()
 626
 627     def run_simple_env_script(self, script_path, logger=None):
 628         """Runs an environment script. Same as run_env_script, but with a
 629            script path as parameter.
 630
 631         :param script_path str: a path to an environment script
 632         :param logger Logger: The logger instance to display messages
 633         """
 634         if not self.enable_simple_env_script:
 635             return
 636         # Check that the script exists
 637         if not os.path.exists(script_path):
 638             raise src.SatException(_("Environment script not found: %s") %
 639                                    script_path)
 640
 641         if not self.silent and logger is not None:
 642             logger.write("  ** load %s\n" % script_path, 4)
 643
 644         script_basename = os.path.basename(script_path)
 645         if script_basename.endswith(".py"):
 646             script_basename = script_basename[:-len(".py")]
 647
 648         # import the script and run the set_env function
 649         try:
 650             import imp
 651             pyproduct = imp.load_source(script_basename + "_env_script",
 652                                         script_path)
 653             pyproduct.load_env(self)
 654         except:
 655             __, exceptionValue, exceptionTraceback = sys.exc_info()
 656             print(exceptionValue)
 657             import traceback
 658             traceback.print_tb(exceptionTraceback)
 659             traceback.print_exc()
 660
 661     def set_products(self, logger, src_root=None):
 662         """Sets the environment for all the products.
 663
 664         :param logger Logger: The logger instance to display messages
 665         :param src_root src: the application working directory
 666         """
 667         self.add_line(1)
 668         self.add_comment('setting environ for all products')
 669
 670         # Make sure that the python lib dirs are set after python
 671         if "Python" in self.cfg.APPLICATION.products:
 672             self.set_a_product("Python", logger)
 673             self.set_python_libdirs()
 674
 675         # The loop on the products
 676         for product in self.cfg.APPLICATION.products.keys():
 677             if product == "Python":
 678                 continue
 679             self.set_a_product(product, logger)
 680             self.finish(False)
 681
 682     def set_full_environ(self, logger, env_info):
 683         """Sets the full environment for products
 684            specified in env_info dictionary.
 685
 686         :param logger Logger: The logger instance to display messages
 687         :param env_info list: the list of products
 688         """
 689         # set product environ
 690         self.set_application_env(logger)
 691
 692         self.set_python_libdirs()
 693
 694         # set products
 695         for product in env_info:
 696             self.set_a_product(product, logger)
 697
 698 class FileEnvWriter:
 699     """Class to dump the environment to a file.
 700     """
 701     def __init__(self, config, logger, out_dir, src_root, env_info=None):
 702         '''Initialization.
 703
 704         :param cfg Config: the global config
 705         :param logger Logger: The logger instance to display messages
 706         :param out_dir str: The directory path where t put the output files
 707         :param src_root str: The application working directory
 708         :param env_info str: The list of products to add in the files.
 709         '''
 710         self.config = config
 711         self.logger = logger
 712         self.out_dir = out_dir
 713         self.src_root= src_root
 714         self.silent = True
 715         self.env_info = env_info
 716
 717     def write_env_file(self, filename, forBuild, shell, for_package = None):
 718         """Create an environment file.
 719
 720         :param filename str: the file path
 721         :param forBuild bool: if true, the build environment
 722         :param shell str: the type of file wanted (.sh, .bat)
 723         :return: The path to the generated file
 724         :rtype: str
 725         """
 726         if not self.silent:
 727             self.logger.write(_("Create environment file %s\n") %
 728                               src.printcolors.printcLabel(filename), 3)
 729
 730         # create then env object
 731         env_file = open(os.path.join(self.out_dir, filename), "w")
 732         tmp = src.fileEnviron.get_file_environ(env_file,
 733                                                shell,
 734                                                {})
 735         env = SalomeEnviron(self.config, tmp, forBuild, for_package=for_package)
 736         env.silent = self.silent
 737
 738         # Set the environment
 739         if self.env_info is not None:
 740             env.set_full_environ(self.logger, self.env_info)
 741         else:
 742             # set env from the APPLICATION
 743             env.set_application_env(self.logger)
 744
 745             # The list of products to launch
 746             lProductsName = env.get_names(self.config.APPLICATION.products.keys())
 747             env.set( "SALOME_MODULES",    ','.join(lProductsName))
 748
 749             # set the products
 750             env.set_products(self.logger,
 751                             src_root=self.src_root)
 752
 753         # add cleanup and close
 754         env.finish(True)
 755         env_file.close()
 756
 757         return env_file.name
 758
 759     def write_cfgForPy_file(self,
 760                             filename,
 761                             additional_env = {},
 762                             for_package = None,
 763                             with_commercial = True):
 764         """Append to current opened aFile a cfgForPy
 765            environment (SALOME python launcher).
 766
 767         :param filename str: the file path
 768         :param additional_env dict: a dictionary of additional variables
 769                                     to add to the environment
 770         :param for_package str: If not None, produce a relative environment
 771                                 designed for a package.
 772         """
 773         if not self.silent:
 774             self.logger.write(_("Create configuration file %s\n") %
 775                               src.printcolors.printcLabel(filename.name), 3)
 776
 777         # create then env object
 778         tmp = src.fileEnviron.get_file_environ(filename,
 779                                                "cfgForPy",
 780                                                {})
 781         # environment for launch
 782         env = SalomeEnviron(self.config,
 783                             tmp,
 784                             forBuild=False,
 785                             for_package=for_package,
 786                             enable_simple_env_script = with_commercial)
 787         env.silent = self.silent
 788
 789         if self.env_info is not None:
 790             env.set_full_environ(self.logger, self.env_info)
 791         else:
 792             # set env from PRODUCT
 793             env.set_application_env(self.logger)
 794
 795             # The list of products to launch
 796             lProductsName = env.get_names(self.config.APPLICATION.products.keys())
 797             env.set( "SALOME_MODULES",    ','.join(lProductsName))
 798
 799             # set the products
 800             env.set_products(self.logger,
 801                             src_root=self.src_root)
 802
 803         # Add the additional environment if it is not empty
 804         if len(additional_env) != 0:
 805             for variable in additional_env:
 806                 env.set(variable, additional_env[variable])
 807
 808         # add cleanup and close
 809         env.finish(True)
 810
 811 class Shell:
 812     """Definition of a Shell.
 813     """
 814     def __init__(self, name, extension):
 815         '''Initialization.
 816
 817         :param name str: the shell name
 818         :param extension str: the shell extension
 819         '''
 820         self.name = name
 821         self.extension = extension
 822
 823 def load_environment(config, build, logger):
 824     """Loads the environment (used to run the tests, for example).
 825
 826     :param config Config: the global config
 827     :param build bool: build environement if True
 828     :param logger Logger: The logger instance to display messages
 829     """
 830     environ = SalomeEnviron(config, Environ(os.environ), build)
 831     environ.set_application_env(logger)
 832     environ.set_products(logger)
 833     environ.finish(True)