[catapult] - Copy Telemetry's gsutilz over to third_party.

third_party/gsutil/gslib/tests/test_util.py

Index: third_party/gsutil/gslib/tests/test_util.py
diff --git a/third_party/gsutil/gslib/tests/test_util.py b/third_party/gsutil/gslib/tests/test_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..0561dd9d47357c77cdbe129f0c389e36392078ba
--- /dev/null
+++ b/third_party/gsutil/gslib/tests/test_util.py
@@ -0,0 +1,211 @@
+# -*- coding: utf-8 -*-
+# Copyright 2013 Google Inc. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish, dis-
+# tribute, sublicense, and/or sell copies of the Software, and to permit
+# persons to whom the Software is furnished to do so, subject to the fol-
+# lowing conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
+# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+# IN THE SOFTWARE.
+"""Tests for gsutil utility functions."""
+
+from __future__ import absolute_import
+
+import httplib2
+from gslib import util
+import gslib.tests.testcase as testcase
+from gslib.tests.util import SetEnvironmentForTest
+from gslib.util import CompareVersions
+
+
+class TestUtil(testcase.GsUtilUnitTestCase):
+  """Tests for utility functions."""
+
+  def test_MakeHumanReadable(self):
+    """Tests converting byte counts to human-readable strings."""
+    self.assertEqual(util.MakeHumanReadable(0), '0 B')
+    self.assertEqual(util.MakeHumanReadable(1023), '1023 B')
+    self.assertEqual(util.MakeHumanReadable(1024), '1 KiB')
+    self.assertEqual(util.MakeHumanReadable(1024 ** 2), '1 MiB')
+    self.assertEqual(util.MakeHumanReadable(1024 ** 3), '1 GiB')
+    self.assertEqual(util.MakeHumanReadable(1024 ** 3 * 5.3), '5.3 GiB')
+    self.assertEqual(util.MakeHumanReadable(1024 ** 4 * 2.7), '2.7 TiB')
+    self.assertEqual(util.MakeHumanReadable(1024 ** 5), '1 PiB')
+    self.assertEqual(util.MakeHumanReadable(1024 ** 6), '1 EiB')
+
+  def test_MakeBitsHumanReadable(self):
+    """Tests converting bit counts to human-readable strings."""
+    self.assertEqual(util.MakeBitsHumanReadable(0), '0 bit')
+    self.assertEqual(util.MakeBitsHumanReadable(1023), '1023 bit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024), '1 Kibit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024 ** 2), '1 Mibit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024 ** 3), '1 Gibit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024 ** 3 * 5.3), '5.3 Gibit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024 ** 4 * 2.7), '2.7 Tibit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024 ** 5), '1 Pibit')
+    self.assertEqual(util.MakeBitsHumanReadable(1024 ** 6), '1 Eibit')
+
+  def test_HumanReadableToBytes(self):
+    """Tests converting human-readable strings to byte counts."""
+    self.assertEqual(util.HumanReadableToBytes('1'), 1)
+    self.assertEqual(util.HumanReadableToBytes('15'), 15)
+    self.assertEqual(util.HumanReadableToBytes('15.3'), 15)
+    self.assertEqual(util.HumanReadableToBytes('15.7'), 16)
+    self.assertEqual(util.HumanReadableToBytes('1023'), 1023)
+    self.assertEqual(util.HumanReadableToBytes('1k'), 1024)
+    self.assertEqual(util.HumanReadableToBytes('2048'), 2048)
+    self.assertEqual(util.HumanReadableToBytes('1 k'), 1024)
+    self.assertEqual(util.HumanReadableToBytes('1 K'), 1024)
+    self.assertEqual(util.HumanReadableToBytes('1 KB'), 1024)
+    self.assertEqual(util.HumanReadableToBytes('1 KiB'), 1024)
+    self.assertEqual(util.HumanReadableToBytes('1 m'), 1024 ** 2)
+    self.assertEqual(util.HumanReadableToBytes('1 M'), 1024 ** 2)
+    self.assertEqual(util.HumanReadableToBytes('1 MB'), 1024 ** 2)
+    self.assertEqual(util.HumanReadableToBytes('1 MiB'), 1024 ** 2)
+    self.assertEqual(util.HumanReadableToBytes('1 g'), 1024 ** 3)
+    self.assertEqual(util.HumanReadableToBytes('1 G'), 1024 ** 3)
+    self.assertEqual(util.HumanReadableToBytes('1 GB'), 1024 ** 3)
+    self.assertEqual(util.HumanReadableToBytes('1 GiB'), 1024 ** 3)
+    self.assertEqual(util.HumanReadableToBytes('1t'), 1024 ** 4)
+    self.assertEqual(util.HumanReadableToBytes('1T'), 1024 ** 4)
+    self.assertEqual(util.HumanReadableToBytes('1TB'), 1024 ** 4)
+    self.assertEqual(util.HumanReadableToBytes('1TiB'), 1024 ** 4)
+    self.assertEqual(util.HumanReadableToBytes('1\t   p'), 1024 ** 5)
+    self.assertEqual(util.HumanReadableToBytes('1\t   P'), 1024 ** 5)
+    self.assertEqual(util.HumanReadableToBytes('1\t   PB'), 1024 ** 5)
+    self.assertEqual(util.HumanReadableToBytes('1\t   PiB'), 1024 ** 5)
+    self.assertEqual(util.HumanReadableToBytes('1e'), 1024 ** 6)
+    self.assertEqual(util.HumanReadableToBytes('1E'), 1024 ** 6)
+    self.assertEqual(util.HumanReadableToBytes('1EB'), 1024 ** 6)
+    self.assertEqual(util.HumanReadableToBytes('1EiB'), 1024 ** 6)
+
+  def test_CompareVersions(self):
+    """Tests CompareVersions for various use cases."""
+    # CompareVersions(first, second) returns (g, m), where
+    #   g is True if first known to be greater than second, else False.
+    #   m is True if first known to be greater by at least 1 major version,
+    (g, m) = CompareVersions('3.37', '3.2')
+    self.assertTrue(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('7', '2')
+    self.assertTrue(g)
+    self.assertTrue(m)
+    (g, m) = CompareVersions('3.32', '3.32pre')
+    self.assertTrue(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.32pre', '3.31')
+    self.assertTrue(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.4pre', '3.3pree')
+    self.assertTrue(g)
+    self.assertFalse(m)
+
+    (g, m) = CompareVersions('3.2', '3.37')
+    self.assertFalse(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('2', '7')
+    self.assertFalse(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.32pre', '3.32')
+    self.assertFalse(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.31', '3.32pre')
+    self.assertFalse(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.3pre', '3.3pre')
+    self.assertFalse(g)
+    self.assertFalse(m)
+
+    (g, m) = CompareVersions('foobar', 'baz')
+    self.assertFalse(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.32', 'baz')
+    self.assertFalse(g)
+    self.assertFalse(m)
+
+    (g, m) = CompareVersions('3.4', '3.3')
+    self.assertTrue(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('3.3', '3.4')
+    self.assertFalse(g)
+    self.assertFalse(m)
+    (g, m) = CompareVersions('4.1', '3.33')
+    self.assertTrue(g)
+    self.assertTrue(m)
+    (g, m) = CompareVersions('3.10', '3.1')
+    self.assertTrue(g)
+    self.assertFalse(m)
+
+  def _AssertProxyInfosEqual(self, pi1, pi2):
+    self.assertEqual(pi1.proxy_type, pi2.proxy_type)
+    self.assertEqual(pi1.proxy_host, pi2.proxy_host)
+    self.assertEqual(pi1.proxy_port, pi2.proxy_port)
+    self.assertEqual(pi1.proxy_rdns, pi2.proxy_rdns)
+    self.assertEqual(pi1.proxy_user, pi2.proxy_user)
+    self.assertEqual(pi1.proxy_pass, pi2.proxy_pass)
+
+  def test_ProxyInfoFromEnvironmentVar(self):
+    """Tests ProxyInfoFromEnvironmentVar for various cases."""
+    valid_variables = ['http_proxy', 'https_proxy']
+    if not util.IS_WINDOWS:
+      # Dynamically set Windows environment variables are case-insensitive.
+      valid_variables.append('HTTPS_PROXY')
+    # Clear any existing environment variables for the duration of the test.
+    clear_dict = {}
+    for key in valid_variables:
+      clear_dict[key] = None
+    with SetEnvironmentForTest(clear_dict):
+      for env_var in valid_variables:
+        for url_string in ['hostname', 'http://hostname', 'https://hostname']:
+          with SetEnvironmentForTest({env_var: url_string}):
+            self._AssertProxyInfosEqual(
+                util.ProxyInfoFromEnvironmentVar(env_var),
+                httplib2.ProxyInfo(
+                    httplib2.socks.PROXY_TYPE_HTTP, 'hostname',
+                    443 if env_var.lower().startswith('https') else 80))
+            # Shouldn't populate info for other variables
+            for other_env_var in valid_variables:
+              if other_env_var == env_var: continue
+              self._AssertProxyInfosEqual(
+                  util.ProxyInfoFromEnvironmentVar(other_env_var),
+                  httplib2.ProxyInfo(httplib2.socks.PROXY_TYPE_HTTP, None, 0))
+        for url_string in ['1.2.3.4:50', 'http://1.2.3.4:50',
+                           'https://1.2.3.4:50']:
+          with SetEnvironmentForTest({env_var: url_string}):
+            self._AssertProxyInfosEqual(
+                util.ProxyInfoFromEnvironmentVar(env_var),
+                httplib2.ProxyInfo(httplib2.socks.PROXY_TYPE_HTTP, '1.2.3.4',
+                                   50))
+        for url_string in ['foo:bar@1.2.3.4:50', 'http://foo:bar@1.2.3.4:50',
+                           'https://foo:bar@1.2.3.4:50']:
+          with SetEnvironmentForTest({env_var: url_string}):
+            self._AssertProxyInfosEqual(
+                util.ProxyInfoFromEnvironmentVar(env_var),
+                httplib2.ProxyInfo(httplib2.socks.PROXY_TYPE_HTTP,
+                                   '1.2.3.4', 50, proxy_user='foo',
+                                   proxy_pass='bar'))
+        for url_string in ['bar@1.2.3.4:50', 'http://bar@1.2.3.4:50',
+                           'https://bar@1.2.3.4:50']:
+          with SetEnvironmentForTest({env_var: url_string}):
+            self._AssertProxyInfosEqual(
+                util.ProxyInfoFromEnvironmentVar(env_var),
+                httplib2.ProxyInfo(httplib2.socks.PROXY_TYPE_HTTP, '1.2.3.4',
+                                   50, proxy_pass='bar'))
+      for env_var in ['proxy', 'noproxy', 'garbage']:
+        for url_string in ['1.2.3.4:50', 'http://1.2.3.4:50']:
+          with SetEnvironmentForTest({env_var: url_string}):
+            self._AssertProxyInfosEqual(
+                util.ProxyInfoFromEnvironmentVar(env_var),
+                httplib2.ProxyInfo(httplib2.socks.PROXY_TYPE_HTTP, None, 0))