#!/usr/bin/python
# -*- coding:utf-8 -*-
# Copyright 2016 The Android Open Source Project
#
# 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.
"""Unittests for the shell module."""
from __future__ import print_function
import difflib
import os
import sys
import unittest
_path = os.path.realpath(__file__ + '/../..')
if sys.path[0] != _path:
sys.path.insert(0, _path)
del _path
import rh.shell
class DiffTestCase(unittest.TestCase):
"""Helper that includes diff output when failing."""
def setUp(self):
self.differ = difflib.Differ()
def _assertEqual(self, func, test_input, test_output, result):
"""Like assertEqual but with built in diff support."""
diff = '\n'.join(list(self.differ.compare([test_output], [result])))
msg = ('Expected %s to translate %r to %r, but got %r\n%s' %
(func, test_input, test_output, result, diff))
self.assertEqual(test_output, result, msg)
def _testData(self, functor, tests, check_type=True):
"""Process a dict of test data."""
for test_output, test_input in tests.iteritems():
result = functor(test_input)
self._assertEqual(functor.__name__, test_input, test_output, result)
if check_type:
# Also make sure the result is a string, otherwise the %r
# output will include a "u" prefix and that is not good for
# logging.
self.assertEqual(type(test_output), str)
class ShellQuoteTest(DiffTestCase):
"""Test the shell_quote & shell_unquote functions."""
def testShellQuote(self):
"""Basic ShellQuote tests."""
# Dict of expected output strings to input lists.
tests_quote = {
"''": '',
'a': unicode('a'),
"'a b c'": unicode('a b c'),
"'a\tb'": 'a\tb',
"'/a$file'": '/a$file',
"'/a#file'": '/a#file',
"""'b"c'""": 'b"c',
"'a@()b'": 'a@()b',
'j%k': 'j%k',
r'''"s'a\$va\\rs"''': r"s'a$va\rs",
r'''"\\'\\\""''': r'''\'\"''',
r'''"'\\\$"''': r"""'\$""",
}
# Expected input output specific to ShellUnquote. This string cannot
# be produced by ShellQuote but is still a valid bash escaped string.
tests_unquote = {
r'''\$''': r'''"\\$"''',
}
def aux(s):
return rh.shell.shell_unquote(rh.shell.shell_quote(s))
self._testData(rh.shell.shell_quote, tests_quote)
self._testData(rh.shell.shell_unquote, tests_unquote)
# Test that the operations are reversible.
self._testData(aux, {k: k for k in tests_quote.values()}, False)
self._testData(aux, {k: k for k in tests_quote.keys()}, False)
class CmdToStrTest(DiffTestCase):
"""Test the cmd_to_str function."""
def testCmdToStr(self):
# Dict of expected output strings to input lists.
tests = {
r"a b": ['a', 'b'],
r"'a b' c": ['a b', 'c'],
r'''a "b'c"''': ['a', "b'c"],
r'''a "/'\$b" 'a b c' "xy'z"''':
[unicode('a'), "/'$b", 'a b c', "xy'z"],
'': [],
}
self._testData(rh.shell.cmd_to_str, tests)
class BooleanShellTest(unittest.TestCase):
"""Test the boolean_shell_value function."""
def testFull(self):
"""Verify nputs work as expected"""
for v in (None,):
self.assertTrue(rh.shell.boolean_shell_value(v, True))
self.assertFalse(rh.shell.boolean_shell_value(v, False))
for v in (1234, '', 'akldjsf', '"'):
self.assertRaises(ValueError, rh.shell.boolean_shell_value, v, True)
for v in ('yes', 'YES', 'YeS', 'y', 'Y', '1', 'true', 'True', 'TRUE',):
self.assertTrue(rh.shell.boolean_shell_value(v, True))
self.assertTrue(rh.shell.boolean_shell_value(v, False))
for v in ('no', 'NO', 'nO', 'n', 'N', '0', 'false', 'False', 'FALSE',):
self.assertFalse(rh.shell.boolean_shell_value(v, True))
self.assertFalse(rh.shell.boolean_shell_value(v, False))
if __name__ == '__main__':
unittest.main()