Inheritance diagram for python.AsgServiceConfig.AsgServiceConfig:

Collaboration diagram for python.AsgServiceConfig.AsgServiceConfig:

Public Member Functions
def	__init__ (self, typeAndName, **kwargs)

def	getName (self)

def	getType (self)

def	__getattr__ (self, name)

def	__setattr__ (self, key, value)

def	__eq__ (self, other)

def	__ne__ (self, other)

def	__str__ (self)

def	addPrivateTool (self, name, type)

Static Public Attributes
int	printHeaderWidth = 80

int	printHeaderPre = 3

Static Private Member Functions
def	_printHeader (title)

def	_printFooter (title)

Private Attributes
	_props

Detailed Description

Standalone Analysis Service Configuration

This class is used to describe the configuration of an analysis service
(a C++ class inheriting from asg::AsgService) in Python. It behaves
similar to an Athena configurable, but is implemented in a much simpler
way.

An example of using it in configuring an EventLoop job could look like:

   job = ROOT.asg.Job()
   ...
   from AsgServices.AsgServiceConfig import AsgServiceConfig
   service = AsgServiceConfig( "asg::UnitTestService1/TestService",
                             property = 1.23 )
   service.string_property = "Foo"
   job.servicesAdd( service )

Note that the python code doesn't know what properties can actually be set
on any given C++ service. Any mistake made in the Python configuration
(apart from syntax errors) is only discovered while initialising the
analysis job.

Definition at line 17 of file AsgServiceConfig.py.

Constructor & Destructor Documentation

◆ init()

def python.AsgServiceConfig.AsgServiceConfig.__init__	(		self,
			typeAndName,
		**	kwargs
	)

Constructor for an service configuration object

Keyword arguments:
  typeAndName -- The type/instance name of the service

Note that you can pass (initial) properties to the constructor like:

   service = AsgServiceConfig( "asg::UnitTestService1/TestService",
                     property = 1.23 )

Definition at line 45 of file AsgServiceConfig.py.

     def __init__( self, typeAndName, **kwargs ):
         """Constructor for an service configuration object
  
         Keyword arguments:
           typeAndName -- The type/instance name of the service
  
         Note that you can pass (initial) properties to the constructor like:
  
            service = AsgServiceConfig( "asg::UnitTestService1/TestService",
                                      property = 1.23 )
         """
  
         # Call the base class's constructor. Use the default constructor instead
         # of the one receiving the type and name, to avoid ROOT-10872.
         super( AsgServiceConfig, self ).__init__()
         self.setTypeAndName( typeAndName )
  
         # Initialise the properties of the service:
         self._props = {}
  
         # Set the properties on the object:
         for key, value in kwargs.items():
             self.setPropertyFromString( key, stringPropValue( value ) )
             self._props[ key ] = copy.deepcopy( value )
             pass
  
         pass
  

Member Function Documentation

◆ eq()

def python.AsgServiceConfig.AsgServiceConfig.__eq__	(	self,
		other
	)

Check for equality with another object

The implementation of this is very simple. We only check that the type
and the name of the services would match.

Definition at line 136 of file AsgServiceConfig.py.

     def __eq__( self, other ):
         """Check for equality with another object
  
         The implementation of this is very simple. We only check that the type
         and the name of the services would match.
         """
  
         # First check that the other object is also an AsgServiceConfig one:
         if not isinstance( other, AsgServiceConfig ):
             return False
  
         # Now check whether the type and the name of the services agree:
         return ( ( self.type() == other.type() ) and
                  ( self.name() == other.name() ) )
  

◆ getattr()

def python.AsgServiceConfig.AsgServiceConfig.__getattr__	(	self,
		name
	)

Get a previously set property value from the configuration

This function allows us to retrieve the value of a property that was
already set for the service, to possibly use it in some configuration
decisions in the Python code itself.

Keyword arguments:
  name -- The name of the property

Definition at line 91 of file AsgServiceConfig.py.

     def __getattr__( self, name ):
         """Get a previously set property value from the configuration
  
         This function allows us to retrieve the value of a property that was
         already set for the service, to possibly use it in some configuration
         decisions in the Python code itself.
  
         Keyword arguments:
           name -- The name of the property
         """
  
         # Fail if the property was not (yet) set:
         if not name in self._props:
             raise AttributeError( 'Property \'%s\' was not set on \'%s/%s\'' %
                                   ( name, self.type(), self.name() ) )
  
         # Return the property value:
         return self._props[ name ]
  

◆ ne()

def python.AsgServiceConfig.AsgServiceConfig.__ne__	(	self,
		other
	)

Check for an inequality with another object

This is just defined to make the '!=' operator of Python behave
consistently with the '==' operator for such objects.

Definition at line 151 of file AsgServiceConfig.py.

     def __ne__( self, other ):
         """Check for an inequality with another object
  
         This is just defined to make the '!=' operator of Python behave
         consistently with the '==' operator for such objects.
         """
         return not self.__eq__( other )
  

◆ setattr()

def python.AsgServiceConfig.AsgServiceConfig.__setattr__	(	self,
		key,
		value
	)

Set an service property on an existing configuration object

This function allows us to set/override properties on an service
configuration object. Allowing for the following syntax:

   service = ...
   service.IntProperty = 66
   service.FloatProperty = 3.141592
   service.StringProperty = "Foo"

Keyword arguments:
  key   -- The key/name of the property
  value -- The value to set for the property

Definition at line 110 of file AsgServiceConfig.py.

     def __setattr__( self, key, value ):
         """Set an service property on an existing configuration object
  
         This function allows us to set/override properties on an service
         configuration object. Allowing for the following syntax:
  
            service = ...
            service.IntProperty = 66
            service.FloatProperty = 3.141592
            service.StringProperty = "Foo"
  
         Keyword arguments:
           key   -- The key/name of the property
           value -- The value to set for the property
         """
  
         # Private variables should be set directly:
         if key[ 0 ] == '_':
             return super( AsgServiceConfig, self ).__setattr__( key, value )
  
         # Set the property, and remember its value:
         super( AsgServiceConfig,
                self ).setPropertyFromString( key, stringPropValue( value ) )
         self._props[ key ] = copy.deepcopy( value )
         pass
  

◆ str()

def python.AsgServiceConfig.AsgServiceConfig.__str__ ( self )

Print the service configuration in a user friendly way

This is just to help with debugging configurations, allowing
the user to get a nice printout of their job configuration.

Definition at line 159 of file AsgServiceConfig.py.

     def __str__( self ):
         """Print the service configuration in a user friendly way
  
         This is just to help with debugging configurations, allowing
         the user to get a nice printout of their job configuration.
         """
  
         name = 'Service %s/%s' % ( self.type(), self.name() )
         result = AsgServiceConfig._printHeader( name )
         result += '\n'
         for key, value in sorted( self._props.items() ):
             if isinstance( value, str ):
                 printedValue = "'%s'" % value
             else:
                 printedValue = value
                 pass
             result += "|- %s: %s\n" % ( key, indentBy( printedValue, "| " ) )
             pass
         result += AsgServiceConfig._printFooter( name )
         return result
  

◆ _printFooter()

def python.AsgServiceConfig.AsgServiceConfig._printFooter ( title )

staticprivate

Produce a nice footer when printing the configuration

This function is used for printing the footer of both services
and tools.

Keyword arguments:
  indentString -- String used as indentation
  title        -- The title of the service/tool

Definition at line 241 of file AsgServiceConfig.py.

     def _printFooter( title ):
         """Produce a nice footer when printing the configuration
  
         This function is used for printing the footer of both services
         and tools.
  
         Keyword arguments:
           indentString -- String used as indentation
           title        -- The title of the service/tool
         """
  
         preLength = AsgServiceConfig.printHeaderPre
         postLength = AsgServiceConfig.printHeaderWidth - 12 - preLength - \
             len( title )
         return '\\%s (End of %s) %s' % ( preLength * '-', title,
                                          postLength * '-' )
  

◆ _printHeader()

def python.AsgServiceConfig.AsgServiceConfig._printHeader ( title )

staticprivate

Produce a nice header when printing the configuration

This function is used for printing the header of both services
and tools.

Keyword arguments:
  indentString -- String used as indentation
  title        -- The title of the service/tool

Definition at line 224 of file AsgServiceConfig.py.

     def _printHeader( title ):
         """Produce a nice header when printing the configuration
  
         This function is used for printing the header of both services
         and tools.
  
         Keyword arguments:
           indentString -- String used as indentation
           title        -- The title of the service/tool
         """
  
         preLength = AsgServiceConfig.printHeaderPre
         postLength = AsgServiceConfig.printHeaderWidth - 3 - preLength - \
             len( title )
         return '/%s %s %s' % ( preLength * '*', title, postLength * '*' )
  

◆ addPrivateTool()

def python.AsgServiceConfig.AsgServiceConfig.addPrivateTool	(	self,
		name,
		type
	)

Create a private tool for the service

This function is used in 'standalone' mode to declare a private tool
for the service, or a private tool for an already declared private
tool.

Can be used like:
  config.addPrivateTool( 'tool1', 'ToolType1' )
  config.addPrivateTool( 'tool1.tool2', 'ToolType2' )

Keyword arguments:
  name -- The full name of the private tool
  type -- The C++ type of the private tool

Definition at line 180 of file AsgServiceConfig.py.

     def addPrivateTool( self, name, type ):
         """Create a private tool for the service
  
         This function is used in 'standalone' mode to declare a private tool
         for the service, or a private tool for an already declared private
         tool.
  
         Can be used like:
           config.addPrivateTool( 'tool1', 'ToolType1' )
           config.addPrivateTool( 'tool1.tool2', 'ToolType2' )
  
         Keyword arguments:
           name -- The full name of the private tool
           type -- The C++ type of the private tool
         """
  
         # And now set up the Python object that will take care of setting
         # properties on this tool.
  
         # Tokenize the tool's name. In case it is a subtool of a tool, or
         # something possibly even deeper.
         toolNames = name.split( '.' )
  
         # Look up the component that we need to set up the private tool on.
         component = self
         for tname in toolNames[ 0 : -1 ]:
             component = getattr( component, tname )
             pass
  
         # Check that the component doesn't have such a (tool) property yet.
         if hasattr( component, toolNames[ -1 ] ):
             raise RuntimeError( "Tool with name '%s' already exists" % name )
             pass
  
         # Now set up a smart object as a property on that component.
         component._props[ toolNames[ -1 ] ] = PrivateToolConfig( self, name,
                                                                  type )
  
         # Finally, tell the C++ code what to do.
         self.createPrivateTool( name, type ).ignore()
  
         pass
  

◆ getName()

def python.AsgServiceConfig.AsgServiceConfig.getName ( self )

Get the instance name of the service

This is for compatibility with the getName() function of Athena
configurables.

Definition at line 73 of file AsgServiceConfig.py.

     def getName( self ):
         """Get the instance name of the service
  
         This is for compatibility with the getName() function of Athena
         configurables.
         """
  
         return self.name()
  

◆ getType()

def python.AsgServiceConfig.AsgServiceConfig.getType ( self )

Get the type name of the service

This is for compatibility with the getType() function of Athena
configurables.

Definition at line 82 of file AsgServiceConfig.py.

     def getType( self ):
         """Get the type name of the service
  
         This is for compatibility with the getType() function of Athena
         configurables.
         """
  
         return self.type()
  

Member Data Documentation

◆ _props

python.AsgServiceConfig.AsgServiceConfig._props

private

Definition at line 63 of file AsgServiceConfig.py.

◆ printHeaderPre

int python.AsgServiceConfig.AsgServiceConfig.printHeaderPre = 3

static

Definition at line 43 of file AsgServiceConfig.py.

◆ printHeaderWidth

int python.AsgServiceConfig.AsgServiceConfig.printHeaderWidth = 80

static

Definition at line 42 of file AsgServiceConfig.py.

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

AsgServiceConfig.py

Public Member Functions

Static Public Attributes

Static Private Member Functions

Private Attributes