**** CubicPower OpenStack Study ****
# Copyright 2013 Red Hat, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
"""Provides the base report model
This module defines a class representing the basic report
data model from which all data models should inherit (or
at least implement similar functionality). Data models
store unserialized data generated by generators during
the report serialization process.
"""
import collections as col
import copy
**** CubicPower OpenStack Study ****
class ReportModel(col.MutableMapping):
"""A Report Data Model
A report data model contains data generated by some
generator method or class. Data may be read or written
using dictionary-style access, and may be read (but not
written) using object-member-style access. Additionally,
a data model may have an associated view. This view is
used to serialize the model when str() is called on the
model. An appropriate object for a view is callable with
a single parameter: the model to be serialized.
:param data: a dictionary of data to initially associate with the model
:param attached_view: a view object to attach to this model
"""
**** CubicPower OpenStack Study ****
def __init__(self, data=None, attached_view=None):
self.attached_view = attached_view
self.data = data or {}
**** CubicPower OpenStack Study ****
def __str__(self):
self_cpy = copy.deepcopy(self)
for key in self_cpy:
if getattr(self_cpy[key], 'attached_view', None) is not None:
self_cpy[key] = str(self_cpy[key])
if self.attached_view is not None:
return self.attached_view(self_cpy)
else:
raise Exception("Cannot stringify model: no attached view")
**** CubicPower OpenStack Study ****
def __repr__(self):
if self.attached_view is not None:
return (" " with view {vw.__module__}." "{vw.__name__}>").format(cl=type(self),
dt=self.data,
vw=type(self.attached_view))
else:
return (" " with no view>").format(cl=type(self), dt=self.data)
**** CubicPower OpenStack Study ****
def __getitem__(self, attrname):
return self.data[attrname]
**** CubicPower OpenStack Study ****
def __setitem__(self, attrname, attrval):
self.data[attrname] = attrval
**** CubicPower OpenStack Study ****
def __delitem__(self, attrname):
del self.data[attrname]
**** CubicPower OpenStack Study ****
def __contains__(self, key):
return self.data.__contains__(key)
**** CubicPower OpenStack Study ****
def __getattr__(self, attrname):
try:
return self.data[attrname]
except KeyError:
raise AttributeError(
"'{cl}' object has no attribute '{an}'".format(
cl=type(self).__name__, an=attrname
)
)
**** CubicPower OpenStack Study ****
def __len__(self):
return len(self.data)
**** CubicPower OpenStack Study ****
def __iter__(self):
return self.data.__iter__()
**** CubicPower OpenStack Study ****
def set_current_view_type(self, tp):
"""Set the current view type
This method attempts to set the current view
type for this model and all submodels by calling
itself recursively on all values (and ignoring the
ones that are not themselves models)
:param tp: the type of the view ('text', 'json', 'xml', etc)
"""
for key in self:
try:
self[key].set_current_view_type(tp)
except AttributeError:
pass