2 new revisions:
Revision: 33b2e4eed4e4
Branch: default
Author: Robot Framework Developers (robotframew...@gmail.com)
Date: Tue Jun 11 04:52:28 2013
Log: UG: little more named/kwargs w/ vars tuning
http://code.google.com/p/robotframework/source/detail?r=33b2e4eed4e4
Revision: 39b11420a81e
Branch: default
Author: Robot Framework Developers (robotframew...@gmail.com)
Date: Tue Jun 11 04:52:43 2013
Log: Automated merge with https://robotframework.googlecode.com/hg/
http://code.google.com/p/robotframework/source/detail?r=39b11420a81e
==============================================================================
Revision: 33b2e4eed4e4
Branch: default
Author: Robot Framework Developers (robotframew...@gmail.com)
Date: Tue Jun 11 04:52:28 2013
Log: UG: little more named/kwargs w/ vars tuning
http://code.google.com/p/robotframework/source/detail?r=33b2e4eed4e4
Modified:
/doc/userguide/src/CreatingTestData/CreatingTestCases.rst
=======================================
--- /doc/userguide/src/CreatingTestData/CreatingTestCases.rst Tue Jun 11
02:58:54 2013
+++ /doc/userguide/src/CreatingTestData/CreatingTestCases.rst Tue Jun 11
04:52:28 2013
@@ -273,17 +273,17 @@
It is possible to use `variables`_ in named argument values.
As when using `scalar variables`_, if the value is a single variable,
it is passed to the keyword as-is. This allows using any objects, not only
-strings, as values also when using the named argument syntax. For example
-calling a keyword with a named variable value :code:`arg=${object}` will
pass
-the variable `${object}` to keyword without converting it to a string.
+strings, as values also when using the named argument syntax. For example,
+calling a keyword like :code:`arg=${object}` will pass
+the variable `${object}` to the keyword without converting it to a string.
Using variables that contain a value like :code:`name=value` does not
trigger the named argument usage. This is because named argument syntax
requires
-the argument name to be written in the keyword call. This is important
-especially when wrapping keywords into other keywords. If for example a
keyword
-takes a `variable number of arguments`_ like :code:`@{args}` and passes
all of
-them to another keyword using the same :code:`@{args}` syntax, the values
are
-not recognized as named. See the example below:
+the argument name to be written in the keyword call. This is important to
+remember especially when wrapping keywords into other keywords. If, for
example,
+a keyword takes a `variable number of arguments`_ like :code:`@{args}`
+and passes all of them to another keyword using the same :code:`@{args}`
+syntax, the values are not recognized as named. See the example below:
.. table:: Named arguments are not recognized from variable values
:class: example
@@ -291,7 +291,7 @@
============= ================ ============ ============
Test Case Action Argument Argument
============= ================ ============ ============
- Example wrapper shell=true # This will not come as
a named argument to Start process
+ Example wrapper shell=True # This will not come as
a named argument to Start process
============= ================ ============ ============
.. table::
@@ -335,7 +335,6 @@
.. note:: Prior to Robot Framework 2.8 named argument syntax did not work
with test libraries using the `dynamic library API`_.
-
Named arguments example
```````````````````````
@@ -381,6 +380,9 @@
call using the :code:`name=value` syntax, but not matching any other
arguments,
are passed to it as free keyword arguments.
+Using variables with free keyword arguments works exactly like when `using
+the named argument syntax`__.
+
For a real life example of using kwargs, let's take a look at
:name:`Run Process` keyword in the Process_ library. It has a signature
:code:`command, *arguments, **configuration`, which means that it takes
@@ -407,6 +409,7 @@
libraries and perhaps also to user keywords in the future.
__ http://docs.python.org/2/tutorial/controlflow.html#keyword-arguments
+__ `Named arguments with variables`_
Arguments embedded to keyword names
'''''''''''''''''''''''''''''''''''
==============================================================================
Revision: 39b11420a81e
Branch: default
Author: Robot Framework Developers (robotframew...@gmail.com)
Date: Tue Jun 11 04:52:43 2013
Log: Automated merge with https://robotframework.googlecode.com/hg/
http://code.google.com/p/robotframework/source/detail?r=39b11420a81e
--
---
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 robotframework-commit+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
