'$dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z gdZ Gdde Z dZejeej ej"zZdZed d Zd ZGd d ej,ZddZy)zCommon utility library.)with_statementN)Errordecode_datetimeget_package_for_module positionalTimeZoneOffset total_secondsceZdZdZy)rz#Base class for protorpc exceptions.N)__name__ __module__ __qualname____doc__2lib/third_party/apitools/base/protorpclite/util.pyrr(s-rrz # Examples: # +01:00 # -05:30 # Z12:00 ((?PZ) | (?P[-+]) (?P\d\d) : (?P\d\d))$ cfd}ttjr|Stj^}}}}}| t dt t|t|z S)a A decorator that declares only the first N arguments may be positional. This decorator makes it easy to support Python 3 style keyword-only parameters. For example, in Python 3 it is possible to write: def fn(pos1, *, kwonly1=None, kwonly1=None): ... All named parameters after * must be a keyword: fn(10, 'kw1', 'kw2') # Raises exception. fn(10, kwonly1='kw1') # Ok. Example: To define a function like above, do: @positional(1) def fn(pos1, kwonly1=None, kwonly2=None): ... If no default value is provided to a keyword argument, it becomes a required keyword argument: @positional(0) def fn(required_kw): ... This must be called with the keyword parameter: fn() # Raises exception. fn(10) # Raises exception. fn(required_kw=10) # Ok. When defining instance or class methods always remember to account for 'self' and 'cls': class MyClass(object): @positional(2) def my_method(self, pos1, kwonly1=None): ... @classmethod @positional(2) def my_method(cls, pos1, kwonly1=None): ... One can omit the argument to 'positional' altogether, and then no arguments with default values may be passed positionally. This would be equivalent to placing a '*' before the first argument with a default value in Python 3. If there are no arguments with default values, and no argument is given to 'positional', an error is raised. @positional def fn(arg1, arg2, required_kw1=None, required_kw2=0): ... fn(1, 3, 5) # Raises exception. fn(1, 3) # Ok. fn(1, 3, required_kw1=5) # Ok. Args: max_positional_arguments: Maximum number of positional arguments. All parameters after the this index must be keyword only. Returns: A decorator that prevents using arguments after max_positional_args from being used as positional parameters. Raises: TypeError if a keyword-only argument is provided as a positional parameter. ValueError if no maximum number of arguments is provided and the function has no arguments with default values. cFtjfd}|S)z9Creates a function wraper to enforce number of arguments.c t|kDr.d}dk7rd}tdj|t|fz|i|S)Nsz6%s() takes at most %d positional argument%s (%d given))len TypeErrorr )argskwargsplural_smax_positional_argswrappeds rpositional_wrapperzDpositional..positional_decorator..positional_wrappersi4y..&!+"H!-070@0@0C08#d)0E!EFFD+F+ +r) functoolswraps)rrrs` rpositional_decoratorz(positional..positional_decorators&  ! , " ,"!rzDFunctions with no keyword arguments must specify max_positional_args) isinstancesix integer_typesinspectgetfullargspec ValueErrorrr)rr"r_defaultss` rrr8sxZ "%s'8'89###*#9#9:M#N aHq  &' '5z#d)c(m345HIIrrc`t|tjr tj|} tj |jS#t $rYywxYw#t$r|jdk(r |j}tjj|}tjj|}t|dk(rtj |cYSdj!|ddcYS#t$rYnwxYwtj |jcYSwxYw)aGet package name for a module. Helper calculates the package name of a module. Args: module: Module to get name for. If module is a string, try to find module in sys.modules. Returns: If module contains 'package' attribute, uses that as package name. Else, if module is not the '__main__' module, the module __name__. Else, the base name of the module file name. Else None. N__main__r.)r#r$ string_typessysmodulesKeyError text_typepackageAttributeErrorr __file__ospathbasenamesplitextrjoin)module file_name base_name split_names rrrs&#**+ [[(F.}}V^^,,     . ??j ( 2"OO GG,,Y7 WW--i8 z?a'==33yyCR11"  }}V__-- .sMAA AAD-7 C<A!D-&D-< DD-D"D-,D-ct|jdzdzdz|jz}|dz|jz}|dz S)z4Backport of offset.total_seconds() from python 2.7+.<i@Bg.A)daysseconds microseconds)offsetrDrEs rr r sBkkB#b(6>>9GU?V%8%88L ; ''rc.eZdZdZfdZdZdZxZS)rz