Salome HOME
Use "default" theme for Sphinx < 1.3
[modules/kernel.git] / bin / appli_gen.py
1 #! /usr/bin/env python
2 #  -*- coding: iso-8859-1 -*-
3 # Copyright (C) 2007-2015  CEA/DEN, EDF R&D, OPEN CASCADE
4 #
5 # Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
6 # CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
7 #
8 # This library is free software; you can redistribute it and/or
9 # modify it under the terms of the GNU Lesser General Public
10 # License as published by the Free Software Foundation; either
11 # version 2.1 of the License, or (at your option) any later version.
12 #
13 # This library is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16 # Lesser General Public License for more details.
17 #
18 # You should have received a copy of the GNU Lesser General Public
19 # License along with this library; if not, write to the Free Software
20 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
21 #
22 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
23 #
24
25 ## \file appli_gen.py
26 #  Create a %SALOME application (virtual Salome installation)
27 #
28 usage = """%(prog)s [options]
29 Typical use is:
30   python %(prog)s
31 Typical use with options is:
32   python %(prog)s --verbose --prefix=<install directory> --config=<configuration file>
33 """
34
35 import os
36 import sys
37 import shutil
38 import virtual_salome
39 import xml.sax
40 import optparse
41
42 # --- names of tags in XML configuration file
43 appli_tag   = "application"
44 prereq_tag  = "prerequisites"
45 context_tag = "context"
46 system_conf_tag  = "system_conf"
47 modules_tag = "modules"
48 module_tag  = "module"
49 samples_tag = "samples"
50 extra_tests_tag = "extra_tests"
51 extra_test_tag = "extra_test"
52 resources_tag = "resources"
53
54 # --- names of attributes in XML configuration file
55 nam_att  = "name"
56 path_att = "path"
57 gui_att  = "gui"
58
59 # -----------------------------------------------------------------------------
60
61 # --- xml reader for SALOME application configuration file
62
63 class xml_parser:
64     def __init__(self, fileName ):
65         print "Configure parser: processing %s ..." % fileName
66         self.space = []
67         self.config = {}
68         self.config["modules"] = []
69         self.config["guimodules"] = []
70         self.config["extra_tests"] = []
71         parser = xml.sax.make_parser()
72         parser.setContentHandler(self)
73         parser.parse(fileName)
74         pass
75
76     def boolValue( self, text):
77         if text in ("yes", "y", "1"):
78             return 1
79         elif text in ("no", "n", "0"):
80             return 0
81         else:
82             return text
83         pass
84
85     def startElement(self, name, attrs):
86         self.space.append(name)
87         self.current = None
88         # --- if we are analyzing "prerequisites" element then store its "path" attribute
89         if self.space == [appli_tag, prereq_tag] and path_att in attrs.getNames():
90             self.config["prereq_path"] = attrs.getValue( path_att )
91             pass
92         # --- if we are analyzing "context" element then store its "path" attribute
93         if self.space == [appli_tag, context_tag] and path_att in attrs.getNames():
94             self.config["context_path"] = attrs.getValue( path_att )
95             pass
96         # --- if we are analyzing "system_conf" element then store its "path" attribute
97         if self.space == [appli_tag, system_conf_tag] and path_att in attrs.getNames():
98             self.config["system_conf_path"] = attrs.getValue( path_att )
99             pass
100         # --- if we are analyzing "resources" element then store its "path" attribute
101         if self.space == [appli_tag, resources_tag] and path_att in attrs.getNames():
102             self.config["resources_path"] = attrs.getValue( path_att )
103             pass
104         # --- if we are analyzing "samples" element then store its "path" attribute
105         if self.space == [appli_tag, samples_tag] and path_att in attrs.getNames():
106             self.config["samples_path"] = attrs.getValue( path_att )
107             pass
108         # --- if we are analyzing "module" element then store its "name" and "path" attributes
109         elif self.space == [appli_tag,modules_tag,module_tag] and \
110             nam_att in attrs.getNames() and \
111             path_att in attrs.getNames():
112             nam = attrs.getValue( nam_att )
113             path = attrs.getValue( path_att )
114             gui = 1
115             if gui_att in attrs.getNames():
116                 gui = self.boolValue(attrs.getValue( gui_att ))
117                 pass
118             self.config["modules"].append(nam)
119             self.config[nam]=path
120             if gui:
121                 self.config["guimodules"].append(nam)
122                 pass
123             pass
124         # --- if we are analyzing "extra_test" element then store its "name" and "path" attributes
125         elif self.space == [appli_tag,extra_tests_tag,extra_test_tag] and \
126             nam_att in attrs.getNames() and \
127             path_att in attrs.getNames():
128             nam = attrs.getValue( nam_att )
129             path = attrs.getValue( path_att )
130             self.config["extra_tests"].append(nam)
131             self.config[nam]=path
132             pass
133         pass
134
135     def endElement(self, name):
136         self.space.pop()
137         self.current = None
138         pass
139
140     def characters(self, content):
141         pass
142
143     def processingInstruction(self, target, data):
144         pass
145
146     def setDocumentLocator(self, locator):
147         pass
148
149     def startDocument(self):
150         self.read = None
151         pass
152
153     def endDocument(self):
154         self.read = None
155         pass
156
157 # -----------------------------------------------------------------------------
158
159 class params:
160     pass
161
162 # -----------------------------------------------------------------------------
163
164 def makedirs(namedir):
165   if os.path.exists(namedir):
166     dirbak = namedir+".bak"
167     if os.path.exists(dirbak):
168       shutil.rmtree(dirbak)
169     os.rename(namedir, dirbak)
170     os.listdir(dirbak) #sert seulement a mettre a jour le systeme de fichier sur certaines machines
171   os.makedirs(namedir)
172
173 def install(prefix, config_file, verbose=0):
174     home_dir = os.path.abspath(os.path.expanduser(prefix))
175     filename = os.path.abspath(os.path.expanduser(config_file))
176     _config = {}
177     try:
178         parser = xml_parser(filename)
179         _config = parser.config
180     except xml.sax.SAXParseException, inst:
181         print inst.getMessage()
182         print "Configure parser: parse error in configuration file %s" % filename
183         pass
184     except xml.sax.SAXException, inst:
185         print inst.args
186         print "Configure parser: error in configuration file %s" % filename
187         pass
188     except:
189         print "Configure parser: Error : can not read configuration file %s, check existence and rights" % filename
190         pass
191
192     if verbose:
193         for cle,val in _config.items():
194             print cle, val
195             pass
196
197     # Remove CTestTestfile.cmake; this file will be filled by successive calls to link_module and link_extra_test
198     try:
199       ctest_file = os.path.join(home_dir, 'bin', 'salome', 'test', "CTestTestfile.cmake")
200       os.remove(ctest_file)
201     except:
202       pass
203
204     for module in _config.get("modules", []):
205         if _config.has_key(module):
206             print "--- add module ", module, _config[module]
207             options = params()
208             options.verbose = verbose
209             options.clear = 0
210             options.prefix = home_dir
211             options.module_name = module
212             options.module_path = _config[module]
213             virtual_salome.link_module(options)
214             pass
215         pass
216
217     for extra_test in _config.get("extra_tests", []):
218         if _config.has_key(extra_test):
219             print "--- add extra test ", extra_test, _config[extra_test]
220             options = params()
221             options.verbose = verbose
222             options.clear = 0
223             options.prefix = home_dir
224             options.extra_test_name = extra_test
225             options.extra_test_path = _config[extra_test]
226             virtual_salome.link_extra_test(options)
227             pass
228         pass
229
230     appliskel_dir = os.path.join(home_dir, 'bin', 'salome', 'appliskel')
231
232     for fn in ('envd',
233                'getAppliPath.py',
234                'kill_remote_containers.py',
235                'runAppli',           # OBSOLETE (replaced by salome)
236                'runConsole',         # OBSOLETE (replaced by salome)
237                'runRemote.sh',
238                'runSalomeScript',    # OBSOLETE (replaced by salome)
239                'runSession',         # OBSOLETE (replaced by salome)
240                'salome',
241                'update_catalogs.py',
242                '.bashrc',
243                ):
244         virtual_salome.symlink( os.path.join( appliskel_dir, fn ), os.path.join( home_dir, fn) )
245         pass
246
247     if filename != os.path.join(home_dir,"config_appli.xml"):
248         shutil.copyfile(filename, os.path.join(home_dir,"config_appli.xml"))
249         pass
250
251
252     # Add .salome-completion.sh file
253     shutil.copyfile(os.path.join(appliskel_dir, ".salome-completion.sh"),
254                     os.path.join(home_dir, ".salome-completion.sh"))
255
256
257     # Creation of env.d directory
258     virtual_salome.mkdir(os.path.join(home_dir,'env.d'))
259
260     if _config.has_key("prereq_path") and os.path.isfile(_config["prereq_path"]):
261         shutil.copyfile(_config["prereq_path"],
262                         os.path.join(home_dir, 'env.d', 'envProducts.sh'))
263         pass
264     else:
265         print "WARNING: prerequisite file does not exist"
266         pass
267
268     if _config.has_key("context_path") and os.path.isfile(_config["context_path"]):
269         shutil.copyfile(_config["context_path"],
270                         os.path.join(home_dir, 'env.d', 'envProducts.cfg'))
271         pass
272     else:
273         print "WARNING: context file does not exist"
274         pass
275
276     if _config.has_key("system_conf_path") and os.path.isfile(_config["system_conf_path"]):
277         shutil.copyfile(_config["system_conf_path"],
278                         os.path.join(home_dir, 'env.d', 'envConfSystem.sh'))
279         pass
280
281     # Create environment file: configSalome.sh
282     with open(os.path.join(home_dir, 'env.d', 'configSalome.sh'),'w') as f:
283         for module in _config.get("modules", []):
284             command = 'export '+ module + '_ROOT_DIR=${HOME}/${APPLI}\n'
285             f.write(command)
286             pass
287         if _config.has_key("samples_path"):
288             command = 'export DATA_DIR=' + _config["samples_path"] +'\n'
289             f.write(command)
290             pass
291         if _config.has_key("resources_path") and os.path.isfile(_config["resources_path"]):
292             command = 'export USER_CATALOG_RESOURCES_FILE=' + os.path.abspath(_config["resources_path"]) +'\n'
293             f.write(command)
294
295     # Create configuration file: configSalome.cfg
296     with open(os.path.join(home_dir, 'env.d', 'configSalome.cfg'),'w') as f:
297         command = "[SALOME ROOT_DIR (modules) Configuration]\n"
298         f.write(command)
299         for module in _config.get("modules", []):
300             command = module + '_ROOT_DIR=${HOME}/${APPLI}\n'
301             f.write(command)
302             pass
303         if _config.has_key("samples_path"):
304             command = 'DATA_DIR=' + _config["samples_path"] +'\n'
305             f.write(command)
306             pass
307         if _config.has_key("resources_path") and os.path.isfile(_config["resources_path"]):
308             command = 'USER_CATALOG_RESOURCES_FILE=' + os.path.abspath(_config["resources_path"]) +'\n'
309             f.write(command)
310
311
312     # Create environment file: configGUI.sh
313     with open(os.path.join(home_dir, 'env.d', 'configGUI.sh'),'w') as f:
314         command = """export SalomeAppConfig=${HOME}/${APPLI}
315 export SUITRoot=${HOME}/${APPLI}/share/salome
316 export DISABLE_FPE=1
317 export MMGT_REENTRANT=1
318 """
319         f.write(command)
320
321     # Create configuration file: configGUI.cfg
322     with open(os.path.join(home_dir, 'env.d', 'configGUI.cfg'),'w') as f:
323         command = """[SALOME GUI Configuration]
324 SalomeAppConfig=${HOME}/${APPLI}
325 SUITRoot=${HOME}/${APPLI}/share/salome
326 DISABLE_FPE=1
327 MMGT_REENTRANT=1
328 """
329         f.write(command)
330
331     #SalomeApp.xml file
332     with open(os.path.join(home_dir,'SalomeApp.xml'),'w') as f:
333         command = """<document>
334   <section name="launch">
335     <!-- SALOME launching parameters -->
336     <parameter name="gui"        value="yes"/>
337     <parameter name="splash"     value="yes"/>
338     <parameter name="file"       value="no"/>
339     <parameter name="key"        value="no"/>
340     <parameter name="interp"     value="no"/>
341     <parameter name="logger"     value="no"/>
342     <parameter name="xterm"      value="no"/>
343     <parameter name="portkill"   value="no"/>
344     <parameter name="killall"    value="no"/>
345     <parameter name="noexcepthandler"  value="no"/>
346     <parameter name="modules"    value="%s"/>
347     <parameter name="pyModules"  value=""/>
348     <parameter name="embedded"   value="SalomeAppEngine,study,cppContainer,registry,moduleCatalog"/>
349     <parameter name="standalone" value=""/>
350   </section>
351 </document>
352 """
353         mods = []
354         #Keep all modules except KERNEL and GUI
355         for module in _config.get("modules", []):
356             if module in ("KERNEL","GUI"):
357                 continue
358             mods.append(module)
359         f.write(command % ",".join(mods))
360
361     #Add USERS directory with 777 permission to store users configuration files
362     users_dir = os.path.join(home_dir,'USERS')
363     makedirs(users_dir)
364     os.chmod(users_dir, 0777)
365
366 def main():
367     parser = optparse.OptionParser(usage=usage)
368
369     parser.add_option('--prefix', dest="prefix", default='.',
370                       help="Installation directory (default .)")
371
372     parser.add_option('--config', dest="config", default='config_appli.xml',
373                       help="XML configuration file (default config_appli.xml)")
374
375     parser.add_option('-v', '--verbose', action='count', dest='verbose',
376                       default=0, help="Increase verbosity")
377
378     options, args = parser.parse_args()
379     if not os.path.exists(options.config):
380         print "ERROR: config file %s does not exist. It is mandatory." % options.config
381         sys.exit(1)
382
383     install(prefix=options.prefix, config_file=options.config, verbose=options.verbose)
384     pass
385
386 # -----------------------------------------------------------------------------
387
388 if __name__ == '__main__':
389     main()
390     pass