Deprecate get_next_timezone_transition()

In preparation of removing the hard dependency on pytz

Refs #716

diff --git a/babel/dates.py b/babel/dates.py
index 01b6580c5b67a56496bb21193c941ddbe4075402..1386316599acc9e0cfa5544f88fa5408829479b1 100644 (file)
--- 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