llvm-project/clang/utils/check_cfc/test_check_cfc.py

#!/usr/bin/env python

"""Test internal functions within check_cfc.py."""

import check_cfc
import os
import platform
import unittest


class TestCheckCFC(unittest.TestCase):

    def test_flip_dash_g(self):
        self.assertIn('-g', check_cfc.flip_dash_g(['clang', '-c']))
        self.assertNotIn('-g', check_cfc.flip_dash_g(['clang', '-c', '-g']))
        self.assertNotIn(
            '-g', check_cfc.flip_dash_g(['clang', '-g', '-c', '-g']))

    def test_remove_dir_from_path(self):
        bin_path = r'/usr/bin'
        space_path = r'/home/user/space in path'
        superstring_path = r'/usr/bin/local'

        # Test removing last thing in path
        self.assertNotIn(
            bin_path, check_cfc.remove_dir_from_path(bin_path, bin_path))

        # Test removing one entry and leaving others
        # Also tests removing repeated path
        path_var = os.pathsep.join(
            [superstring_path, bin_path, space_path, bin_path])
        stripped_path_var = check_cfc.remove_dir_from_path(path_var, bin_path)
        self.assertIn(superstring_path, stripped_path_var)
        self.assertNotIn(bin_path, stripped_path_var.split(os.pathsep))
        self.assertIn(space_path, stripped_path_var)

        # Test removing non-canonical path
        self.assertNotIn(r'/usr//bin',
                         check_cfc.remove_dir_from_path(r'/usr//bin', bin_path))

        if platform == 'Windows':
            # Windows is case insensitive so should remove a different case
            # path
            self.assertNotIn(
                bin_path, check_cfc.remove_dir_from_path(path_var, r'/USR/BIN'))
        else:
            # Case sensitive so will not remove different case path
            self.assertIn(
                bin_path, check_cfc.remove_dir_from_path(path_var, r'/USR/BIN'))

    def test_is_output_specified(self):
        self.assertTrue(
            check_cfc.is_output_specified(['clang', '-o', 'test.o']))
        self.assertTrue(check_cfc.is_output_specified(['clang', '-otest.o']))
        self.assertFalse(
            check_cfc.is_output_specified(['clang', '-gline-tables-only']))
        # Not specified for implied output file name
        self.assertFalse(check_cfc.is_output_specified(['clang', 'test.c']))

    def test_get_output_file(self):
        self.assertEqual(
            check_cfc.get_output_file(['clang', '-o', 'test.o']), 'test.o')
        self.assertEqual(
            check_cfc.get_output_file(['clang', '-otest.o']), 'test.o')
        self.assertIsNone(
            check_cfc.get_output_file(['clang', '-gline-tables-only']))
        # Can't get output file if more than one input file
        self.assertIsNone(
            check_cfc.get_output_file(['clang', '-c', 'test.cpp', 'test2.cpp']))
        # No output file specified
        self.assertIsNone(check_cfc.get_output_file(['clang', '-c', 'test.c']))

    def test_derive_output_file(self):
        # Test getting implicit output file
        self.assertEqual(
            check_cfc.derive_output_file(['clang', '-c', 'test.c']), 'test.o')
        self.assertEqual(
            check_cfc.derive_output_file(['clang', '-c', 'test.cpp']), 'test.o')
        self.assertIsNone(check_cfc.derive_output_file(['clang', '--version']))

    def test_is_normal_compile(self):
        self.assertTrue(check_cfc.is_normal_compile(
            ['clang', '-c', 'test.cpp', '-o', 'test2.o']))
        self.assertTrue(
            check_cfc.is_normal_compile(['clang', '-c', 'test.cpp']))
        # Outputting bitcode is not a normal compile
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', 'test.cpp', '-flto']))
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', 'test.cpp', '-emit-llvm']))
        # Outputting preprocessed output or assembly is not a normal compile
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-E', 'test.cpp', '-o', 'test.ii']))
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-S', 'test.cpp', '-o', 'test.s']))
        # Input of preprocessed or assembly is not a "normal compile"
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', 'test.s', '-o', 'test.o']))
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', 'test.ii', '-o', 'test.o']))
        # Specifying --version and -c is not a normal compile
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', 'test.cpp', '--version']))
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', 'test.cpp', '--help']))
        # Outputting dependency files is not a normal compile
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', '-M', 'test.cpp']))
        self.assertFalse(
            check_cfc.is_normal_compile(['clang', '-c', '-MM', 'test.cpp']))
        # Creating a dependency file as a side effect still outputs an object file
        self.assertTrue(
            check_cfc.is_normal_compile(['clang', '-c', '-MD', 'test.cpp']))
        self.assertTrue(
            check_cfc.is_normal_compile(['clang', '-c', '-MMD', 'test.cpp']))

    def test_replace_output_file(self):
        self.assertEqual(check_cfc.replace_output_file(
            ['clang', '-o', 'test.o'], 'testg.o'), ['clang', '-o', 'testg.o'])
        self.assertEqual(check_cfc.replace_output_file(
            ['clang', '-otest.o'], 'testg.o'), ['clang', '-otestg.o'])
        with self.assertRaises(Exception):
            check_cfc.replace_output_file(['clang'], 'testg.o')

    def test_add_output_file(self):
        self.assertEqual(check_cfc.add_output_file(
            ['clang'], 'testg.o'), ['clang', '-o', 'testg.o'])

    def test_set_output_file(self):
        # Test output not specified
        self.assertEqual(
            check_cfc.set_output_file(['clang'], 'test.o'), ['clang', '-o', 'test.o'])
        # Test output is specified
        self.assertEqual(check_cfc.set_output_file(
            ['clang', '-o', 'test.o'], 'testb.o'), ['clang', '-o', 'testb.o'])

    def test_get_input_file(self):
        # No input file
        self.assertIsNone(check_cfc.get_input_file(['clang']))
        # Input C file
        self.assertEqual(
            check_cfc.get_input_file(['clang', 'test.c']), 'test.c')
        # Input C++ file
        self.assertEqual(
            check_cfc.get_input_file(['clang', 'test.cpp']), 'test.cpp')
        # Multiple input files
        self.assertIsNone(
            check_cfc.get_input_file(['clang', 'test.c', 'test2.cpp']))
        self.assertIsNone(
            check_cfc.get_input_file(['clang', 'test.c', 'test2.c']))
        # Don't handle preprocessed files
        self.assertIsNone(check_cfc.get_input_file(['clang', 'test.i']))
        self.assertIsNone(check_cfc.get_input_file(['clang', 'test.ii']))
        # Test identifying input file with quotes
        self.assertEqual(
            check_cfc.get_input_file(['clang', '"test.c"']), '"test.c"')
        self.assertEqual(
            check_cfc.get_input_file(['clang', "'test.c'"]), "'test.c'")
        # Test multiple quotes
        self.assertEqual(
            check_cfc.get_input_file(['clang', "\"'test.c'\""]), "\"'test.c'\"")

    def test_set_input_file(self):
        self.assertEqual(check_cfc.set_input_file(
            ['clang', 'test.c'], 'test.s'), ['clang', 'test.s'])

if __name__ == '__main__':
    unittest.main()