Salome HOME
small bug correction
[tools/sat.git] / commands / package.py
1 #!/usr/bin/env python
2 #-*- coding:utf-8 -*-
3 #  Copyright (C) 2010-2012  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 stat
21 import shutil
22 import datetime
23 import tarfile
24 import codecs
25 import string
26
27 import src
28
29 from application import get_SALOME_modules
30 import src.debug as DBG
31
32 BINARY = "binary"
33 SOURCE = "Source"
34 PROJECT = "Project"
35 SAT = "Sat"
36
37 ARCHIVE_DIR = "ARCHIVES"
38 PROJECT_DIR = "PROJECT"
39
40 IGNORED_DIRS = [".git", ".svn"]
41 IGNORED_EXTENSIONS = []
42
43 PROJECT_TEMPLATE = """#!/usr/bin/env python
44 #-*- coding:utf-8 -*-
45
46 # The path to the archive root directory
47 root_path : $PWD + "/../"
48 # path to the PROJECT
49 project_path : $PWD + "/"
50
51 # Where to search the archives of the products
52 ARCHIVEPATH : $root_path + "ARCHIVES"
53 # Where to search the pyconf of the applications
54 APPLICATIONPATH : $project_path + "applications/"
55 # Where to search the pyconf of the products
56 PRODUCTPATH : $project_path + "products/"
57 # Where to search the pyconf of the jobs of the project
58 JOBPATH : $project_path + "jobs/"
59 # Where to search the pyconf of the machines of the project
60 MACHINEPATH : $project_path + "machines/"
61 """
62
63 LOCAL_TEMPLATE = ("""#!/usr/bin/env python
64 #-*- coding:utf-8 -*-
65
66   LOCAL :
67   {
68     base : 'default'
69     workdir : 'default'
70     log_dir : 'default'
71     archive_dir : 'default'
72     VCS : None
73     tag : None
74   }
75
76 PROJECTS :
77 {
78 project_file_paths : [$VARS.salometoolsway + $VARS.sep + \"..\" + $VARS.sep"""
79 """ + \"""" + PROJECT_DIR + """\" + $VARS.sep + "project.pyconf"]
80 }
81 """)
82
83 # Define all possible option for the package command :  sat package <options>
84 parser = src.options.Options()
85 parser.add_option('b', 'binaries', 'boolean', 'binaries',
86     _('Optional: Produce a binary package.'), False)
87 parser.add_option('f', 'force_creation', 'boolean', 'force_creation',
88     _('Optional: Only binary package: produce the archive even if '
89       'there are some missing products.'), False)
90 parser.add_option('s', 'sources', 'boolean', 'sources',
91     _('Optional: Produce a compilable archive of the sources of the '
92       'application.'), False)
93 parser.add_option('', 'with_vcs', 'boolean', 'with_vcs',
94     _('Optional: Only source package: do not make archive of vcs products.'),
95     False)
96 parser.add_option('p', 'project', 'string', 'project',
97     _('Optional: Produce an archive that contains a project.'), "")
98 parser.add_option('t', 'salometools', 'boolean', 'sat',
99     _('Optional: Produce an archive that contains salomeTools.'), False)
100 parser.add_option('n', 'name', 'string', 'name',
101     _('Optional: The name or full path of the archive.'), None)
102 parser.add_option('', 'add_files', 'list2', 'add_files',
103     _('Optional: The list of additional files to add to the archive.'), [])
104 parser.add_option('', 'without_commercial', 'boolean', 'without_commercial',
105     _('Optional: do not add commercial licence.'), False)
106 parser.add_option('', 'without_property', 'string', 'without_property',
107     _('Optional: Filter the products by their properties.\n\tSyntax: '
108       '--without_property <property>:<value>'))
109
110
111 def add_files(tar, name_archive, d_content, logger, f_exclude=None):
112     '''Create an archive containing all directories and files that are given in
113        the d_content argument.
114     
115     :param tar tarfile: The tarfile instance used to make the archive.
116     :param name_archive str: The name of the archive to make.
117     :param d_content dict: The dictionary that contain all directories and files
118                            to add in the archive.
119                            d_content[label] = 
120                                         (path_on_local_machine, path_in_archive)
121     :param logger Logger: the logging instance
122     :param f_exclude Function: the function that filters
123     :return: 0 if success, 1 if not.
124     :rtype: int
125     '''
126     # get the max length of the messages in order to make the display
127     max_len = len(max(d_content.keys(), key=len))
128     
129     success = 0
130     # loop over each directory or file stored in the d_content dictionary
131     for name in sorted(d_content.keys()):
132         # display information
133         len_points = max_len - len(name)
134         logger.write(name + " " + len_points * "." + " ", 3)
135         # Get the local path and the path in archive 
136         # of the directory or file to add
137         local_path, archive_path = d_content[name]
138         in_archive = os.path.join(name_archive, archive_path)
139         # Add it in the archive
140         try:
141             tar.add(local_path, arcname=in_archive, exclude=f_exclude)
142             logger.write(src.printcolors.printcSuccess(_("OK")), 3)
143         except Exception as e:
144             logger.write(src.printcolors.printcError(_("KO ")), 3)
145             logger.write(str(e), 3)
146             success = 1
147         logger.write("\n", 3)
148     return success
149
150 def exclude_VCS_and_extensions(filename):
151     ''' The function that is used to exclude from package the link to the 
152         VCS repositories (like .git)
153
154     :param filename Str: The filname to exclude (or not).
155     :return: True if the file has to be exclude
156     :rtype: Boolean
157     '''
158     for dir_name in IGNORED_DIRS:
159         if dir_name in filename:
160             return True
161     for extension in IGNORED_EXTENSIONS:
162         if filename.endswith(extension):
163             return True
164     return False
165
166 def produce_relative_launcher(config,
167                               logger,
168                               file_dir,
169                               file_name,
170                               binaries_dir_name,
171                               with_commercial=True):
172     '''Create a specific SALOME launcher for the binary package. This launcher 
173        uses relative paths.
174     
175     :param config Config: The global configuration.
176     :param logger Logger: the logging instance
177     :param file_dir str: the directory where to put the launcher
178     :param file_name str: The launcher name
179     :param binaries_dir_name str: the name of the repository where the binaries
180                                   are, in the archive.
181     :return: the path of the produced launcher
182     :rtype: str
183     '''
184     
185     # get KERNEL installation path 
186     kernel_root_dir = os.path.join(binaries_dir_name, "KERNEL")
187
188     # set kernel bin dir (considering fhs property)
189     kernel_cfg = src.product.get_product_config(config, "KERNEL")
190     if src.get_property_in_product_cfg(kernel_cfg, "fhs"):
191         bin_kernel_install_dir = os.path.join(kernel_root_dir,"bin") 
192     else:
193         bin_kernel_install_dir = os.path.join(kernel_root_dir,"bin","salome") 
194
195     # Get the launcher template and do substitutions
196     withProfile = src.fileEnviron.withProfile
197
198     withProfile = withProfile.replace(
199         "ABSOLUTE_APPLI_PATH'] = 'KERNEL_INSTALL_DIR'",
200         "ABSOLUTE_APPLI_PATH'] = out_dir_Path + '" + config.VARS.sep + kernel_root_dir + "'")
201     withProfile = withProfile.replace(
202         " 'BIN_KERNEL_INSTALL_DIR'",
203         " out_dir_Path + '" + config.VARS.sep + bin_kernel_install_dir + "'")
204
205     before, after = withProfile.split(
206                                 "# here your local standalone environment\n")
207
208     # create an environment file writer
209     writer = src.environment.FileEnvWriter(config,
210                                            logger,
211                                            file_dir,
212                                            src_root=None)
213     
214     filepath = os.path.join(file_dir, file_name)
215     # open the file and write into it
216     launch_file = open(filepath, "w")
217     launch_file.write(before)
218     # Write
219     writer.write_cfgForPy_file(launch_file,
220                                for_package = binaries_dir_name,
221                                with_commercial=with_commercial)
222     launch_file.write(after)
223     launch_file.close()
224     
225     # Little hack to put out_dir_Path outside the strings
226     src.replace_in_file(filepath, 'r"out_dir_Path', 'out_dir_Path + r"' )
227     
228     # A hack to put a call to a file for distene licence.
229     # It does nothing to an application that has no distene product
230     hack_for_distene_licence(filepath)
231        
232     # change the rights in order to make the file executable for everybody
233     os.chmod(filepath,
234              stat.S_IRUSR |
235              stat.S_IRGRP |
236              stat.S_IROTH |
237              stat.S_IWUSR |
238              stat.S_IXUSR |
239              stat.S_IXGRP |
240              stat.S_IXOTH)
241
242     return filepath
243
244 def hack_for_distene_licence(filepath):
245     '''Replace the distene licence env variable by a call to a file.
246     
247     :param filepath Str: The path to the launcher to modify.
248     '''  
249     shutil.move(filepath, filepath + "_old")
250     fileout= filepath
251     filein = filepath + "_old"
252     fin = open(filein, "r")
253     fout = open(fileout, "w")
254     text = fin.readlines()
255     # Find the Distene section
256     num_line = -1
257     for i,line in enumerate(text):
258         if "# Set DISTENE License" in line:
259             num_line = i
260             break
261     if num_line == -1:
262         # No distene product, there is nothing to do
263         fin.close()
264         for line in text:
265             fout.write(line)
266         fout.close()
267         return
268     del text[num_line +1]
269     del text[num_line +1]
270     text_to_insert ="""    import imp
271     try:
272         distene = imp.load_source('distene_licence', '/data/tmpsalome/salome/prerequis/install/LICENSE/dlim8.var.py')
273         distene.set_distene_variables(context)
274     except:
275         pass\n"""
276     text.insert(num_line + 1, text_to_insert)
277     for line in text:
278         fout.write(line)
279     fin.close()    
280     fout.close()
281     return
282     
283 def produce_relative_env_files(config,
284                               logger,
285                               file_dir,
286                               binaries_dir_name):
287     '''Create some specific environment files for the binary package. These 
288        files use relative paths.
289     
290     :param config Config: The global configuration.
291     :param logger Logger: the logging instance
292     :param file_dir str: the directory where to put the files
293     :param binaries_dir_name str: the name of the repository where the binaries
294                                   are, in the archive.
295     :return: the list of path of the produced environment files
296     :rtype: List
297     '''  
298     # create an environment file writer
299     writer = src.environment.FileEnvWriter(config,
300                                            logger,
301                                            file_dir,
302                                            src_root=None)
303     
304     # Write
305     filepath = writer.write_env_file("env_launch.sh",
306                           False, # for launch
307                           "bash",
308                           for_package = binaries_dir_name)
309
310     # Little hack to put out_dir_Path as environment variable
311     src.replace_in_file(filepath, '"out_dir_Path', '"${out_dir_Path}' )
312
313     # change the rights in order to make the file executable for everybody
314     os.chmod(filepath,
315              stat.S_IRUSR |
316              stat.S_IRGRP |
317              stat.S_IROTH |
318              stat.S_IWUSR |
319              stat.S_IXUSR |
320              stat.S_IXGRP |
321              stat.S_IXOTH)
322     
323     return filepath
324
325 def produce_install_bin_file(config,
326                              logger,
327                              file_dir,
328                              d_sub,
329                              file_name):
330     '''Create a bash shell script which do substitutions in BIRARIES dir 
331        in order to use it for extra compilations.
332     
333     :param config Config: The global configuration.
334     :param logger Logger: the logging instance
335     :param file_dir str: the directory where to put the files
336     :param d_sub, dict: the dictionnary that contains the substitutions to be done
337     :param file_name str: the name of the install script file
338     :return: the produced file
339     :rtype: str
340     '''  
341     # Write
342     filepath = os.path.join(file_dir, file_name)
343     # open the file and write into it
344     # use codec utf-8 as sat variables are in unicode
345     with codecs.open(filepath, "w", 'utf-8') as installbin_file:
346         installbin_template_path = os.path.join(config.VARS.internal_dir,
347                                         "INSTALL_BIN.template")
348         
349         # build the name of the directory that will contain the binaries
350         binaries_dir_name = "BINARIES-" + config.VARS.dist
351         # build the substitution loop
352         loop_cmd = "for f in $(grep -RIl"
353         for key in d_sub:
354             loop_cmd += " -e "+ key
355         loop_cmd += ' INSTALL); do\n     sed -i "\n'
356         for key in d_sub:
357             loop_cmd += "        s?" + key + "?$(pwd)/" + d_sub[key] + "?g\n"
358         loop_cmd += '            " $f\ndone'
359
360         d={}
361         d["BINARIES_DIR"] = binaries_dir_name
362         d["SUBSTITUTION_LOOP"]=loop_cmd
363         
364         # substitute the template and write it in file
365         content=src.template.substitute(installbin_template_path, d)
366         installbin_file.write(content)
367         # change the rights in order to make the file executable for everybody
368         os.chmod(filepath,
369                  stat.S_IRUSR |
370                  stat.S_IRGRP |
371                  stat.S_IROTH |
372                  stat.S_IWUSR |
373                  stat.S_IXUSR |
374                  stat.S_IXGRP |
375                  stat.S_IXOTH)
376     
377     return filepath
378
379 def product_appli_creation_script(config,
380                                   logger,
381                                   file_dir,
382                                   binaries_dir_name):
383     '''Create a script that can produce an application (EDF style) in the binary
384        package.
385     
386     :param config Config: The global configuration.
387     :param logger Logger: the logging instance
388     :param file_dir str: the directory where to put the file
389     :param binaries_dir_name str: the name of the repository where the binaries
390                                   are, in the archive.
391     :return: the path of the produced script file
392     :rtype: Str
393     '''
394     template_name = "create_appli.py.for_bin_packages.template"
395     template_path = os.path.join(config.VARS.internal_dir, template_name)
396     text_to_fill = open(template_path, "r").read()
397     text_to_fill = text_to_fill.replace("TO BE FILLED 1",
398                                         '"' + binaries_dir_name + '"')
399     
400     text_to_add = ""
401     for product_name in get_SALOME_modules(config):
402         product_info = src.product.get_product_config(config, product_name)
403        
404         if src.product.product_is_smesh_plugin(product_info):
405             continue
406
407         if 'install_dir' in product_info and bool(product_info.install_dir):
408             if src.product.product_is_cpp(product_info):
409                 # cpp module
410                 for cpp_name in src.product.get_product_components(product_info):
411                     line_to_add = ("<module name=\"" + 
412                                    cpp_name + 
413                                    "\" gui=\"yes\" path=\"''' + "
414                                    "os.path.join(dir_bin_name, \"" + 
415                                    cpp_name + "\") + '''\"/>")
416             else:
417                 # regular module
418                 line_to_add = ("<module name=\"" + 
419                                product_name + 
420                                "\" gui=\"yes\" path=\"''' + "
421                                "os.path.join(dir_bin_name, \"" + 
422                                product_name + "\") + '''\"/>")
423             text_to_add += line_to_add + "\n"
424     
425     filled_text = text_to_fill.replace("TO BE FILLED 2", text_to_add)
426     
427     tmp_file_path = os.path.join(file_dir, "create_appli.py")
428     ff = open(tmp_file_path, "w")
429     ff.write(filled_text)
430     ff.close()
431     
432     # change the rights in order to make the file executable for everybody
433     os.chmod(tmp_file_path,
434              stat.S_IRUSR |
435              stat.S_IRGRP |
436              stat.S_IROTH |
437              stat.S_IWUSR |
438              stat.S_IXUSR |
439              stat.S_IXGRP |
440              stat.S_IXOTH)
441     
442     return tmp_file_path
443
444 def binary_package(config, logger, options, tmp_working_dir):
445     '''Prepare a dictionary that stores all the needed directories and files to
446        add in a binary package.
447     
448     :param config Config: The global configuration.
449     :param logger Logger: the logging instance
450     :param options OptResult: the options of the launched command
451     :param tmp_working_dir str: The temporary local directory containing some 
452                                 specific directories or files needed in the 
453                                 binary package
454     :return: the dictionary that stores all the needed directories and files to
455              add in a binary package.
456              {label : (path_on_local_machine, path_in_archive)}
457     :rtype: dict
458     '''
459
460     # Get the list of product installation to add to the archive
461     l_products_name = sorted(config.APPLICATION.products.keys())
462     l_product_info = src.product.get_products_infos(l_products_name,
463                                                     config)
464     l_install_dir = []
465     l_source_dir = []
466     l_not_installed = []
467     l_sources_not_present = []
468     for prod_name, prod_info in l_product_info:
469
470         # Add the sources of the products that have the property 
471         # sources_in_package : "yes"
472         if src.get_property_in_product_cfg(prod_info,
473                                            "sources_in_package") == "yes":
474             if os.path.exists(prod_info.source_dir):
475                 l_source_dir.append((prod_name, prod_info.source_dir))
476             else:
477                 l_sources_not_present.append(prod_name)
478
479         # ignore the native and fixed products for install directories
480         if (src.product.product_is_native(prod_info) 
481                 or src.product.product_is_fixed(prod_info)
482                 or not src.product.product_compiles(prod_info)):
483             continue
484         if src.product.check_installation(prod_info):
485             l_install_dir.append((prod_name, prod_info.install_dir))
486         else:
487             l_not_installed.append(prod_name)
488         
489         # Add also the cpp generated modules (if any)
490         if src.product.product_is_cpp(prod_info):
491             # cpp module
492             for name_cpp in src.product.get_product_components(prod_info):
493                 install_dir = os.path.join(config.APPLICATION.workdir,
494                                            "INSTALL", name_cpp) 
495                 if os.path.exists(install_dir):
496                     l_install_dir.append((name_cpp, install_dir))
497                 else:
498                     l_not_installed.append(name_cpp)
499         
500     # check the name of the directory that (could) contains the binaries 
501     # from previous detar
502     binaries_from_detar = os.path.join(config.APPLICATION.workdir, "BINARIES-" + config.VARS.dist)
503     if os.path.exists(binaries_from_detar):
504          logger.write("""
505 WARNING: existing binaries directory from previous detar installation:
506          %s
507          To make new package from this, you have to: 
508          1) install binaries in INSTALL directory with the script "install_bin.sh" 
509             see README file for more details
510          2) or recompile everything in INSTALL with "sat compile" command 
511             this step is long, and requires some linux packages to be installed 
512             on your system\n
513 """ % binaries_from_detar)
514     
515     # Print warning or error if there are some missing products
516     if len(l_not_installed) > 0:
517         text_missing_prods = ""
518         for p_name in l_not_installed:
519             text_missing_prods += "-" + p_name + "\n"
520         if not options.force_creation:
521             msg = _("ERROR: there are missing products installations:")
522             logger.write("%s\n%s" % (src.printcolors.printcError(msg),
523                                      text_missing_prods),
524                          1)
525             return None
526         else:
527             msg = _("WARNING: there are missing products installations:")
528             logger.write("%s\n%s" % (src.printcolors.printcWarning(msg),
529                                      text_missing_prods),
530                          1)
531
532     # Do the same for sources
533     if len(l_sources_not_present) > 0:
534         text_missing_prods = ""
535         for p_name in l_sources_not_present:
536             text_missing_prods += "-" + p_name + "\n"
537         if not options.force_creation:
538             msg = _("ERROR: there are missing products sources:")
539             logger.write("%s\n%s" % (src.printcolors.printcError(msg),
540                                      text_missing_prods),
541                          1)
542             return None
543         else:
544             msg = _("WARNING: there are missing products sources:")
545             logger.write("%s\n%s" % (src.printcolors.printcWarning(msg),
546                                      text_missing_prods),
547                          1)
548  
549     # construct the name of the directory that will contain the binaries
550     binaries_dir_name = "BINARIES-" + config.VARS.dist
551     
552     # construct the correlation table between the product names, there 
553     # actual install directories and there install directory in archive
554     d_products = {}
555     for prod_name, install_dir in l_install_dir:
556         path_in_archive = os.path.join(binaries_dir_name, prod_name)
557         d_products[prod_name + " (bin)"] = (install_dir, path_in_archive)
558         
559     for prod_name, source_dir in l_source_dir:
560         path_in_archive = os.path.join("SOURCES", prod_name)
561         d_products[prod_name + " (sources)"] = (source_dir, path_in_archive)
562
563     # for packages of SALOME applications including KERNEL, 
564     # we produce a salome launcher or a virtual application (depending on salome version)
565     if 'KERNEL' in config.APPLICATION.products:
566         VersionSalome = src.get_salome_version(config)
567         # Case where SALOME has the launcher that uses the SalomeContext API
568         if VersionSalome >= 730:
569             # create the relative launcher and add it to the files to add
570             launcher_name = src.get_launcher_name(config)
571             launcher_package = produce_relative_launcher(config,
572                                                  logger,
573                                                  tmp_working_dir,
574                                                  launcher_name,
575                                                  binaries_dir_name,
576                                                  not(options.without_commercial))
577         
578             d_products["launcher"] = (launcher_package, launcher_name)
579             if options.sources:
580                 # if we mix binaries and sources, we add a copy of the launcher, 
581                 # prefixed  with "bin",in order to avoid clashes
582                 d_products["launcher (copy)"] = (launcher_package, "bin"+launcher_name)
583         else:
584             # Provide a script for the creation of an application EDF style
585             appli_script = product_appli_creation_script(config,
586                                                         logger,
587                                                         tmp_working_dir,
588                                                         binaries_dir_name)
589             
590             d_products["appli script"] = (appli_script, "create_appli.py")
591
592     # Put also the environment file
593     env_file = produce_relative_env_files(config,
594                                            logger,
595                                            tmp_working_dir,
596                                            binaries_dir_name)
597
598     d_products["environment file"] = (env_file, "env_launch.sh")
599       
600     return d_products
601
602 def source_package(sat, config, logger, options, tmp_working_dir):
603     '''Prepare a dictionary that stores all the needed directories and files to
604        add in a source package.
605     
606     :param config Config: The global configuration.
607     :param logger Logger: the logging instance
608     :param options OptResult: the options of the launched command
609     :param tmp_working_dir str: The temporary local directory containing some 
610                                 specific directories or files needed in the 
611                                 binary package
612     :return: the dictionary that stores all the needed directories and files to
613              add in a source package.
614              {label : (path_on_local_machine, path_in_archive)}
615     :rtype: dict
616     '''
617     
618     # Get all the products that are prepared using an archive
619     logger.write("Find archive products ... ")
620     d_archives, l_pinfo_vcs = get_archives(config, logger)
621     logger.write("Done\n")
622     d_archives_vcs = {}
623     if not options.with_vcs and len(l_pinfo_vcs) > 0:
624         # Make archives with the products that are not prepared using an archive
625         # (git, cvs, svn, etc)
626         logger.write("Construct archives for vcs products ... ")
627         d_archives_vcs = get_archives_vcs(l_pinfo_vcs,
628                                           sat,
629                                           config,
630                                           logger,
631                                           tmp_working_dir)
632         logger.write("Done\n")
633
634     # Create a project
635     logger.write("Create the project ... ")
636     d_project = create_project_for_src_package(config,
637                                                 tmp_working_dir,
638                                                 options.with_vcs)
639     logger.write("Done\n")
640     
641     # Add salomeTools
642     tmp_sat = add_salomeTools(config, tmp_working_dir)
643     d_sat = {"salomeTools" : (tmp_sat, "salomeTools")}
644     
645     # Add a sat symbolic link if not win
646     if not src.architecture.is_windows():
647         tmp_satlink_path = os.path.join(tmp_working_dir, 'sat')
648         try:
649             t = os.getcwd()
650         except:
651             # In the jobs, os.getcwd() can fail
652             t = config.LOCAL.workdir
653         os.chdir(tmp_working_dir)
654         if os.path.lexists(tmp_satlink_path):
655             os.remove(tmp_satlink_path)
656         os.symlink(os.path.join('salomeTools', 'sat'), 'sat')
657         os.chdir(t)
658         
659         d_sat["sat link"] = (tmp_satlink_path, "sat")
660     
661     d_source = src.merge_dicts(d_archives, d_archives_vcs, d_project, d_sat)
662     return d_source
663
664 def get_archives(config, logger):
665     '''Find all the products that are get using an archive and all the products
666        that are get using a vcs (git, cvs, svn) repository.
667     
668     :param config Config: The global configuration.
669     :param logger Logger: the logging instance
670     :return: the dictionary {name_product : 
671              (local path of its archive, path in the package of its archive )}
672              and the list of specific configuration corresponding to the vcs 
673              products
674     :rtype: (Dict, List)
675     '''
676     # Get the list of product informations
677     l_products_name = config.APPLICATION.products.keys()
678     l_product_info = src.product.get_products_infos(l_products_name,
679                                                     config)
680     d_archives = {}
681     l_pinfo_vcs = []
682     for p_name, p_info in l_product_info:
683         # ignore the native and fixed products
684         if (src.product.product_is_native(p_info) 
685                 or src.product.product_is_fixed(p_info)):
686             continue
687         if p_info.get_source == "archive":
688             archive_path = p_info.archive_info.archive_name
689             archive_name = os.path.basename(archive_path)
690         else:
691             l_pinfo_vcs.append((p_name, p_info))
692             
693         d_archives[p_name] = (archive_path,
694                               os.path.join(ARCHIVE_DIR, archive_name))
695     return d_archives, l_pinfo_vcs
696
697 def add_salomeTools(config, tmp_working_dir):
698     '''Prepare a version of salomeTools that has a specific local.pyconf file 
699        configured for a source package.
700
701     :param config Config: The global configuration.
702     :param tmp_working_dir str: The temporary local directory containing some 
703                                 specific directories or files needed in the 
704                                 source package
705     :return: The path to the local salomeTools directory to add in the package
706     :rtype: str
707     '''
708     # Copy sat in the temporary working directory
709     sat_tmp_path = src.Path(os.path.join(tmp_working_dir, "salomeTools"))
710     sat_running_path = src.Path(config.VARS.salometoolsway)
711     sat_running_path.copy(sat_tmp_path)
712     
713     # Update the local.pyconf file that contains the path to the project
714     local_pyconf_name = "local.pyconf"
715     local_pyconf_dir = os.path.join(tmp_working_dir, "salomeTools", "data")
716     local_pyconf_file = os.path.join(local_pyconf_dir, local_pyconf_name)
717     # Remove the .pyconf file in the root directory of salomeTools if there is
718     # any. (For example when launching jobs, a pyconf file describing the jobs 
719     # can be here and is not useful) 
720     files_or_dir_SAT = os.listdir(os.path.join(tmp_working_dir, "salomeTools"))
721     for file_or_dir in files_or_dir_SAT:
722         if file_or_dir.endswith(".pyconf") or file_or_dir.endswith(".txt"):
723             file_path = os.path.join(tmp_working_dir,
724                                      "salomeTools",
725                                      file_or_dir)
726             os.remove(file_path)
727     
728     ff = open(local_pyconf_file, "w")
729     ff.write(LOCAL_TEMPLATE)
730     ff.close()
731     
732     return sat_tmp_path.path
733
734 def get_archives_vcs(l_pinfo_vcs, sat, config, logger, tmp_working_dir):
735     '''For sources package that require that all products are get using an 
736        archive, one has to create some archive for the vcs products.
737        So this method calls the clean and source command of sat and then create
738        the archives.
739
740     :param l_pinfo_vcs List: The list of specific configuration corresponding to
741                              each vcs product
742     :param sat Sat: The Sat instance that can be called to clean and source the
743                     products
744     :param config Config: The global configuration.
745     :param logger Logger: the logging instance
746     :param tmp_working_dir str: The temporary local directory containing some 
747                                 specific directories or files needed in the 
748                                 source package
749     :return: the dictionary that stores all the archives to add in the source 
750              package. {label : (path_on_local_machine, path_in_archive)}
751     :rtype: dict
752     '''
753     # clean the source directory of all the vcs products, then use the source 
754     # command and thus construct an archive that will not contain the patches
755     l_prod_names = [pn for pn, __ in l_pinfo_vcs]
756     # clean
757     logger.write(_("clean sources\n"))
758     args_clean = config.VARS.application
759     args_clean += " --sources --products "
760     args_clean += ",".join(l_prod_names)
761     sat.clean(args_clean, batch=True, verbose=0, logger_add_link = logger)
762     # source
763     logger.write(_("get sources"))
764     args_source = config.VARS.application
765     args_source += " --products "
766     args_source += ",".join(l_prod_names)
767     sat.source(args_source, batch=True, verbose=0, logger_add_link = logger)
768
769     # make the new archives
770     d_archives_vcs = {}
771     for pn, pinfo in l_pinfo_vcs:
772         path_archive = make_archive(pn, pinfo, tmp_working_dir)
773         d_archives_vcs[pn] = (path_archive,
774                               os.path.join(ARCHIVE_DIR, pn + ".tgz"))
775     return d_archives_vcs
776
777 def make_archive(prod_name, prod_info, where):
778     '''Create an archive of a product by searching its source directory.
779
780     :param prod_name str: The name of the product.
781     :param prod_info Config: The specific configuration corresponding to the 
782                              product
783     :param where str: The path of the repository where to put the resulting 
784                       archive
785     :return: The path of the resulting archive
786     :rtype: str
787     '''
788     path_targz_prod = os.path.join(where, prod_name + ".tgz")
789     tar_prod = tarfile.open(path_targz_prod, mode='w:gz')
790     local_path = prod_info.source_dir
791     tar_prod.add(local_path,
792                  arcname=prod_name,
793                  exclude=exclude_VCS_and_extensions)
794     tar_prod.close()
795     return path_targz_prod       
796
797 def create_project_for_src_package(config, tmp_working_dir, with_vcs):
798     '''Create a specific project for a source package.
799
800     :param config Config: The global configuration.
801     :param tmp_working_dir str: The temporary local directory containing some 
802                                 specific directories or files needed in the 
803                                 source package
804     :param with_vcs boolean: True if the package is with vcs products (not 
805                              transformed into archive products)
806     :return: The dictionary 
807              {"project" : (produced project, project path in the archive)}
808     :rtype: Dict
809     '''
810
811     # Create in the working temporary directory the full project tree
812     project_tmp_dir = os.path.join(tmp_working_dir, PROJECT_DIR)
813     products_pyconf_tmp_dir = os.path.join(project_tmp_dir,
814                                          "products")
815     compil_scripts_tmp_dir = os.path.join(project_tmp_dir,
816                                          "products",
817                                          "compil_scripts")
818     env_scripts_tmp_dir = os.path.join(project_tmp_dir,
819                                          "products",
820                                          "env_scripts")
821     patches_tmp_dir = os.path.join(project_tmp_dir,
822                                          "products",
823                                          "patches")
824     application_tmp_dir = os.path.join(project_tmp_dir,
825                                          "applications")
826     for directory in [project_tmp_dir,
827                       compil_scripts_tmp_dir,
828                       env_scripts_tmp_dir,
829                       patches_tmp_dir,
830                       application_tmp_dir]:
831         src.ensure_path_exists(directory)
832
833     # Create the pyconf that contains the information of the project
834     project_pyconf_name = "project.pyconf"        
835     project_pyconf_file = os.path.join(project_tmp_dir, project_pyconf_name)
836     ff = open(project_pyconf_file, "w")
837     ff.write(PROJECT_TEMPLATE)
838     ff.close()
839     
840     # Loop over the products to get there pyconf and all the scripts 
841     # (compilation, environment, patches)
842     # and create the pyconf file to add to the project
843     lproducts_name = config.APPLICATION.products.keys()
844     l_products = src.product.get_products_infos(lproducts_name, config)
845     for p_name, p_info in l_products:
846         find_product_scripts_and_pyconf(p_name,
847                                         p_info,
848                                         config,
849                                         with_vcs,
850                                         compil_scripts_tmp_dir,
851                                         env_scripts_tmp_dir,
852                                         patches_tmp_dir,
853                                         products_pyconf_tmp_dir)
854     
855     find_application_pyconf(config, application_tmp_dir)
856     
857     d_project = {"project" : (project_tmp_dir, PROJECT_DIR )}
858     return d_project
859
860 def find_product_scripts_and_pyconf(p_name,
861                                     p_info,
862                                     config,
863                                     with_vcs,
864                                     compil_scripts_tmp_dir,
865                                     env_scripts_tmp_dir,
866                                     patches_tmp_dir,
867                                     products_pyconf_tmp_dir):
868     '''Create a specific pyconf file for a given product. Get its environment 
869        script, its compilation script and patches and put it in the temporary
870        working directory. This method is used in the source package in order to
871        construct the specific project.
872
873     :param p_name str: The name of the product.
874     :param p_info Config: The specific configuration corresponding to the 
875                              product
876     :param config Config: The global configuration.
877     :param with_vcs boolean: True if the package is with vcs products (not 
878                              transformed into archive products)
879     :param compil_scripts_tmp_dir str: The path to the temporary compilation 
880                                        scripts directory of the project.
881     :param env_scripts_tmp_dir str: The path to the temporary environment script 
882                                     directory of the project.
883     :param patches_tmp_dir str: The path to the temporary patch scripts 
884                                 directory of the project.
885     :param products_pyconf_tmp_dir str: The path to the temporary product 
886                                         scripts directory of the project.
887     '''
888     
889     # read the pyconf of the product
890     product_pyconf_path = src.find_file_in_lpath(p_name + ".pyconf",
891                                            config.PATHS.PRODUCTPATH)
892     product_pyconf_cfg = src.pyconf.Config(product_pyconf_path)
893
894     # find the compilation script if any
895     if src.product.product_has_script(p_info):
896         compil_script_path = src.Path(p_info.compil_script)
897         compil_script_path.copy(compil_scripts_tmp_dir)
898         product_pyconf_cfg[p_info.section].compil_script = os.path.basename(
899                                                     p_info.compil_script)
900     # find the environment script if any
901     if src.product.product_has_env_script(p_info):
902         env_script_path = src.Path(p_info.environ.env_script)
903         env_script_path.copy(env_scripts_tmp_dir)
904         product_pyconf_cfg[p_info.section].environ.env_script = os.path.basename(
905                                                 p_info.environ.env_script)
906     # find the patches if any
907     if src.product.product_has_patches(p_info):
908         patches = src.pyconf.Sequence()
909         for patch_path in p_info.patches:
910             p_path = src.Path(patch_path)
911             p_path.copy(patches_tmp_dir)
912             patches.append(os.path.basename(patch_path), "")
913
914         product_pyconf_cfg[p_info.section].patches = patches
915     
916     if with_vcs:
917         # put in the pyconf file the resolved values
918         for info in ["git_info", "cvs_info", "svn_info"]:
919             if info in p_info:
920                 for key in p_info[info]:
921                     product_pyconf_cfg[p_info.section][info][key] = p_info[
922                                                                       info][key]
923     else:
924         # if the product is not archive, then make it become archive.
925         if src.product.product_is_vcs(p_info):
926             product_pyconf_cfg[p_info.section].get_source = "archive"
927             if not "archive_info" in product_pyconf_cfg[p_info.section]:
928                 product_pyconf_cfg[p_info.section].addMapping("archive_info",
929                                         src.pyconf.Mapping(product_pyconf_cfg),
930                                         "")
931             product_pyconf_cfg[p_info.section
932                               ].archive_info.archive_name = p_info.name + ".tgz"
933     
934     # write the pyconf file to the temporary project location
935     product_tmp_pyconf_path = os.path.join(products_pyconf_tmp_dir,
936                                            p_name + ".pyconf")
937     ff = open(product_tmp_pyconf_path, 'w')
938     ff.write("#!/usr/bin/env python\n#-*- coding:utf-8 -*-\n\n")
939     product_pyconf_cfg.__save__(ff, 1)
940     ff.close()
941
942 def find_application_pyconf(config, application_tmp_dir):
943     '''Find the application pyconf file and put it in the specific temporary 
944        directory containing the specific project of a source package.
945
946     :param config Config: The global configuration.
947     :param application_tmp_dir str: The path to the temporary application 
948                                        scripts directory of the project.
949     '''
950     # read the pyconf of the application
951     application_name = config.VARS.application
952     application_pyconf_path = src.find_file_in_lpath(
953                                             application_name + ".pyconf",
954                                             config.PATHS.APPLICATIONPATH)
955     application_pyconf_cfg = src.pyconf.Config(application_pyconf_path)
956     
957     # Change the workdir
958     application_pyconf_cfg.APPLICATION.workdir = src.pyconf.Reference(
959                                     application_pyconf_cfg,
960                                     src.pyconf.DOLLAR,
961                                     'VARS.salometoolsway + $VARS.sep + ".."')
962
963     # Prevent from compilation in base
964     application_pyconf_cfg.APPLICATION.no_base = "yes"
965     
966     # write the pyconf file to the temporary application location
967     application_tmp_pyconf_path = os.path.join(application_tmp_dir,
968                                                application_name + ".pyconf")
969     ff = open(application_tmp_pyconf_path, 'w')
970     ff.write("#!/usr/bin/env python\n#-*- coding:utf-8 -*-\n\n")
971     application_pyconf_cfg.__save__(ff, 1)
972     ff.close()
973
974 def project_package(config, name_project, project_file_path, tmp_working_dir, logger):
975     '''Prepare a dictionary that stores all the needed directories and files to
976        add in a project package.
977     
978     :param project_file_path str: The path to the local project.
979     :param tmp_working_dir str: The temporary local directory containing some 
980                                 specific directories or files needed in the 
981                                 project package
982     :return: the dictionary that stores all the needed directories and files to
983              add in a project package.
984              {label : (path_on_local_machine, path_in_archive)}
985     :rtype: dict
986     '''
987     d_project = {}
988     # Read the project file and get the directories to add to the package
989     
990     try: 
991       project_pyconf_cfg = config.PROJECTS.projects.__getattr__(name_project)
992     except:
993       logger.write("""
994 WARNING: inexisting config.PROJECTS.projects.%s, try to read now from:\n%s\n""" % (name_project, project_file_path))
995       project_pyconf_cfg = src.pyconf.Config(project_file_path)
996       project_pyconf_cfg.PWD = os.path.dirname(project_file_path)
997     
998     paths = {"ARCHIVEPATH" : "archives",
999              "APPLICATIONPATH" : "applications",
1000              "PRODUCTPATH" : "products",
1001              "JOBPATH" : "jobs",
1002              "MACHINEPATH" : "machines"}
1003     # Loop over the project paths and add it
1004     for path in paths:
1005         if path not in project_pyconf_cfg:
1006             continue
1007         # Add the directory to the files to add in the package
1008         d_project[path] = (project_pyconf_cfg[path], paths[path])
1009         # Modify the value of the path in the package
1010         project_pyconf_cfg[path] = src.pyconf.Reference(
1011                                     project_pyconf_cfg,
1012                                     src.pyconf.DOLLAR,
1013                                     'project_path + "/' + paths[path] + '"')
1014     
1015     # Modify some values
1016     if "project_path" not in project_pyconf_cfg:
1017         project_pyconf_cfg.addMapping("project_path",
1018                                       src.pyconf.Mapping(project_pyconf_cfg),
1019                                       "")
1020     project_pyconf_cfg.project_path = src.pyconf.Reference(project_pyconf_cfg,
1021                                                            src.pyconf.DOLLAR,
1022                                                            'PWD')
1023     
1024     # Write the project pyconf file
1025     project_file_name = os.path.basename(project_file_path)
1026     project_pyconf_tmp_path = os.path.join(tmp_working_dir, project_file_name)
1027     ff = open(project_pyconf_tmp_path, 'w')
1028     ff.write("#!/usr/bin/env python\n#-*- coding:utf-8 -*-\n\n")
1029     project_pyconf_cfg.__save__(ff, 1)
1030     ff.close()
1031     d_project["Project hat file"] = (project_pyconf_tmp_path, project_file_name)
1032     
1033     return d_project
1034
1035 def add_readme(config, options, where):
1036     readme_path = os.path.join(where, "README")
1037     with codecs.open(readme_path, "w", 'utf-8') as f:
1038
1039     # templates for building the header
1040         readme_header="""
1041 # This package was generated with sat $version
1042 # Date: $date
1043 # User: $user
1044 # Distribution : $dist
1045
1046 In the following, $$ROOT represents the directory where you have installed 
1047 SALOME (the directory where this file is located).
1048
1049 """
1050         readme_compilation_with_binaries="""
1051
1052 compilation based on the binaries used as prerequisites
1053 =======================================================
1054
1055 If you fail to compile the complete application (for example because
1056 you are not root on your system and cannot install missing packages), you
1057 may try a partial compilation based on the binaries.
1058 For that it is necessary to copy the binaries from BINARIES to INSTALL,
1059 and do some substitutions on cmake and .la files (replace the build directories
1060 with local paths).
1061 The procedure to do it is:
1062  1) Remove or rename INSTALL directory if it exists
1063  2) Execute the shell script install_bin.sh:
1064  > cd $ROOT
1065  > ./install_bin.sh
1066  3) Use SalomeTool (as explained in Sources section) and compile only the 
1067     modules you need to (with -p option)
1068
1069 """
1070         readme_header_tpl=string.Template(readme_header)
1071         readme_template_path_bin = os.path.join(config.VARS.internal_dir,
1072                 "README_BIN.template")
1073         readme_template_path_bin_launcher = os.path.join(config.VARS.internal_dir,
1074                 "README_LAUNCHER.template")
1075         readme_template_path_bin_virtapp = os.path.join(config.VARS.internal_dir,
1076                 "README_BIN_VIRTUAL_APP.template")
1077         readme_template_path_src = os.path.join(config.VARS.internal_dir,
1078                 "README_SRC.template")
1079         readme_template_path_pro = os.path.join(config.VARS.internal_dir,
1080                 "README_PROJECT.template")
1081         readme_template_path_sat = os.path.join(config.VARS.internal_dir,
1082                 "README_SAT.template")
1083
1084         # prepare substitution dictionary
1085         d = dict()
1086         d['user'] = config.VARS.user
1087         d['date'] = datetime.datetime.now().strftime("%Y-%m-%d %H:%M")
1088         d['version'] = config.INTERNAL.sat_version
1089         d['dist'] = config.VARS.dist
1090         f.write(readme_header_tpl.substitute(d)) # write the general header (common)
1091
1092         if options.binaries or options.sources:
1093             d['application'] = config.VARS.application
1094             f.write("# Application: " + d['application'] + "\n")
1095             if 'KERNEL' in config.APPLICATION.products:
1096                 VersionSalome = src.get_salome_version(config)
1097                 # Case where SALOME has the launcher that uses the SalomeContext API
1098                 if VersionSalome >= 730:
1099                     d['launcher'] = config.APPLICATION.profile.launcher_name
1100                 else:
1101                     d['virtual_app'] = 'runAppli' # this info is not used now)
1102
1103         # write the specific sections
1104         if options.binaries:
1105             f.write(src.template.substitute(readme_template_path_bin, d))
1106             if "virtual_app" in d:
1107                 f.write(src.template.substitute(readme_template_path_bin_virtapp, d))
1108             if "launcher" in d:
1109                 f.write(src.template.substitute(readme_template_path_bin_launcher, d))
1110
1111         if options.sources:
1112             f.write(src.template.substitute(readme_template_path_src, d))
1113
1114         if options.binaries and options.sources:
1115             f.write(readme_compilation_with_binaries)
1116
1117         if options.project:
1118             f.write(src.template.substitute(readme_template_path_pro, d))
1119
1120         if options.sat:
1121             f.write(src.template.substitute(readme_template_path_sat, d))
1122     
1123     return readme_path
1124
1125 def update_config(config, prop, value):
1126     '''Remove from config.APPLICATION.products the products that have the property given as input.
1127     
1128     :param config Config: The global config.
1129     :param prop str: The property to filter
1130     :param value str: The value of the property to filter
1131     '''
1132     src.check_config_has_application(config)
1133     l_product_to_remove = []
1134     for product_name in config.APPLICATION.products.keys():
1135         prod_cfg = src.product.get_product_config(config, product_name)
1136         if src.get_property_in_product_cfg(prod_cfg, prop) == value:
1137             l_product_to_remove.append(product_name)
1138     for product_name in l_product_to_remove:
1139         config.APPLICATION.products.__delitem__(product_name)
1140
1141 def description():
1142     '''method that is called when salomeTools is called with --help option.
1143     
1144     :return: The text to display for the package command description.
1145     :rtype: str
1146     '''
1147     return _("The package command creates an archive.\nThere are 4 kinds of "
1148              "archive, which can be mixed:\n  1- The binary archive. It contains all the product "
1149              "installation directories and a launcher,\n  2- The sources archive."
1150              " It contains the products archives, a project corresponding to "
1151              "the application and salomeTools,\n  3- The project archive. It "
1152              "contains a project (give the project file path as argument),\n  4-"
1153              " The salomeTools archive. It contains salomeTools.\n\nexample:"
1154              "\nsat package SALOME-master --bineries --sources")
1155   
1156 def run(args, runner, logger):
1157     '''method that is called when salomeTools is called with package parameter.
1158     '''
1159     
1160     # Parse the options
1161     (options, args) = parser.parse_args(args)
1162
1163     # Check that a type of package is called, and only one
1164     all_option_types = (options.binaries,
1165                         options.sources,
1166                         options.project not in ["", None],
1167                         options.sat)
1168
1169     # Check if no option for package type
1170     if all_option_types.count(True) == 0:
1171         msg = _("Error: Precise a type for the package\nUse one of the "
1172                 "following options: --binaries, --sources, --project or"
1173                 " --salometools")
1174         logger.write(src.printcolors.printcError(msg), 1)
1175         logger.write("\n", 1)
1176         return 1
1177     
1178     # The repository where to put the package if not Binary or Source
1179     package_default_path = runner.cfg.LOCAL.workdir
1180     
1181     # if the package contains binaries or sources:
1182     if options.binaries or options.sources:
1183         # Check that the command has been called with an application
1184         src.check_config_has_application(runner.cfg)
1185
1186         # Display information
1187         logger.write(_("Packaging application %s\n") % src.printcolors.printcLabel(
1188                                                     runner.cfg.VARS.application), 1)
1189         
1190         # Get the default directory where to put the packages
1191         package_default_path = os.path.join(runner.cfg.APPLICATION.workdir,
1192                                             "PACKAGE")
1193         src.ensure_path_exists(package_default_path)
1194         
1195     # if the package contains a project:
1196     if options.project:
1197         # check that the project is visible by SAT
1198         projectNameFile = options.project + ".pyconf"
1199         foundProject = None
1200         for i in runner.cfg.PROJECTS.project_file_paths:
1201             baseName = os.path.basename(i)
1202             if baseName == projectNameFile:
1203                 foundProject = i
1204                 break
1205
1206         if foundProject is None:
1207             local_path = os.path.join(runner.cfg.VARS.salometoolsway,
1208                                      "data",
1209                                      "local.pyconf")
1210             msg = _("""ERROR: the project %(1)s is not visible by salomeTools.
1211 known projects are:
1212 %(2)s
1213
1214 Please add it in file:
1215 %(3)s""" % \
1216                     {"1": options.project, "2": "\n  ".join(runner.cfg.PROJECTS.project_file_paths), "3": local_path})
1217             logger.write(src.printcolors.printcError(msg), 1)
1218             logger.write("\n", 1)
1219             return 1
1220         else:
1221             options.project_file_path = foundProject
1222             src.printcolors.print_value(logger, "Project path", options.project_file_path, 2)
1223     
1224     # Remove the products that are filtered by the --without_property option
1225     if options.without_property:
1226         [prop, value] = options.without_property.split(":")
1227         update_config(runner.cfg, prop, value)
1228     
1229     # get the name of the archive or build it
1230     if options.name:
1231         if os.path.basename(options.name) == options.name:
1232             # only a name (not a path)
1233             archive_name = options.name           
1234             dir_name = package_default_path
1235         else:
1236             archive_name = os.path.basename(options.name)
1237             dir_name = os.path.dirname(options.name)
1238         
1239         # suppress extension
1240         if archive_name[-len(".tgz"):] == ".tgz":
1241             archive_name = archive_name[:-len(".tgz")]
1242         if archive_name[-len(".tar.gz"):] == ".tar.gz":
1243             archive_name = archive_name[:-len(".tar.gz")]
1244         
1245     else:
1246         archive_name=""
1247         dir_name = package_default_path
1248         if options.binaries or options.sources:
1249             archive_name = runner.cfg.APPLICATION.name
1250
1251         if options.binaries:
1252             archive_name += "-"+runner.cfg.VARS.dist
1253             
1254         if options.sources:
1255             archive_name += "-SRC"
1256             if options.with_vcs:
1257                 archive_name += "-VCS"
1258
1259         if options.project:
1260             project_name = options.project
1261             archive_name += ("PROJECT-" + project_name)
1262  
1263         if options.sat:
1264             archive_name += ("salomeTools_" + runner.cfg.INTERNAL.sat_version)
1265         if len(archive_name)==0: # no option worked 
1266             msg = _("Error: Cannot name the archive\n"
1267                     " check if at least one of the following options was "
1268                     "selected : --binaries, --sources, --project or"
1269                     " --salometools")
1270             logger.write(src.printcolors.printcError(msg), 1)
1271             logger.write("\n", 1)
1272             return 1
1273  
1274     path_targz = os.path.join(dir_name, archive_name + ".tgz")
1275     
1276     src.printcolors.print_value(logger, "Package path", path_targz, 2)
1277
1278     # Create a working directory for all files that are produced during the
1279     # package creation and that will be removed at the end of the command
1280     tmp_working_dir = os.path.join(runner.cfg.VARS.tmp_root,
1281                                    runner.cfg.VARS.datehour)
1282     src.ensure_path_exists(tmp_working_dir)
1283     logger.write("\n", 5)
1284     logger.write(_("The temporary working directory: %s\n" % tmp_working_dir),5)
1285     
1286     logger.write("\n", 3)
1287
1288     msg = _("Preparation of files to add to the archive")
1289     logger.write(src.printcolors.printcLabel(msg), 2)
1290     logger.write("\n", 2)
1291     
1292     d_files_to_add={}  # content of the archive
1293
1294     # a dict to hold paths that will need to be substitute for users recompilations
1295     d_paths_to_substitute={}  
1296
1297     if options.binaries:
1298         d_bin_files_to_add = binary_package(runner.cfg,
1299                                             logger,
1300                                             options,
1301                                             tmp_working_dir)
1302         # for all binaries dir, store the substitution that will be required 
1303         # for extra compilations
1304         for key in d_bin_files_to_add:
1305             if key.endswith("(bin)"):
1306                 source_dir = d_bin_files_to_add[key][0]
1307                 path_in_archive = d_bin_files_to_add[key][1].replace("BINARIES-" + runner.cfg.VARS.dist,"INSTALL")
1308                 if os.path.basename(source_dir)==os.path.basename(path_in_archive):
1309                     # if basename is the same we will just substitute the dirname 
1310                     d_paths_to_substitute[os.path.dirname(source_dir)]=\
1311                         os.path.dirname(path_in_archive)
1312                 else:
1313                     d_paths_to_substitute[source_dir]=path_in_archive
1314
1315         d_files_to_add.update(d_bin_files_to_add)
1316
1317     if options.sources:
1318         d_files_to_add.update(source_package(runner,
1319                                         runner.cfg,
1320                                         logger, 
1321                                         options,
1322                                         tmp_working_dir))
1323         if options.binaries:
1324             # for archives with bin and sources we provide a shell script able to 
1325             # install binaries for compilation
1326             file_install_bin=produce_install_bin_file(runner.cfg,logger,
1327                                                       tmp_working_dir,
1328                                                       d_paths_to_substitute,
1329                                                       "install_bin.sh")
1330             d_files_to_add.update({"install_bin" : (file_install_bin, "install_bin.sh")})
1331             logger.write("substitutions that need to be done later : \n", 5)
1332             logger.write(str(d_paths_to_substitute), 5)
1333             logger.write("\n", 5)
1334     else:
1335         # --salomeTool option is not considered when --sources is selected, as this option
1336         # already brings salomeTool!
1337         if options.sat:
1338             d_files_to_add.update({"salomeTools" : (runner.cfg.VARS.salometoolsway, "")})
1339         
1340
1341     if options.project:
1342         DBG.write("config for package %s" % project_name, runner.cfg)
1343         d_files_to_add.update(project_package(runner.cfg, project_name, options.project_file_path, tmp_working_dir, logger))
1344
1345     if not(d_files_to_add):
1346         msg = _("Error: Empty dictionnary to build the archive!\n")
1347         logger.write(src.printcolors.printcError(msg), 1)
1348         logger.write("\n", 1)
1349         return 1
1350
1351     # Add the README file in the package
1352     local_readme_tmp_path = add_readme(runner.cfg,
1353                                        options,
1354                                        tmp_working_dir)
1355     d_files_to_add["README"] = (local_readme_tmp_path, "README")
1356
1357     # Add the additional files of option add_files
1358     if options.add_files:
1359         for file_path in options.add_files:
1360             if not os.path.exists(file_path):
1361                 msg = _("WARNING: the file %s is not accessible.\n" % file_path)
1362                 continue
1363             file_name = os.path.basename(file_path)
1364             d_files_to_add[file_name] = (file_path, file_name)
1365
1366     logger.write("\n", 2)
1367
1368     logger.write(src.printcolors.printcLabel(_("Actually do the package")), 2)
1369     logger.write("\n", 2)
1370     
1371     try:
1372         # Creating the object tarfile
1373         tar = tarfile.open(path_targz, mode='w:gz')
1374         
1375         # get the filtering function if needed
1376         filter_function = exclude_VCS_and_extensions
1377
1378         # Add the files to the tarfile object
1379         res = add_files(tar, archive_name, d_files_to_add, logger, f_exclude=filter_function)
1380         tar.close()
1381     except KeyboardInterrupt:
1382         logger.write(src.printcolors.printcError("\nERROR: forced interruption\n"), 1)
1383         logger.write(_("Removing the temporary working directory ... "), 1)
1384         # remove the working directory
1385         shutil.rmtree(tmp_working_dir)
1386         logger.write(_("OK"), 1)
1387         logger.write(_("\n"), 1)
1388         return 1
1389     
1390     # remove the working directory    
1391     shutil.rmtree(tmp_working_dir)
1392     
1393     # Print again the path of the package
1394     logger.write("\n", 2)
1395     src.printcolors.print_value(logger, "Package path", path_targz, 2)
1396     
1397     return res