#26622: Improve timezone documentation regarding requirement for pytz
------------------------------------------------+------------------------
Reporter: jarshwah | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
------------------------------------------------+------------------------
While implementing tests for #25774 it was difficult to determine whether
or not pytz had to be installed or not for certain timezone operations to
work.
The documentation at
https://docs.djangoproject.com/en/dev/topics/i18n/timezones/ mentions:
> Installing pytz is highly recommended, but may not be mandatory
depending on your particular database backend, operating system and time
zone. If you encounter an exception querying dates or times, please try
installing it before filing a bug.
I think it'd be a good idea to be more explicit with this recommendation,
potentially providing a matrix of "database, operating system platform,
pytz required?". We can codify this as a database feature so we can make
use of it in tests, and allow 3rd party backends to define their own
requirements for platform and pytz.
Alternatively we can just fully require pytz for timezone support and
error early if it's not installed (on startup?).
Whoever takes this ticket will need to do some experimentation on linux
and windows with all of the core databases to properly determine
requirements. I can help with oracle on linux if needed.
Preliminary investigation by Tim in #25774 seems to show that all
databases require pytz on Windows for the tests in 25774 at least. There
may be some basic timezone operations that do not depend on pytz which
would be nice to account for, but maybe not necessary.
--
Ticket URL: <https://code.djangoproject.com/ticket/26622>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/051.0ff649071affe0b45fb310e9f2b9c7e3%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
