[robotframework] 2 new revisions pushed by pekka.klarck on 2012-07-05 21:00 GMT

robotframework Thu, 05 Jul 2012 14:00:53 -0700

2 new revisions:

Revision: aeef53a2ad68
Author:   Pekka Klärck
Date:     Thu Jul  5 14:00:18 2012

Log: XML lib: Initial overall documentation. Not yet ready for reviewand k...

http://code.google.com/p/robotframework/source/detail?r=aeef53a2ad68


Revision: a761ce6e0170
Author:   Pekka Klärck
Date:     Thu Jul  5 14:00:25 2012
Log:      regen
http://code.google.com/p/robotframework/source/detail?r=a761ce6e0170

==============================================================================
Revision: aeef53a2ad68
Author:   Pekka Klärck
Date:     Thu Jul  5 14:00:18 2012

Log: XML lib: Initial overall documentation. Not yet ready for reviewand kw docs fully missing too.

http://code.google.com/p/robotframework/source/detail?r=aeef53a2ad68

Modified:
 /src/robot/libraries/XML.py

=======================================
--- /src/robot/libraries/XML.py Thu Jul  5 04:48:26 2012
+++ /src/robot/libraries/XML.py Thu Jul  5 14:00:18 2012
@@ -27,11 +27,172 @@


 class XML(object):
+    """Robot Framework test library for XML verification.
+

+ As the name implies, `XML` is a test library for verifying contents ofXML+ files. In practice this library is a pretty thin wrapper on top ofPython's+ [ElementTree XML API|http://docs.python.org/library/xml.etree.elementtree.html].

+
+    XML can be parsed into an element structure using either `Parse XML`,

+ `Get Element` or `Get Elements` keywords. The returned elements canthen

+    be used as an input with all other keywords, but these keywords also
+    support parsing XML files and strings directly.
+
+    *Elements attributes*
+

+ All keywords returning elements, such as `Parse XML`, and `GetElement`,

+    return ElementTree's

+ [Element classes|http://docs.python.org/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element].

+    These elements can be used as inputs for other keywords, but they also
+    contain several useful attributes that can be accessed directly using
+    the extended variable syntax.
+
+    The attributes that are both useful and convenient to use in the test
+    data are explained below with examples. Also other attributes, and also
+    methods, can be accessed, but that is typically better to do in custom
+    libraries than directly in the test data.
+
+    In the examples `${XML}` and `${HTML}` refer to the following example
+    structures:
+
+    | <example>
+    |   <first>text</first>
+    |   <second id="2">
+    |     <child/>
+    |   </second>
+    |   <third>
+    |     <child>more text</child>
+    |     <second id="child"/>
+    |     <child><grandchild/></child>
+    |   </third>
+    | </example>
+
+    | <html>
+    |   <head><title>Example</title></head>
+    |   <body>
+    |     <p>
+    |       Example text with <b>bold</b> and <i>italics</i>.
+    |     </p>
+    |   </body>
+    | </html>
+
+    _tag_
+
+    The tag of the element.
+
+    | ${root} =       | Parse XML   | ${XML}  |
+    | Should Be Equal | ${root.tag} | example |
+
+    _text_
+

+ The text that the element contains or Python `None` if the element hasno

+    text. Notice that the text _does not_ contain texts of possible child
+    elements nor text after/between children. Notice also that in XML

+ whitespace is significant, so the text contains also possibleindentation

+    and newlines. To get also text of the possible children, optionally
+    whitespace normalized, use `Get Element Text` keyword.
+
+    | ${1st} =        | Get Element | ${XML}    | first  |
+    | Should Be Equal | ${1st.text} | text      |        |
+    | ${2nd} =        | Get Element | ${XML}    | second |
+    | Should Be Equal | ${2nd.text} | ${NONE}   |        |
+    | ${p} =          | Get Element | ${HTML}   | body/p |

+ | Should Be Equal | ${p.text} | \n${SPACE*6}Example textwith${SPACE} |

+
+    _tail_
+

+ The text after the element before the next opening or closing tag.Python+ `None` if the element has no tail. Similarly as with `text`, also`tail`

+    contains possible indentation and newlines.
+
+    | ${title} =      | Get Element    | ${HTML}   | head/title  |
+    | Should Be Equal | ${title.tail}  | ${NONE}   |             |
+    | ${b} =          | Get Element    | ${HTML}   | body/p/b    |
+    | Should Be Equal | ${b.tail}      | ${SPACE}and${SPACE}     |
+
+    _attrib_
+
+    A Python dictionary containing attributes of the element.
+
+    | ${1st} =        | Get Element         | ${XML} | first  |
+    | Should Be Empty | ${1st.attrib}       |        |        |
+    | ${2nd} =        | Get Element         | ${XML} | second |
+    | Should Be Equal | ${2nd.attrib['id']} | 2      |        |
+
+    *Finding elements with xpath*
+

+ ElementTree, and thus also this library, supports finding elementsusing+ xpath expressions. ElementTree does not, however, support the fullxpath+ syntax, and what is supported depends on its version. ElementTree 1.3that+ is distributed with Python/Jython 2.7 supports richer syntax thanversions

+    distributed with earlier Python interpreters.
+
+    Supported xpath syntax is explained below and
+    [ElementTree documentation|http://effbot.org/zone/element-xpath.htm]
+    provides more details. The examples use same `${XML}` and `${HTML}`
+    structures as earlier examples.
+
+    _Tag names_
+
+    When just a tag name is used, xpath matches all direct child elements
+    that have that tag name.
+
+    | ${elem} =        | Get Element   | ${XML}      | third  |
+    | Should Be Equal  | ${elem.tag}   | third       |        |
+    | @{children} =    | Get Elements  | ${elem}     | child  |
+    | Length Should Be | ${children}   | 2           |        |
+
+    _Paths_
+
+    Paths are creating by combining tag names with a forward slash (`/`).
+    For example, `parent/child` matches all `child` elements under `parent`
+    element.
+
+    | ${elem} = | Get Element | ${XML} | second/child            |
+    | ${elem} = | Get Element | ${XML} | third/child/grandchild  |
+
+    _Wildcards_
+
+    An asterisk (`*`) can be used in paths instead of a tag name to denote
+    any element.
+
+    | @{children} =    | Get Element | ${XML} | */child |
+    | Length Should Be | ${children} | 3      |         |
+
+    _Current node_
+
+    The current node is denoted with a dot (`.`). Normally the current node
+    is implicit and does not need to be included in the path.
+
+    _Search all sub elements_
+
+    Two forward slashes (`//`) mean that all sub elements, not only the

+ direct children, are searched. If the search is started from thecurrent

+    element, an explicit dot is required.
+
+    | @{elements} =    | Get Element | ${XML} | .//second |
+    | Length Should Be | ${children} | 2      |           |
+
+    _Predicates_
+
+    Predicates allow selecting elements using also other criteria than tag

+ names such as attributes or position. They are specified after thenormal

+    tag name or path using syntax `path[predicate]`.
+
+    Notice that predicates are supported only in ElementTree 1.3 that is
+    shipped with Python/Jython 2.7. What predicates are supported in that
+    version is explained in the table below.
+
+    | _Predicate_     | _Matches elements that_ | _Example_ |
+    | @attrib         | have the specified attribute. | third[@id] |

+ | @attrib="value" | have the specified attribute and it has thespecified value. | *[@id="2"] |+ | position | are in the specified position. Position can be aninteger (starting from 1), expression `last()`, or relative expression like`last() - 1`. | third/child[1] |+ | tag | have child element named `tag`. |third/child[grandchild] |

+
+    Predicates can also be stacked like `path[predicate1][predicate2]`.
+    A limitation is that possible position predicate must always be first.
     """

- Supported xpath is documented here:http://effbot.org/zone/element-xpath.htm

-    Notice that predicates (e.g. tag[@id="1"]) are supported only in ET 1.3
-    i.e in Python 2.7!
-    """
+
     _whitespace = re.compile('\s+')
     _xml_declaration = re.compile('^<\?xml .*\?>\n')


==============================================================================
Revision: a761ce6e0170
Author:   Pekka Klärck
Date:     Thu Jul  5 14:00:25 2012
Log:      regen
http://code.google.com/p/robotframework/source/detail?r=a761ce6e0170

Modified:
 /doc/libraries/XML.html

=======================================
--- /doc/libraries/XML.html     Thu Jun 28 14:48:38 2012
+++ /doc/libraries/XML.html     Thu Jul  5 14:00:25 2012
@@ -177,7 +177,7 @@

(function(a){var r=a.fn.domManip,d="_tmplitem",q=/^[^<]*(<[\w\W]+>)[^>]*$|\{\{\! /,b={},f={},e,p={key:0,data:{}},i=0,c=0,l=[];function g(g,d,h,e){varc={data:e||(e===0||e===false)?e:d?d.data:{},_wrap:d?d._wrap:null,tmpl:null,parent:d||null,nodes:[],calls:u,nest:w,wrap:x,html:v,update:t};g&&a.extend(c,g,{nodes:[],parent:d});if(h){c.tmpl=h;c._ctnt=c._ctnt||c.tmpl(a,c);c.key=++i;(l.length?f:b)[i]=c}returnc}a.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(f,d){a.fn[f]=function(n){varg=[],i=a(n),k,h,m,l,j=this.length===1&&this[0].parentNode;e=b||{};if(j&&j.nodeType===11&&j.childNodes.length===1&&i.length===1){i[d](this[0]);g=this}else{for(h=0,m=i.length;h<m;h++){c=h;k=(h>0?this.clone(true):this).get();a(i[h])[d](k);g=g.concat(k)}c=0;g=this.pushStack(g,f,i.selector)}l=e;e=null;a.tmpl.complete(l);returng}});a.fn.extend({tmpl:function(d,c,b){returna.tmpl(this[0],d,c,b)},tmplItem:function(){returna.tmplItem(this[0])},template:function(b){returna.template(b,this[0])},domManip:function(d,m,k){if(d[0]&&a.isArray(d[0])){varg=a.makeArray(arguments),h=d[0],j=h.length,i=0,f;while(i<j&&!(f=a.data(h[i++],"tmplItem")));if(f&&c)g[2]=function(b){a.tmpl.afterManip(this,b,k)};r.apply(this,g)}elser.apply(this,arguments);c=0;!e&&a.tmpl.complete(b);returnthis}});a.extend({tmpl:function(d,h,e,c){vari,k=!c;if(k){c=p;d=a.template[d]||a.template(null,d);f={}}elseif(!d){d=c.tmpl;b[c.key]=c;c.nodes=[];c.wrapped&&n(c,c.wrapped);returna(j(c,null,c.tmpl(a,c)))}if(!d)return[];if(typeof h==="function")h=h.call(c||{});e&&e.wrapped&&n(e,e.wrapped);i=a.isArray(h)?a.map(h,function(a){returna?g(e,c,d,a):null}):[g(e,c,d,h)];returnk?a(j(c,null,i)):i},tmplItem:function(b){var c;if(b instanceofa)b=b[0];while(b&&b.nodeType===1&&!(c=a.data(b,"tmplItem"))&&(b=b.parentNode));returnc||p},template:function(c,b){if(b){if(typeof b==="string")b=o(b);else if(binstanceof a)b=b[0]||{};if(b.nodeType)b=a.data(b,"tmpl")||a.data(b,"tmpl",o(b.innerHTML));return typeofc==="string"?(a.template[c]=b):b}return c?typeofc!=="string"?a.template(null,c):a.template[c]||a.template(null,q.test(c)?c:a(c)):null},encode:function(a){return(""+a).split("&").join("&").split("<").join("<").split(">").join(">").split('"').join(""").split("'").join("'")}});a.extend(a.tmpl,{tag:{tmpl:{_default:{$2:"null"},open:"if($notnull_1){__=__.concat($item.nest($1,$2));}"},wrap:{_default:{$2:"null"},open:"$item.calls(__,$1,$2);__=[];",close:"call=$item.calls();__=call._.concat($item.wrap(call,__));"},each:{_default:{$2:"$index,$value"},open:"if($notnull_1){$.each($1a,function($2){with(this){",close:"}});}"},"if":{open:"if(($notnull_1)&& $1a){",close:"}"},"else":{_default:{$1:"true"},open:"}elseif(($notnull_1) &&$1a){"},html:{open:"if($notnull_1){__.push($1a);}"},"=":{_default:{$1:"$data"},open:"if($notnull_1){__.push($.encode($1a));}"},"!":{open:""}},complete:function(){b={}},afterManip:function(f,b,d){vare=b.nodeType===11?a.makeArray(b.childNodes):b.nodeType===1?[b]:[];d.call(f,b);m(e);c++}});functionj(e,g,f){var b,c=f?a.map(f,function(a){return typeofa==="string"?e.key?a.replace(/(<\w+)(?=[\s>])(?![^>]*_tmplitem)([^>]*)/g,"$1 "+d+'="'+e.key+'"$2'):a:j(a,e,a._ctnt)}):e;if(g)returnc;c=c.join("");c.replace(/^\s*([^<\s][^<]*)?(<[\w\W]+>)([^>]*[^>\s])?\s*$/,function(f,c,e,d){b=a(e).get();m(b);if(c)b=k(c).concat(b);if(d)b=b.concat(k(d))});returnb?b:k(c)}function k(c){varb=document.createElement("div");b.innerHTML=c;returna.makeArray(b.childNodes)}function o(b){return newFunction("jQuery","$item","var$=jQuery,call,__=[],$data=$item.data;with($data){__.push('"+a.trim(b).replace(/([\\'])/g,"\\$1").replace(/[\r\t\n]/g," ").replace(/\$\{([^\}]*)\}/g,"{{=$1}}").replace(/\{\{(\/?)(\w+|.)(?:$((?:[^\}]|\}(?!\}))*?)?$)?(?:\s+(.*?)?)?($((?:[^\}]|\}(?!\}))*?)$)?\s*\}\}/g,function(m,l,k,g,b,c,d){varj=a.tmpl.tag[k],i,e,f;if(!j)throw"Unknown template tag: "+k;i=j._default||[];if(c&&!/\w$/.test(b)){b+=c;c=""}if(b){b=h(b);d=d?","+h(d)+")":c?")":"";e=c?b.indexOf(".")>-1?b+h(c):"("+b+").call($item"+d:b;f=c?e:"(typeof("+b+")==='function'?("+b+").call($item):("+b+"))"}elsef=e=i.$1||"null";g=h(g);return"');"+j[l?"close":"open"].split("$notnull_1").join(b?"typeof("+b+")!=='undefined'&&("+b+")!=null":"true").split("$1a").join(f).split("$1").join(e).split("$2").join(g||i.$2||"")+"__.push('"})+"');}return __;")}functionn(c,b){c._wrap=j(c,true,a.isArray(b)?b:[q.test(b)?b:a(b).html()]).join("")}functionh(a){return a?a.replace(/\\'/g,"'").replace(/\\\\/g,"\\"):null}functions(b){vara=document.createElement("div");a.appendChild(b.cloneNode(true));returna.innerHTML}function m(o){varn="_"+c,k,j,l={},e,p,h;for(e=0,p=o.length;e<p;e++){if((k=o[e]).nodeType!==1)continue;j=k.getElementsByTagName("*");for(h=j.length-1;h>=0;h--)m(j[h]);m(k)}functionm(j){varp,h=j,k,e,m;if(m=j.getAttribute(d)){while(h.parentNode&&(h=h.parentNode).nodeType===1&&!(p=h.getAttribute(d)));if(p!==m){h=h.parentNode?h.nodeType===11?0:h.getAttribute(d)||0:0;if(!(e=b[m])){e=f[m];e=g(e,b[h]||f[h]);e.key=++i;b[i]=e}c&&o(m)}j.removeAttribute(d)}elseif(c&&(e=a.data(j,"tmplItem"))){o(e.key);b[e.key]=e;h=a.data(j.parentNode,"tmplItem");h=h?h.key:0}if(e){k=e;while(k&&k.key!=h){k.nodes.push(j);k=k.parent}deletee._ctnt;delete e._wrap;a.data(j,"tmplItem",e)}functiono(a){a=a+n;e=l[a]=l[a]||g(e,b[e.parent.key+n]||e.parent)}}}functionu(a,d,c,b){if(!a)returnl.pop();l.push({_:a,tmpl:d,item:this,data:c,options:b})}functionw(d,c,b){return a.tmpl(a.template(d),c,b,this)}function x(b,d){varc=b.options||{};c.wrapped=d;returna.tmpl(a.template(b.tmpl),b.data,c,b.item)}function v(d,c){varb=this._wrap;return a.map(a(a.isArray(b)?b.join(""):b).filter(d||"*"),function(a){return c?a.innerText||a.textContent:a.outerHTML||s(a)})}function t(){varb=this.nodes;a.tmpl(null,null,null,this).insertBefore(b[0]);a(b).remove()}})(jQuery);

 </script>
 <script type="text/javascript">

-libdoc = {"doc":"Supported xpath is documented here: <ahref=\"http://effbot.org/zone/element-xpath.htm\";>http://effbot.org/zone/element-xpath.htm</a>Notice that support for predicates (e.g. tag[@id=\"1\"]) is supported onlyin 1.3 i.e in Python 2.7!","generated":"2012-06-2900:47:14","inits":[],"keywords":[{"args":"source, name, expected, xpath=.,message=None","doc":"","name":"Element Attribute ShouldBe","shortdoc":""},{"args":"source, name, pattern, xpath=.,message=None","doc":"","name":"Element Attribute ShouldMatch","shortdoc":""},{"args":"source, expected, xpath=.,normalize_whitespace=False, message=None","doc":"","name":"Element TextShould Be","shortdoc":""},{"args":"source, pattern, xpath=.,normalize_whitespace=False, message=None","doc":"","name":"Element TextShould Match","shortdoc":""},{"args":"source","doc":"","name":"Element ToString","shortdoc":""},{"args":"source, expected,normalize_whitespace=False","doc":"","name":"Elements Should BeEqual","shortdoc":""},{"args":"source, expected,normalize_whitespace=False, message=None","doc":"","name":"Elements ShouldMatch","shortdoc":""},{"args":"source, xpath=.","doc":"","name":"GetElement","shortdoc":""},{"args":"source, name, xpath=.,default=None","doc":"","name":"Get ElementAttribute","shortdoc":""},{"args":"source, xpath=.","doc":"","name":"GetElement Attributes","shortdoc":""},{"args":"source, xpath=.,normalize_whitespace=False","doc":"","name":"Get ElementText","shortdoc":""},{"args":"source, xpath","doc":"","name":"GetElements","shortdoc":""},{"args":"source, xpath,normalize_whitespace=False","doc":"","name":"Get ElementsTexts","shortdoc":""},{"args":"source","doc":"","name":"LogElement","shortdoc":""},{"args":"source","doc":"","name":"ParseXml","shortdoc":""}],"name":"XML","named_args":true,"scope":"testcase","version":"<unknown>"};+libdoc = {"doc":"Robot Framework test library for XMLverification.\nAs the name implies, XMLis a test library for verifying contents of XML files. In practice thislibrary is a pretty thin wrapper on top of Python's <a href=\"ElementTreeXMLAPI\">http://docs.python.org/library/xml.etree.elementtree.html</a>.\nXMLcan be parsed into an element structure using either <a href=\"#Parse Xml\"class=\"name\">Parse XML</a>, <a href=\"#Get Element\" class=\"name\">GetElement</a> or <a href=\"#Get Elements\" class=\"name\">Get Elements</a>keywords. The returned elements can then be used as an input with all otherkeywords, but these keywords also support parsing XML files and stringsdirectly.\nElements attributes\nAll keywords returningelements, such as <a href=\"#Parse Xml\" class=\"name\">Parse XML</a>, and<a href=\"#Get Element\" class=\"name\">Get Element</a>, returnElementTree's <a href=\"Elementclasses\">http://docs.python.org/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element</a>.These elements can be used as inputs for other keywords, but they alsocontain several useful attributes that can be accessed directly using theextended variable syntax.\nThe attributes that are both useful andconvenient to use in the test data are explained below with examples. Alsoother attributes, and also methods, can be accessed, but that is typicallybetter to do in custom libraries than directly in the test data.\nInthe examples ${XML} and <spanclass=\"name\">${HTML} refer to the following examplestructures:\n<pre>\n<example>\n<first>text</first>\n <second id=\"2\">\n<child/>\n </second>\n <third>\n <child>moretext</child>\n <second id=\"child\"/>\n<child><grandchild/></child>\n</third>\n</example>\n</pre>\n<pre>\n<html>\n<head><title>Example</title></head>\n<body>\n \n Example text withbold and italics.\n \n</body>\n</html>\n</pre>\ntag\nThe tag of theelement.\n<table border=\"1\">\n<tr>\n<td>${root} =</td>\n<td>ParseXML</td>\n<td>${XML}</td>\n</tr>\n<tr>\n<td>Should BeEqual</td>\n<td>${root.tag}</td>\n<td>example</td>\n</tr>\n</table>\ntext\nThetext that the element contains or Python Noneif the element has no text. Notice that the text does not containtexts of possible child elements nor text after/between children. Noticealso that in XML whitespace is significant, so the text contains alsopossible indentation and newlines. To get also text of the possiblechildren, optionally whitespace normalized, use <a href=\"#Get ElementText\" class=\"name\">Get Element Text</a> keyword.\n<tableborder=\"1\">\n<tr>\n<td>${1st} =</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>first</td>\n</tr>\n<tr>\n<td>Should BeEqual</td>\n<td>${1st.text}</td>\n<td>text</td>\n<td></td>\n</tr>\n<tr>\n<td>${2nd}=</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>second</td>\n</tr>\n<tr>\n<td>Should BeEqual</td>\n<td>${2nd.text}</td>\n<td>${NONE}</td>\n<td></td>\n</tr>\n<tr>\n<td>${p}=</td>\n<td>GetElement</td>\n<td>${HTML}</td>\n<td>body/p</td>\n</tr>\n<tr>\n<td>Should BeEqual</td>\n<td>${p.text}</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n${SPACE*6}Exampletext with${SPACE} |\ntail\nThe text after the elementbefore the next opening or closing tag. Python <spanclass=\"name\">None if the element has no tail. Similarly as withtext, also tailcontains possible indentation and newlines.\n<tableborder=\"1\">\n<tr>\n<td>${title} =</td>\n<td>GetElement</td>\n<td>${HTML}</td>\n<td>head/title</td>\n</tr>\n<tr>\n<td>ShouldBeEqual</td>\n<td>${title.tail}</td>\n<td>${NONE}</td>\n<td></td>\n</tr>\n<tr>\n<td>${b}=</td>\n<td>GetElement</td>\n<td>${HTML}</td>\n<td>body/p/b</td>\n</tr>\n<tr>\n<td>ShouldBeEqual</td>\n<td>${b.tail}</td>\n<td>${SPACE}and${SPACE}</td>\n<td></td>\n</tr>\n</table>\nattrib\nAPython dictionary containing attributes of the element.\n<tableborder=\"1\">\n<tr>\n<td>${1st} =</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>first</td>\n</tr>\n<tr>\n<td>Should BeEmpty</td>\n<td>${1st.attrib}</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${2nd}=</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>second</td>\n</tr>\n<tr>\n<td>Should BeEqual</td>\n<td>${2nd.attrib['id']}</td>\n<td>2</td>\n<td></td>\n</tr>\n</table>\nFindingelements with xpath\nElementTree, and thus also this library,supports finding elements using xpath expressions. ElementTree does not,however, support the full xpath syntax, and what is supported depends onits version. ElementTree 1.3 that is distributed with Python/Jython 2.7supports richer syntax than versions distributed with earlier Pythoninterpreters.\nSupported xpath syntax is explained below and <ahref=\"ElementTreedocumentation\">http://effbot.org/zone/element-xpath.htm</a> provides moredetails. The examples use same ${XML} and <spanclass=\"name\">${HTML} structures as earlierexamples.\nTag names\nWhen just a tag name is used,xpath matches all direct child elements that have that tagname.\n<table border=\"1\">\n<tr>\n<td>${elem} =</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>third</td>\n</tr>\n<tr>\n<td>Should BeEqual</td>\n<td>${elem.tag}</td>\n<td>third</td>\n<td></td>\n</tr>\n<tr>\n<td>@{children}=</td>\n<td>GetElements</td>\n<td>${elem}</td>\n<td>child</td>\n</tr>\n<tr>\n<td>LengthShouldBe</td>\n<td>${children}</td>\n<td>2</td>\n<td></td>\n</tr>\n</table>\nPaths\nPathsare creating by combining tag names with a forward slash (<spanclass=\"name\">/). For example, <spanclass=\"name\">parent/child matches all <spanclass=\"name\">child elements under <spanclass=\"name\">parent element.\n<tableborder=\"1\">\n<tr>\n<td>${elem} =</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>second/child</td>\n</tr>\n<tr>\n<td>${elem}=</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>third/child/grandchild</td>\n</tr>\n</table>\nWildcards\nAnasterisk (*) can be used in paths instead of atag name to denote any element.\n<tableborder=\"1\">\n<tr>\n<td>@{children} =</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>*/child</td>\n</tr>\n<tr>\n<td>LengthShouldBe</td>\n<td>${children}</td>\n<td>3</td>\n<td></td>\n</tr>\n</table>\nCurrentnode\nThe current node is denoted with a dot (<spanclass=\"name\">.). Normally the current node is implicit and doesnot need to be included in the path.\nSearch all subelements\nTwo forward slashes (//)mean that all sub elements, not only the direct children, are searched. Ifthe search is started from the current element, an explicit dot isrequired.\n<table border=\"1\">\n<tr>\n<td>@{elements} =</td>\n<td>GetElement</td>\n<td>${XML}</td>\n<td>.//second</td>\n</tr>\n<tr>\n<td>LengthShouldBe</td>\n<td>${children}</td>\n<td>2</td>\n<td></td>\n</tr>\n</table>\nPredicates\nPredicatesallow selecting elements using also other criteria than tag names such asattributes or position. They are specified after the normal tag name orpath using syntax <spanclass=\"name\">path[predicate].\nNotice that predicates aresupported only in ElementTree 1.3 that is shipped with Python/Jython 2.7.What predicates are supported in that version is explained in the tablebelow.\n<tableborder=\"1\">\n<tr>\n<td>Predicate</td>\n<td>Matches elementsthat</td>\n<td>Example</td>\n</tr>\n<tr>\n<td>@attrib</td>\n<td>havethe specifiedattribute.</td>\n<td>third[@id]</td>\n</tr>\n<tr>\n<td>@attrib=\"value\"</td>\n<td>havethe specified attribute and it has the specifiedvalue.</td>\n<td>*[@id=\"2\"]</td>\n</tr>\n<tr>\n<td>position</td>\n<td>arein the specified position. Position can be an integer (starting from 1),expression last(), or relative expression likelast() -1.</td>\n<td>third/child[1]</td>\n</tr>\n<tr>\n<td>tag</td>\n<td>havechild element named <spanclass=\"name\">tag.</td>\n<td>third/child[grandchild]</td>\n</tr>\n</table>\nPredicatescan also be stacked like <spanclass=\"name\">path[predicate1][predicate2]. A limitation is thatpossible position predicate must always befirst.","generated":"2012-07-0523:58:23","inits":[],"keywords":[{"args":"source, name, expected, xpath=.,message=None","doc":"","name":"Element Attribute ShouldBe","shortdoc":""},{"args":"source, name, pattern, xpath=.,message=None","doc":"","name":"Element Attribute ShouldMatch","shortdoc":""},{"args":"source, expected, xpath=.,normalize_whitespace=False, message=None","doc":"","name":"Element TextShould Be","shortdoc":""},{"args":"source, pattern, xpath=.,normalize_whitespace=False, message=None","doc":"","name":"Element TextShould Match","shortdoc":""},{"args":"source","doc":"","name":"Element ToString","shortdoc":""},{"args":"source, expected,normalize_whitespace=False","doc":"","name":"Elements Should BeEqual","shortdoc":""},{"args":"source, expected,normalize_whitespace=False","doc":"","name":"Elements ShouldMatch","shortdoc":""},{"args":"source, xpath=.","doc":"","name":"Get ChildElements","shortdoc":""},{"args":"source, xpath=.","doc":"","name":"GetElement","shortdoc":""},{"args":"source, name, xpath=.,default=None","doc":"","name":"Get ElementAttribute","shortdoc":""},{"args":"source, xpath=.","doc":"","name":"GetElement Attributes","shortdoc":""},{"args":"source, xpath=.,normalize_whitespace=False","doc":"","name":"Get ElementText","shortdoc":""},{"args":"source, xpath","doc":"","name":"GetElements","shortdoc":""},{"args":"source, xpath,normalize_whitespace=False","doc":"","name":"Get ElementsTexts","shortdoc":""},{"args":"source, level=INFO","doc":"","name":"LogElement","shortdoc":""},{"args":"source","doc":"","name":"ParseXml","shortdoc":""}],"name":"XML","named_args":true,"scope":"testcase","version":"<unknown>"};

 </script>
 <title></title>
 </head>

[robotframework] 2 new revisions pushed by pekka.klarck on 2012-07-05 21:00 GMT

Reply via email to