diff options
author | Chris St. Pierre <chris.a.st.pierre@gmail.com> | 2011-07-27 09:07:33 -0400 |
---|---|---|
committer | Chris St. Pierre <chris.a.st.pierre@gmail.com> | 2011-07-27 09:07:33 -0400 |
commit | c0a7ace1b35c61848a7d755cdb14bd61d13932ed (patch) | |
tree | 48486a2016b7328cbc481358405bae6fcd04cc35 /doc | |
parent | 61766a5d46c15bb2b41eb07d822d04fb96ee8055 (diff) | |
download | bcfg2-c0a7ace1b35c61848a7d755cdb14bd61d13932ed.tar.gz bcfg2-c0a7ace1b35c61848a7d755cdb14bd61d13932ed.tar.bz2 bcfg2-c0a7ace1b35c61848a7d755cdb14bd61d13932ed.zip |
added write() method to Properties to write back persistent changes
Diffstat (limited to 'doc')
-rw-r--r-- | doc/server/plugins/connectors/properties.txt | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/doc/server/plugins/connectors/properties.txt b/doc/server/plugins/connectors/properties.txt index 3329f48bd..7695e902c 100644 --- a/doc/server/plugins/connectors/properties.txt +++ b/doc/server/plugins/connectors/properties.txt @@ -53,8 +53,23 @@ more details on how Group and Client tags are parsed.) For instance:: if el.tag == "Server"] %} +If you need to make persistent changes to properties data, you can use +the ``write`` method of the ``PropertyFile`` class:: + + {% python + import lxml.etree + from genshi.template import TemplateError + lxml.etree.SubElement(metadata.Properties['foo.xml'], + "Client", + name=metadata.hostname) + if not metadata.Properties['foo.xml'].write(): + raise TemplateError("Failed to write changes back to foo.xml") + +The ``write`` method checks the data in the object against its schema +before writing it; see `Data Structures`_ for details. + As we formulate more common use cases, we will add them to the -!PropertyFile class as methods. This will simplify templates. +``PropertyFile`` class as methods. This will simplify templates. You can also access the XML data that comprises a property file directly in one of several ways: |