ATLAS Offline Software
Public Member Functions | Private Member Functions | Private Attributes | List of all members
python.TransformConfig.String Class Reference
Inheritance diagram for python.TransformConfig.String:
Collaboration diagram for python.TransformConfig.String:

Public Member Functions

def __init__ (self, doc, default='', allowedValues=None)
 
def __get__ (self, instance, owner)
 
def __set__ (self, instance, value)
 
def name (self)
 
def default (self)
 
def doc (self)
 
def help (self)
 
def allowedValues (self)
 

Private Member Functions

def _checkValue (self, variableName, value)
 
def _attributeName (self, instance)
 
def _checkType (self, variableName, value)
 
def _setValue (self, variableName, value)
 
def _checkAllowedValues (self, variableName, allowedValues)
 

Private Attributes

 __name
 
 __doc
 
 __allowed
 
 __default
 

Detailed Description

Definition at line 130 of file TransformConfig.py.

Constructor & Destructor Documentation

◆ __init__()

def python.TransformConfig.String.__init__ (   self,
  doc,
  default = '',
  allowedValues = None 
)

Reimplemented from python.TransformConfig.Descriptor.

Definition at line 131 of file TransformConfig.py.

131  def __init__(self,doc,default='',allowedValues=None):
132  Descriptor.__init__(self,doc,default,allowedValues)
133 
134 

Member Function Documentation

◆ __get__()

def python.TransformConfig.Descriptor.__get__ (   self,
  instance,
  owner 
)
inherited

Definition at line 35 of file TransformConfig.py.

35  def __get__(self,instance,owner):
36  if instance is None:
37  return self
38  return instance._attributeDictionary().get(self._attributeName(instance),self.__default)
39 
40 

◆ __set__()

def python.TransformConfig.Descriptor.__set__ (   self,
  instance,
  value 
)
inherited

Definition at line 41 of file TransformConfig.py.

41  def __set__(self,instance,value):
42  varName = "%s.%s" % (instance.name(), self.__name) # for error/debug printout
43  # allow None as a value for all types
44  if value is not None:
45  # do value and/or type checking and possibly change type and/or value
46  value = self._checkType(varName,value)
47  value = self._checkValue(varName,value)
48  # Do possible additional actions
49  self._setValue(varName,value)
50  instance._attributeDictionary()[self._attributeName(instance)] = value # store the value
51 
52 

◆ _attributeName()

def python.TransformConfig.Descriptor._attributeName (   self,
  instance 
)
privateinherited

Definition at line 53 of file TransformConfig.py.

53  def _attributeName(self,instance):
54  return '_%s__%s' % (instance.__class__.__name__,self.__name)
55 
56 

◆ _checkAllowedValues()

def python.TransformConfig.Descriptor._checkAllowedValues (   self,
  variableName,
  allowedValues 
)
privateinherited

Reimplemented in python.TransformConfig.UniqueList.

Definition at line 122 of file TransformConfig.py.

122  def _checkAllowedValues(self,variableName,allowedValues):
123  # Check all allowed values
124  for v in allowedValues:
125  self._checkType(variableName,v)
126  return allowedValues
127 
128 
129 

◆ _checkType()

def python.TransformConfig.Descriptor._checkType (   self,
  variableName,
  value 
)
privateinherited
Private helper functin to check the type of <value>. May convert to another type.
This implementation does nothing, it just returns value.
This function can be overridden in derived class to do type checking.
It should return the value (possible with new type), or raise a TransformConfigError
exception in case of problems. 

Reimplemented in python.TransformConfig.ListOfStrings, and python.TransformConfig.UniqueList.

Definition at line 83 of file TransformConfig.py.

83  def _checkType(self,variableName,value):
84  """Private helper functin to check the type of <value>. May convert to another type.
85  This implementation does nothing, it just returns value.
86  This function can be overridden in derived class to do type checking.
87  It should return the value (possible with new type), or raise a TransformConfigError
88  exception in case of problems. """
89  return value
90 
91 

◆ _checkValue()

def python.TransformConfig.String._checkValue (   self,
  variableName,
  value 
)
private
Private helper function to check the value of <value>. This function is
called after calling _checkType. <value> can therefore be considered to be
of the correct type.
This implementation checks that the value is one of the allowed values (if defined).
This function can be overridden in derived class to do type & additional value checking.
It has to return the value (adapted if needed) if all is OK. It has to raise
a TransformConfigError exception in case of problems.
<variableName> is the name of the variable that is being set and is typically
only used for error messages.

Reimplemented from python.TransformConfig.Descriptor.

Definition at line 135 of file TransformConfig.py.

135  def _checkValue(self,variableName,value):
136  valType = type(value).__name__
137  if valType != 'str':
138  raise TransformConfigError( '%s should be a string. Got %s instead.' % (variableName, valType) )
139 
140  # check the value against list of possible values
141  return Descriptor._checkValue(self,variableName,value)
142 
143 
144 

◆ _setValue()

def python.TransformConfig.Descriptor._setValue (   self,
  variableName,
  value 
)
privateinherited
Private helper function which is called when the value of the object is set.
It is called after _checkType() and _checkValue(), so the value can be
assumed to be correct.
This function can be overridden in a derived class, typically to trigger additional action
when the value is set.
In case of error, raise a TransformConfigError exception, otherwise just return.
This implementation does nothing.
<variableName> is the name of the variable that is being set and is typically
only used for error messages.

Definition at line 109 of file TransformConfig.py.

109  def _setValue(self,variableName,value):
110  """Private helper function which is called when the value of the object is set.
111  It is called after _checkType() and _checkValue(), so the value can be
112  assumed to be correct.
113  This function can be overridden in a derived class, typically to trigger additional action
114  when the value is set.
115  In case of error, raise a TransformConfigError exception, otherwise just return.
116  This implementation does nothing.
117  <variableName> is the name of the variable that is being set and is typically
118  only used for error messages."""
119  pass
120 
121 

◆ allowedValues()

def python.TransformConfig.Descriptor.allowedValues (   self)
inherited

Definition at line 79 of file TransformConfig.py.

79  def allowedValues(self):
80  return self.__allowed
81 
82 

◆ default()

def python.TransformConfig.Descriptor.default (   self)
inherited

Definition at line 61 of file TransformConfig.py.

61  def default(self):
62  return self.__default
63 
64 

◆ doc()

def python.TransformConfig.Descriptor.doc (   self)
inherited
The documentation string

Definition at line 65 of file TransformConfig.py.

65  def doc(self):
66  """The documentation string"""
67  return self.__doc
68 
69 

◆ help()

def python.TransformConfig.Descriptor.help (   self)
inherited
The help string: type, documentation and possible values

Definition at line 70 of file TransformConfig.py.

70  def help(self):
71  """The help string: type, documentation and possible values"""
72  hlp = '(%s) %s' % (self.__class__.__name__, self.__doc)
73  if self.__allowed:
74  hlp += '. Possible values: %s' % self.__allowed
75 
76  return hlp
77 
78 

◆ name()

def python.TransformConfig.Descriptor.name (   self)
inherited

Definition at line 57 of file TransformConfig.py.

57  def name(self):
58  return self.__name
59 
60 

Member Data Documentation

◆ __allowed

python.TransformConfig.Descriptor.__allowed
privateinherited

Definition at line 19 of file TransformConfig.py.

◆ __default

python.TransformConfig.Descriptor.__default
privateinherited

Definition at line 33 of file TransformConfig.py.

◆ __doc

python.TransformConfig.Descriptor.__doc
privateinherited

Definition at line 18 of file TransformConfig.py.

◆ __name

python.TransformConfig.Descriptor.__name
privateinherited

Definition at line 17 of file TransformConfig.py.


The documentation for this class was generated from the following file:
python.CaloScaleNoiseConfig.help
help
Definition: CaloScaleNoiseConfig.py:76
merge_scale_histograms.doc
string doc
Definition: merge_scale_histograms.py:9
name
std::string name
Definition: Control/AthContainers/Root/debug.cxx:195
python.processes.powheg.ZZ.ZZ.__init__
def __init__(self, base_directory, **kwargs)
Constructor: all process options are set here.
Definition: ZZ.py:18
python.CaloScaleNoiseConfig.type
type
Definition: CaloScaleNoiseConfig.py:78
get
T * get(TKey *tobj)
get a TObject* from a TKey* (why can't a TObject be a TKey?)
Definition: hcg.cxx:127
python.CaloScaleNoiseConfig.default
default
Definition: CaloScaleNoiseConfig.py:79