Opened 16 years ago
Closed 16 years ago
#9925 closed (invalid)
Signals documentation + import
Reported by: | miohtama | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.0 |
Severity: | Keywords: | ||
Cc: | Triage Stage: | Unreviewed | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
The signals manual page
http://docs.djangoproject.com/en/dev/topics/signals/#topics-signals
does not mention to which module your custom signal handlers and their connect() methods should put. This is a problem because if the file is not in the explicit import chain, the signal handler is never installed. This may happen e.g. when you the signal handler connect() is called in views.py main body, but view functions are referred by name only in url mapper: the signal handler is not installed until the first view is opened.
Could documentation be updated to have the best practice regarding this?
There is admonition "Where should this code live?" http://docs.djangoproject.com/en/dev/topics/signals/#connecting-receiver-functions