Inheritance diagram for conffwk.Configuration.Configuration:

Collaboration diagram for conffwk.Configuration.Configuration:

Public Member Functions
	__core_init__ (self)

	__init__ (self, connection='oksconflibs:')

	databases (self)

	set_active (self, name)

	__initialize_cache__ (self)

	__update_cache__ (self, objs)

	__delete_cache__ (self, objs)

	__retrieve_cache__ (self, class_name, id=None)

	get_objs (self, class_name, query='')

	attributes (self, class_name, all=False)

	relations (self, class_name, all=False)

	superclasses (self, class_name, all=False)

	subclasses (self, class_name, all=False)

	classes (self)

	create_db (self, db_name, includes)

	get_includes (self, at=None)

	remove_include (self, include, at=None)

	add_include (self, include, at=None)

	__str__ (self)

	__repr__ (self)

	create_obj (self, class_name, uid, at=None)

	get_obj (self, class_name, uid)

	add_dal (self, dal_obj, at=None, cache=None, recurse=True)

	update_dal (self, dal_obj, ignore_error=True, at=None, cache=None, recurse=False)

	update_dal_permissive (self, dal_obj, at=None, cache=None, recurse=False)

	update_dal_pedantic (self, dal_obj, at=None, cache=None, recurse=False)

	get_dal (self, class_name, uid)

	get_dals (self, class_name)

	get_all_dals (self)

	destroy_dal (self, dal_obj)

	destroy_obj (self, obj)

Public Attributes
list	databases = []

	active_database = None

	add_dal

	get_obj

Private Attributes
	__schema__ = schema.Cache(self, all=True)

dict	__cache__ = {}

Additional Inherited Members
Static Public Attributes inherited from conffwk.Configuration._ConfigurationProxy
	memberclass = _Configuration

Detailed Description

Access OKS/RDB configuration databases from python.

Definition at line 24 of file Configuration.py.

Constructor & Destructor Documentation

◆ init()

conffwk.Configuration.Configuration.__init__	(		self,
			connection = 'oksconflibs:' )

Initializes a Configuration database.

Keyword arguments:

connection -- A connection string, in the form of <backend>:<database>
name, where <backend> may be set to be 'oksconflibs' or 'rdbconffwk' and
<database> is either the name of the database XML file (in the case of
'oksconflibs') or the name of a database associated with an RDB server
(in the case of 'rdbconffwk').

Warning: To use the RDB server, the IPC subsystem has to be initialized
beforehand and as this is not done by this package. If the parameter
'connection' is empty, the default is whatever is the default for the
conffwk::Configuration C++ class, which at this time boils down to look
if TDAQ_DB is set and take that default.

Raises RuntimeError, in case of problems.

Definition at line 43 of file Configuration.py.

    def __init__(self, connection='oksconflibs:'):
        """Initializes a Configuration database.
 
        Keyword arguments:
 
        connection -- A connection string, in the form of <backend>:<database>
        name, where <backend> may be set to be 'oksconflibs' or 'rdbconffwk' and
        <database> is either the name of the database XML file (in the case of
        'oksconflibs') or the name of a database associated with an RDB server
        (in the case of 'rdbconffwk').
 
        Warning: To use the RDB server, the IPC subsystem has to be initialized
        beforehand and as this is not done by this package. If the parameter
        'connection' is empty, the default is whatever is the default for the
        conffwk::Configuration C++ class, which at this time boils down to look
        if TDAQ_DB is set and take that default.
 
        Raises RuntimeError, in case of problems.
        """
 
        try:
            super(Configuration, self).__init__(connection)
        except RuntimeError:
            preamble = f"Unable to open database off of \"{connection}\""
            if not re.search(r"^oksconflibs:", connection):
                raise RuntimeError(f"""
{preamble}; one reason is that it looks 
like the database type wasn't specified in the name (i.e. \"oksconflibs:<filename>\")
""")
            else:
                dbfilename = connection[len("oksconflibs:"):]
                if not os.path.exists(dbfilename):
                    raise RuntimeError(f"{preamble}; one reason is that it looks like \"{dbfilename}\" doesn't exist")
                elif not re.search(r".xml$", dbfilename):
                    raise RuntimeError(f"{preamble}; one reason is that it looks like \"{dbfilename}\" isn't an XML file")
                else:
                    raise RuntimeError(f"""
{preamble}; try running
\"oks_dump --files-only {dbfilename}\"
to see if there's a problem with the input database""")
 
        self.__core_init__()
 

Member Function Documentation

◆ __core_init__()

conffwk.Configuration.Configuration.__core_init__ ( self )

Definition at line 28 of file Configuration.py.

    def __core_init__(self):
        self.__schema__ = schema.Cache(self, all=True)
        self.__schema__.update_dal(self)
 
        # initialize the inner set of configuration files available
        self.databases = []
        self.active_database = None
        if self.get_impl_param():
            self.databases.append(self.get_impl_param())
            self.active_database = self.get_impl_param()
 
        # we keep a cache of DAL'ed objects
        self.__cache__ = {}
        self.__initialize_cache__()
 

◆ __delete_cache__()

conffwk.Configuration.Configuration.__delete_cache__	(		self,
			objs )

Updates the internal DAL cache

Definition at line 113 of file Configuration.py.

    def __delete_cache__(self, objs):
        """Updates the internal DAL cache"""
        for obj in objs:
            for oks_type in obj.oksTypes():
                if obj.id in self.__cache__[oks_type]:
                    del self.__cache__[oks_type][obj.id]
 

◆ __initialize_cache__()

conffwk.Configuration.Configuration.__initialize_cache__ ( self )

Initializes the internal DAL cache

Definition at line 101 of file Configuration.py.

    def __initialize_cache__(self):
        """Initializes the internal DAL cache"""
        for k in self.classes():
            if k not in self.__cache__:
                self.__cache__[k] = {}
 

◆ repr()

conffwk.Configuration.Configuration.__repr__ ( self )

Definition at line 340 of file Configuration.py.

    def __repr__(self):
        return '<Configuration \'' + self.get_impl_spec() + '\'>'
 

◆ __retrieve_cache__()

conffwk.Configuration.Configuration.__retrieve_cache__	(	self,
		class_name,
		id = None )

Retrieves all objects that match a certain class_name/id

Definition at line 120 of file Configuration.py.

    def __retrieve_cache__(self, class_name, id=None):
        """Retrieves all objects that match a certain class_name/id"""
        if id:
            if id in self.__cache__[class_name]:
                return self.__cache__[class_name][id]
        else:
            return iter(self.__cache__[class_name].values())
 

◆ str()

conffwk.Configuration.Configuration.__str__ ( self )

Definition at line 336 of file Configuration.py.

    def __str__(self):
        return self.get_impl_spec() + \
            ', %d classes loaded' % len(self.classes())
 

◆ __update_cache__()

conffwk.Configuration.Configuration.__update_cache__	(		self,
			objs )

Updates the internal DAL cache

Definition at line 107 of file Configuration.py.

    def __update_cache__(self, objs):
        """Updates the internal DAL cache"""
        for obj in objs:
            for oks_type in obj.oksTypes():
                self.__cache__[oks_type][obj.id] = obj
 

◆ add_dal()

conffwk.Configuration.Configuration.add_dal	(	self,
		dal_obj,
		at = None,
		cache = None,
		recurse = True )

Updates the related ConfigObject in the database using a DAL
reflection.

This method will take the properties of the DAL object passed as
parameter and will try to either create or update the relevant
ConfigObject in the database, at the file specified. It does this
recursively, in colaboration with the ConfigObject class.

Keyword arguments:

dal_obj -- This is the DAL object that will be used for the operation.
It should be a reflection of the ConfigObject you want to create.

at -- This is either the name of database you want to create the object
at, or another ConfigObject that will be used as a reference to
determine at which database to create the new object. If set to None
(the default), I'll simply use the value of 'self.active_database',
hoping for the best.

cache -- This is a cache that may be set by the Configuration object if
necessary. Users should *never* set this variable. This variable is
there to handle recursions gracefully.

recurse -- This is a boolean flag that indicates if you want to enable
recursion or not in the update. If set to 'True' (the default), I'll
recurse until all objects in the tree that do *not* exist yet in the
database are created (existing objects are gracefully ignored).
Otherwise, I'll not recurse at all and just make sure the attributes
and relationships of the object passed as parameter are set to what you
determine they should be.  Please note that if you decide to update
relationships, that the objects to which you are pointing to should be
available in the database (directly or indirectly through includes) if
you choose to do this non-recursively.

Returns the ConfigObject you wanted to create or update, that you may
ignore for practical purposes.

Definition at line 380 of file Configuration.py.

    def add_dal(self, dal_obj, at=None, cache=None, recurse=True):
        """Updates the related ConfigObject in the database using a DAL
        reflection.
 
        This method will take the properties of the DAL object passed as
        parameter and will try to either create or update the relevant
        ConfigObject in the database, at the file specified. It does this
        recursively, in colaboration with the ConfigObject class.
 
        Keyword arguments:
 
        dal_obj -- This is the DAL object that will be used for the operation.
        It should be a reflection of the ConfigObject you want to create.
 
        at -- This is either the name of database you want to create the object
        at, or another ConfigObject that will be used as a reference to
        determine at which database to create the new object. If set to None
        (the default), I'll simply use the value of 'self.active_database',
        hoping for the best.
 
        cache -- This is a cache that may be set by the Configuration object if
        necessary. Users should *never* set this variable. This variable is
        there to handle recursions gracefully.
 
        recurse -- This is a boolean flag that indicates if you want to enable
        recursion or not in the update. If set to 'True' (the default), I'll
        recurse until all objects in the tree that do *not* exist yet in the
        database are created (existing objects are gracefully ignored).
        Otherwise, I'll not recurse at all and just make sure the attributes
        and relationships of the object passed as parameter are set to what you
        determine they should be.  Please note that if you decide to update
        relationships, that the objects to which you are pointing to should be
        available in the database (directly or indirectly through includes) if
        you choose to do this non-recursively.
 
        Returns the ConfigObject you wanted to create or update, that you may
        ignore for practical purposes.
        """
        if not cache:
            cache = {}
 
        if self.test_object(dal_obj.className(), dal_obj.id, 0, []):
            obj = super(Configuration, self).get_obj(
                dal_obj.className(), dal_obj.id)
            co = ConfigObject.ConfigObject(obj, self.__schema__, self)
            cache[dal_obj.fullName()] = co
            self.__update_cache__([dal_obj])
 
        else:
            if not at:
                at = self.active_database
            obj = super(Configuration, self) \
                .create_obj(at, dal_obj.className(),
                            dal_obj.id)
            co = ConfigObject.ConfigObject(obj, self.__schema__, self)
            cache[dal_obj.fullName()] = co
            co.update_dal(dal_obj, self.add_dal, self.get_obj, cache=cache,
                          recurse=recurse)
            self.__update_cache__([dal_obj])
 
        return co
 

◆ add_include()

conffwk.Configuration.Configuration.add_include	(	self,
		include,
		at = None )

Adds a new include to the database.

This method includes new files in the include section of your database.
You can specify the file to which you want to add the include file.
If you don't, it uses the last opened (active) file.

Keyword parameters:

include -- This is a single include to add into your database

at -- This is the name of database you want to add the include at,
If set to None (the default), I'll simply use the value of
'self.active_database', hoping for the best.

Definition at line 312 of file Configuration.py.

    def add_include(self, include, at=None):
        """Adds a new include to the database.
 
        This method includes new files in the include section of your database.
        You can specify the file to which you want to add the include file.
        If you don't, it uses the last opened (active) file.
 
        Keyword parameters:
 
        include -- This is a single include to add into your database
 
        at -- This is the name of database you want to add the include at,
        If set to None (the default), I'll simply use the value of
        'self.active_database', hoping for the best.
        """
        if not at:
            at = self.active_database
        if include not in self.get_includes(at):
            super(Configuration, self).add_include(at, include)
            # we take this opportunity to update the class cache we have
            self.__schema__.update(self)
            self.__schema__.update_dal(self)
            self.__initialize_cache__()
 

◆ attributes()

conffwk.Configuration.Configuration.attributes	(	self,
		class_name,
		all = False )

Returns a list of attributes of the named class

This method will return a list of direct (not inherited) attributes of
a certain class as a python list. If the 'all' flag is set to True,
then direct and inherited attributes are returned.

Keyword arguments:

class_name -- This is the class of the object you want to inspect.

all -- If set to 'True', returns direct and inherited attributes,
otherwise, only direct attributes (the default).

Raises RuntimeError on problems

Definition at line 148 of file Configuration.py.

    def attributes(self, class_name, all=False):
        """Returns a list of attributes of the named class
 
        This method will return a list of direct (not inherited) attributes of
        a certain class as a python list. If the 'all' flag is set to True,
        then direct and inherited attributes are returned.
 
        Keyword arguments:
 
        class_name -- This is the class of the object you want to inspect.
 
        all -- If set to 'True', returns direct and inherited attributes,
        otherwise, only direct attributes (the default).
 
        Raises RuntimeError on problems
        """
        attribute_properties_as_strings = super(Configuration, self).attributes(class_name, all)
        attribute_properties_to_return = {}
        for attribute, properties in attribute_properties_as_strings.items():
 
            for k, v in properties.items():
                if v == "None":
                    properties[k] = None
                elif v == "True":
                    properties[k] = True
                elif v == "False":
                    properties[k] = False
 
            attribute_properties_to_return[attribute] = properties
 
        return attribute_properties_to_return
 

◆ classes()

conffwk.Configuration.Configuration.classes ( self )

Returns a list of all classes loaded in this Configuration.

Definition at line 250 of file Configuration.py.

    def classes(self):
        """Returns a list of all classes loaded in this Configuration."""
        return list(super(Configuration, self).classes())
 

◆ create_db()

conffwk.Configuration.Configuration.create_db	(	self,
		db_name,
		includes )

Creates a new database on the specified server, sets it active.

This method creates a new database on the specified server. If the
server is not specified, what is returned by get_impl_name() is used.
After the creation, this database immediately becomes the "active"
database where new objects will be created at. You can reset that
using the "set_active()" call in objects of this class.

Keyword parameters:

db_name -- The name of the database to create.

includes -- A list of includes this database will have.

Definition at line 254 of file Configuration.py.

    def create_db(self, db_name, includes):
        """Creates a new database on the specified server, sets it active.
 
        This method creates a new database on the specified server. If the
        server is not specified, what is returned by get_impl_name() is used.
        After the creation, this database immediately becomes the "active"
        database where new objects will be created at. You can reset that
        using the "set_active()" call in objects of this class.
 
        Keyword parameters:
 
        db_name -- The name of the database to create.
 
        includes -- A list of includes this database will have.
        """
        super(Configuration, self).create_db(db_name, includes)
 
        # we take this opportunity to update the class cache we have
        self.__schema__.update(self)
        self.__schema__.update_dal(self)
        self.__initialize_cache__()
 
        # and to set the current available databases and active database
        if db_name not in self.databases:
            self.databases.append(db_name)
        self.active_database = db_name
 

◆ create_obj()

conffwk.Configuration.Configuration.create_obj	(	self,
		class_name,
		uid,
		at = None )

Creates a new ConfigObject, related with the database you specify.

Keyword arguments:

class_name -- This is the name of the OKS Class to be used for the
newly created object. It has to be amongst one of the classes returned
by the "classes()" method.

uid -- This is the UID of the object inside the OKS database.

at -- This is either the name of database you want to create the object
at, or another ConfigObject that will be used as a reference to
determine at which database to create the new object. If set to None
(the default), I'll simply use the value of 'self.active_database',
hoping for the best.

Definition at line 343 of file Configuration.py.

    def create_obj(self, class_name, uid, at=None):
        """Creates a new ConfigObject, related with the database you specify.
 
        Keyword arguments:
 
        class_name -- This is the name of the OKS Class to be used for the
        newly created object. It has to be amongst one of the classes returned
        by the "classes()" method.
 
        uid -- This is the UID of the object inside the OKS database.
 
        at -- This is either the name of database you want to create the object
        at, or another ConfigObject that will be used as a reference to
        determine at which database to create the new object. If set to None
        (the default), I'll simply use the value of 'self.active_database',
        hoping for the best.
        """
        if not at:
            at = self.active_database
        obj = super(Configuration, self).create_obj(at, class_name, uid)
        return ConfigObject.ConfigObject(obj, self.__schema__, self)
 

◆ databases()

conffwk.Configuration.Configuration.databases ( self )

Returns a list of associated databases which are opened

Definition at line 86 of file Configuration.py.

    def databases(self):
        """Returns a list of associated databases which are opened"""
        return self.databases
 

◆ destroy_dal()

conffwk.Configuration.Configuration.destroy_dal	(		self,
			dal_obj )

Destroyes the Database counterpart of the DAL object given.

This method will destroy the equivalent ConfigObject reflection from
this Configuration object.

Keyword parameters:

dal_obj -- This is the DAL reflection of the object you want to delete.

Definition at line 615 of file Configuration.py.

    def destroy_dal(self, dal_obj):
        """Destroyes the Database counterpart of the DAL object given.
 
        This method will destroy the equivalent ConfigObject reflection from
        this Configuration object.
 
        Keyword parameters:
 
        dal_obj -- This is the DAL reflection of the object you want to delete.
 
        """
        if self.test_object(dal_obj.className(), dal_obj.id, 0, []):
            obj = self.get_obj(dal_obj.className(), dal_obj.id)
            self.destroy_obj(obj)
        self.__delete_cache__((dal_obj,))
 

◆ destroy_obj()

conffwk.Configuration.Configuration.destroy_obj	(		self,
			obj )

Destroyes the given database object.

This method will destroy the given ConfigObject object.

Definition at line 631 of file Configuration.py.

    def destroy_obj(self, obj):
        """Destroyes the given database object.
 
        This method will destroy the given ConfigObject object.
 
        """
 
        # the C++ implementation of destroy_obj wants
        # a libpyconffwk.ConfigObject instance. So
        # we have to extract it from our proxy
        return super(Configuration, self).destroy_obj(obj._obj)

◆ get_all_dals()

conffwk.Configuration.Configuration.get_all_dals ( self )

Retrieves (multiple) DAL reflections of ConfigObjects in this
database.

This method acts recursively, until all objects deriving from the
object you are retrieving have been returned.

Returns DAL representations of objects in this Configuration database.

Definition at line 583 of file Configuration.py.

    def get_all_dals(self):
        """Retrieves (multiple) DAL reflections of ConfigObjects in this
        database.
 
        This method acts recursively, until all objects deriving from the
        object you are retrieving have been returned.
 
        Returns DAL representations of objects in this Configuration database.
        """
        from .ConfigObject import ConfigObject as CO
 
        # get the unique values existing in the cache (probably few)
        retval = {}
        for v in self.__cache__.values():
            for k in v.values():
                if k.fullName() not in retval:
                    retval[k.fullName()] = k
 
        # put all objects in the cache and update the return list
        for class_name in self.classes():
            for k in super(Configuration,
                           self).get_objs(class_name,
                                          '(this (object-id \"\" !=))'):
                if k.UID() not in self.__cache__[class_name]:
                    j = CO(k, self.__schema__, self).as_dal(self.__cache__)
                    retval[j.fullName()] = j
                else:
                    j = self.__cache__[class_name][k.UID()]
                    retval[j.fullName()] = j
 
        return retval
 

◆ get_dal()

conffwk.Configuration.Configuration.get_dal	(	self,
		class_name,
		uid )

Retrieves a DAL reflection of a ConfigObject in this OKS database.

This method acts recursively, until all objects deriving from the
object you are retrieving have been returned. It is possible to reach
the python limit using this. If that is the case, make sure to extend
this limit with the following technique:

import sys
sys.setrecursionlimit(10000) # for example

Keyword arguments:

class_name -- The name of the OKS class of the object you are trying to
retrieve

uid -- This is the object's UID.

Returns DAL representations of object in this Configuration database.

Definition at line 538 of file Configuration.py.

    def get_dal(self, class_name, uid):
        """Retrieves a DAL reflection of a ConfigObject in this OKS database.
 
        This method acts recursively, until all objects deriving from the
        object you are retrieving have been returned. It is possible to reach
        the python limit using this. If that is the case, make sure to extend
        this limit with the following technique:
 
        import sys
        sys.setrecursionlimit(10000) # for example
 
        Keyword arguments:
 
        class_name -- The name of the OKS class of the object you are trying to
        retrieve
 
        uid -- This is the object's UID.
 
        Returns DAL representations of object in this Configuration database.
        """
        if uid not in self.__cache__[class_name]:
            obj = self.get_obj(class_name, uid)
            obj.as_dal(self.__cache__)
        return self.__cache__[class_name][uid]
 

◆ get_dals()

conffwk.Configuration.Configuration.get_dals	(		self,
			class_name )

Retrieves (multiple) DAL reflections of ConfigObjects in this
database.

This method acts recursively, until all objects deriving from the
object you are retrieving have been returned.

Keyword arguments:

class_name -- The name of the OKS class of the objects you are trying
to retrieve

Returns DAL representations of objects in this Configuration database.

Definition at line 563 of file Configuration.py.

    def get_dals(self, class_name):
        """Retrieves (multiple) DAL reflections of ConfigObjects in this
        database.
 
        This method acts recursively, until all objects deriving from the
        object you are retrieving have been returned.
 
        Keyword arguments:
 
        class_name -- The name of the OKS class of the objects you are trying
        to retrieve
 
        Returns DAL representations of objects in this Configuration database.
        """
 
        for k in self.get_objs(class_name):
            if k.UID() not in self.__cache__[class_name]:
                k.as_dal(self.__cache__)
        return list(self.__cache__[class_name].values())
 

◆ get_includes()

conffwk.Configuration.Configuration.get_includes	(		self,
			at = None )

Returns a a list of all includes in a certain database.

Keyword arguments:

at -- This is the name of the database you want to get the includes
from. If set to 'None' (the default) we use whatever
self.active_database is set to hoping for the best.

Definition at line 281 of file Configuration.py.

    def get_includes(self, at=None):
        """Returns a a list of all includes in a certain database.
 
        Keyword arguments:
 
        at -- This is the name of the database you want to get the includes
        from. If set to 'None' (the default) we use whatever
        self.active_database is set to hoping for the best.
        """
        if not at:
            at = self.active_database
        return super(Configuration, self).get_includes(at)
 

◆ get_obj()

conffwk.Configuration.Configuration.get_obj	(	self,
		class_name,
		uid )

Retrieves a ConfigObject you specified.

Keyword arguments:

class_name -- This is the name of the OKS Class to be used for the
search. It has to be amongst one of the classes returned by the
"classes()" method.

uid -- This is the UID of the object inside the OKS database.

Definition at line 365 of file Configuration.py.

    def get_obj(self, class_name, uid):
        """Retrieves a ConfigObject you specified.
 
        Keyword arguments:
 
        class_name -- This is the name of the OKS Class to be used for the
        search. It has to be amongst one of the classes returned by the
        "classes()" method.
 
        uid -- This is the UID of the object inside the OKS database.
 
        """
        obj = super(Configuration, self).get_obj(class_name, uid)
        return ConfigObject.ConfigObject(obj, self.__schema__, self)
 

◆ get_objs()

conffwk.Configuration.Configuration.get_objs	(	self,
		class_name,
		query = '' )

Returns a python list of ConfigObject's with the given class name.

Keyword arguments:

class_name -- This is the name of the OKS Class to be used for the
search. It has to be amongst one of the classes returned by the
"classes()" method.

query -- This is specific OKS query you may want to perform to reduce
the returned subset. By default it is empty, what makes me return all
objects for which the class (or base class) matches the 'class_name'
parameter you set.

Returns a (python) list with conffwk.ConfigObject's

Definition at line 128 of file Configuration.py.

    def get_objs(self, class_name, query=''):
        """Returns a python list of ConfigObject's with the given class name.
 
        Keyword arguments:
 
        class_name -- This is the name of the OKS Class to be used for the
        search. It has to be amongst one of the classes returned by the
        "classes()" method.
 
        query -- This is specific OKS query you may want to perform to reduce
        the returned subset. By default it is empty, what makes me return all
        objects for which the class (or base class) matches the 'class_name'
        parameter you set.
 
        Returns a (python) list with conffwk.ConfigObject's
        """
        objs = super(Configuration, self).get_objs(class_name, query)
        return [ConfigObject.ConfigObject(k, self.__schema__, self)
                for k in objs]
 

◆ relations()

conffwk.Configuration.Configuration.relations	(	self,
		class_name,
		all = False )

Returns a list of attributes of the named class

This method will return a list of direct (not inherited) relationships
of a certain class as a python list. If the 'all' flag is set to True,
then direct and inherited attributes are returned.

Keyword arguments:

class_name -- This is the class of the object you want to inspect.

all -- If set to 'True', returns direct and inherited relationships,
otherwise, only direct relationships (the default).

Raises RuntimeError on problems

Definition at line 180 of file Configuration.py.

    def relations(self, class_name, all=False):
        """Returns a list of attributes of the named class
 
        This method will return a list of direct (not inherited) relationships
        of a certain class as a python list. If the 'all' flag is set to True,
        then direct and inherited attributes are returned.
 
        Keyword arguments:
 
        class_name -- This is the class of the object you want to inspect.
 
        all -- If set to 'True', returns direct and inherited relationships,
        otherwise, only direct relationships (the default).
 
        Raises RuntimeError on problems
        """
        relationship_properties_as_strings = super(Configuration, self).relations(class_name, all)
        relationship_properties_to_return = {}
 
        for relationship, properties in relationship_properties_as_strings.items():
 
            for k, v in properties.items():
                if v == "None":
                    properties[k] = None
                elif v == "True":
                    properties[k] = True
                elif v == "False":
                    properties[k] = False
 
            relationship_properties_to_return[relationship] = properties
 
        return relationship_properties_to_return
 
 

◆ remove_include()

conffwk.Configuration.Configuration.remove_include	(	self,
		include,
		at = None )

Removes a included file in a certain database.

This method will remove include files from the active database or from
any other include database if mentioned.

Keyword parameters:

include -- A single include to remove from the database.

at -- This is the name of database you want to remove the include(s)
from, If set to None (the default), I'll simply use the value of
'self.active_database', hoping for the best.

Definition at line 294 of file Configuration.py.

    def remove_include(self, include, at=None):
        """Removes a included file in a certain database.
 
        This method will remove include files from the active database or from
        any other include database if mentioned.
 
        Keyword parameters:
 
        include -- A single include to remove from the database.
 
        at -- This is the name of database you want to remove the include(s)
        from, If set to None (the default), I'll simply use the value of
        'self.active_database', hoping for the best.
        """
        if not at:
            at = self.active_database
        super(Configuration, self).remove_include(at, include)
 

◆ set_active()

conffwk.Configuration.Configuration.set_active	(		self,
			name )

Sets a database to become active when adding new objects.

This method raises NameError in case a database cannot be made active.

Definition at line 90 of file Configuration.py.

    def set_active(self, name):
        """Sets a database to become active when adding new objects.
 
        This method raises NameError in case a database cannot be made active.
        """
 
        if name in self.databases:
            self.active_database = name
        else:
            raise NameError('database "%s is not loaded in this object' % name)
 

◆ subclasses()

conffwk.Configuration.Configuration.subclasses	(	self,
		class_name,
		all = False )

Returns a list of subclasses of the named class

This method will return a list of direct (not inherited) subclasses of
a certain class as a python list. If the 'all' flag is set to True,
then direct and inherited attributes are returned.

Keyword arguments:

class_name -- This is the class of the object you want to inspect.

all -- If set to 'True', returns direct and inherited subclasses,
otherwise, only direct subclasses (the default).

Raises RuntimeError on problems

Definition at line 232 of file Configuration.py.

    def subclasses(self, class_name, all=False):
        """Returns a list of subclasses of the named class
 
        This method will return a list of direct (not inherited) subclasses of
        a certain class as a python list. If the 'all' flag is set to True,
        then direct and inherited attributes are returned.
 
        Keyword arguments:
 
        class_name -- This is the class of the object you want to inspect.
 
        all -- If set to 'True', returns direct and inherited subclasses,
        otherwise, only direct subclasses (the default).
 
        Raises RuntimeError on problems
        """
        return super(Configuration, self).subclasses(class_name, all)
 

◆ superclasses()

conffwk.Configuration.Configuration.superclasses	(	self,
		class_name,
		all = False )

Returns a list of superclasses of the named class

This method will return a list of direct (not inherited) superclasses
of a certain class as a python list. If the 'all' flag is set to True,
then direct and inherited attributes are returned.

Keyword arguments:

class_name -- This is the class of the object you want to inspect.

all -- If set to 'True', returns direct and inherited superclasses,
otherwise, only direct superclasses (the default).

Raises RuntimeError on problems

Definition at line 214 of file Configuration.py.

    def superclasses(self, class_name, all=False):
        """Returns a list of superclasses of the named class
 
        This method will return a list of direct (not inherited) superclasses
        of a certain class as a python list. If the 'all' flag is set to True,
        then direct and inherited attributes are returned.
 
        Keyword arguments:
 
        class_name -- This is the class of the object you want to inspect.
 
        all -- If set to 'True', returns direct and inherited superclasses,
        otherwise, only direct superclasses (the default).
 
        Raises RuntimeError on problems
        """
        return super(Configuration, self).superclasses(class_name, all)
 

◆ update_dal()

conffwk.Configuration.Configuration.update_dal	(	self,
		dal_obj,
		ignore_error = True,
		at = None,
		cache = None,
		recurse = False )

Updates the related ConfigObject in the database using a DAL
reflection.

This method will take the properties of the DAL object passed as
parameter and will try to either create or update the relevant
ConfigObject in the database, at the file specified. It does this
recursively, in colaboration with the ConfigObject class.

Keyword arguments:

dal_obj -- This is the DAL object that will be used for the operation.
It should be a reflection of the ConfigObject you want to create.

ignore_error -- This flag will make me ignore errors related to the
update of objects in this database. It is useful if you want to
overwrite as much as you can and leave the other objects which you
cannot write to untouched.
Otherwise, objects you cannot touch (write permissions or other
problems), when tried to be set, will raise a 'ValueError'.

at -- This is either the name of database you want to create the
object at, or another ConfigObject that will be used as a reference to
determine at which database to create the new object. If set to None
(the default), I'll simply use the value of 'self.active_database',
hoping for the best.

cache -- This is a cache that may be set by the Configuration object if
necessary. Users should *never* set this variable. This variable is
there to handle recursions gracefully.

recurse -- If this flag is set, the update will recurse until all
objects linked from the given object are updated. This encompasses
'include-file' objects. The default is a safe "False". Please,
understand the impact of what you are doing before setting this to
'True'.

Returns the ConfigObject you wanted to create or update, that you may
ignore for practical purposes.

Definition at line 442 of file Configuration.py.

                   recurse=False):
        """Updates the related ConfigObject in the database using a DAL
        reflection.
 
        This method will take the properties of the DAL object passed as
        parameter and will try to either create or update the relevant
        ConfigObject in the database, at the file specified. It does this
        recursively, in colaboration with the ConfigObject class.
 
        Keyword arguments:
 
        dal_obj -- This is the DAL object that will be used for the operation.
        It should be a reflection of the ConfigObject you want to create.
 
        ignore_error -- This flag will make me ignore errors related to the
        update of objects in this database. It is useful if you want to
        overwrite as much as you can and leave the other objects which you
        cannot write to untouched.
        Otherwise, objects you cannot touch (write permissions or other
        problems), when tried to be set, will raise a 'ValueError'.
 
        at -- This is either the name of database you want to create the
        object at, or another ConfigObject that will be used as a reference to
        determine at which database to create the new object. If set to None
        (the default), I'll simply use the value of 'self.active_database',
        hoping for the best.
 
        cache -- This is a cache that may be set by the Configuration object if
        necessary. Users should *never* set this variable. This variable is
        there to handle recursions gracefully.
 
        recurse -- If this flag is set, the update will recurse until all
        objects linked from the given object are updated. This encompasses
        'include-file' objects. The default is a safe "False". Please,
        understand the impact of what you are doing before setting this to
        'True'.
 
        Returns the ConfigObject you wanted to create or update, that you may
        ignore for practical purposes.
        """
        if not cache:
            cache = {}
        co_func = self.update_dal_permissive
        if not ignore_error:
            co_func = self.update_dal_pedantic
 
        if hasattr(dal_obj, '__old_id'):
            old_id = getattr(dal_obj, '__old_id')
            if old_id != dal_obj.id:
                old = super(Configuration, self).get_obj(
                      dal_obj.className(), old_id)
                if old:
                    old.rename(dal_obj.id)
                    delattr(dal_obj, '__old_id')
 
        if self.test_object(dal_obj.className(), dal_obj.id, 0, []):
            obj = super(Configuration, self).get_obj(
                dal_obj.className(), dal_obj.id)
            co = ConfigObject.ConfigObject(obj, self.__schema__, self)
            cache[dal_obj.fullName()] = co
            try:
                co.update_dal(dal_obj, co_func, self.get_obj, cache=cache,
                              recurse=recurse)
            except ValueError as e:
                if not ignore_error:
                    raise
                else:
                    logging.warning(
                        'Ignoring error in setting %s: %s'
                        % (repr(co), str(e)))
            self.__update_cache__([dal_obj])
 
        else:
            if not at:
                at = self.active_database
            obj = super(Configuration, self) \
                .create_obj(at, dal_obj.className(),
                            dal_obj.id)
            co = ConfigObject.ConfigObject(obj, self.__schema__, self)
            cache[dal_obj.fullName()] = co
            co.update_dal(dal_obj, co_func, self.get_obj, cache=cache,
                          recurse=recurse)
            self.__update_cache__([dal_obj])
 
        return co
 

◆ update_dal_pedantic()

conffwk.Configuration.Configuration.update_dal_pedantic	(	self,
		dal_obj,
		at = None,
		cache = None,
		recurse = False )

Alias to update_dal() with ignore_error=False

Definition at line 534 of file Configuration.py.

    def update_dal_pedantic(self, dal_obj, at=None, cache=None, recurse=False):
        """Alias to update_dal() with ignore_error=False"""
        return self.update_dal(dal_obj, False, at, cache, recurse)
 

◆ update_dal_permissive()

conffwk.Configuration.Configuration.update_dal_permissive	(	self,
		dal_obj,
		at = None,
		cache = None,
		recurse = False )

Alias to update_dal() with ignore_error=True

Definition at line 529 of file Configuration.py.

                              recurse=False):
        """Alias to update_dal() with ignore_error=True"""
        return self.update_dal(dal_obj, True, at, cache, recurse)
 

Member Data Documentation

◆ cache

dict conffwk.Configuration.Configuration.__cache__ = {}

private

Definition at line 40 of file Configuration.py.

◆ schema

conffwk.Configuration.Configuration.__schema__ = schema.Cache(self, all=True)

private

Definition at line 29 of file Configuration.py.

◆ active_database

conffwk.Configuration.Configuration.active_database = None

Definition at line 34 of file Configuration.py.

◆ add_dal

conffwk.Configuration.Configuration.add_dal

Definition at line 436 of file Configuration.py.

◆ databases

list conffwk.Configuration.Configuration.databases = []

Definition at line 33 of file Configuration.py.

◆ get_obj

conffwk.Configuration.Configuration.get_obj