configurationengine/source/cone/public/settings.py
author terytkon
Thu, 11 Mar 2010 17:04:37 +0200
changeset 0 2e8eeb919028
permissions -rw-r--r--
Adding EPL version of configurationengine.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     1
#
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     2
# Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     3
# All rights reserved.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     4
# This component and the accompanying materials are made available
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     5
# under the terms of "Eclipse Public License v1.0"
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     6
# which accompanies this distribution, and is available
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     7
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     8
#
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
     9
# Initial Contributors:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    10
# Nokia Corporation - initial contribution.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    11
#
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    12
# Contributors:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    13
#
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    14
# Description: 
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    15
#
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    16
import os
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    17
import logging
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    18
import ConfigParser
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    19
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    20
DEFAULT_SECTION = 'DEFAULT'
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    21
class ConeSettings(object):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    22
    def __init__(self, parser, section=DEFAULT_SECTION):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    23
        self.parser = parser
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    24
        self.section = section
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    25
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    26
    def get(self, property, default=None, vars=None):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    27
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    28
        Try to get a single property from the ConeSettings section. The method support the
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    29
        ConfigParser interpolation of variables and deliver extra variables via the vars param.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    30
       
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    31
        1. Try to get the property from configured section.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    32
        2. If section is not found try to get it from DEFAULT section.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    33
        3. Still if property is not found return the default values
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    34
        @param property: the name of the setting property get
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    35
        @param default: the default value to return if the property is not found from settings
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    36
        @param vars: a dictionary of variables that are given to the ConfigParser get 
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    37
        for interpolation. e.g. {'output':'testing'}.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    38
        
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    39
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    40
        try:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    41
            return self.parser.get(self.section, property, False, vars)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    42
        # if the section is not found try to use default
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    43
        except ConfigParser.NoSectionError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    44
            try:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    45
                return self.parser.get(DEFAULT_SECTION, property, False, vars)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    46
            except ConfigParser.NoOptionError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    47
                if default != None:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    48
                    return self.parser._interpolate(DEFAULT_SECTION,property,default,vars)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    49
                else:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    50
                    return default
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    51
        # if the option is not found return the default value
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    52
        except ConfigParser.NoOptionError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    53
            if default != None:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    54
                return self.parser._interpolate(DEFAULT_SECTION,property,default,vars)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    55
            else:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    56
                return default
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    57
            #return default
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    58
            
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    59
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    60
class SettingsFactory(object):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    61
    configsettings = None
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    62
    configpath    = ''
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    63
    defaultconfig = 'cone_defaults.cfg'
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    64
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    65
    @classmethod
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    66
    def get_defaultconfig_path(cls):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    67
        return os.path.join(cls.configpath,cls.defaultconfig)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    68
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    69
    @classmethod
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    70
    def cone_parser(cls):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    71
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    72
        Get a singleton instance of ConfigParser.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    73
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    74
        if not cls.configsettings:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    75
            cls.configsettings = ConfigParser.ConfigParser()
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    76
            
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    77
            try:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    78
                cls.configsettings.readfp(open(cls.get_defaultconfig_path()))
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    79
            except IOError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    80
                logging.getLogger('cone').warning("Could not read default configuration file %s" % cls.get_defaultconfig_path())
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    81
        return cls.configsettings
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    82
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    83
    @classmethod
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    84
    def clear(cls):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    85
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    86
        Clear everything back to default so that the next time the settings are re-parsed.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    87
        
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    88
        This method is provided for unit testing purposes.
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    89
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    90
        cls.configsettings = None
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    91
        cls.configpath    = ''
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    92
        cls.defaultconfig = 'cone_defaults.cfg'