Author: pekka.klarck
Date: Mon Mar 23 00:45:58 2009
New Revision: 1481
Modified:
trunk/doc/libraries/BuiltIn.html
Log:
regen
Modified: trunk/doc/libraries/BuiltIn.html
==============================================================================
--- trunk/doc/libraries/BuiltIn.html (original)
+++ trunk/doc/libraries/BuiltIn.html Mon Mar 23 00:45:58 2009
@@ -2,8 +2,8 @@
<html>
<head>
<title>BuiltIn - Documentation</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style>
-
body {
background: white;
color: black;
@@ -79,7 +79,7 @@
</head>
<body>
<h1>BuiltIn - Documentation</h1>
-<p><b>Version:</b> trunk 20081201</p>
+<p><b>Version:</b> trunk 20090322</p>
<h2 id="introduction">Introduction</h2>
<p class='libdoc'>BuiltIn library provides a set of often needed generic
keywords.<br />
@@ -125,6 +125,7 @@
<a href="#Run Keyword If Test Passed" title="Runs the given keyword with
the given arguments, if the test
passed.">Run Keyword If Test Passed</a>
<a href="#Run Keyword Unless" title="Runs the given keyword with the given
arguments, if `condition` is false.">Run Keyword Unless</a>
<a href="#Set Global Variable" title="Makes a variable available globally
in all tests and suites.">Set Global Variable</a>
+<a href="#Set Library Order" title="Sets order in which keywords are
looked from libraries.">Set Library Order</a>
<a href="#Set Log Level" title="Sets the log threshold to the specified
level and returns the old level.">Set Log Level</a>
<a href="#Set Suite Variable" title="Makes a variable available everywhere
within the scope of the current
suite.">Set Suite Variable</a>
<a href="#Set Tags" title="Adds given `tags` for the current test or all
tests in a suite.">Set Tags</a>
@@ -316,25 +317,45 @@
</tr>
<tr>
<td class="kw"><a name="Evaluate"></a>Evaluate</td>
- <td class="arg">expression</td>
+ <td class="arg">expression, modules=None</td>
<td class="doc">Evaluates the given expression in Python and returns the
results.<br />
<br />
-Examples (expecting ${RC} is -1):<br />
+<span class="name">modules</span> argument can be used to specify a comma
separated list of Python modules to be imported and added to the namespace
of the evaluated <span class="name">expression</span>.<br />
+<br />
+Examples (expecting ${result} is 3.14):<br />
<table border="1" class="doc">
<tr>
<td>${status} =</td>
<td>Evaluate</td>
-<td>0 < ${RC} < 10</td>
+<td>0 < ${result} < 10</td>
+<td></td>
+</tr>
+<tr>
+<td>${down} =</td>
+<td>Evaluate</td>
+<td>int(${result})</td>
+<td></td>
</tr>
<tr>
-<td>${dict} =</td>
+<td>${up} =</td>
<td>Evaluate</td>
-<td>{ 'a':1, 'b':2, 'c':3 }</td>
+<td>math.ceil(${result})</td>
+<td>math</td>
+</tr>
+<tr>
+<td>${random} =</td>
+<td>Evaluate</td>
+<td>random.randint(0, sys.maxint)</td>
+<td>random,sys</td>
</tr>
</table>
=><br />
-- ${status} = False<br />
-- ${dict} = { 'a':1, 'b':2, 'c':3 }</td>
+- ${status} = True<br />
+- ${down} = 3<br />
+- ${up} = 4.0<br />
+- ${rondom} = <random integer><br />
+<br />
+Notice that instead of creating complicated expressions, it is recommended
to move the logic into a test library.</td>
</tr>
<tr>
<td class="kw"><a name="Fail"></a>Fail</td>
@@ -810,6 +831,73 @@
See <a href="#Set Suite Variable" class="name">Set Suite Variable</a> for
more information and examples.</td>
</tr>
<tr>
+ <td class="kw"><a name="Set Library Order"></a>Set Library Order</td>
+ <td class="arg">*libraries</td>
+ <td class="doc">Sets order in which keywords are looked from
libraries.<br />
+<br />
+By setting order in which keywords are serached it is possible to use
libraries providing keywords with same name without using long format
LibraryName.Keyword Name notation. This keyword is usefull in case there is
need to use multiple applications through the same library. By changing
library which is used, it is possible to use same resources instead
dublicating the keywords for all the applications.<br />
+<br />
+Examples:<br />
+<table border="1" class="doc">
+<tr>
+<td>Import Library</td>
+<td>MyLibrary</td>
+<td>WITH NAME</td>
+<td>application1</td>
+</tr>
+<tr>
+<td>Import Library</td>
+<td>MyLibrary</td>
+<td>WITH NAME</td>
+<td>application2</td>
+</tr>
+<tr>
+<td>Set Default Library</td>
+<td>application1</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>Comment</td>
+<td>Next step opens application1 using User Keyword</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>Comment</td>
+<td>Open Application which contains multiple keywords from MyLibrary</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>Open Application</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>Set Default Library</td>
+<td>application2</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>Comment</td>
+<td>Now the same keyword is used for opening application2</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>Open Application</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+</table>
+<br />
+Note: Set Library Order keyword cannot be used inside parallel
keywords.</td>
+</tr>
+<tr>
<td class="kw"><a name="Set Log Level"></a>Set Log Level</td>
<td class="arg">level</td>
<td class="doc">Sets the log threshold to the specified level and
returns the old level.<br />
@@ -1380,9 +1468,9 @@
</tr>
</table>
<p class="footer">
-Altogether 69 keywords.<br />
+Altogether 70 keywords.<br />
Generated by <a
href="http://code.google.com/p/robotframework/wiki/LibraryDocumentationTool";>libdoc.py</a>
-on 2009-01-05 18:05:55.
+on 2009-03-23 09:45:17.
</p>
</body>
</html>
