o ˷e@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__)method source_method source_classK/var/www/ideatree/venv/lib/python3.10/site-packages/google/auth/_helpers.py decorator,s   z!copy_docstring..decoratorr )r rr r rcopy_docstring!s rcCs tjS)z_Returns the current UTC datetime. Returns: datetime: The current time in UTC. )datetimeutcnowr r r rrC rcCst|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 rdatetime_to_secsLs rutf-8cCs8t|tjr ||n|}t|tjr|Std|)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 bytes) isinstancesix text_typeencode binary_typerformat)rencodingresultr r rto_bytesXs r#cCs8t|tjr |dn|}t|tjr|Std|)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 unicode)rrrdecoderrr )rr"r r r from_bytesqs r%cspdurgtj|}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)parts query_params new_query new_partsr r(r update_querys     r;cCs 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.  )joinscopesr r rscopes_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. r<)splitr>r r rstring_to_scopess  rBcCs(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)r b64stringpaddedr r rpadded_urlsafe_b64decodes  rJcCst|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 rC)rFurlsafe_b64encoderstriprr r runpadded_urlsafe_b64encodesrMcCs 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_3rrQ)r)N)rrFrrrOr six.movesr timedeltaREFRESH_THRESHOLDrrrr#r%r;r@rBrJrMrQr r r rs&  "  -