configurationengine/source/cone/storage/metadata.py
author terytkon
Sat, 06 Nov 2010 16:59:14 +0200
changeset 9 63964d875993
parent 3 e7e0ae78773e
permissions -rw-r--r--
Merge changes to system model generator to SF tip.
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
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    17
try:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    18
    from cElementTree import ElementTree
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    19
except ImportError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    20
    try:    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    21
        from elementtree import ElementTree
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    22
    except ImportError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    23
        try:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    24
            from xml.etree import cElementTree as ElementTree
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    25
        except ImportError:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    26
            from xml.etree import ElementTree
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    27
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    28
import StringIO
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    29
import os
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    30
import logging
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    31
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    32
from cone.public import exceptions, persistence
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    33
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    34
class Metadata(object):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    35
    """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    36
    metadata container objectl, which is only a dictionary container
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    37
    """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    38
    META_ROOT_FILE = 'cpf.rootFile'
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    39
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    40
    def __init__(self, copyobj=None):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    41
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    42
        Constructor initializes the default values
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    43
        """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    44
        self.data = {}
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    45
        if copyobj != None:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    46
            self.data = copyobj.data.copy()
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    47
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    48
    def get_root_file(self):
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    49
        return self.data.get(self.META_ROOT_FILE, None)
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    50
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    51
    def set_root_file(self,filename):
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    52
        if filename:
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    53
            self.data[self.META_ROOT_FILE] = filename
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    54
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    55
class MetadataReader(persistence.ConeReader):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    56
    """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    57
    Parses a single metadata file
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    58
    """ 
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    59
    class_type = "Metadata"
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    60
    NAMESPACES = ['http://www.nokia.com/xml/ns/confml-core/metadata-2.0']
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    61
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    62
    def fromstring(self, xml_as_string):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    63
        meta = Metadata()
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    64
        try:
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    65
            etree = ElementTree.fromstring(xml_as_string)
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    66
            for elem in etree.getiterator("{%s}property" % self.NAMESPACES[0]):
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    67
                (key,value) = self.get_property(elem)
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    68
                meta.data[key] = value
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    69
        except Exception,e:
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    70
            logging.getLogger('cone').warning("Could not read metadata! Exception %s" % (e))
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    71
        return meta
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    72
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    73
    def get_property(self, elem):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    74
        key = elem.get('name')
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    75
        value = ''
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    76
        if elem.get('value'): value = elem.get('value')
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    77
        return (key,value)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    78
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    79
class MetadataWriter(persistence.ConeWriter):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    80
    """
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    81
    Writes a single metadata file
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    82
    """ 
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    83
    class_type = "Metadata"
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    84
    NAMESPACES = ['http://www.nokia.com/xml/ns/confml-core/metadata-2.0']
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    85
    DEFAULT_ENCODING = "ASCII"
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    86
    def __init__(self):
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
    87
        super(MetadataWriter, self).__init__()
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    88
        self.encoding = self.DEFAULT_ENCODING
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    89
        return
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    90
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    91
    def tostring(self,obj,indent=True):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    92
        stringdata =  StringIO.StringIO()
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    93
        self.toresource(obj, stringdata, indent)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    94
        return stringdata.getvalue()
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    95
    
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    96
    def toresource(self,obj,res,indent=True):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    97
        root = ElementTree.Element("metadata")
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    98
        root.set('xmlns',self.NAMESPACES[0])
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
    99
        if not obj.__class__ == Metadata:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   100
            raise exceptions.IncorrectClassError('The given object is not a instance of %s' % Metadata)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   101
        for key in obj.data.keys():
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   102
            prop = ElementTree.SubElement(root,'property')
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   103
            self.set_property(prop, key, obj.data[key])
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   104
        if indent:
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   105
            persistence.indent(root)
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   106
        
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   107
        # To make the output the same in linux and windows
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   108
        # (needed to make testing easier)
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   109
        class LinesepNormalizerResource(object):
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   110
            def __init__(self, resource):
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   111
                self.resource = resource
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   112
            def write(self, data):
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   113
                if os.linesep != '\r\n':
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   114
                    data = data.replace(os.linesep, '\r\n')
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   115
                self.resource.write(data)
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   116
        res = LinesepNormalizerResource(res)
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   117
        
0
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   118
        # some smarter way to implement adding of the encoding to the beginning of file
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   119
        res.write('<?xml version="1.0" encoding="%s"?>%s' % (self.encoding,os.linesep))
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   120
        ElementTree.ElementTree(root).write(res)
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   121
        
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   122
    def set_property(self, elem, key, value):
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   123
        elem.attrib['name'] = key
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   124
        if value != '':
2e8eeb919028 Adding EPL version of configurationengine.
terytkon
parents:
diff changeset
   125
            elem.attrib['value'] = value
3
e7e0ae78773e ConE 1.2.11 release
m2lahtel
parents: 0
diff changeset
   126
        return elem