Changes between Version 24 and Version 25 of Signals

Timestamp:

Aug 8, 2008, 7:52:24 AM (16 years ago)

Author:

Henrik Vendelbo

Comment:

--

Signals

@@ -210 +210 @@
  * `context` -- the `Context` with which the template was rendered.
 
+== Refactoring differences ==
+
+[8223] refactored signals and {{{django.dispatch}}} with an eye towards speed. The net result was up to a 90% improvement in the speed of signal handling, but along the way some backwards-incompatible changes were made:
+
+ * All handlers now must be declared as accepting {{{**kwargs}}}.
+ * Signals are now instances of {{{django.dispatch.Signal}}} instead of anonymous objects.
+ * Connecting, disconnecting, and sending signals are done via methods on the {{{Signal}}} object instead of through module methods in {{{django.dispatch.dispatcher}}}. The module-level methods are deprecated.
+ * The {{{Anonymous}}} and {{{Any}}} sender options no longer exist. You can still receive signals sent by any sender by using {{{sender=None}}}
+ 
+So, a quick summary of the code changes you'd need to make:
+
+|| '''Before''' || '''After'''  ||
+|| {{{def my_handler(sender)}}} || {{{def my_handler(sender, **kwargs)}}} ||
+|| {{{my_signal = object()}}} || {{{my_signal = django.dispatch.Signal()}}} ||    
+|| {{{dispatcher.connect(my_handler, my_signal)}}} || {{{my_signal.connect(my_handler)}}} ||
+|| {{{dispatcher.send(my_signal, sender)}}} || {{{my_signal.send(sender)}}} ||
+|| {{{dispatcher.connect(my_handler, my_signal, sender=Any)}}} || {{{my_signal.connect(my_handler, sender=None)}}} ||
+
 == Other documentation ==
 
@@ -223 +241 @@
  * [http://satchmoproject.com/ Satchmo]
  * [http://getbanjo.com/ Banjo]
+ * [http://code.google.com/p/django-announcements/ Django Announcements]
+ * [http://code.google.com/p/django-evolution/ Django Evolution]