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