Salome HOME
Merge branch 'omu/SalomeLauncher'
[modules/kernel.git] / bin / salomeContextUtils.py.in
1 #! /usr/bin/env python
2
3 # Copyright (C) 2013-2015  CEA/DEN, EDF R&D, OPEN CASCADE
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, or (at your option) any later version.
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 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
20 #
21
22 import os
23 import sys
24 import glob
25 import subprocess
26 import re
27 import socket
28 import json
29
30 """
31 Define a specific exception class to manage exceptions related to SalomeContext
32 """
33 class SalomeContextException(Exception):
34   """Report error messages to the user interface of SalomeContext."""
35 #
36
37 def __listDirectory(path):
38   allFiles = []
39   for root, dirs, files in os.walk(path):
40     cfgFiles = glob.glob(os.path.join(root,'*.cfg'))
41     allFiles += cfgFiles
42
43     shFiles = glob.glob(os.path.join(root,'*.sh'))
44     for f in shFiles:
45       no_ext = os.path.splitext(f)[0]
46       if not os.path.isfile(no_ext+".cfg"):
47         allFiles.append(f)
48
49   return allFiles
50 #
51
52 def __getConfigFileNamesDefault():
53   absoluteAppliPath = os.getenv('ABSOLUTE_APPLI_PATH','')
54   if not absoluteAppliPath:
55     return []
56
57   envdDir = absoluteAppliPath + '/env.d'
58   if not os.path.isdir(envdDir):
59     return []
60
61   return __listDirectory(envdDir)
62 #
63
64 def getConfigFileNames(args, checkExistence=False):
65   # special case: configuration files are provided by user
66   # Search for command-line argument(s) --config=file1,file2,..., filen
67   # Search for command-line argument(s) --config=dir1,dir2,..., dirn
68   configOptionPrefix = "--config="
69   configArgs = [ str(x) for x in args if str(x).startswith(configOptionPrefix) ]
70
71   if len(configArgs) == 0:
72     return __getConfigFileNamesDefault(), args, []
73
74   args = [ x for x in args if not x.startswith(configOptionPrefix) ]
75   allLists = [ x.replace(configOptionPrefix, '') for x in configArgs ]
76
77   configFileNames = []
78   unexisting = []
79   for currentList in allLists:
80     elements = currentList.split(',')
81     for elt in elements:
82       elt = os.path.realpath(os.path.expanduser(elt))
83       if os.path.isdir(elt):
84         configFileNames += __listDirectory(elt)
85       else:
86         if checkExistence and not os.path.isfile(elt):
87           unexisting += [elt]
88         else:
89           configFileNames += [elt]
90
91   return configFileNames, args, unexisting
92 #
93
94 def __getScriptPath(scriptName, searchPathList):
95   scriptName = os.path.expanduser(scriptName)
96   if os.path.isabs(scriptName):
97     return scriptName
98
99   if searchPathList is None or len(searchPathList) == 0:
100     return None
101
102   for path in searchPathList:
103     fullName = os.path.join(path, scriptName)
104     if os.path.isfile(fullName) or os.path.isfile(fullName+".py"):
105       return fullName
106
107   return None
108 #
109
110 class ScriptAndArgs:
111   # script: the command to be run, e.g. python <script.py>
112   # args: its input parameters
113   # out: its output parameters
114   def __init__(self, script = None, args = None, out = None):
115     self.script = script
116     self.args = args
117     self.out = out
118   #
119   def __repr__(self):
120     msg = "\n# Script: %s\n"%self.script
121     msg += "     * Input: %s\n"%self.args
122     msg += "     * Output: %s\n"%self.out
123     return msg
124   #
125 #
126 class ScriptAndArgsObjectEncoder(json.JSONEncoder):
127   def default(self, obj):
128     if isinstance(obj, ScriptAndArgs):
129       # to be easily parsed in GUI module (SalomeApp_Application)
130       # Do not export output arguments
131       return {obj.script:obj.args or []}
132     else:
133       return json.JSONEncoder.default(self, obj)
134 #
135
136 # Return an array of ScriptAndArgs objects
137 def getScriptsAndArgs(args=None, searchPathList=None):
138   if args is None:
139     args = []
140   if searchPathList is None:
141     searchPathList = sys.path
142
143   # Syntax of args: script.py [args:a1,a2=val,an] ... script.py [args:a1,a2=val,an]
144   scriptArgs = []
145   currentKey = None
146   argsPrefix = "args:"
147   outPrefix = "out:"
148   callPython = False
149   afterArgs = False
150   currentScript = None
151
152   for i in range(len(args)):
153     elt = os.path.expanduser(args[i])
154     isDriver = (elt == "driver") # special case for YACS scheme execution
155
156     if elt.startswith(argsPrefix):
157       if not currentKey or callPython:
158         raise SalomeContextException("args list must follow corresponding script file in command line.")
159       elt = elt.replace(argsPrefix, '')
160       scriptArgs[len(scriptArgs)-1].args = [os.path.expanduser(x) for x in elt.split(",")]
161       currentKey = None
162       callPython = False
163       afterArgs = True
164     elif elt.startswith(outPrefix):
165       if (not currentKey and not afterArgs) or callPython:
166         raise SalomeContextException("out list must follow both corresponding script file and its args in command line.")
167       elt = elt.replace(outPrefix, '')
168       scriptArgs[len(scriptArgs)-1].out = [os.path.expanduser(x) for x in elt.split(",")]
169       currentKey = None
170       callPython = False
171       afterArgs = False
172     elif elt.startswith("python"):
173       callPython = True
174       afterArgs = False
175     else:
176       if not os.path.isfile(elt) and not os.path.isfile(elt+".py"):
177         eltInSearchPath = __getScriptPath(elt, searchPathList)
178         if eltInSearchPath is None or (not os.path.isfile(eltInSearchPath) and not os.path.isfile(eltInSearchPath+".py")):
179           if elt[-3:] == ".py":
180             raise SalomeContextException("Script not found: %s"%elt)
181           scriptArgs.append(ScriptAndArgs(script=elt))
182           continue
183         elt = eltInSearchPath
184
185       if elt[-4:] != ".hdf":
186         if elt[-3:] == ".py" or isDriver:
187           currentScript = os.path.abspath(elt)
188         elif os.path.isfile(elt+".py"):
189           currentScript = os.path.abspath(elt+".py")
190         else:
191           currentScript = os.path.abspath(elt) # python script not necessary has .py extension
192         pass
193
194       if currentScript and callPython:
195         currentKey = "@PYTHONBIN@ "+currentScript
196         scriptArgs.append(ScriptAndArgs(script=currentKey))
197         callPython = False
198       elif currentScript:
199         if isDriver:
200           currentKey = currentScript
201           scriptArgs.append(ScriptAndArgs(script=currentKey))
202           callPython = False
203         elif not os.access(currentScript, os.X_OK):
204           currentKey = "@PYTHONBIN@ "+currentScript
205           scriptArgs.append(ScriptAndArgs(script=currentKey))
206         else:
207           ispython = False
208           try:
209             fn = open(currentScript)
210             for i in xrange(10): # read only 10 first lines
211               ln = fn.readline()
212               if re.search("#!.*python"):
213                 ispython = True
214                 break
215               pass
216             fn.close()
217           except:
218             pass
219           if not ispython and currentScript[-3:] == ".py":
220             currentKey = "@PYTHONBIN@ "+currentScript
221           else:
222             currentKey = currentScript
223             pass
224           scriptArgs.append(ScriptAndArgs(script=currentKey))
225       # CLOSE elif currentScript
226       afterArgs = False
227   # end for loop
228   return scriptArgs
229 #
230
231 # Formatting scripts and args as a Bash-like command-line:
232 # script1.py [args] ; script2.py [args] ; ...
233 # scriptArgs is a list of ScriptAndArgs objects; their output parameters are omitted
234 def formatScriptsAndArgs(scriptArgs=None):
235     if scriptArgs is None:
236       return ""
237     commands = []
238     for sa_obj in scriptArgs:
239       cmd = sa_obj.script
240       if sa_obj.args:
241         cmd = " ".join([cmd]+sa_obj.args)
242       commands.append(cmd)
243
244     sep = " ; "
245     if sys.platform == "win32":
246       sep = " & "
247     command = sep.join(["%s"%x for x in commands])
248     return command
249 #
250
251 # Ensure OMNIORB_USER_PATH is defined. This variable refers to a the folder in which
252 # SALOME will write omniOrb configuration files.
253 # If OMNIORB_USER_PATH is already set, only checks write access to associated directory ;
254 # an exception is raised if check fails. It allows users for choosing a specific folder.
255 # Else the function sets OMNIORB_USER_PATH this way:
256 # - If APPLI environment variable is set, OMNIORB_USER_PATH is set to ${APPLI}/USERS.
257 #   The function does not check USERS folder existence or write access. This folder
258 #   must exist ; this is the case if SALOME virtual application has been created using
259 #   appli_gen.py script.
260 # - Else OMNIORB_USER_PATH is set to user home directory.
261 def setOmniOrbUserPath():
262   omniorbUserPath = os.getenv("OMNIORB_USER_PATH")
263   if omniorbUserPath:
264     if not os.access(omniorbUserPath, os.W_OK):
265       raise Exception("Unable to get write access to directory: %s"%omniorbUserPath)
266     pass
267   else:
268     homePath = os.path.realpath(os.path.expanduser('~'))
269     #defaultOmniorbUserPath = os.path.join(homePath, ".salomeConfig/USERS")
270     defaultOmniorbUserPath = homePath
271     if os.getenv("APPLI"):
272       defaultOmniorbUserPath = os.path.join(homePath, os.getenv("APPLI"), "USERS")
273       pass
274     os.environ["OMNIORB_USER_PATH"] = defaultOmniorbUserPath
275 #
276
277 def getHostname():
278   return socket.gethostname().split('.')[0]
279 #