python.trfArgClasses.argSubstepFloat Class Reference

Float substep argument. More...

Inheritance diagram for python.trfArgClasses.argSubstepFloat:

Collaboration diagram for python.trfArgClasses.argSubstepFloat:

Public Member Functions
def	__init__ (self, value=None, min=None, max=None, runarg=True, name=None)
	argSubstep constructor More...
def	prodsysDescription (self)
def	value (self)
	Return argument value. More...
def	value (self, value)
	Set argument value. More...
def	returnMyValue (self, name=None, substep=None, first=False, exe=None)
	Return the value of this substep arg for an executor with the given parameters. More...
def	isRunarg (self)
	Return runarg status. More...
def	name (self)
	Name getter. More...
def	name (self, value)
	Name setter. More...
def	__str__ (self)
	String conversion of our value. More...
def	__repr__ (self)
	Repr conversion of our value. More...
def	__eq__ (self, other)
	Comparison is based on value attribute. More...
def	__nq__ (self, other)
def	__lt__ (self, other)
def	__gt__ (self, other)

Public Attributes
	value

Private Member Functions
def	_parseStringAsSubstep (self, string)
	Parse a string for substep:value format. More...

Private Attributes
	_min
	_max
	_value
	_defaultSubstep
	_separator
	_runarg
	_name

Detailed Description

Float substep argument.

Definition at line 2264 of file trfArgClasses.py.

Constructor & Destructor Documentation

__init__()

def python.trfArgClasses.argSubstepFloat.__init__	(		self,
			value = None,
			runarg = None,
			name = None,
			defaultSubstep = True,
			separator = None
	)

argSubstep constructor

Parameters

defaultSubstep

Default substep to use when no specific substep has been given - this should be set to first for arguments that apply, by default, to the first executor in the chain (e.g., maxEvents)

Reimplemented from python.trfArgClasses.argSubstep.

Definition at line 2266 of file trfArgClasses.py.

    def __init__(self, value=None, min=None, max=None, runarg=True, name=None):
        self._min = min
        self._max = max
        super(argSubstepFloat, self).__init__(value = value, runarg = runarg, name=name)
        

Member Function Documentation

__eq__()

def python.trfArgClasses.argument.__eq__ (   self,   other  )

inherited

Comparison is based on value attribute.

Definition at line 161 of file trfArgClasses.py.

    def __eq__(self,other):
        return self.value == other.value
 

__gt__()

def python.trfArgClasses.argument.__gt__ (   self,   other  )

inherited

Definition at line 170 of file trfArgClasses.py.

    def __gt__(self, other):
        return self.value > other.value
 

__lt__()

def python.trfArgClasses.argument.__lt__ (   self,   other  )

inherited

Definition at line 167 of file trfArgClasses.py.

    def __lt__(self, other):
        return self.value < other.value
 

__nq__()

def python.trfArgClasses.argument.__nq__ (   self,   other  )

inherited

Definition at line 164 of file trfArgClasses.py.

    def __nq__(self, other):
        return self.value != other.value
 

__repr__()

def python.trfArgClasses.argument.__repr__ (   self )

inherited

Repr conversion of our value.

Reimplemented in python.trfArgClasses.argList.

Definition at line 157 of file trfArgClasses.py.

    def __repr__(self):
        return repr(self.value)
    

__str__()

def python.trfArgClasses.argument.__str__ (   self )

inherited

String conversion of our value.

Reimplemented in python.trfArgClasses.argFile, python.trfArgClasses.argKeyFloatValueList, python.trfArgClasses.argIntList, python.trfArgClasses.argList, and python.trfArgClasses.argString.

Definition at line 153 of file trfArgClasses.py.

    def __str__(self):
        return '{0}: Value {1} (isRunArg={2})'.format(self.__class__.__name__, self._value, self._runarg)
    

_parseStringAsSubstep()

def python.trfArgClasses.argSubstep._parseStringAsSubstep (   self,   string  )

privateinherited

Parse a string for substep:value format.

If the string matches the substep specifier regexp then we return the two parts; if not then the substep is returned as self._defaultSubstep, with the entire string passed back as the value

Parameters

string

The string which should be parsed

Reimplemented in python.trfArgClasses.argSubstepList.

Definition at line 2001 of file trfArgClasses.py.

    def _parseStringAsSubstep(self, string):
        subStepMatch = re.match(r'([a-zA-Z0-9,]+)' + self._separator + r'(.*)', string)
        subStepList = []
        if subStepMatch:
            subStep = subStepMatch.group(1).split(',')
            subStepValue = subStepMatch.group(2)
        else:
            subStep = [self._defaultSubstep]
            subStepValue = string
        msg.debug('Parsed {0} as substep {1}, argument {2}'.format(string, subStep, subStepValue))
        for step in subStep:
            subStepList.append((step, subStepValue))
        return subStepList
    
    

isRunarg()

def python.trfArgClasses.argument.isRunarg (   self )

inherited

Return runarg status.

Definition at line 134 of file trfArgClasses.py.

    def isRunarg(self):
        return self._runarg
    

name() [1/2]

def python.trfArgClasses.argument.name (   self )

inherited

Name getter.

Reimplemented in python.trfArgClasses.argFile.

Definition at line 139 of file trfArgClasses.py.

    def name(self):
        return self._name
    

name() [2/2]

def python.trfArgClasses.argument.name (   self,   value  )

inherited

Name setter.

Reimplemented in python.trfArgClasses.argFile.

Definition at line 144 of file trfArgClasses.py.

    def name(self, value):
        self._name = value
 

prodsysDescription()

def python.trfArgClasses.argSubstepFloat.prodsysDescription

(

self

)

Reimplemented from python.trfArgClasses.argSubstep.

Definition at line 2272 of file trfArgClasses.py.

    def prodsysDescription(self):
        desc = {'type': 'substep', 'substeptype': 'float', 'separator': self._separator,
                'default': self._defaultSubstep}     
        if self._min:
            desc['min'] = self._min
        if self._max:
            desc['max'] = self._max
        return desc
    
        

returnMyValue()

def python.trfArgClasses.argSubstep.returnMyValue (   self,   name = None,   substep = None,   first = False,   exe = None  )

inherited

Return the value of this substep arg for an executor with the given parameters.

Parameters

name	Executor name
substep	Executor substep nickname
first	Boolean flag set true if this is the first executor in the chain
exe	Executor instance, from which 'name', 'substep' and 'first' can be taken.

Definition at line 2021 of file trfArgClasses.py.

    def returnMyValue(self, name=None, substep=None, first=False, exe=None):
        if exe:
            name = exe.name
            substep = exe.substep
            first = exe.conf.firstExecutor
 
        name = commonExecutorStepName(name)
 
        value = None
        
        if name in self._value:
            value = self._value[name]
        elif substep in self._value:
            value = self._value[substep]  
        elif first and 'first' in self._value:
            value = self._value['first']
        elif 'default' in self._value:
            value = self._value['default']
            
        
        if 'all' in self._value:
            if value is None:
                value = self._value['all']
            elif isinstance(value, list):
                value = self._value['all'] + value
                
        msg.debug('From substep argument {myvalue} picked value "{value}" for {name}, {substep}, first={first}'.format(myvalue=self._value, value=value, name=name, substep=substep, first=first))
        
        return value
 

value() [1/2]

def python.trfArgClasses.argSubstepFloat.value

(

self

)

Return argument value.

Returns

Current value

Reimplemented from python.trfArgClasses.argSubstep.

Definition at line 2284 of file trfArgClasses.py.

    def value(self):
        return self._value
    

value() [2/2]

def python.trfArgClasses.argSubstepFloat.value	(		self,
			value
	)

Set argument value.

Note

No conversion or coercion done

Reimplemented from python.trfArgClasses.argSubstep.

Definition at line 2288 of file trfArgClasses.py.

    def value(self, value):
        msg.debug('Attempting to set argSubstep from {0!s} (type {1}'.format(value, type(value)))
        try:
            if value is None:
                self._value = {}
            elif isinstance(value, float):
                self._value = {self._defaultSubstep: value}              
            elif isinstance(value, str):
                subStepList = self._parseStringAsSubstep(value)
                self._value = dict([(subStep[0], float(subStep[1])) for subStep in subStepList])
            elif isinstance(value, (list, tuple)):
                # This is a list of strings to parse
                self._value = {}
                for item in value:
                    if not isinstance(item, str):
                        raise trfExceptions.TransformArgException(trfExit.nameToCode('TRF_ARG_CONV_FAIL'), 
                                                                  'Failed to convert list item {0!s} to substep (should be a string)'.format(item))
                    subStepList = self._parseStringAsSubstep(item)
                    for subStep in subStepList:
                        self._value[subStep[0]] = float(subStep[1])
            elif isinstance(value, dict):
                for k, v in value.items():
                    if not isinstance(k, str):
                        raise trfExceptions.TransformArgException(trfExit.nameToCode('TRF_ARG_CONV_FAIL'), 
                                                                  'Dictionary key {0!s} for substep is not a string'.format(k))
                    if not isinstance(v, float):
                        raise trfExceptions.TransformArgException(trfExit.nameToCode('TRF_ARG_CONV_FAIL'), 
                                                                  'Dictionary value {0!s} for substep is not an float'.format(v))
                self._value = value
            else:
                raise trfExceptions.TransformArgException(trfExit.nameToCode('TRF_ARG_CONV_FAIL'), 
                                                          'Setter value {0!s} (type {1}) for substep argument cannot be parsed'.format(value, type(value)))
            # Now do min/max checks
            for my_float in self._value.values():
                if (self._min is not None and my_float < self._min) or (self._max is not None and my_float > self._max):
                        raise trfExceptions.TransformArgException(trfExit.nameToCode('TRF_ARG_OUT_OF_RANGE'),
                                                              'argFloat value out of range: {0} is not between {1} and {2}'.format(my_float, self._min, self._max))
        except ValueError as e:
            raise trfExceptions.TransformArgException(trfExit.nameToCode('TRF_ARG_CONV_FAIL'), 
                                                      'Failed to convert substep value {0} to float: {1}'.format(value, e))
 
 

Member Data Documentation

_defaultSubstep

python.trfArgClasses.argSubstep._defaultSubstep

privateinherited

Definition at line 1966 of file trfArgClasses.py.

_max

python.trfArgClasses.argSubstepFloat._max

private

Definition at line 2268 of file trfArgClasses.py.

_min

python.trfArgClasses.argSubstepFloat._min

private

Definition at line 2267 of file trfArgClasses.py.

_name

python.trfArgClasses.argument._name

privateinherited

Definition at line 111 of file trfArgClasses.py.

_runarg

python.trfArgClasses.argument._runarg

privateinherited

Definition at line 110 of file trfArgClasses.py.

_separator

python.trfArgClasses.argSubstep._separator

privateinherited

Definition at line 1967 of file trfArgClasses.py.

_value

python.trfArgClasses.argSubstepFloat._value

private

Definition at line 2292 of file trfArgClasses.py.

value

python.trfArgClasses.argument.value

inherited

Note

We have a default of None here, but all derived classes should definitely have their own value setter and translate this value to something sensible for their underlying value type. N.B. As most argument classes use this default constructor it must call the @value .setter function!

Definition at line 118 of file trfArgClasses.py.

---

The documentation for this class was generated from the following file:

• trfArgClasses.py