794 lines
28 KiB
Python
794 lines
28 KiB
Python
#
|
|
# Base class for all VM devices
|
|
#
|
|
# Copyright 2008, 2013 Red Hat, Inc.
|
|
# Cole Robinson <crobinso@redhat.com>
|
|
#
|
|
# This work is licensed under the GNU GPLv2 or later.
|
|
# See the COPYING file in the top-level directory.
|
|
|
|
import collections
|
|
import logging
|
|
import os
|
|
import re
|
|
import string # pylint: disable=deprecated-module
|
|
|
|
from .xmlapi import XMLAPI
|
|
from . import util
|
|
|
|
|
|
# pylint: disable=protected-access
|
|
# This whole file is calling around into non-public functions that we
|
|
# don't want regular API users to touch
|
|
|
|
_trackprops = bool("VIRTINST_TEST_SUITE" in os.environ)
|
|
_allprops = []
|
|
_seenprops = []
|
|
|
|
|
|
class _XMLPropertyCache(object):
|
|
"""
|
|
Cache lookup tables mapping classes to their associated
|
|
XMLProperty and XMLChildProperty classes
|
|
"""
|
|
def __init__(self):
|
|
self._name_to_prop = {}
|
|
self._prop_to_name = {}
|
|
|
|
def _get_prop_cache(self, cls, checkclass):
|
|
cachename = str(cls) + "-" + checkclass.__name__
|
|
if cachename not in self._name_to_prop:
|
|
ret = {}
|
|
for c in reversed(type.mro(cls)[:-1]):
|
|
for key, val in c.__dict__.items():
|
|
if isinstance(val, checkclass):
|
|
ret[key] = val
|
|
self._prop_to_name[val] = key
|
|
self._name_to_prop[cachename] = ret
|
|
return self._name_to_prop[cachename]
|
|
|
|
def get_xml_props(self, inst):
|
|
return self._get_prop_cache(inst.__class__, XMLProperty)
|
|
|
|
def get_child_props(self, inst):
|
|
return self._get_prop_cache(inst.__class__, XMLChildProperty)
|
|
|
|
def get_prop_name(self, propinst):
|
|
return self._prop_to_name[propinst]
|
|
|
|
|
|
_PropCache = _XMLPropertyCache()
|
|
|
|
|
|
class _XMLChildList(list):
|
|
"""
|
|
Little wrapper for a list containing XMLChildProperty output.
|
|
This is just to insert a dynamically created add_new() function
|
|
which instantiates and appends a new child object
|
|
"""
|
|
def __init__(self, childclass, copylist, xmlbuilder):
|
|
list.__init__(self)
|
|
self._childclass = childclass
|
|
self._xmlbuilder = xmlbuilder
|
|
for i in copylist:
|
|
self.append(i)
|
|
|
|
def new(self):
|
|
"""
|
|
Instantiate a new child object and return it
|
|
"""
|
|
return self._childclass(self._xmlbuilder.conn)
|
|
|
|
def add_new(self):
|
|
"""
|
|
Instantiate a new child object, append it, and return it
|
|
"""
|
|
obj = self.new()
|
|
self._xmlbuilder.add_child(obj)
|
|
return obj
|
|
|
|
|
|
class _XMLPropertyBase(property):
|
|
def __init__(self, fget, fset):
|
|
self._propname = None
|
|
property.__init__(self, fget=fget, fset=fset)
|
|
|
|
@property
|
|
def propname(self):
|
|
"""
|
|
The variable name associated with this XMLProperty. So with
|
|
a definition like
|
|
|
|
foo = XMLProperty("./@bar")
|
|
|
|
and this will return "foo".
|
|
"""
|
|
if not self._propname:
|
|
self._propname = _PropCache.get_prop_name(self)
|
|
return self._propname
|
|
|
|
|
|
class XMLChildProperty(_XMLPropertyBase):
|
|
"""
|
|
Property that points to a class used for parsing a subsection of
|
|
of the parent XML. For example when we deligate parsing
|
|
/domain/cpu/feature of the /domain/cpu class.
|
|
|
|
@child_class: XMLBuilder class this property is tracking. So for
|
|
guest.devices.disk this is DeviceDisk
|
|
@relative_xpath: Relative location where the class is rooted compared
|
|
to its xmlbuilder root path. So if xmlbuilder is ./foo and we
|
|
want to track ./foo/bar/baz instances, set relative_xpath=./bar
|
|
@is_single: If True, this represents an XML node that is only expected
|
|
to appear once, like <domain><cpu>
|
|
"""
|
|
def __init__(self, child_class, relative_xpath=".", is_single=False):
|
|
self.child_class = child_class
|
|
self.is_single = is_single
|
|
self.relative_xpath = relative_xpath
|
|
|
|
_XMLPropertyBase.__init__(self, self._fget, None)
|
|
|
|
def __repr__(self):
|
|
return "<XMLChildProperty %s %s>" % (str(self.child_class), id(self))
|
|
|
|
|
|
def _get(self, xmlbuilder):
|
|
if self.propname not in xmlbuilder._propstore and not self.is_single:
|
|
xmlbuilder._propstore[self.propname] = []
|
|
return xmlbuilder._propstore[self.propname]
|
|
|
|
def _fget(self, xmlbuilder):
|
|
if self.is_single:
|
|
return self._get(xmlbuilder)
|
|
return _XMLChildList(self.child_class,
|
|
self._get(xmlbuilder),
|
|
xmlbuilder)
|
|
|
|
def clear(self, xmlbuilder):
|
|
if self.is_single:
|
|
self._get(xmlbuilder).clear()
|
|
else:
|
|
for obj in self._get(xmlbuilder)[:]:
|
|
xmlbuilder.remove_child(obj)
|
|
|
|
def append(self, xmlbuilder, newobj):
|
|
self._get(xmlbuilder).append(newobj)
|
|
def remove(self, xmlbuilder, obj):
|
|
self._get(xmlbuilder).remove(obj)
|
|
def set(self, xmlbuilder, obj):
|
|
xmlbuilder._propstore[self.propname] = obj
|
|
|
|
def get_prop_xpath(self, _xmlbuilder, obj):
|
|
return self.relative_xpath + "/" + obj.XML_NAME
|
|
|
|
|
|
class XMLProperty(_XMLPropertyBase):
|
|
def __init__(self, xpath,
|
|
set_converter=None, validate_cb=None,
|
|
is_bool=False, is_int=False, is_yesno=False, is_onoff=False,
|
|
default_cb=None, default_name=None, do_abspath=False):
|
|
"""
|
|
Set a XMLBuilder class property that maps to a value in an XML
|
|
document, indicated by the passed xpath. For example, for a
|
|
<domain><name> the definition may look like:
|
|
|
|
name = XMLProperty("./name")
|
|
|
|
When building XML from scratch (virt-install), 'name' works
|
|
similar to a regular class property(). When parsing and editing
|
|
existing guest XML, we use the xpath value to get/set the value
|
|
in the parsed XML document.
|
|
|
|
:param xpath: xpath string which maps to the associated property
|
|
in a typical XML document
|
|
:param name: Just a string to print for debugging, only needed
|
|
if xpath isn't specified.
|
|
:param set_converter: optional function for converting the property
|
|
value from the virtinst API to the guest XML. For example,
|
|
the Guest.memory API was once in MiB, but the libvirt domain
|
|
memory API is in KiB. So, if xpath is specified, on a 'get'
|
|
operation we convert the XML value with int(val) / 1024.
|
|
:param validate_cb: Called once when value is set, should
|
|
raise a RuntimeError if the value is not proper.
|
|
:param is_bool: Whether this is a boolean property in the XML
|
|
:param is_int: Whether this is an integer property in the XML
|
|
:param is_yesno: Whether this is a yes/no property in the XML
|
|
:param is_onoff: Whether this is an on/off property in the XML
|
|
:param default_cb: If building XML from scratch, and this property
|
|
is never explicitly altered, this function is called for setting
|
|
a default value in the XML, and for any 'get' call before the
|
|
first explicit 'set'.
|
|
:param default_name: If the user does a set and passes in this
|
|
value, instead use the value of default_cb()
|
|
:param do_abspath: If True, run os.path.abspath on the passed value
|
|
"""
|
|
self._xpath = xpath
|
|
if not self._xpath:
|
|
raise RuntimeError("XMLProperty: xpath must be passed.")
|
|
|
|
self._is_bool = is_bool
|
|
self._is_int = is_int
|
|
self._is_yesno = is_yesno
|
|
self._is_onoff = is_onoff
|
|
self._do_abspath = do_abspath
|
|
|
|
self._validate_cb = validate_cb
|
|
self._convert_value_for_setter_cb = set_converter
|
|
self._default_cb = default_cb
|
|
self._default_name = default_name
|
|
|
|
if sum([int(bool(i)) for i in
|
|
[self._is_bool, self._is_int,
|
|
self._is_yesno, self._is_onoff]]) > 1:
|
|
raise RuntimeError("Conflict property converter options.")
|
|
|
|
if self._default_name and not self._default_cb:
|
|
raise RuntimeError("default_name requires default_cb.")
|
|
|
|
self._is_tracked = False
|
|
if _trackprops:
|
|
_allprops.append(self)
|
|
|
|
_XMLPropertyBase.__init__(self, self.getter, self.setter)
|
|
|
|
|
|
def __repr__(self):
|
|
return "<XMLProperty %s %s>" % (str(self._xpath), id(self))
|
|
|
|
|
|
####################
|
|
# Internal helpers #
|
|
####################
|
|
|
|
def _convert_get_value(self, val):
|
|
# pylint: disable=redefined-variable-type
|
|
if self._default_name and val == self._default_name:
|
|
ret = val
|
|
elif self._is_bool:
|
|
ret = bool(val)
|
|
elif self._is_int and val is not None:
|
|
intkwargs = {}
|
|
if "0x" in str(val):
|
|
intkwargs["base"] = 16
|
|
ret = int(val, **intkwargs)
|
|
elif self._is_yesno and val is not None:
|
|
ret = bool(val == "yes")
|
|
elif self._is_onoff and val is not None:
|
|
ret = bool(val == "on")
|
|
else:
|
|
ret = val
|
|
return ret
|
|
|
|
def _convert_set_value(self, xmlbuilder, val):
|
|
if self._default_name and val == self._default_name:
|
|
val = self._default_cb(xmlbuilder)
|
|
elif self._do_abspath and val is not None:
|
|
val = os.path.abspath(val)
|
|
elif self._is_onoff and val is not None:
|
|
val = bool(val) and "on" or "off"
|
|
elif self._is_yesno and val is not None:
|
|
val = bool(val) and "yes" or "no"
|
|
elif self._is_int and val is not None:
|
|
intkwargs = {}
|
|
if "0x" in str(val):
|
|
intkwargs["base"] = 16
|
|
val = int(val, **intkwargs)
|
|
|
|
if self._convert_value_for_setter_cb:
|
|
val = self._convert_value_for_setter_cb(xmlbuilder, val)
|
|
return val
|
|
|
|
def _default_get_value(self, xmlbuilder):
|
|
"""
|
|
Return (can use default, default value)
|
|
"""
|
|
ret = (False, -1)
|
|
if not xmlbuilder._xmlstate.is_build:
|
|
return ret
|
|
if self.propname in xmlbuilder._propstore:
|
|
return ret
|
|
if not self._default_cb:
|
|
return ret
|
|
|
|
if self._default_name:
|
|
return (True, self._default_name)
|
|
return (True, self._default_cb(xmlbuilder))
|
|
|
|
|
|
def _set_default(self, xmlbuilder):
|
|
"""
|
|
Encode the property default into the XML and propstore, but
|
|
only if a default is registered, and only if the property was
|
|
not already explicitly set by the API user.
|
|
|
|
This is called during the get_xml_config process and shouldn't
|
|
be called from outside this file.
|
|
"""
|
|
candefault, val = self._default_get_value(xmlbuilder)
|
|
if not candefault:
|
|
return
|
|
self.setter(xmlbuilder, val, validate=False)
|
|
|
|
def _nonxml_fset(self, xmlbuilder, val):
|
|
"""
|
|
This stores the value in XMLBuilder._propstore
|
|
dict as propname->value. This saves us from having to explicitly
|
|
track every variable.
|
|
"""
|
|
propstore = xmlbuilder._propstore
|
|
|
|
if self.propname in propstore:
|
|
del(propstore[self.propname])
|
|
propstore[self.propname] = val
|
|
|
|
def _nonxml_fget(self, xmlbuilder):
|
|
"""
|
|
The flip side to nonxml_fset, fetch the value from
|
|
XMLBuilder._propstore
|
|
"""
|
|
candefault, val = self._default_get_value(xmlbuilder)
|
|
if candefault:
|
|
return val
|
|
return xmlbuilder._propstore.get(self.propname, None)
|
|
|
|
def clear(self, xmlbuilder):
|
|
# We only unset the cached data, since XML will be cleared elsewhere
|
|
propstore = xmlbuilder._propstore
|
|
if self.propname in propstore:
|
|
self.setter(xmlbuilder, None)
|
|
|
|
|
|
##################################
|
|
# The actual getter/setter impls #
|
|
##################################
|
|
|
|
def getter(self, xmlbuilder):
|
|
"""
|
|
Fetch value at user request. If we are parsing existing XML and
|
|
the user hasn't done a 'set' yet, return the value from the XML,
|
|
otherwise return the value from propstore
|
|
|
|
If this is a built from scratch object, we never pull from XML
|
|
since it's known to the empty, and we may want to return
|
|
a 'default' value
|
|
"""
|
|
if _trackprops and not self._is_tracked:
|
|
_seenprops.append(self)
|
|
self._is_tracked = True
|
|
|
|
if (self.propname in xmlbuilder._propstore or
|
|
xmlbuilder._xmlstate.is_build):
|
|
val = self._nonxml_fget(xmlbuilder)
|
|
else:
|
|
val = self._get_xml(xmlbuilder)
|
|
return self._convert_get_value(val)
|
|
|
|
def _get_xml(self, xmlbuilder):
|
|
"""
|
|
Actually fetch the associated value from the backing XML
|
|
"""
|
|
xpath = xmlbuilder._xmlstate.make_abs_xpath(self._xpath)
|
|
return xmlbuilder._xmlstate.xmlapi.get_xpath_content(
|
|
xpath, self._is_bool)
|
|
|
|
def setter(self, xmlbuilder, val, validate=True):
|
|
"""
|
|
Set the value at user request. This just stores the value
|
|
in propstore. Setting the actual XML is only done at
|
|
get_xml_config time.
|
|
"""
|
|
if _trackprops and not self._is_tracked:
|
|
_seenprops.append(self)
|
|
self._is_tracked = True
|
|
|
|
if validate and self._validate_cb:
|
|
self._validate_cb(xmlbuilder, val)
|
|
self._nonxml_fset(xmlbuilder,
|
|
self._convert_set_value(xmlbuilder, val))
|
|
|
|
def _set_xml(self, xmlbuilder, setval):
|
|
"""
|
|
Actually set the passed value in the XML document
|
|
"""
|
|
xpath = xmlbuilder._xmlstate.make_abs_xpath(self._xpath)
|
|
xmlbuilder._xmlstate.xmlapi.set_xpath_content(xpath, setval)
|
|
|
|
|
|
class _XMLState(object):
|
|
def __init__(self, root_name, parsexml, parentxmlstate,
|
|
relative_object_xpath):
|
|
self._root_name = root_name
|
|
self._namespace = ""
|
|
if ":" in self._root_name:
|
|
ns = self._root_name.split(":")[0]
|
|
self._namespace = " xmlns:%s='%s'" % (ns, XMLAPI.NAMESPACES[ns])
|
|
|
|
# xpath of this object relative to its parent. So for a standalone
|
|
# <disk> this is empty, but if the disk is the forth one in a <domain>
|
|
# it will be set to ./devices/disk[4]
|
|
self._relative_object_xpath = relative_object_xpath or ""
|
|
|
|
# xpath of the parent. For a disk in a standalone <domain>, this
|
|
# is empty, but if the <domain> is part of a <domainsnapshot>,
|
|
# it will be "./domain"
|
|
self._parent_xpath = (
|
|
parentxmlstate and parentxmlstate.abs_xpath()) or ""
|
|
|
|
self.xmlapi = None
|
|
self.is_build = False
|
|
if not parsexml and not parentxmlstate:
|
|
self.is_build = True
|
|
self.parse(parsexml, parentxmlstate)
|
|
|
|
def parse(self, parsexml, parentxmlstate):
|
|
if parentxmlstate:
|
|
self.is_build = parentxmlstate.is_build or self.is_build
|
|
self.xmlapi = parentxmlstate.xmlapi
|
|
return
|
|
|
|
# Make sure passed in XML has required xmlns inserted
|
|
if not parsexml:
|
|
parsexml = "<%s%s/>" % (self._root_name, self._namespace)
|
|
elif self._namespace and "xmlns" not in parsexml:
|
|
parsexml = parsexml.replace("<" + self._root_name,
|
|
"<" + self._root_name + self._namespace)
|
|
|
|
try:
|
|
self.xmlapi = XMLAPI(parsexml)
|
|
except Exception:
|
|
logging.debug("Error parsing xml=\n%s", parsexml)
|
|
raise
|
|
|
|
def set_relative_object_xpath(self, xpath):
|
|
self._relative_object_xpath = xpath or ""
|
|
|
|
def set_parent_xpath(self, xpath):
|
|
self._parent_xpath = xpath or ""
|
|
|
|
def _join_xpath(self, x1, x2):
|
|
if x1.endswith("/"):
|
|
x1 = x1[:-1]
|
|
if x2.startswith("."):
|
|
x2 = x2[1:]
|
|
return x1 + x2
|
|
|
|
def abs_xpath(self):
|
|
return self._join_xpath(self._parent_xpath or ".",
|
|
self._relative_object_xpath or ".")
|
|
|
|
def make_abs_xpath(self, xpath):
|
|
"""
|
|
Convert a relative xpath to an absolute xpath. So for DeviceDisk
|
|
that's part of a Guest, accessing driver_name will do convert:
|
|
./driver/@name
|
|
to an absolute xpath like:
|
|
./devices/disk[3]/driver/@name
|
|
"""
|
|
return self._join_xpath(self.abs_xpath() or ".", xpath)
|
|
|
|
|
|
class XMLBuilder(object):
|
|
"""
|
|
Base for all classes which build or parse domain XML
|
|
"""
|
|
# Order that we should apply values to the XML. Keeps XML generation
|
|
# consistent with what the test suite expects.
|
|
_XML_PROP_ORDER = []
|
|
|
|
# Name of the root XML element
|
|
XML_NAME = None
|
|
|
|
# In some cases, libvirt can incorrectly generate unparseable XML.
|
|
# These are libvirt bugs, but this allows us to work around it in
|
|
# for specific XML classes.
|
|
#
|
|
# Example: nodedev 'system' XML:
|
|
# https://bugzilla.redhat.com/show_bug.cgi?id=1184131
|
|
_XML_SANITIZE = False
|
|
|
|
def __init__(self, conn, parsexml=None,
|
|
parentxmlstate=None, relative_object_xpath=None):
|
|
"""
|
|
Initialize state
|
|
|
|
:param conn: VirtinstConnection to validate device against
|
|
:param parsexml: Optional XML string to parse
|
|
|
|
The rest of the parameters are for internal use only
|
|
"""
|
|
self.conn = conn
|
|
|
|
if self._XML_SANITIZE:
|
|
if hasattr(parsexml, 'decode'):
|
|
parsexml = parsexml.decode("ascii", "ignore").encode("ascii")
|
|
else:
|
|
parsexml = parsexml.encode("ascii", "ignore").decode("ascii")
|
|
|
|
parsexml = "".join([c for c in parsexml if c in string.printable])
|
|
|
|
self._propstore = collections.OrderedDict()
|
|
self._xmlstate = _XMLState(self.XML_NAME,
|
|
parsexml, parentxmlstate,
|
|
relative_object_xpath)
|
|
|
|
self._validate_xmlbuilder()
|
|
self._initial_child_parse()
|
|
|
|
def _validate_xmlbuilder(self):
|
|
# This is one time validation we run once per XMLBuilder class
|
|
cachekey = self.__class__.__name__ + "_xmlbuilder_validated"
|
|
if getattr(self.__class__, cachekey, False):
|
|
return
|
|
|
|
xmlprops = self._all_xml_props()
|
|
childprops = self._all_child_props()
|
|
for key in self._XML_PROP_ORDER:
|
|
if key not in xmlprops and key not in childprops:
|
|
raise RuntimeError("programming error: key '%s' must be "
|
|
"xml prop or child prop" % key)
|
|
|
|
childclasses = []
|
|
for childprop in childprops.values():
|
|
if childprop.child_class in childclasses:
|
|
raise RuntimeError("programming error: can't register "
|
|
"duplicate child_classs=%s" % childprop.child_class)
|
|
childclasses.append(childprop.child_class)
|
|
|
|
setattr(self.__class__, cachekey, True)
|
|
|
|
def _initial_child_parse(self):
|
|
# Walk the XML tree and hand of parsing to any registered
|
|
# child classes
|
|
for xmlprop in list(self._all_child_props().values()):
|
|
child_class = xmlprop.child_class
|
|
prop_path = xmlprop.get_prop_xpath(self, child_class)
|
|
|
|
if xmlprop.is_single:
|
|
obj = child_class(self.conn,
|
|
parentxmlstate=self._xmlstate,
|
|
relative_object_xpath=prop_path)
|
|
xmlprop.set(self, obj)
|
|
continue
|
|
|
|
if self._xmlstate.is_build:
|
|
continue
|
|
|
|
nodecount = self._xmlstate.xmlapi.count(
|
|
self._xmlstate.make_abs_xpath(prop_path))
|
|
for idx in range(nodecount):
|
|
idxstr = "[%d]" % (idx + 1)
|
|
obj = child_class(self.conn,
|
|
parentxmlstate=self._xmlstate,
|
|
relative_object_xpath=(prop_path + idxstr))
|
|
xmlprop.append(self, obj)
|
|
|
|
def __repr__(self):
|
|
return "<%s %s %s>" % (self.__class__.__name__.split(".")[-1],
|
|
self.XML_NAME, id(self))
|
|
|
|
|
|
############################
|
|
# Public XML managing APIs #
|
|
############################
|
|
|
|
def get_xml_config(self):
|
|
"""
|
|
Return XML string of the object
|
|
"""
|
|
xmlapi = self._xmlstate.xmlapi
|
|
if self._xmlstate.is_build:
|
|
xmlapi = xmlapi.copy_api()
|
|
|
|
self._add_parse_bits(xmlapi)
|
|
ret = xmlapi.get_xml(self._xmlstate.make_abs_xpath("."))
|
|
|
|
if ret and not ret.endswith("\n"):
|
|
ret += "\n"
|
|
return ret
|
|
|
|
def clear(self, leave_stub=False):
|
|
"""
|
|
Wipe out all properties of the object
|
|
|
|
:param leave_stub: if True, don't unlink the top stub node,
|
|
see virtinst/cli usage for an explanation
|
|
"""
|
|
props = list(self._all_xml_props().values())
|
|
props += list(self._all_child_props().values())
|
|
for prop in props:
|
|
prop.clear(self)
|
|
|
|
is_child = bool(re.match("^.*\[\d+\]$", self._xmlstate.abs_xpath()))
|
|
if is_child or leave_stub:
|
|
# User requested to clear an object that is the child of
|
|
# another object (xpath ends in [1] etc). We can't fully remove
|
|
# the node in that case, since then the xmlbuilder object is
|
|
# no longer valid, and all the other child xpaths will be
|
|
# pointing to the wrong node. So just stub out the content
|
|
self._xmlstate.xmlapi.node_clear(self._xmlstate.abs_xpath())
|
|
else:
|
|
self._xmlstate.xmlapi.node_force_remove(self._xmlstate.abs_xpath())
|
|
|
|
def validate(self):
|
|
"""
|
|
Validate any set values and raise an exception if there's
|
|
a problem
|
|
"""
|
|
pass
|
|
|
|
def set_defaults(self, guest):
|
|
"""
|
|
Encode any default values if needed
|
|
"""
|
|
ignore = guest
|
|
|
|
def get_xml_id(self):
|
|
"""
|
|
Return the location of the object in the XML document. This is
|
|
basically the absolute xpath, but the value returned should be
|
|
treated as opaque, it's just for cross XML comparisons. Used
|
|
in virt-manager code
|
|
"""
|
|
return self._xmlstate.abs_xpath()
|
|
|
|
def get_xml_idx(self):
|
|
"""
|
|
This is basically the offset parsed out of the object's xpath,
|
|
minus 1. So if this is the fifth <disk> in a <domain>, ret=4.
|
|
If this is the only <cpu> in a domain, ret=0.
|
|
"""
|
|
xpath = self._xmlstate.abs_xpath()
|
|
if "[" not in xpath:
|
|
return 0
|
|
return int(xpath.rsplit("[", 1)[1].strip("]")) - 1
|
|
|
|
|
|
################
|
|
# Internal API #
|
|
################
|
|
|
|
def _all_xml_props(self):
|
|
"""
|
|
Return a list of all XMLProperty instances that this class has.
|
|
"""
|
|
return _PropCache.get_xml_props(self)
|
|
|
|
def _all_child_props(self):
|
|
"""
|
|
Return a list of all XMLChildProperty instances that this class has.
|
|
"""
|
|
return _PropCache.get_child_props(self)
|
|
|
|
def _find_child_prop(self, child_class):
|
|
xmlprops = self._all_child_props()
|
|
for xmlprop in list(xmlprops.values()):
|
|
if xmlprop.is_single:
|
|
continue
|
|
if child_class is xmlprop.child_class:
|
|
return xmlprop
|
|
raise RuntimeError("programming error: "
|
|
"Didn't find child property for child_class=%s" %
|
|
child_class)
|
|
|
|
def _set_xpaths(self, parent_xpath, relative_object_xpath=-1):
|
|
"""
|
|
Change the object hierarchy's cached xpaths
|
|
"""
|
|
self._xmlstate.set_parent_xpath(parent_xpath)
|
|
if relative_object_xpath != -1:
|
|
self._xmlstate.set_relative_object_xpath(relative_object_xpath)
|
|
for propname in self._all_child_props():
|
|
for p in util.listify(getattr(self, propname, [])):
|
|
p._set_xpaths(self._xmlstate.abs_xpath())
|
|
|
|
def _set_child_xpaths(self):
|
|
"""
|
|
Walk the list of child properties and make sure their
|
|
xpaths point at their particular element. Needs to be called
|
|
whenever child objects are added or removed
|
|
"""
|
|
typecount = {}
|
|
for propname, xmlprop in self._all_child_props().items():
|
|
for obj in util.listify(getattr(self, propname)):
|
|
idxstr = ""
|
|
if not xmlprop.is_single:
|
|
class_type = obj.__class__
|
|
if class_type not in typecount:
|
|
typecount[class_type] = 0
|
|
typecount[class_type] += 1
|
|
idxstr = "[%d]" % typecount[class_type]
|
|
|
|
prop_path = xmlprop.get_prop_xpath(self, obj)
|
|
obj._set_xpaths(self._xmlstate.abs_xpath(),
|
|
prop_path + idxstr)
|
|
|
|
def _parse_with_children(self, *args, **kwargs):
|
|
"""
|
|
Set new backing XML objects in ourselves and all our child props
|
|
"""
|
|
self._xmlstate.parse(*args, **kwargs)
|
|
for propname in self._all_child_props():
|
|
for p in util.listify(getattr(self, propname, [])):
|
|
p._parse_with_children(None, self._xmlstate)
|
|
|
|
def add_child(self, obj):
|
|
"""
|
|
Insert the passed XMLBuilder object into our XML document. The
|
|
object needs to have an associated mapping via XMLChildProperty
|
|
"""
|
|
xmlprop = self._find_child_prop(obj.__class__)
|
|
xml = obj.get_xml_config()
|
|
xmlprop.append(self, obj)
|
|
self._set_child_xpaths()
|
|
|
|
if not obj._xmlstate.is_build:
|
|
use_xpath = obj._xmlstate.abs_xpath().rsplit("/", 1)[0]
|
|
indent = 2 * obj._xmlstate.abs_xpath().count("/")
|
|
self._xmlstate.xmlapi.node_add_xml(
|
|
util.xml_indent(xml, indent), use_xpath)
|
|
obj._parse_with_children(None, self._xmlstate)
|
|
|
|
def remove_child(self, obj):
|
|
"""
|
|
Remove the passed XMLBuilder object from our XML document, but
|
|
ensure its data isn't altered.
|
|
"""
|
|
xmlprop = self._find_child_prop(obj.__class__)
|
|
xmlprop.remove(self, obj)
|
|
|
|
xpath = obj._xmlstate.abs_xpath()
|
|
xml = obj.get_xml_config()
|
|
obj._set_xpaths(None, None)
|
|
obj._parse_with_children(xml, None)
|
|
self._xmlstate.xmlapi.node_force_remove(xpath)
|
|
self._set_child_xpaths()
|
|
|
|
|
|
#################################
|
|
# Private XML building routines #
|
|
#################################
|
|
|
|
def _add_parse_bits(self, xmlapi):
|
|
"""
|
|
Callback that adds the implicitly tracked XML properties to
|
|
the backing xml.
|
|
"""
|
|
origpropstore = self._propstore.copy()
|
|
origapi = self._xmlstate.xmlapi
|
|
try:
|
|
self._xmlstate.xmlapi = xmlapi
|
|
return self._do_add_parse_bits()
|
|
finally:
|
|
self._xmlstate.xmlapi = origapi
|
|
self._propstore = origpropstore
|
|
|
|
def _do_add_parse_bits(self):
|
|
# Set all defaults if the properties have one registered
|
|
xmlprops = self._all_xml_props()
|
|
childprops = self._all_child_props()
|
|
|
|
for prop in list(xmlprops.values()):
|
|
prop._set_default(self)
|
|
|
|
# Set up preferred XML ordering
|
|
do_order = [p for p in self._propstore if p not in childprops]
|
|
for key in reversed(self._XML_PROP_ORDER):
|
|
if key in do_order:
|
|
do_order.remove(key)
|
|
do_order.insert(0, key)
|
|
elif key in childprops:
|
|
do_order.insert(0, key)
|
|
|
|
for key in sorted(list(childprops.keys())):
|
|
if key not in do_order:
|
|
do_order.append(key)
|
|
|
|
# Alter the XML
|
|
for key in do_order:
|
|
if key in xmlprops:
|
|
xmlprops[key]._set_xml(self, self._propstore[key])
|
|
elif key in childprops:
|
|
for obj in util.listify(getattr(self, key)):
|
|
obj._add_parse_bits(self._xmlstate.xmlapi)
|