Index: third_party/oauth2client/util.py |
diff --git a/third_party/oauth2client/util.py b/third_party/oauth2client/util.py |
index b0963ef520d836a03fb8340613afe5f015925f66..90dff155bcfb90d3125c167b11c5773a3b876a54 100644 |
--- a/third_party/oauth2client/util.py |
+++ b/third_party/oauth2client/util.py |
@@ -1,6 +1,6 @@ |
#!/usr/bin/env python |
# |
-# Copyright 2014 Google Inc. All rights reserved. |
+# Copyright 2010 Google Inc. |
# |
# Licensed under the Apache License, Version 2.0 (the "License"); |
# you may not use this file except in compliance with the License. |
@@ -17,27 +17,26 @@ |
"""Common utility library.""" |
-__author__ = [ |
- 'rafek@google.com (Rafe Kaplan)', |
- 'guido@google.com (Guido van Rossum)', |
+__author__ = ['rafek@google.com (Rafe Kaplan)', |
+ 'guido@google.com (Guido van Rossum)', |
+] |
+__all__ = [ |
+ 'positional', |
+ 'POSITIONAL_WARNING', |
+ 'POSITIONAL_EXCEPTION', |
+ 'POSITIONAL_IGNORE', |
] |
-__all__ = [ |
- 'positional', |
- 'POSITIONAL_WARNING', |
- 'POSITIONAL_EXCEPTION', |
- 'POSITIONAL_IGNORE', |
-] |
- |
-import functools |
import inspect |
import logging |
-import sys |
import types |
+import urllib |
+import urlparse |
-from third_party import six |
-from third_party.six.moves import urllib |
- |
+try: |
+ from urlparse import parse_qsl |
+except ImportError: |
+ from cgi import parse_qsl |
logger = logging.getLogger(__name__) |
@@ -52,58 +51,56 @@ |
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:: |
+ This decorator makes it easy to support Python 3 style key-word 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:: |
+ All named parameters after * must be a keyword: |
fn(10, 'kw1', 'kw2') # Raises exception. |
fn(10, kwonly1='kw1') # Ok. |
- Example |
- ^^^^^^^ |
+ Example: |
+ To define a function like above, do: |
- 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): |
+ @positional(1) |
+ def fn(pos1, kwonly1=None, kwonly2=None): |
... |
- @classmethod |
- @positional(2) |
- def my_method(cls, pos1, kwonly1=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. |
+ 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 |
@@ -117,10 +114,8 @@ |
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 = '' |
@@ -137,7 +132,7 @@ |
return wrapped(*args, **kwargs) |
return positional_wrapper |
- if isinstance(max_positional_args, six.integer_types): |
+ if isinstance(max_positional_args, (int, long)): |
return positional_decorator |
else: |
args, _, _, defaults = inspect.getargspec(max_positional_args) |
@@ -157,7 +152,7 @@ |
Returns: |
The scopes formatted as a single string. |
""" |
- if isinstance(scopes, six.string_types): |
+ if isinstance(scopes, types.StringTypes): |
return scopes |
else: |
return ' '.join(scopes) |
@@ -194,8 +189,8 @@ |
if value is None: |
return url |
else: |
- parsed = list(urllib.parse.urlparse(url)) |
- q = dict(urllib.parse.parse_qsl(parsed[4])) |
+ parsed = list(urlparse.urlparse(url)) |
+ q = dict(parse_qsl(parsed[4])) |
q[name] = value |
- parsed[4] = urllib.parse.urlencode(q) |
- return urllib.parse.urlunparse(parsed) |
+ parsed[4] = urllib.urlencode(q) |
+ return urlparse.urlunparse(parsed) |