1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
############################################################################
# Copyright (C) CFEngine AS
#
# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License LGPL as published by the
# Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# To the extent this program is licensed as part of the Enterprise
# versions of CFEngine, the applicable Commercial Open Source License
# (COSL) may apply to this file if you as a licensee so wish it. See
# included file COSL.txt.
###########################################################################
#
# CFEngine Community Open Promise-Body Library
#
# This initiative started by CFEngine promotes a
# standardized set of names and promise specifications
# for template functionality within CFEngine 3.
#
# The aim is to promote an industry standard for
# naming of configuration patterns, leading to a
# de facto middleware of standardized syntax.
#
# Names should be intuitive and parameters should be
# minimal to assist readability and comprehensibility.
# Contributions to this file are voluntarily given to
# the cfengine community, and are moderated by CFEngine.
# No liability or warranty for misuse is implied.
#
# If you add to this file, please try to make the
# contributions "self-documenting". Comments made
# after the bundle/body statement are retained in
# the online docs
#
# For CFEngine Core: 3.6.0 to 3.6.x
# edit_xml bundles
###################################################
# If you find CFEngine useful, please consider #
# purchasing a commercial version of the software.#
###################################################
bundle edit_xml xml_insert_tree_nopath(treestring)
# @brief Insert XML tree with no path
#
# This `edit_xml` bundle inserts the given XML tree. Use with an
# empty XML document.
#
# @param treestring The XML tree, as a string
#
# **Example:**
#
# ```cf3
# files:
# "/newfile" edit_xml => xml_insert_tree_nopath('<x>y</x>');
# ```
{
insert_tree:
'$(treestring)';
}
bundle edit_xml xml_insert_tree(treestring, xpath)
# @brief Insert XML tree at the given XPath
#
# This `edit_xml` bundle inserts the given XML tree at a specific
# XPath. Uses `insert_tree`.
#
# @param treestring The XML tree, as a string
# @param xpath A valid XPath string
#
# **Example:**
#
# ```cf3
# files:
# "/file.xml" edit_xml => xml_insert_tree('<x>y</x>', '/a/b/c');
# ```
{
insert_tree:
'$(treestring)' select_xpath => "$(xpath)";
}
bundle edit_xml xml_set_value(value, xpath)
# @brief Sets or replaces a value in XML at the given XPath
#
# This `edit_xml` bundle sets or replaces the value at a specific
# XPath with the given value. Uses `set_text`.
#
# @param value The new value
# @param xpath A valid XPath string
#
# **Example:**
#
# ```cf3
# files:
# "/file.xml" edit_xml => xml_set_value('hello', '/a/b/c');
# ```
{
set_text:
"$(value)"
select_xpath => "$(xpath)";
}
bundle edit_xml xml_set_attribute(attr, value, xpath)
# @brief Sets or replaces an attribute in XML at the given XPath
#
# This `edit_xml` bundle sets or replaces an attribute at a specific
# XPath with the given value. Uses `set_attribute`.
#
# @param attr The attribute name
# @param value The new attribute value
# @param xpath A valid XPath string
#
# **Example:**
#
# ```cf3
# files:
# "/file.xml" edit_xml => xml_set_attribute('parameter', 'ha', '/a/b/c');
# ```
{
set_attribute:
"$(attr)"
attribute_value => "$(value)",
select_xpath => "$(xpath)";
}
|
