innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Fixed #22029 -- Removed obsolete advice on registering migrate/syncdb signal handlers. 

All signals should now be registered in AppConfig.ready().

Thanks un33k for the report.
This commit is contained in:
Tim Graham 2014-03-26 10:39:52 -04:00
parent 45ef4baf5c
commit 5233b36693
1 changed files with 6 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
docs/ref/signals.txt
View File

@ -376,11 +376,6 @@ pre_migrate
Sent by the :djadmin:`migrate` command before it starts to install an Sent by the :djadmin:`migrate` command before it starts to install an
application. It's not emitted for applications that lack a ``models`` module. application. It's not emitted for applications that lack a ``models`` module.
Any handlers that listen to this signal need to be written in a particular
place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If
handlers are registered anywhere else they may not be loaded by
:djadmin:`migrate`.
Arguments sent with this signal: Arguments sent with this signal:
``sender`` ``sender``
@ -421,11 +416,6 @@ pre_syncdb
Sent by the :djadmin:`syncdb` command before it starts to install an Sent by the :djadmin:`syncdb` command before it starts to install an
application. application.
Any handlers that listen to this signal need to be written in a particular
place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If
handlers are registered anywhere else they may not be loaded by
:djadmin:`syncdb`.
Arguments sent with this signal: Arguments sent with this signal:
``sender`` ``sender``
@ -469,13 +459,9 @@ Sent by the :djadmin:`migrate` command after it installs an application, and the
:djadmin:`flush` command. It's not emitted for applications that lack a :djadmin:`flush` command. It's not emitted for applications that lack a
``models`` module. ``models`` module.
Any handlers that listen to this signal need to be written in a particular It is important that handlers of this signal perform idempotent changes (e.g.
place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If no database alterations) as this may cause the :djadmin:`flush` management
handlers are registered anywhere else they may not be loaded by command to fail if it also ran during the :djadmin:`migrate` command.
:djadmin:`migrate`. It is important that handlers of this signal perform
idempotent changes (e.g. no database alterations) as this may cause the
:djadmin:`flush` management command to fail if it also ran during the
:djadmin:`migrate` command.
Arguments sent with this signal: Arguments sent with this signal:
@ -529,13 +515,9 @@ post_syncdb
Sent by the :djadmin:`syncdb` command after it installs an application, and the Sent by the :djadmin:`syncdb` command after it installs an application, and the
:djadmin:`flush` command. :djadmin:`flush` command.
Any handlers that listen to this signal need to be written in a particular It is important that handlers of this signal perform idempotent changes (e.g.
place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If no database alterations) as this may cause the :djadmin:`flush` management
handlers are registered anywhere else they may not be loaded by command to fail if it also ran during the :djadmin:`syncdb` command.
:djadmin:`syncdb`. It is important that handlers of this signal perform
idempotent changes (e.g. no database alterations) as this may cause the
:djadmin:`flush` management command to fail if it also ran during the
:djadmin:`syncdb` command.
Arguments sent with this signal: Arguments sent with this signal: