3 new revisions:
Revision: bff79f693130
Author: Pekka Klärck
Date: Sun Sep 25 01:21:51 2011
Log: dos2unix
http://code.google.com/p/robotframework/source/detail?r=bff79f693130
Revision: e1bf6add4677
Author: Pekka Klärck
Date: Sun Sep 25 11:19:52 2011
Log: bump
http://code.google.com/p/robotframework/source/detail?r=e1bf6add4677
Revision: 3f93ebb41af5
Author: Pekka Klärck
Date: Sun Sep 25 11:30:46 2011
Log: Documented how listener methods can log....
http://code.google.com/p/robotframework/source/detail?r=3f93ebb41af5
==============================================================================
Revision: bff79f693130
Author: Pekka Klärck
Date: Sun Sep 25 01:21:51 2011
Log: dos2unix
http://code.google.com/p/robotframework/source/detail?r=bff79f693130
Modified:
/atest/testdata/output/listeners/failing_listener.py
/atest/testdata/output/listeners/logging_listener.py
==============================================================================
Revision: e1bf6add4677
Author: Pekka Klärck
Date: Sun Sep 25 11:19:52 2011
Log: bump
http://code.google.com/p/robotframework/source/detail?r=e1bf6add4677
Modified:
/src/robot/version.py
=======================================
--- /src/robot/version.py Wed Jul 27 04:38:15 2011
+++ /src/robot/version.py Sun Sep 25 11:19:52 2011
@@ -3,8 +3,8 @@
import sys
VERSION = 'trunk'
-RELEASE = '20110727'
-TIMESTAMP = '20110727-143805'
+RELEASE = '20110925'
+TIMESTAMP = '20110925-211944'
def get_version(sep=' '):
if RELEASE == 'final':
==============================================================================
Revision: 3f93ebb41af5
Author: Pekka Klärck
Date: Sun Sep 25 11:30:46 2011
Log: Documented how listener methods can log.
Update issue 548
Status: Review
This is now documented in the User Guide. Review would be nice. Otherwise I
consider this done.
http://code.google.com/p/robotframework/source/detail?r=3f93ebb41af5
Modified:
/doc/userguide/src/ExtendingRobotFramework/ListenerInterface.txt
=======================================
--- /doc/userguide/src/ExtendingRobotFramework/ListenerInterface.txt Fri
Jul 22 01:51:13 2011
+++ /doc/userguide/src/ExtendingRobotFramework/ListenerInterface.txt Sun
Sep 25 11:30:46 2011
@@ -232,6 +232,42 @@
void debugFile(String path);
void close();
}
+
+Listeners logging
+~~~~~~~~~~~~~~~~~
+
+Robot Framework 2.6 introduced new `programmatic logging APIs`_ that
+also listeners can utilize. There are some limitations, however, and
+how different listener methods can log messages is explained in the
+table below.
+
+.. table:: How listener methods can log
+ :class: tabular
+
+
+----------------------+---------------------------------------------------+
+ | Methods |
Explanation |
+
+======================+===================================================+
+ | start_keyword, | Messages are logged to the normal `log
file`_ |
+ | end_keyword, | under the executed
keyword. |
+ | log_message
| |
+
+----------------------+---------------------------------------------------+
+ | start_suite, | Messages are logged to the syslog_. Warnings
are |
+ | end_suite, | shown also in the `execution errors`_ section
of |
+ | start_test, end_test | the normal log
file. |
+
+----------------------+---------------------------------------------------+
+ | message | Messages are normally logged to the syslog.
If |
+ | | this method is used while a keyword is
executing, |
+ | | messages are logged to the normal log
file. |
+
+----------------------+---------------------------------------------------+
+ | Other methods | Messages are only logged to the
syslog. |
+
+----------------------+---------------------------------------------------+
+
+.. note:: To avoid recursion, messages logged by listeners are not sent to
+ listener methods :code:`log_message` and :code:`message`.
+
+.. warning:: There were severe problems with listeners logging prior
+ to Robot Framework 2.6.2. Using this functionality with
+ earlier versions is thus not recommended.
Listener examples
~~~~~~~~~~~~~~~~~
