Opened 13 years ago
Last modified 8 years ago
#18394 closed Cleanup/optimization
Better docs, and possibly better handling, for 'packages' argument to javascript_catalog — at Version 2
| Reported by: | James Bennett | Owned by: | nobody |
|---|---|---|---|
| Component: | Internationalization | Version: | dev |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Ready for checkin | |
| Has patch: | yes | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | no | UI/UX: | no |
Description (last modified by )
The javascript_catalog i18n view's packages argument only accepts modules which are either django.conf or which are also in INSTALLED_APPS. But there are two issues with this:
- The documentation for the view hides this a bit, and can create the impression that the restriction only applies to a
packagesargument passed through the URL.
- The view itself does not give you any warning if you're violating this restriction; it just silently discards anything in
packagesthat doesn't meet the requirements.
At the very least, the documentation should be more up-front that this requirement always applies no matter how you're passing packages to the view. Possibly as a bonus, the view should warn that it's discarding any packages that don't conform to the requirements, to aid in debugging.
Change History (2)
comment:1 by , 13 years ago
| Component: | Documentation → Internationalization |
|---|---|
| Triage Stage: | Unreviewed → Accepted |
comment:2 by , 9 years ago
| Cc: | added |
|---|---|
| Description: | modified (diff) |
Claude, I know made some improvements when you created the new JavaScriptCatalog class-based view in 1.10. Is this ticket still relevant for that view?
Two problems are reported in this ticket:
(a) the documentation of javascript_catalog is confusing
(b) invalid package names are silently dropped: yes, silent failure is bad and we should do something. Raising an exception would be backwards incompatible. Raising a warning could be a good compromise.
I've created #18596 to track (a). Let's focus this ticket on (b).