summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/manual/usermanual.xml4
-rw-r--r--lib/bb/event.py8
2 files changed, 7 insertions, 5 deletions
diff --git a/doc/manual/usermanual.xml b/doc/manual/usermanual.xml
index 6424a7ebd..bd44a69e3 100644
--- a/doc/manual/usermanual.xml
+++ b/doc/manual/usermanual.xml
@@ -215,13 +215,11 @@ addtask printdate before do_build</screen></para>
<para>BitBake allows to install event handlers. Events are triggered at certain points during operation, such as, the beginning of operation against a given .bb, the start of a given task, task failure, task success, et cetera. The intent was to make it easy to do things like email notifications on build failure.</para>
<para><screen>addhandler myclass_eventhandler
python myclass_eventhandler() {
- from bb.event import NotHandled, getName
+ from bb.event import getName
from bb import data
print "The name of the Event is %s" % getName(e)
print "The file we run for is %s" % data.getVar('FILE', e.data, True)
-
- return NotHandled
}
</screen></para><para>
This event handler gets called every time an event is triggered. A global variable <varname>e</varname> is defined. <varname>e</varname>.data contains an instance of bb.data. With the getName(<varname>e</varname>)
diff --git a/lib/bb/event.py b/lib/bb/event.py
index f49f71cf7..c1c6a36c9 100644
--- a/lib/bb/event.py
+++ b/lib/bb/event.py
@@ -23,6 +23,7 @@ BitBake build tools.
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
import os, re, sys
+import warnings
import bb.utils
import pickle
@@ -38,7 +39,7 @@ class Event:
self.pid = worker_pid
NotHandled = 0
-Handled = 1
+Handled = 1
Registered = 10
AlreadyRegistered = 14
@@ -59,7 +60,10 @@ def fire_class_handlers(event, d):
if type(h).__name__ == "code":
locals = {"e": event}
bb.utils.simple_exec(h, locals)
- bb.utils.better_eval("tmpHandler(e)", locals)
+ ret = bb.utils.better_eval("tmpHandler(e)", locals)
+ if ret is not None:
+ warnings.warn("Using Handled/NotHandled in event handlers is deprecated",
+ DeprecationWarning, stacklevel = 2)
else:
h(event)
del event.data