??????????????
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 173
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 174
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 175
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 176
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 177
Warning: Cannot modify header information - headers already sent by (output started at /home/mybf1/public_html/mentol.bf1.my/SS1.php:4) in /home/mybf1/public_html/mentol.bf1.my/SS1.php on line 178
Udac @` s* d d l m Z m Z m Z e Z i d d 6d g d 6d d 6Z d Z d Z d
Z d d l
Z
d d l Z d d l Z d d l
Z
d d l Z d d l m Z d d
l m Z d Z y d d l m Z m Z e Z Wn# e k
r e j Z e Z n Xd d l m Z m Z m Z d d l! m" Z" m# Z# d d l$ m% Z% m& Z& d d l' m( Z( d Z) e) d e) d e) Z* d Z+ e
j, d e* d Z- e
j, d e* d e+ d Z. e
j, d e* d Z/ e
j, d e* d e+ d Z0 e
j, d e* d Z1 e
j, d e+ d Z2 d Z3 d! Z4 d" Z5 d# Z6 d$ Z7 d% Z8 d& Z9 d' Z: d( Z; d) Z< d* Z= d+ Z> d, Z? d- Z@ d. ZA d/ ZB d0 ZC d1 ZD d2 ZE d3 ZF d4 ZG d5 ZH d d d6 d7 ZI d8 ZJ e d9 d eK d: ZL d; ZM eN d< k r&eM n d S(= i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont previewt statust communityt supported_bys
---
module: xml
short_description: Manage bits and pieces of XML files or strings
description:
- A CRUD-like interface to managing bits of XML files.
version_added: '2.4'
options:
path:
description:
- Path to the file to operate on.
- This file must exist ahead of time.
- This parameter is required, unless C(xmlstring) is given.
type: path
required: yes
aliases: [ dest, file ]
xmlstring:
description:
- A string containing XML on which to operate.
- This parameter is required, unless C(path) is given.
type: str
required: yes
xpath:
description:
- A valid XPath expression describing the item(s) you want to manipulate.
- Operates on the document root, C(/), by default.
type: str
namespaces:
description:
- The namespace C(prefix:uri) mapping for the XPath expression.
- Needs to be a C(dict), not a C(list) of items.
type: dict
state:
description:
- Set or remove an xpath selection (node(s), attribute(s)).
type: str
choices: [ absent, present ]
default: present
aliases: [ ensure ]
attribute:
description:
- The attribute to select when using parameter C(value).
- This is a string, not prepended with C(@).
type: raw
value:
description:
- Desired state of the selected attribute.
- Either a string, or to unset a value, the Python C(None) keyword (YAML Equivalent, C(null)).
- Elements default to no value (but present).
- Attributes default to an empty string.
type: raw
add_children:
description:
- Add additional child-element(s) to a selected element for a given C(xpath).
- Child elements must be given in a list and each item may be either a string
(eg. C(children=ansible) to add an empty C() child element),
or a hash where the key is an element name and the value is the element value.
- This parameter requires C(xpath) to be set.
type: list
set_children:
description:
- Set the child-element(s) of a selected element for a given C(xpath).
- Removes any existing children.
- Child elements must be specified as in C(add_children).
- This parameter requires C(xpath) to be set.
type: list
count:
description:
- Search for a given C(xpath) and provide the count of any matches.
- This parameter requires C(xpath) to be set.
type: bool
default: no
print_match:
description:
- Search for a given C(xpath) and print out any matches.
- This parameter requires C(xpath) to be set.
type: bool
default: no
pretty_print:
description:
- Pretty print XML output.
type: bool
default: no
content:
description:
- Search for a given C(xpath) and get content.
- This parameter requires C(xpath) to be set.
type: str
choices: [ attribute, text ]
input_type:
description:
- Type of input for C(add_children) and C(set_children).
type: str
choices: [ xml, yaml ]
default: yaml
backup:
description:
- Create a backup file including the timestamp information so you can get
the original file back if you somehow clobbered it incorrectly.
type: bool
default: no
strip_cdata_tags:
description:
- Remove CDATA tags surrounding text values.
- Note that this might break your XML file if text values contain characters that could be interpreted as XML.
type: bool
default: no
version_added: '2.7'
insertbefore:
description:
- Add additional child-element(s) before the first selected element for a given C(xpath).
- Child elements must be given in a list and each item may be either a string
(eg. C(children=ansible) to add an empty C() child element),
or a hash where the key is an element name and the value is the element value.
- This parameter requires C(xpath) to be set.
type: bool
default: no
version_added: '2.8'
insertafter:
description:
- Add additional child-element(s) after the last selected element for a given C(xpath).
- Child elements must be given in a list and each item may be either a string
(eg. C(children=ansible) to add an empty C() child element),
or a hash where the key is an element name and the value is the element value.
- This parameter requires C(xpath) to be set.
type: bool
default: no
version_added: '2.8'
requirements:
- lxml >= 2.3.0
notes:
- Use the C(--check) and C(--diff) options when testing your expressions.
- The diff output is automatically pretty-printed, so may not reflect the actual file content, only the file structure.
- This module does not handle complicated xpath expressions, so limit xpath selectors to simple expressions.
- Beware that in case your XML elements are namespaced, you need to use the C(namespaces) parameter, see the examples.
- Namespaces prefix should be used for all children of an element where namespace is defined, unless another namespace is defined for them.
seealso:
- name: Xml module development community wiki
description: More information related to the development of this xml module.
link: https://github.com/ansible/community/wiki/Module:-xml
- name: Introduction to XPath
description: A brief tutorial on XPath (w3schools.com).
link: https://www.w3schools.com/xml/xpath_intro.asp
- name: XPath Reference document
description: The reference documentation on XSLT/XPath (developer.mozilla.org).
link: https://developer.mozilla.org/en-US/docs/Web/XPath
author:
- Tim Bielawa (@tbielawa)
- Magnus Hedemark (@magnus919)
- Dag Wieers (@dagwieers)
s
# Consider the following XML file:
#
#
# Tasty Beverage Co.
#
# Rochefort 10
# St. Bernardus Abbot 12
# Schlitz
#
# 10
#
#
# http://tastybeverageco.com
#
#
- name: Remove the 'subjective' attribute of the 'rating' element
xml:
path: /foo/bar.xml
xpath: /business/rating/@subjective
state: absent
- name: Set the rating to '11'
xml:
path: /foo/bar.xml
xpath: /business/rating
value: 11
# Retrieve and display the number of nodes
- name: Get count of 'beers' nodes
xml:
path: /foo/bar.xml
xpath: /business/beers/beer
count: yes
register: hits
- debug:
var: hits.count
# Example where parent XML nodes are created automatically
- name: Add a 'phonenumber' element to the 'business' element
xml:
path: /foo/bar.xml
xpath: /business/phonenumber
value: 555-555-1234
- name: Add several more beers to the 'beers' element
xml:
path: /foo/bar.xml
xpath: /business/beers
add_children:
- beer: Old Rasputin
- beer: Old Motor Oil
- beer: Old Curmudgeon
- name: Add several more beers to the 'beers' element and add them before the 'Rochefort 10' element
xml:
path: /foo/bar.xml
xpath: '/business/beers/beer[text()="Rochefort 10"]'
insertbefore: yes
add_children:
- beer: Old Rasputin
- beer: Old Motor Oil
- beer: Old Curmudgeon
# NOTE: The 'state' defaults to 'present' and 'value' defaults to 'null' for elements
- name: Add a 'validxhtml' element to the 'website' element
xml:
path: /foo/bar.xml
xpath: /business/website/validxhtml
- name: Add an empty 'validatedon' attribute to the 'validxhtml' element
xml:
path: /foo/bar.xml
xpath: /business/website/validxhtml/@validatedon
- name: Add or modify an attribute, add element if needed
xml:
path: /foo/bar.xml
xpath: /business/website/validxhtml
attribute: validatedon
value: 1976-08-05
# How to read an attribute value and access it in Ansible
- name: Read an element's attribute values
xml:
path: /foo/bar.xml
xpath: /business/website/validxhtml
content: attribute
register: xmlresp
- name: Show an attribute value
debug:
var: xmlresp.matches[0].validxhtml.validatedon
- name: Remove all children from the 'website' element (option 1)
xml:
path: /foo/bar.xml
xpath: /business/website/*
state: absent
- name: Remove all children from the 'website' element (option 2)
xml:
path: /foo/bar.xml
xpath: /business/website
children: []
# In case of namespaces, like in below XML, they have to be explicitly stated.
#
#
#
#
#
#
# NOTE: There is the prefix 'x' in front of the 'bar' element, too.
- name: Set namespaced '/x:foo/x:bar/y:baz/@z:my_namespaced_attribute' to 'false'
xml:
path: foo.xml
xpath: /x:foo/x:bar/y:baz
namespaces:
x: http://x.test
y: http://y.test
z: http://z.test
attribute: z:my_namespaced_attribute
value: 'false'
sS
actions:
description: A dictionary with the original xpath, namespaces and state.
type: dict
returned: success
sample: {xpath: xpath, namespaces: [namespace1, namespace2], state=present}
backup_file:
description: The name of the backup file that was created
type: str
returned: when backup=yes
sample: /path/to/file.xml.1942.2017-08-24@14:16:01~
count:
description: The count of xpath matches.
type: int
returned: when parameter 'count' is set
sample: 2
matches:
description: The xpath matches found.
type: list
returned: when parameter 'print_match' is set
msg:
description: A message related to the performed action(s).
type: str
returned: always
xmlstring:
description: An XML string of the resulting output.
type: str
returned: when parameter 'xmlstring' is set
N( t LooseVersion( t BytesIO( t etreet objectify( t
AnsibleModulet json_dict_bytes_to_unicodet missing_required_lib( t iteritemst string_types( t to_bytest to_native( t MutableMappings [a-zA-Z-][a-zA-Z0-9_\-\.]*t |t :s ('(?:.*)'|"(?:.*)")s ^(.*)/(s )$s )/text\(\)=t $s ^(.*)/(@(?:s ))$s ))=s
)\[(.*)\]$s ^(.*)/text\(\)=c C` sL t j t j t j t } t j t j t j | } | | k S( N( R
t tostringR t
fromstringt orig_doc( t doct orig_objt obj( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt has_changedl s !!c C` s | j | d | } g } x$ | D] } | j | j | q" Wt j | } d | | f } t | | | | d t d | d S( Nt
namespacess selector '%s' match: %st changedt msg( t xpatht appendt getpatht jsont dumpst finisht False( t modulet treeR! R t matcht match_xpathst mt match_strR ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt do_print_matchr s
c C` sR | j d | d | } d | } t | | | | d t d | d t | d S( s. Return the count of nodes matching the xpath s
count(/%s)R s found %d nodesR R t hitcountN( R! R& R' t int( R( R) R! R t hitsR ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt count_nodes| s
c C` sH t | | | rD | j | d | } t | d t j rD t Sn t S( s Test if a given xpath matches anything and if that match is a node.
For now we just assume you're only searching for one specific thing.R i ( t
xpath_matchesR! t
isinstanceR
t _Elementt TrueR' ( R) R! R R* ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt is_node s
c C` sb t | | | r^ | j | d | } t | d t j rA t St | d t j r^ t Sn t S( su Test if a given xpath matches and that match is an attribute
An xpath attribute search will only match one itemR i ( R3 R! R4 R
t _ElementStringResultR6 t _ElementUnicodeResultR' ( R) R! R R* ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt is_attribute s c C` s | j | d | r t St S( s Test if a node exists R ( R! R6 R' ( R) R! R ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyR3 s c C` s y x | j | d | D]n } t | | | rS | j } | j j | j q t | | | r{ | j j | q t d q WWn- t k
r } | j d d | | f n Xt
| | | | d t d S( s, Delete an attribute or element from a tree R s Impossible errorR s% Couldn't delete xpath target: %s (%s)R N( R! R: t getparentt attribt popt attrnameR7 t removet Exceptiont fail_jsonR& R6 ( R( R) R! R t resultt parentt e( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt delete_xpath_target s c C` s5 x! t | D] } | j | q
W| j | d S( N( t listR? t extend( t childrenR* t element( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt replace_children_of s c
C` s | j | d | } t | | | } g | D] } t j | ^ q. } t } x | D] }
t t |
t | k r xf t t |
D]< \ } } t j | | | k r t | |
t } Pq q WqV t | |
t } qV W| S( NR (
R! t children_to_nodesR
R R' t lenRF t enumerateRJ R6 (
R( R) R! R RH t in_typet matchest ct children_as_stringR R* t idxRI ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt set_target_children_inner s "
c C` s8 t | | | | | | } t | | | | d | d S( NR ( RS R& ( R( R) R! R RH RN R ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt set_target_children s c
C` s t | | | r t | | | } | s0 | rL t | | | | | | n- x* | j | d | D] } | j | qb Wt | | | | d t n t | | | | d S( NR R ( R7 RK t insert_target_childrenR! RG R& R6 (
R( R) R! R RH RN t insertbeforet insertaftert new_kidst node( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt add_target_children s c C` s | j | d | } | r! d n d } | | j j | | } | d j } | rg | d 7} n x( | D] }
| j | |
| d 7} qn Wd S( s
Insert the given children before or after the given xpath. If insertbefore is True, it is inserted before the
first xpath hit, with insertafter, it is inserted after the last xpath hit.
R i ii N( R! R; t indext insert( R) R! R RH RV RW t
insert_targett loc_indext index_in_parentRC t child( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyRU s
c C` s | d d !S( Ni i( ( t g( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt _extract_xpstr s c C` s | j } t j | } | rF | j d | j d d f g f St j | } | r | j d | j d t | j d f g f St j | } | r | j d | j d d f g f St j | } | r| j d | j d t | j d f g f St j | } | rg | j d j
d D] } | j ^ q@} | j d d | j d | f g f St j | } | r| j d d t | j d f g f S| g f S( s= split an XPath of the form /foo/bar/baz into /foo/bar and bazi i i s and t /t N( t stript _RE_SPLITSIMPLELASTR* t groupt Nonet _RE_SPLITSIMPLELASTEQVALUERb t _RE_SPLITSIMPLEATTRLASTt _RE_SPLITSIMPLEATTRLASTEQVALUEt _RE_SPLITSUBLASTt splitt _RE_SPLITONLYEQVALUE( R! R, t xt content( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt split_xpath_last s* %4%41)+c C` s9 d | k r5 | j d \ } } d j | | | S| S( NR s
{{{0}}}{1}( Rm t format( t nameR t nsnamet rawname( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt
nsnameToClark" s c C` s% t | \ } } | | k s* | d k rW | j d d | t j | d t f t St } t | | | s t | | | | } n t | | | r!| r!x| D]t\ } } | rO| d d k rO| d d k rOt | t
| | g d } | rx | D] }
| |
_ qWn x| j | d | D] } | j
| t } q/Wq | r| d d k r| d } t | t
| | g d } x| j | d | D]R } | j
| x6 | D]. }
x% | D] }
t | |
d
|
| qWqWt } qWq | d k rLx| j | d | D]' } | j | k r | | _ t } q q Wq | r| d d k rt
| d | } x | j | d | D]e } | | j k p| j | | k } | r| p| } | d k rd } n | } | | j | Invalid child input type: %s. Type must be either xml or yaml.( R R R
t XMLParsert parseR t XMLSyntaxErrorRA R4 R t ElementR RL t nextR R= Rh RF t typeRK RG R{ ( R( R` RN t infilet parserRY RD R R RH t subnodes( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt child_to_element s8
Ry c C` s; | d k r g n | } g | D] } t | | | ^ q S( s8 turn a str/hash/list of str&hash into a list of elementsN( Rh R ( R( RH R R` ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyRK s c
C` s2 t j | d t d d d | j d } t d t } | j d r | j d } t | d } | | j k r t | d <| j s | j d r | j | j d | d t
d- j d1 t j
D t
d2 k r| j d3 n | d k r-| d k r-| j d4 | d5 n | rNt t | d6 d7 } n8 t j j | rrt | d8 } n | j d* d9 | | d k ry t j | Wqt j k
r} | j d* d: | | f qt j k
r} | j d* d; | | f qXn y. t j d< |
d= | } t j | | } Wn6 t j k
rn} | j d* d> | p`d? | f n Xt j | a |
rt | | | | n | rt! | | | | n | d k rt" | | | | n" | d k rt# | | | | n | d k r t$ | | | | n | r>t% | | | | | | n | rft& | | | | | | | | n | d k rt' | | | | | | n | d k rt( | | | | n |
rt) | | n | j d* d@ d S(A Nt
argument_specR R t aliasest destt fileR t strR! R R t defaultR t presentt choicest absentt ensureR t rawR t add_childrenRF t set_childrenR t boolR Rw Rp R{ t
input_typeRy R R t strip_cdata_tagsRV RW t supports_check_modet required_byt required_ift required_one_oft mutually_exclusiveR t lxmlR t .c s` s | ] } t | Vq d S( N( R ( t .0t f( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pys p s s 2.3.0sT The xml ansible module requires lxml 2.3.0 or newer installed on the managed machinec s` s | ] } t | Vq d S( N( R ( R R ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pys r s s 3.0.0s[ Using lxml version lower than 3.0.0 does not guarantee predictable element attribute order.sm Parameter 'attribute=%s' is ignored when using 'content=attribute' only 'xpath' is used. Please remove entry.s 2.12R R R s* The target XML source '%s' does not exist.s) Syntax error in xpath expression: %s (%s)s- Evaluation error in xpath expression: %s (%s)t remove_blank_textt strip_cdatas% Error while parsing document: %s (%s)R s Don't know what to do(* R R R' R6 R R
t HAS_LXMLRA R t LXML_IMP_ERRR t joinR
t LXML_VERSIONt warnRh t deprecateR R t osR t isfileR t XPatht XPathSyntaxErrort XPathEvalErrorR R R t copyt deepcopyR R. R2 R R RE RT RZ R R R ( R( R R R! R R R R R R Rw Rp R R R R R RV RW R RD R R ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt main* s *!
.. !$ " t __main__(O t
__future__R R R R t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNR R$ R t reR t distutils.versionR t ioR Rh R R R
R R6 R t ImportErrorR R' t ansible.module_utils.basicR R
R t ansible.module_utils.sixR R t ansible.module_utils._textR R t/ ansible.module_utils.common._collections_compatR t _IDENTt _NSIDENTt _XPSTRt compileRf Ri Rj Rk Rl Rn R R. R2 R7 R: R3 RE RJ RS RT RZ RU Rb Rq Rv Rz R R R R R R RK R t tupleR& R t __name__( ( ( s= /usr/lib/python2.7/site-packages/ansible/modules/files/xml.pyt
s|
!
D $ ' &