| Index: tools/telemetry/third_party/gsutilz/third_party/oauth2client/oauth2client/util.py
|
| diff --git a/tools/telemetry/third_party/gsutilz/third_party/oauth2client/oauth2client/util.py b/tools/telemetry/third_party/gsutilz/third_party/oauth2client/oauth2client/util.py
|
| deleted file mode 100755
|
| index a706f0261fbe6636666a392d01c9429fc7637b34..0000000000000000000000000000000000000000
|
| --- a/tools/telemetry/third_party/gsutilz/third_party/oauth2client/oauth2client/util.py
|
| +++ /dev/null
|
| @@ -1,201 +0,0 @@
|
| -#!/usr/bin/env python
|
| -#
|
| -# Copyright 2014 Google Inc. All rights reserved.
|
| -#
|
| -# Licensed under the Apache License, Version 2.0 (the "License");
|
| -# you may not use this file except in compliance with the License.
|
| -# You may obtain a copy of the License at
|
| -#
|
| -# http://www.apache.org/licenses/LICENSE-2.0
|
| -#
|
| -# Unless required by applicable law or agreed to in writing, software
|
| -# distributed under the License is distributed on an "AS IS" BASIS,
|
| -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| -# See the License for the specific language governing permissions and
|
| -# limitations under the License.
|
| -#
|
| -
|
| -"""Common utility library."""
|
| -
|
| -__author__ = [
|
| - 'rafek@google.com (Rafe Kaplan)',
|
| - 'guido@google.com (Guido van Rossum)',
|
| -]
|
| -
|
| -__all__ = [
|
| - 'positional',
|
| - 'POSITIONAL_WARNING',
|
| - 'POSITIONAL_EXCEPTION',
|
| - 'POSITIONAL_IGNORE',
|
| -]
|
| -
|
| -import functools
|
| -import inspect
|
| -import logging
|
| -import sys
|
| -import types
|
| -
|
| -import six
|
| -from six.moves import urllib
|
| -
|
| -
|
| -logger = logging.getLogger(__name__)
|
| -
|
| -POSITIONAL_WARNING = 'WARNING'
|
| -POSITIONAL_EXCEPTION = 'EXCEPTION'
|
| -POSITIONAL_IGNORE = 'IGNORE'
|
| -POSITIONAL_SET = frozenset([POSITIONAL_WARNING, POSITIONAL_EXCEPTION,
|
| - POSITIONAL_IGNORE])
|
| -
|
| -positional_parameters_enforcement = POSITIONAL_WARNING
|
| -
|
| -def positional(max_positional_args):
|
| - """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
|
| - ``util.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 util.positional_parameters_enforcement is set to
|
| - POSITIONAL_EXCEPTION.
|
| -
|
| - """
|
| - def positional_decorator(wrapped):
|
| - @functools.wraps(wrapped)
|
| - def positional_wrapper(*args, **kwargs):
|
| - if len(args) > max_positional_args:
|
| - plural_s = ''
|
| - if max_positional_args != 1:
|
| - plural_s = 's'
|
| - message = '%s() takes at most %d positional argument%s (%d given)' % (
|
| - wrapped.__name__, max_positional_args, plural_s, len(args))
|
| - if positional_parameters_enforcement == POSITIONAL_EXCEPTION:
|
| - raise TypeError(message)
|
| - elif positional_parameters_enforcement == POSITIONAL_WARNING:
|
| - logger.warning(message)
|
| - else: # IGNORE
|
| - pass
|
| - return wrapped(*args, **kwargs)
|
| - return positional_wrapper
|
| -
|
| - if isinstance(max_positional_args, six.integer_types):
|
| - return positional_decorator
|
| - else:
|
| - args, _, _, defaults = inspect.getargspec(max_positional_args)
|
| - return positional(len(args) - len(defaults))(max_positional_args)
|
| -
|
| -
|
| -def scopes_to_string(scopes):
|
| - """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.
|
| - """
|
| - if isinstance(scopes, six.string_types):
|
| - return scopes
|
| - else:
|
| - return ' '.join(scopes)
|
| -
|
| -
|
| -def dict_to_tuple_key(dictionary):
|
| - """Converts a dictionary to a tuple that can be used as an immutable key.
|
| -
|
| - The resulting key is always sorted so that logically equivalent dictionaries
|
| - always produce an identical tuple for a key.
|
| -
|
| - Args:
|
| - dictionary: the dictionary to use as the key.
|
| -
|
| - Returns:
|
| - A tuple representing the dictionary in it's naturally sorted ordering.
|
| - """
|
| - return tuple(sorted(dictionary.items()))
|
| -
|
| -
|
| -def _add_query_parameter(url, name, value):
|
| - """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.
|
| - """
|
| - if value is None:
|
| - return url
|
| - else:
|
| - parsed = list(urllib.parse.urlparse(url))
|
| - q = dict(urllib.parse.parse_qsl(parsed[4]))
|
| - q[name] = value
|
| - parsed[4] = urllib.parse.urlencode(q)
|
| - return urllib.parse.urlunparse(parsed)
|
|
|