'&SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r /SQr "SS\ 5r Sr\R"\\R \R"-5rSr\"S 5S 5rS r"S S \R,5rSSjrg)zCommon utility library.)with_statementN)Errordecode_datetimeget_package_for_module positionalTimeZoneOffset total_secondsc\rSrSrSrSrg)r(z#Base class for protorpc exceptions.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r 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))$ c^U4Sjn[T[R5(aU$[R"T5tn p4nUc [ S5e[ [U5[U5- 5"T5$)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. cJ>^[R"T5UU4Sj5nU$)z9Creates a function wraper to enforce number of arguments.c >[U5T:a/SnTS:waSn[STRTU[U54-5eT"U0UD6$)Nsz6%s() takes at most %d positional argument%s (%d given))len TypeErrorr )argskwargsplural_smax_positional_argswrappeds rpositional_wrapperDpositional..positional_decorator..positional_wrappersi4y..&!+"H!-070@0@0C08#d)0E!EFFD+F+ +r) functoolswraps)r!r"r s` rpositional_decorator(positional..positional_decorators&  ! , " ,"!rzDFunctions with no keyword arguments must specify max_positional_args) isinstancesix integer_typesinspectgetfullargspec ValueErrorrr)r r&r_defaultss` rrr8swZ "%s'8'899###*#9#9:M#N aq  &' '#d)c(m345HIIrrcz[U[R5(a[RUn[R "UR5$![ a gf=f![a URS:XaURn[RRU5n[RRU5n[U5S:Xa[R "U5s$SR!USS5s$![a Of=f[R "UR5s$f=f)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% A"!A"%D: D A#D:1D: DD:D#D:9D:ctURS-S-S-UR-nUS-UR-nUS- $)z4Backport of offset.total_seconds() from python 2.7+.<i@Bg.A)daysseconds microseconds)offsetrIrJs rr r sBkkB#b(6>>9GU?V%8%88L ; ''rc8^\rSrSrSrU4SjrSrSrSrU=r $)rz