1# -*- coding: utf-8 -*-
2from ._parser import parse, parser, parserinfo
3from ._parser import DEFAULTPARSER, DEFAULTTZPARSER
4from ._parser import UnknownTimezoneWarning
5
6from ._parser import __doc__
7
8from .isoparser import isoparser, isoparse
9
10__all__ = ['parse', 'parser', 'parserinfo',
11           'isoparse', 'isoparser',
12           'UnknownTimezoneWarning']
13
14
15###
16# Deprecate portions of the private interface so that downstream code that
17# is improperly relying on it is given *some* notice.
18
19
20def __deprecated_private_func(f):
21    from functools import wraps
22    import warnings
23
24    msg = ('{name} is a private function and may break without warning, '
25           'it will be moved and or renamed in future versions.')
26    msg = msg.format(name=f.__name__)
27
28    @wraps(f)
29    def deprecated_func(*args, **kwargs):
30        warnings.warn(msg, DeprecationWarning)
31        return f(*args, **kwargs)
32
33    return deprecated_func
34
35def __deprecate_private_class(c):
36    import warnings
37
38    msg = ('{name} is a private class and may break without warning, '
39           'it will be moved and or renamed in future versions.')
40    msg = msg.format(name=c.__name__)
41
42    class private_class(c):
43        __doc__ = c.__doc__
44
45        def __init__(self, *args, **kwargs):
46            warnings.warn(msg, DeprecationWarning)
47            super(private_class, self).__init__(*args, **kwargs)
48
49    private_class.__name__ = c.__name__
50
51    return private_class
52
53
54from ._parser import _timelex, _resultbase
55from ._parser import _tzparser, _parsetz
56
57_timelex = __deprecate_private_class(_timelex)
58_tzparser = __deprecate_private_class(_tzparser)
59_resultbase = __deprecate_private_class(_resultbase)
60_parsetz = __deprecated_private_func(_parsetz)
61