From 10b3d6eec0d4cf2d76e451c0a0df5152b454e3db Mon Sep 17 00:00:00 2001 From: Aarni Koskela Date: Fri, 8 Apr 2022 16:33:41 +0300 Subject: [PATCH] Deprecate get_next_timezone_transition() In preparation of removing the hard dependency on pytz Refs #716 --- babel/dates.py | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/babel/dates.py b/babel/dates.py index 01b6580c5..138631659 100644 --- a/babel/dates.py +++ b/babel/dates.py @@ -221,11 +221,21 @@ def get_next_timezone_transition(zone=None, dt=None): Transition information can only be provided for timezones returned by the :func:`get_timezone` function. + This function is pending deprecation with no replacement planned in the + Babel library. + :param zone: the timezone for which the transition should be looked up. If not provided the local timezone is used. :param dt: the date after which the next transition should be found. If not given the current time is assumed. """ + warnings.warn( + "get_next_timezone_transition() is deprecated and will be " + "removed in the next version of Babel. " + "Please see https://github.com/python-babel/babel/issues/716 " + "for discussion.", + category=DeprecationWarning, + ) zone = get_timezone(zone) dt = _get_datetime(dt).replace(tzinfo=None) @@ -256,6 +266,9 @@ class TimezoneTransition(object): """A helper object that represents the return value from :func:`get_next_timezone_transition`. + This class is pending deprecation with no replacement planned in the + Babel library. + :field activates: The time of the activation of the timezone transition in UTC. :field from_tzinfo: @@ -268,6 +281,13 @@ class TimezoneTransition(object): """ def __init__(self, activates, from_tzinfo, to_tzinfo, reference_date=None): + warnings.warn( + "TimezoneTransition is deprecated and will be " + "removed in the next version of Babel. " + "Please see https://github.com/python-babel/babel/issues/716 " + "for discussion.", + category=DeprecationWarning, + ) self.activates = activates self.from_tzinfo = from_tzinfo self.to_tzinfo = to_tzinfo