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)
	Import a file containing declaration of units. More...

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

Function Documentation

def GaudiKernel.ProcessJobOptions._find_file (   f )

private

Definition at line 111 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))

def GaudiKernel.ProcessJobOptions._import_opts (   file )

private

Definition at line 423 of file ProcessJobOptions.py.

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

def GaudiKernel.ProcessJobOptions._import_pickle (   file )

private

Definition at line 417 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))

def GaudiKernel.ProcessJobOptions._import_python (   file )

private

Definition at line 414 of file ProcessJobOptions.py.

def _import_python(file):
    execfile(file, {})

def GaudiKernel.ProcessJobOptions._to_be_included (   f )

private

Definition at line 125 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

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

Definition at line 87 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

def GaudiKernel.ProcessJobOptions.importOptions

(

optsfile

)

Definition at line 432 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))

def GaudiKernel.ProcessJobOptions.importUnits

(

unitsfile

)

Import a file containing declaration of units.

It is equivalent to:

#units "unitsfile.opts"

Definition at line 453 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)

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

Definition at line 95 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)

def GaudiKernel.ProcessJobOptions.PrintOff

(

step = 1

)

Definition at line 105 of file ProcessJobOptions.py.

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

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

Definition at line 103 of file ProcessJobOptions.py.

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

Variable Documentation

GaudiKernel.ProcessJobOptions._consoleHandler = None

private

Definition at line 86 of file ProcessJobOptions.py.

dictionary GaudiKernel.ProcessJobOptions._import_function_mapping

private

Initial value:

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

Definition at line 426 of file ProcessJobOptions.py.

GaudiKernel.ProcessJobOptions._included_files = set()

private

Definition at line 124 of file ProcessJobOptions.py.

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

private

Definition at line 5 of file ProcessJobOptions.py.

GaudiKernel.ProcessJobOptions._parser = JobOptsParser()

private

Definition at line 412 of file ProcessJobOptions.py.