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