Skip to content

Commit

Permalink
Fixed #33163 -- Added example of connection signal handlers in AppCon…
Browse files Browse the repository at this point in the history
…fig.ready() to docs.
  • Loading branch information
roxanebellot authored and felixxm committed Nov 17, 2021
1 parent bb223c6 commit 2d124f6
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 3 deletions.
1 change: 1 addition & 0 deletions AUTHORS
Expand Up @@ -819,6 +819,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
Expand Down
18 changes: 15 additions & 3 deletions docs/topics/signals.txt
Expand Up @@ -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::

Expand Down

0 comments on commit 2d124f6

Please sign in to comment.