ó ‚¾^Yc@s@dZddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ej e ƒZ dZdZdZeeeegƒZeZdZdZd Zd „Zd „Zd „Zd „Zd„Zd„Zd„Zd„Zd„Zdd„Z d„Z!d„Z"d„Z#dS(s-Helper functions for commonly used utilities.iÿÿÿÿN(turllibtWARNINGt EXCEPTIONtIGNOREsFile: {0}: Is a symbolic link.s{0}: Is a directorys,Cannot access {0}: No such file or directorycsd‡fd†}tˆtjƒr%|Stjˆƒ\}}}}tt|ƒt|ƒƒˆƒSdS(sŽA decorator to declare that only the first N arguments my 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): ... The positional decorator behavior is controlled by ``_helpers.positional_parameters_enforcement``, which may be set to ``POSITIONAL_EXCEPTION``, ``POSITIONAL_WARNING`` or ``POSITIONAL_IGNORE`` to raise an exception, log a warning, or do nothing, respectively, if a declaration is violated. 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 key-word only argument is provided as a positional parameter, but only if _helpers.positional_parameters_enforcement is set to POSITIONAL_EXCEPTION. cs%tjˆƒ‡‡fd†ƒ}|S(Nc s¡t|ƒˆkr”d}ˆdkr-d}ndjdˆjdˆdt|ƒd|ƒ}ttkrut|ƒ‚q”ttkr”tj|ƒq”nˆ||ŽS( NtitssV{function}() takes at most {args_max} positional argument{plural} ({args_given} given)tfunctiontargs_maxt args_giventplural( tlentformatt__name__t!positional_parameters_enforcementtPOSITIONAL_EXCEPTIONt TypeErrortPOSITIONAL_WARNINGtloggertwarning(targstkwargstplural_stmessage(tmax_positional_argstwrapped(s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pytpositional_wrapperus        (t functoolstwraps(RR(R(Rs;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pytpositional_decoratorts!N(t isinstancetsixt integer_typestinspectt getargspect positionalR (RRRt_tdefaults((Rs;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyR",s HcCs't|tjƒr|Sdj|ƒSdS(s_Converts scope value to a string. If scopes is a string then it is simply passed through. If scopes is an iterable then a string is returned that is all the individual scopes concatenated with spaces. Args: scopes: string or iterable of strings, the scopes. Returns: The scopes formatted as a single string. t N(RRt string_typestjoin(tscopes((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pytscopes_to_strings cCs1|s gSt|tjƒr)|jdƒS|SdS(s+Converts stringifed scope value to a list. If scopes is a list then it is simply passed through. If scopes is an string then a list of each individual scope is returned. Args: scopes: a string or iterable of strings, the scopes. Returns: The scopes in a list. R%N(RRR&tsplit(R(((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pytstring_to_scopes¢s  cCs„tjj|ƒ}i}xetj|ƒD]T\}}t|ƒdkrnd|dj|ƒf}t|ƒ‚n|d|| %ss, i(Rtparsetparse_qsRt iteritemsR R't ValueError(tcontentturlencoded_paramstparamstkeytvaluetmsg((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pytparse_unique_urlencoded¶s cCsbtjj|ƒ}t|jƒ}|j|ƒtjj|ƒ}|jd|ƒ}tjj|ƒS(sUpdates a URI with new query parameters. If a given key from ``params`` is repeated in the ``uri``, then the URI will be considered invalid and an error will occur. If the URI is valid, then each value from ``params`` will replace the corresponding value in the query parameters (if it exists). Args: uri: string, A valid URI, with potential existing query parameters. params: dict, A dictionary of query parameters. Returns: The same URI but with the new query parameters added. tquery( RR,turlparseR6R7tupdatet urlencodet_replacet urlunparse(turiR2tpartst query_paramst new_queryt new_parts((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pytupdate_query_paramsÍs  cCs(|dkr|St|i||6ƒSdS(s\Adds a query parameter to a url. Replaces the current value if it already exists in the URL. Args: url: string, url to add the query parameter to. name: string, query parameter name. value: string, query parameter value. Returns: Updated query parameter. Does not update the url if value is None. N(tNoneRB(turltnameR4((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt_add_query_parameteræs cCsƒtjj|ƒr*ttj|ƒƒ‚nUtjj|ƒrTttj|ƒƒ‚n+tjj|ƒst j t j|ƒƒndS(N( tostpathtislinktIOErrort_SYM_LINK_MESSAGER tisdirt_IS_DIR_MESSAGEtisfiletwarningstwarnt_MISSING_FILE_MESSAGE(tfilename((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt validate_fileùs cCs'|jdƒ}|dkr#||SdS(szIdentify and extract PEM keys. Determines whether the given key is in the format of PEM key, and extracts the relevant part of the key if it is. Args: raw_key_input: The contents of a private key file (either PEM or PKCS12). Returns: string, The actual key if the contents are from a PEM file, or else None. s -----BEGIN iÿÿÿÿN(tfind(t raw_key_inputtoffset((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt_parse_pem_keys cCstj|ddƒS(Nt separatorst,t:(RYRZ(tjsontdumps(tdata((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt _json_encodestasciicCsVt|tjƒr!|j|ƒn|}t|tjƒr=|Stdj|ƒƒ‚dS(s4Converts a string value to bytes, if necessary. Unfortunately, ``six.b`` is insufficient for this task since in Python2 it does not modify ``unicode`` objects. Args: value: The string/bytes value to be converted. encoding: The encoding to use to convert unicode to bytes. Defaults to "ascii", which will not allow any characters from ordinals larger than 127. Other useful values are "latin-1", which which will only allows byte ordinals (up to 255) and "utf-8", which will encode any unicode that needs to be. Returns: The original value converted to bytes (if unicode) or as passed in if it started out as bytes. Raises: ValueError if the value could not be converted to bytes. s%{0!r} could not be converted to bytesN(RRt text_typetencodet binary_typeR/R (R4tencodingtresult((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt _to_bytess'cCsVt|tjƒr!|jdƒn|}t|tjƒr=|Stdj|ƒƒ‚dS(sEConverts bytes to a string value, if necessary. Args: value: The string/bytes value to be converted. Returns: The original value converted to unicode (if bytes) or as passed in if it started out as unicode. Raises: ValueError if the value could not be converted to unicode. sutf-8s'{0!r} could not be converted to unicodeN(RRRbtdecodeR`R/R (R4Rd((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt _from_bytes6s 'cCs(t|ddƒ}tj|ƒjdƒS(NRcsutf-8t=(Retbase64turlsafe_b64encodetrstrip(t raw_bytes((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt_urlsafe_b64encodeLscCs5t|ƒ}|ddt|ƒd}tj|ƒS(NRhi(ReR Riturlsafe_b64decode(t b64stringtpadded((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyt_urlsafe_b64decodeQs ($t__doc__RiRR R[tloggingRGRORt six.movesRt getLoggerR RRRtPOSITIONAL_IGNOREt frozensettPOSITIONAL_SETR RKRMRQR"R)R+R6RBRFRSRWR^ReRgRmRq(((s;/tmp/pip-build-kpPAdC/oauth2client/oauth2client/_helpers.pyts@           c