o '@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z gdZ Gddde Z dZeeejejBZdd Zed d d Zd dZGdddejZdddZdS)zCommon utility library.)with_statementN)Errordecode_datetimeget_package_for_module positionalTimeZoneOffset total_secondsc@seZdZdZdS)rz#Base class for protorpc exceptions.N)__name__ __module__ __qualname____doc__r r H/tmp/google-cloud-sdk/lib/third_party/apitools/base/protorpclite/util.pyr(srz # Examples: # +01:00 # -05:30 # Z12:00 ((?PZ) | (?P[-+]) (?P\d\d) : (?P\d\d))$ csXfdd}ttjr|St^}}}}}|dur tdtt|t|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. cstfdd}|S)z9Creates a function wraper to enforce number of arguments.csDt|krd}dkrd}tdj|t|f|i|S)Nsz6%s() takes at most %d positional argument%s (%d given))len TypeErrorr )argskwargsplural_s)max_positional_argswrappedr rpositional_wrappers zDpositional..positional_decorator..positional_wrapper) functoolswraps)rrr)rrpositional_decorators z(positional..positional_decoratorNzDFunctions with no keyword arguments must specify max_positional_args) isinstancesix integer_typesinspectgetfullargspec ValueErrorrr)rrr_defaultsr rrr8s M rrc Cst|tjrztj|}Wn tyYdSwzt|jWStyf|j dkr^z|j }Wn ty9Yn%wt j |}t j |}t|dkrSt|YSd|ddYSt|j YSw)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.)rr string_typessysmodulesKeyError text_typepackageAttributeErrorr __file__ospathbasenamesplitextrjoin)module file_name base_name split_namer r rrs,         rcCs.|jddd|j}|d|j}|dS)z4Backport of offset.total_seconds() from python 2.7+.<i@Bg.A)daysseconds microseconds)offsetr=r>r r rrsrcs0eZdZdZfddZddZddZZS)rz