GaudiKernel.ProcessJobOptions Namespace Reference

Classes
class	_TempSysPath
class	ConsoleHandler
class	JobOptsParser
class	LogFilter
class	LogFormatter
class	ParserError

Functions
def	GetConsoleHandler (prefix=None, stream=None, with_time=False)
def	InstallRootLoggingHandler (prefix=None, level=None, stream=None, with_time=False)
def	PrintOn (step=1, force=False)
def	PrintOff (step=1)
def	_find_file (f)
def	_to_be_included (f)
def	_import_python (file)
def	_import_pickle (file)
def	_import_opts (file)
def	importOptions (optsfile)
def	importUnits (unitsfile)

Variables
	_log = logging.getLogger(__name__)
	_consoleHandler = None
	_included_files = set()
	_parser = JobOptsParser()
dictionary	_import_function_mapping

Function Documentation

_find_file()

def GaudiKernel.ProcessJobOptions._find_file (   f )

private

Definition at line 150 of file ProcessJobOptions.py.

def _find_file(f):
    # expand environment variables in the filename
    f = os.path.expandvars(f)
    if os.path.isfile(f):
        return os.path.realpath(f)
 
    path = os.environ.get('JOBOPTSEARCHPATH', '').split(os.pathsep)
    # find the full path to the option file
    candidates = [d for d in path if os.path.isfile(os.path.join(d, f))]
    if not candidates:
        raise ParserError("Cannot find '%s' in %s" % (f, path))
    return os.path.realpath(os.path.join(candidates[0], f))
 
 

_import_opts()

def GaudiKernel.ProcessJobOptions._import_opts (   file )

private

Definition at line 480 of file ProcessJobOptions.py.

def _import_opts(file):
    _parser.parse(file)
 
 

_import_pickle()

def GaudiKernel.ProcessJobOptions._import_pickle (   file )

private

Definition at line 473 of file ProcessJobOptions.py.

def _import_pickle(file):
    import pickle
    input = open(file, 'rb')
    catalog = pickle.load(input)
    _log.info('Unpickled %d configurables', len(catalog))
 
 

_import_python()

def GaudiKernel.ProcessJobOptions._import_python (   file )

private

Definition at line 467 of file ProcessJobOptions.py.

def _import_python(file):
    with open(file) as f:
        code = compile(f.read(), file, 'exec')
        exec(code, {})
 
 

_to_be_included()

def GaudiKernel.ProcessJobOptions._to_be_included (   f )

private

Definition at line 167 of file ProcessJobOptions.py.

def _to_be_included(f):
    if f in _included_files:
        _log.warning("file '%s' already included, ignored.", f)
        return False
    _included_files.add(f)
    return True
 
 

GetConsoleHandler()

def GaudiKernel.ProcessJobOptions.GetConsoleHandler	(		prefix = None,
			stream = None,
			with_time = False
	)

Definition at line 116 of file ProcessJobOptions.py.

def GetConsoleHandler(prefix=None, stream=None, with_time=False):
    global _consoleHandler
    if _consoleHandler is None:
        _consoleHandler = ConsoleHandler(
            prefix=prefix, stream=stream, with_time=with_time)
    elif prefix is not None:
        _consoleHandler.setPrefix(prefix)
    return _consoleHandler
 
 

importOptions()

def GaudiKernel.ProcessJobOptions.importOptions

(

optsfile

)

Definition at line 491 of file ProcessJobOptions.py.

def importOptions(optsfile):
    # expand environment variables before checking the extension
    optsfile = os.path.expandvars(optsfile)
    # check the file type (extension)
    dummy, ext = os.path.splitext(optsfile)
    if ext in _import_function_mapping:
        # check if the file has been already included
        optsfile = _find_file(optsfile)
        if _to_be_included(optsfile):
            _log.info("--> Including file '%s'", optsfile)
            # include the file
            _import_function_mapping[ext](optsfile)
            _log.info("<-- End of file '%s'", optsfile)
    else:
        raise ParserError("Unknown file type '%s' ('%s')" % (ext, optsfile))
 
 
# Import a file containing declaration of units.
#  It is equivalent to:
#
#  #units "unitsfile.opts"
#
 
 

importUnits()

def GaudiKernel.ProcessJobOptions.importUnits

(

unitsfile

)

Definition at line 515 of file ProcessJobOptions.py.

def importUnits(unitsfile):
    # expand environment variables
    unitsfile = os.path.expandvars(unitsfile)
    # we do not need to check the file type (extension) because it must be a
    # units file
    _parser._include(unitsfile, _parser._parse_units)

InstallRootLoggingHandler()

def GaudiKernel.ProcessJobOptions.InstallRootLoggingHandler	(		prefix = None,
			level = None,
			stream = None,
			with_time = False
	)

Definition at line 126 of file ProcessJobOptions.py.

def InstallRootLoggingHandler(prefix=None,
                              level=None,
                              stream=None,
                              with_time=False):
    root_logger = logging.getLogger()
    if not root_logger.handlers:
        root_logger.addHandler(GetConsoleHandler(prefix, stream, with_time))
        root_logger.setLevel(logging.WARNING)
    if level is not None:
        root_logger.setLevel(level)
 
 

PrintOff()

def GaudiKernel.ProcessJobOptions.PrintOff

(

step = 1

)

Definition at line 142 of file ProcessJobOptions.py.

def PrintOff(step=1):
    GetConsoleHandler().printOff(step)
 
 

PrintOn()

def GaudiKernel.ProcessJobOptions.PrintOn	(		step = 1,
			force = False
	)

Definition at line 138 of file ProcessJobOptions.py.

def PrintOn(step=1, force=False):
    GetConsoleHandler().printOn(step, force)
 
 

Variable Documentation

_consoleHandler

GaudiKernel.ProcessJobOptions._consoleHandler = None

private

Definition at line 113 of file ProcessJobOptions.py.

_import_function_mapping

dictionary GaudiKernel.ProcessJobOptions._import_function_mapping

private

Initial value:

=  {
    ".py": _import_python,
    ".pkl": _import_pickle,
    ".opts": _import_opts,
}

Definition at line 484 of file ProcessJobOptions.py.

_included_files

GaudiKernel.ProcessJobOptions._included_files = set()

private

Definition at line 164 of file ProcessJobOptions.py.

_log

GaudiKernel.ProcessJobOptions._log = logging.getLogger(__name__)

private

Definition at line 17 of file ProcessJobOptions.py.

_parser

GaudiKernel.ProcessJobOptions._parser = JobOptsParser()

private

Definition at line 464 of file ProcessJobOptions.py.