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