summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRoxane <roxane.bellot@gmail.com>2021-10-02 15:46:04 +0200
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2021-11-17 12:30:19 +0100
commit350d15d79c01d2dd7c6c3196a4a01a5f63b45148 (patch)
tree8aacb92f7a4f9725331d8bc55e733d159355ba40
parentd54aa49a7d15e708b7da1620310167f39e859cba (diff)
downloaddjango-350d15d79c01d2dd7c6c3196a4a01a5f63b45148.tar.gz
[4.0.x] Fixed #33163 -- Added example of connection signal handlers in AppConfig.ready() to docs.
Backport of 2d124f6a1c45afdde8be90c01043e0b14455d41e from main
-rw-r--r--AUTHORS1
-rw-r--r--docs/topics/signals.txt18
2 files changed, 16 insertions, 3 deletions
diff --git a/AUTHORS b/AUTHORS
index 146b0be3a3..00e51d6bc8 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -816,6 +816,7 @@ answer newbie questions, and generally made Django that much better:
Romain Garrigues <romain.garrigues.cs@gmail.com>
Ronny Haryanto <https://ronny.haryan.to/>
Ross Poulton <ross@rossp.org>
+ Roxane Bellot <https://github.com/roxanebellot/>
Rozza <ross.lawley@gmail.com>
Rudolph Froger <rfroger@estrate.nl>
Rudy Mutter
diff --git a/docs/topics/signals.txt b/docs/topics/signals.txt
index f4c6290a14..3e5c09b63a 100644
--- a/docs/topics/signals.txt
+++ b/docs/topics/signals.txt
@@ -136,9 +136,21 @@ Now, our ``my_callback`` function will be called each time a request finishes.
In practice, signal handlers are usually defined in a ``signals``
submodule of the application they relate to. Signal receivers are
connected in the :meth:`~django.apps.AppConfig.ready` method of your
- application configuration class. If you're using the :func:`receiver`
- decorator, import the ``signals`` submodule inside
- :meth:`~django.apps.AppConfig.ready`.
+ application :ref:`configuration class <configuring-applications-ref>`. If
+ you're using the :func:`receiver` decorator, import the ``signals``
+ submodule inside :meth:`~django.apps.AppConfig.ready`, this will implicitly
+ connect signal handlers::
+
+ from django.apps import AppConfig
+
+ class MyAppConfig(AppConfig):
+ ...
+
+ def ready(self):
+ # Implicitly connect a signal handlers decorated with @receiver.
+ from . import signals
+ # Explicitly connect a signal handler.
+ signals.request_finished.connect(signals.my_callback)
.. note::