Inheritance diagram for python.AsgServiceConfig.AsgServiceConfig:

Collaboration diagram for python.AsgServiceConfig.AsgServiceConfig:

Public Member Functions
	__init__ (self, typeAndName, **kwargs)
	getName (self)
	getType (self)
	__getattr__ (self, name)
	__setattr__ (self, key, value)
	__eq__ (self, other)
	__ne__ (self, other)
	__str__ (self)
	addPrivateTool (self, name, type)

Static Public Attributes
int	printHeaderWidth = 80
int	printHeaderPre = 3

Static Protected Member Functions
	_printHeader (title)
	_printFooter (title)

Protected Attributes
dict	_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()

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()

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()

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()

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()

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()

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()

python.AsgServiceConfig.AsgServiceConfig._printFooter ( title )

staticprotected

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()

python.AsgServiceConfig.AsgServiceConfig._printHeader ( title )

staticprotected

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()

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()

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()

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

dict python.AsgServiceConfig.AsgServiceConfig._props = {}

protected

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 Protected Member Functions

Protected Attributes