a w=ic@sdZddlZddlZddlZddlZddlZddlmZejddZ ddZ dd Z d d Z dd dZ ddZdddZddZddZddZddZddZdS)z-Helper functions for commonly used utilities.N)urllib)secondscsfdd}|S)a0Decorator that copies a method's docstring from another class. Args: source_class (type): The class that has the documented method. Returns: Callable: A decorator that will copy the docstring of the same named method in the source class to the decorated method. cs&|jrtdt|j}|j|_|S)a"Decorator implementation. Args: method (Callable): The method to copy the docstring to. Returns: Callable: the same method passed in with an updated docstring. Raises: ValueError: if the method already has a docstring. zMethod already has a docstring.)__doc__ ValueErrorgetattr__name__)methodZ source_method source_classe/home/droni/.local/share/virtualenvs/DPS-5Je3_V2c/lib/python3.9/site-packages/google/auth/_helpers.py decorator,s  z!copy_docstring..decoratorr )r rr r r copy_docstring!s rcCs tjS)z_Returns the current UTC datetime. Returns: datetime: The current time in UTC. )datetimeutcnowr r r r rCsrcCst|S)zConvert a datetime object to the number of seconds since the UNIX epoch. Args: value (datetime): The datetime to convert. Returns: int: The number of seconds since the UNIX epoch. )calendartimegm utctimetuplevaluer r r datetime_to_secsLs rutf-8cCs<t|tjr||n|}t|tjr*|Std|dS)a@Converts a string value to bytes, if necessary. Unfortunately, ``six.b`` is insufficient for this task since in Python 2 because it does not modify ``unicode`` objects. Args: value (Union[str, bytes]): The value to be converted. encoding (str): The encoding to use to convert unicode to bytes. Defaults to "utf-8". Returns: bytes: 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. z%{0!r} could not be converted to bytesN) isinstancesix text_typeencode binary_typerformat)rencodingresultr r r to_bytesXs r!cCs<t|tjr|dn|}t|tjr*|Std|dS)aVConverts bytes to a string value, if necessary. Args: value (Union[str, bytes]): The value to be converted. Returns: str: 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. rz'{0!r} could not be converted to unicodeN)rrrdecoderrr)rr r r r from_bytesqs  r#cspdur gtj|}tj|j}||fddt|D}tjj|dd}|j |d}tj |S)aUpdates a URL's query parameters. Replaces any current values if they are already present in the URL. Args: url (str): The URL to update. params (Mapping[str, str]): A mapping of query parameter keys to values. remove (Sequence[str]): Parameters to remove from the query string. Returns: str: The URL with updated query parameters. Examples: >>> url = 'http://example.com?a=1' >>> update_query(url, {'a': '2'}) http://example.com?a=2 >>> update_query(url, {'b': '3'}) http://example.com?a=1&b=3 >> update_query(url, {'b': '3'}, remove=['a']) http://example.com?b=3 Ncsi|]\}}|vr||qSr r ).0keyrremover r sz update_query..T)doseq)query) rparseurlparseparse_qsr*updater iteritems urlencode_replace urlunparse)urlparamsr'partsZ query_paramsZ new_queryZ new_partsr r&r update_querys    r6cCs d|S)zConverts scope value to a string suitable for sending to OAuth 2.0 authorization servers. Args: scopes (Sequence[str]): The sequence of scopes to convert. Returns: str: The scopes formatted as a single string.  )joinZscopesr r r scopes_to_strings r:cCs|sgS|dS)zConverts stringifed scopes value to a list. Args: scopes (Union[Sequence, str]): The string of space-separated scopes to convert. Returns: Sequence(str): The separated scopes. r7)splitr9r r r string_to_scopess r<cCs(t|}|dt| d}t|S)zDecodes base64 strings lacking padding characters. Google infrastructure tends to omit the base64 padding characters. Args: value (Union[str, bytes]): The encoded value. Returns: bytes: The decoded value =)r!lenbase64urlsafe_b64decode)rZ b64stringpaddedr r r padded_urlsafe_b64decodes rCcCst|dS)auEncodes base64 strings removing any padding characters. `rfc 7515`_ defines Base64url to NOT include any padding characters, but the stdlib doesn't do that by default. _rfc7515: https://tools.ietf.org/html/rfc7515#page-6 Args: value (Union[str|bytes]): The bytes-like value to encode Returns: Union[str|bytes]: The encoded value r=)r@urlsafe_b64encoderstriprr r r unpadded_urlsafe_b64encodesrFcCs tjdkS)zCheck if the Python interpreter is Python 2 or 3. Returns: bool: True if the Python interpreter is Python 3 and False otherwise. )r)sys version_infor r r r is_python_3srJ)r)N)rr@rrrHrZ six.movesr timedeltaZREFRESH_THRESHOLDrrrr!r#r6r:r<rCrFrJr r r r s$  "   -