freebsd-ports/devel/py-pytz-deprecation-shim/pkg-descr
Po-Chuan Hsieh 4a78f88950
devel/py-pytz-deprecation-shim: Add py-pytz-deprecation-shim 0.1.0.post0
pytz has served the Python community well for many years, but it is no longer
the best option for providing time zones. pytz has a non-standard interface that
is very easy to misuse; this interface was necessary when pytz was created,
because datetime had no way to represent ambiguous datetimes, but this was
solved in Python 3.6, which added a fold attribute to datetimes in PEP 495. With
the addition of the zoneinfo module in Python 3.9 (PEP 615), there has never
been a better time to migrate away from pytz.

However, since pytz time zones are used very differently from a standard tzinfo,
and many libraries have built pytz zones into their standard time zone interface
(and thus may have users relying on the existence of the localize and normalize
methods); this library provides shim classes that are compatible with both PEP
495 and pytz's interface, to make it easier for libraries to deprecate pytz.

WWW: https://github.com/pganssle/pytz-deprecation-shim
2022-04-16 12:19:03 +08:00

15 lines
969 B
Text

pytz has served the Python community well for many years, but it is no longer
the best option for providing time zones. pytz has a non-standard interface that
is very easy to misuse; this interface was necessary when pytz was created,
because datetime had no way to represent ambiguous datetimes, but this was
solved in Python 3.6, which added a fold attribute to datetimes in PEP 495. With
the addition of the zoneinfo module in Python 3.9 (PEP 615), there has never
been a better time to migrate away from pytz.
However, since pytz time zones are used very differently from a standard tzinfo,
and many libraries have built pytz zones into their standard time zone interface
(and thus may have users relying on the existence of the localize and normalize
methods); this library provides shim classes that are compatible with both PEP
495 and pytz's interface, to make it easier for libraries to deprecate pytz.
WWW: https://github.com/pganssle/pytz-deprecation-shim