# -*- 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))