diff options
| author | Jason Held <jasonsheld@gmail.com> | 2020-06-30 22:54:39 -0400 |
|---|---|---|
| committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2020-07-08 08:23:08 +0200 |
| commit | 703256fc681338bc227768a15c1f56851d05adae (patch) | |
| tree | e2c9c125e61b094dc69e513fbf228447fdd0340b /docs | |
| parent | eae78a363b94640cd17ddd2b3133bf1a790bca72 (diff) | |
[3.1.x] Fixed #24816 -- Clarified docs about preventing duplicate signals.
Backport of 639142e24d41c5e5a508cb1280f32fd7ff159cca from master
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/topics/signals.txt | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/docs/topics/signals.txt b/docs/topics/signals.txt index 30c8299fae..b76a000b34 100644 --- a/docs/topics/signals.txt +++ b/docs/topics/signals.txt @@ -188,7 +188,11 @@ Preventing duplicate signals In some circumstances, the code connecting receivers to signals may run multiple times. This can cause your receiver function to be registered more -than once, and thus called multiple times for a single signal event. +than once, and thus called as many times for a signal event. For example, the +:meth:`~django.apps.AppConfig.ready` method may be executed more than once +during testing. More generally, this occurs everywhere your project imports the +module where you define the signals, because signal registration runs as many +times as it is imported. If this behavior is problematic (such as when using signals to send an email whenever a model is saved), pass a unique identifier as |
