[robotframework] 2 new revisions pushed by [email protected] on 2013-12-02 12:16 GMT

robotframework Mon, 02 Dec 2013 04:17:43 -0800

2 new revisions:

Revision: 3206ecb960f5
Branch:   default
Author:   Jussi Malinen <[email protected]>
Date:     Mon Dec  2 12:16:02 2013 UTC
Log:      Document kwargs on java...
http://code.google.com/p/robotframework/source/detail?r=3206ecb960f5


Revision: f679db2110e7
Branch:   default
Author:   Jussi Malinen <[email protected]>
Date:     Mon Dec  2 12:16:11 2013 UTC
Log:      regen
http://code.google.com/p/robotframework/source/detail?r=f679db2110e7

==============================================================================
Revision: 3206ecb960f5
Branch:   default
Author:   Jussi Malinen <[email protected]>
Date:     Mon Dec  2 12:16:02 2013 UTC
Log:      Document kwargs on java
Update issue 1583
Document kwargs on java
http://code.google.com/p/robotframework/source/detail?r=3206ecb960f5

Modified:
 /doc/userguide/src/ExtendingRobotFramework/CreatingTestLibraries.rst

=======================================

--- /doc/userguide/src/ExtendingRobotFramework/CreatingTestLibraries.rstFri Nov 29 22:29:06 2013 UTC+++ /doc/userguide/src/ExtendingRobotFramework/CreatingTestLibraries.rstMon Dec 2 12:16:02 2013 UTC

@@ -722,8 +722,9 @@

:code:`**kwargs` syntax. How to use the syntax in the test data isdiscussed

 in `Free keyword arguments`_ section under `Creating test cases`_. In this
 section we take a look at how to actually use it in custom test libraries.

-Because Java does not have similar keyword argument concept, thisfunctionality

-is only available with Python based libraries.
+
+Starting from Robot Framework 2.8.3, also Java libraries support the free
+keyword arguments.

 If you are already familiar how kwargs work with Python, understanding how
 they work with Robot Framework test libraries is rather simple. The example
@@ -735,7 +736,17 @@
         for name, value in stuff.items():
             print name, value

-.. table:: Using keywords with python :code:`**kwargs`
+
+Or the same in Java:
+
+.. sourcecode:: java
+
+    public void exampleKeyword(Map<String, Object> stuff):
+        for (String key: stuff.keySet())
+            System.out.println(key + " " + stuff.get(key));
+
+
+.. table:: Using keywords with :code:`**kwargs`
    :class: example

==================== ================ ============== =========================================

@@ -754,6 +765,8 @@
 The following examples illustrate how normal arguments, varargs, and kwargs
 work together.

+The example keyword in python:
+
 .. sourcecode:: python

   def various_args(arg, *varargs, **kwargs):
@@ -763,6 +776,18 @@
       for name, value in kwargs.items():
           print 'kwarg:', name, value

+and the same keyword implemented in java:
+
+.. sourcecode:: java
+

+ public void exampleKeyword(String arg, List<String> varargs,Map<String, Object> kwargs):

+        System.out.println("arg:" + arg);
+        for (String varg: varargs)
+            System.out.println("vararg:" + varg);
+        for (String key: kwargs.keySet())
+            System.out.println(key + " " + kwargs.get(key));
+
+
 .. table:: Using defaults, varargs, and kwargs together
    :class: example


==============================================================================
Revision: f679db2110e7
Branch:   default
Author:   Jussi Malinen <[email protected]>
Date:     Mon Dec  2 12:16:11 2013 UTC
Log:      regen
http://code.google.com/p/robotframework/source/detail?r=f679db2110e7

Modified:
 /doc/userguide/RobotFrameworkUserGuide.html

=======================================
--- /doc/userguide/RobotFrameworkUserGuide.html Mon Dec  2 09:19:06 2013 UTC
+++ /doc/userguide/RobotFrameworkUserGuide.html Mon Dec  2 12:16:11 2013 UTC
@@ -13011,9 +13011,9 @@

Robot Framework 2.8 added the support for free keyword arguments usingPython's**kwargs syntax. How to use the syntax in thetest data is discussedin <a class="reference internal" href="#free-keyword-arguments">Freekeyword arguments</a> section under <a class="reference internal"href="#creating-test-cases">Creating test cases</a>. In this

-section we take a look at how to actually use it in custom test libraries.

-Because Java does not have similar keyword argument concept, thisfunctionality

-is only available with Python based libraries.</p>

+section we take a look at how to actually use it in custom testlibraries.+Starting from Robot Framework 2.8.3, also Java libraries support thefree

+keyword arguments.</p>

If you are already familiar how kwargs work with Python, understandinghow

 they work with Robot Framework test libraries is rather simple. The example
 below shows the basic functionality.</p>
@@ -13021,8 +13021,13 @@

for name<spanclass="p">, value instuff.<spanclass="n">items():print name<spanclass="p">, value

 </pre></div>
+<p>Or the same in Java:</p>

+</pre></div>
 <table border="1" class="example docutils">

-<caption>Using keywords with python <spanclass="code">**kwargs</caption>

+<caption>Using keywords with <span class="code">**kwargs</span></caption>
 <colgroup>
 <col width="22%" />
 <col width="18%" />
@@ -13060,6 +13065,7 @@
 like <span class="code">foo\=quux</span>.</p>

The following examples illustrate how normal arguments, varargs, andkwargs

 work together.</p>
+<p>The example keyword in python:</p>

<div class="highlight"><pre>def <spanclass="nf">various_args(<spanclass="n">arg, *<spanclass="n">varargs, <spanclass="o">**kwargs):print <spanclass="s">'arg:', <spanclass="n">argfor value <spanclass="ow">in varargs:

@@ -13067,6 +13073,14 @@

for name<spanclass="p">, value inkwargs.<spanclass="n">items():print <spanclass="s">'kwarg:', <spanclass="n">name, value

 </pre></div>
+<p>and the same keyword implemented in java:</p>

+<div class="highlight"><pre>public <spanclass="kt">void exampleKeyword<spanclass="o">(String <spanclass="n">arg, <spanclass="n">List<<spanclass="n">String> <spanclass="n">varargs, <spanclass="n">Map<<spanclass="n">String, <spanclass="n">Object> <spanclass="n">kwargs):+ System.<spanclass="na">out.<spanclass="na">println(<spanclass="s">"arg:" + <spanclass="n">arg);+ for (<spanclass="n">String varg: <spanclass="n">varargs)+ System.<spanclass="na">out.<spanclass="na">println(<spanclass="s">"vararg:" + <spanclass="n">varg);+ for (<spanclass="n">String key: <spanclass="n">kwargs.<spanclass="na">keySet())+ System.<spanclass="na">out.<spanclass="na">println(key+ " " <spanclass="o">+ kwargs<spanclass="o">.get(<spanclass="n">key));

+</pre></div>
 <table border="1" class="example docutils">
 <caption>Using defaults, varargs, and kwargs together</caption>
 <colgroup>
@@ -17670,7 +17684,7 @@
 <div class="footer">
 <hr class="footer" />

Generated by <a class="reference external"href="http://docutils.sourceforge.net/rst.html";>reStructuredText</a>.Syntax highlighting by <a class="reference external"href="http://pygments.org/";>Pygments</a>.

-<p>Generated on: 2013-12-02 09:16 UTC.
+<p>Generated on: 2013-12-02 12:14 UTC.
 </p>

 </div>

--

---You received this message because you are subscribed to the Google Groups "robotframework-commit" group.

To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/groups/opt_out.

[robotframework] 2 new revisions pushed by [email protected] on 2013-12-02 12:16 GMT

Reply via email to