# ============LICENSE_START======================================================= # Copyright (C) 2022 Nordix Foundation # ================================================================================ # 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. # # SPDX-License-Identifier: Apache-2.0 # ============LICENSE_END========================================================= import datetime import sys import unittest from unittest import mock from unittest.mock import MagicMock import io import CopyrightCheck BANNER = '=' * 120 def MockStdout(command): mock_stdout = MagicMock() mock_stdout.configure_mock(**{"stdout.decode.return_value": command}) return mock_stdout class TestCopyrightCheck(unittest.TestCase): @mock.patch('subprocess.run') def test_PermissionsCheckFalse(self, mock_subprocess_run): mock_subprocess_run.return_value = MockStdout('Permission denied') capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with self.assertRaises(SystemExit): CopyrightCheck.PermissionsCheck() sys.stdout = sys.__stdout__ self.assertEqual(capturedOutput.getvalue(), 'Error, I may not have the necessary permissions. Exiting...\n' + BANNER + '\n') @mock.patch('subprocess.run') def test_PermissionsCheckTrue(self, mock_subprocess_run): mock_subprocess_run.return_value = MockStdout( 'usage: git [--version] [--help] [-C ] [-c =]...') CopyrightCheck.PermissionsCheck() # Assert no error thrown @mock.patch('CopyrightCheck.GetIgnoredFiles') @mock.patch('subprocess.run') def test_FindAlteredFiles(self, mock_subprocess_run, mock_GetIgnoredFiles): mock_GetIgnoredFiles.return_value = ['.*.json', 'dir/.*'] mock_subprocess_run.return_value = MockStdout('File1.json\nFile2.java\nFile2.java\ndir/File3.java') result = CopyrightCheck.FindAlteredFiles() # Duplicates, .json and files in 'dir' removed self.assertEqual(result, ['File2.java']) @mock.patch('CopyrightCheck.GetIgnoredFiles') @mock.patch('subprocess.run') def test_FindAlteredFilesWithNoFileChanges(self, mock_subprocess_run, mock_GetIgnoredFiles): mock_GetIgnoredFiles.return_value = ['.*.json', 'dir/.*'] mock_subprocess_run.return_value = MockStdout('File1.json\ndir/File3.java') capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.FindAlteredFiles() sys.stdout = sys.__stdout__ self.assertEqual(result, []) self.assertEqual(capturedOutput.getvalue(), '') @mock.patch('subprocess.run') def test_GetCommitterEmailExtension(self, mock_subprocess_run): mock_subprocess_run.return_value = MockStdout('a.committer.name@address.com') result = CopyrightCheck.GetCommitterEmailExtension() self.assertEqual(result, '@address.com') def test_ReadProjectCommittersConfigFile(self): mock_open = mock.mock_open(read_data="email,signature\n@address.com,Company Name") with mock.patch('builtins.open', mock_open): result = CopyrightCheck.ReadProjectCommittersConfigFile() self.assertEqual(result, {'@address.com': 'Company Name'}) @mock.patch('CopyrightCheck.open') def test_ReadProjectCommittersConfigFileError(self, mock_OpenFile): mock_OpenFile.side_effect = FileNotFoundError capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with self.assertRaises(SystemExit): CopyrightCheck.ReadProjectCommittersConfigFile() sys.stdout = sys.__stdout__ expectedOutput = ('Unable to open Project Committers Config File, have the command line arguments been set?\n' + BANNER + '\n') self.assertEqual(capturedOutput.getvalue(), expectedOutput) def test_CheckCommitterInConfigFileTrue(self): committerEmailExtension = '@address.com' projectCommitters = {'@address.com': 'Company Name'} capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCommitterInConfigFile(committerEmailExtension, projectCommitters) sys.stdout = sys.__stdout__ self.assertTrue(result) self.assertEqual(capturedOutput.getvalue(), "") def test_CheckCommitterInConfigFileFalse(self): committerEmailExtension = '@address.com' projectCommitters = {'@anotheraddress.com': 'Another Company Name'} capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with self.assertRaises(SystemExit): CopyrightCheck.CheckCommitterInConfigFile(committerEmailExtension, projectCommitters) sys.stdout = sys.__stdout__ expectedOutput = ('Error, Committer email is not included in config file.\n' + 'If your company is new to the project please make appropriate changes to project-committers-config.csv\n' + 'for Copyright Check to work.\n' + 'Exiting...\n' + BANNER + '\n') self.assertEqual(capturedOutput.getvalue(), expectedOutput) def test_GetIgnoredFiles(self): mock_open = mock.mock_open(read_data="file path\n*checkstyle/*\n*.json") with mock.patch('builtins.open', mock_open): result = CopyrightCheck.GetIgnoredFiles() self.assertEqual(result, [".*checkstyle/.*", ".*.json"]) @mock.patch('CopyrightCheck.open') def test_GetIgnoredFilesError(self, mock_OpenFile): mock_OpenFile.side_effect = FileNotFoundError capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with self.assertRaises(SystemExit): CopyrightCheck.GetIgnoredFiles() sys.stdout = sys.__stdout__ expectedOutput = ('Unable to open File Ignore Config File, have the command line arguments been set?\n' + BANNER + '\n') self.assertEqual(capturedOutput.getvalue(), expectedOutput) def test_GetCopyrightTemplate(self): mock_open = mock.mock_open(read_data="****\nThis is a\nCopyright File\n****") with mock.patch('builtins.open', mock_open): result = CopyrightCheck.GetCopyrightTemplate() self.assertEqual(result, ["****\n", "This is a\n", "Copyright File\n", "****"]) @mock.patch('CopyrightCheck.open') def test_GetCopyrightTemplateError(self, mock_OpenFile): mock_OpenFile.side_effect = FileNotFoundError capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with self.assertRaises(SystemExit): CopyrightCheck.GetCopyrightTemplate() sys.stdout = sys.__stdout__ expectedOutput = ('Unable to open Template Copyright File, have the command line arguments been set?\n' + BANNER + '\n') self.assertEqual(capturedOutput.getvalue(), expectedOutput) @mock.patch('subprocess.run') def test_GetProjectRootDir(self, mock_subprocess_run): mock_subprocess_run.return_value = MockStdout('project/root/dir\n') result = CopyrightCheck.GetProjectRootDir() self.assertEqual(result, 'project/root/dir/') def test_ParseFileCopyright(self): readFromFile = ["#Before lines will not be included\n", "#===LICENSE_START===\n", "#Copyright (C) 0000 Some Company\n", "#A line without signature\n", "#===============================\n", "#This is the start of the Copyright\n", "#===LICENSE_END===\n", "After lines will not be included"] copyright, signatures = CopyrightCheck.ParseFileCopyright(readFromFile) self.assertEqual(copyright, {2: "#===LICENSE_START===\n", 5: "#===============================\n", 6: "#This is the start of the Copyright\n", 7: "#===LICENSE_END===\n"}) self.assertEqual(signatures, {3: "#Copyright (C) 0000 Some Company\n", 4: "#A line without signature\n"}) def test_ParseFileCopyrightNoCopyright(self): fileObject = io.StringIO("#This is not\na copyright\n") fileObject.name = 'some/file/name' capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout copyright, signatures = CopyrightCheck.ParseFileCopyright(fileObject) sys.stdout = sys.__stdout__ self.assertEqual(copyright, {}) self.assertEqual(signatures, {}) self.assertEqual(capturedOutput.getvalue(), 'some/file/name | no copyright found\n') def test_RemoveCommentBlock(self): commentCharactersList = ['# ', '* ', '# ', '* '] for commentCharacters in commentCharactersList: copyright = {1: commentCharacters + '===LICENSE_START===\n', 2: '\n', 3: commentCharacters + 'This is the License\n', 4: commentCharacters + '===LICENSE_END===\n'} result = CopyrightCheck.RemoveCommentBlock(copyright) self.assertEqual(result, {1: '===LICENSE_START===\n', 2: '\n', 3: 'This is the License\n', 4: '===LICENSE_END===\n'}) @mock.patch('CopyrightCheck.open') @mock.patch('CopyrightCheck.GetProjectRootDir') @mock.patch('CopyrightCheck.GetCopyrightTemplate') def test_CheckCopyrightForFileNotFound(self, mock_GetCopyrightTemplate, mock_GetProjectRootDir, mock_OpenFile): mock_GetCopyrightTemplate.return_value = 'some-copyright-template' mock_GetProjectRootDir.return_value = 'some/project/root/dir/' mock_OpenFile.side_effect = FileNotFoundError capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCopyrightForFiles(['some-file.java'], {}, []) sys.stdout = sys.__stdout__ self.assertEqual(capturedOutput.getvalue(), 'Unable to find file some/project/root/dir/some-file.java\n') self.assertEqual(result, 1) @mock.patch('CopyrightCheck.ParseFileCopyright') @mock.patch('CopyrightCheck.GetProjectRootDir') @mock.patch('CopyrightCheck.GetCopyrightTemplate') def test_CheckCopyrightForFileWithNoCopyright(self, mock_GetCopyrightTemplate, mock_GetProjectRootDir, mock_ParseFileCopyright): mock_GetCopyrightTemplate.return_value = 'some-copyright-template' mock_GetProjectRootDir.return_value = 'some/project/root/dir/' mock_ParseFileCopyright.return_value = ({}, {}) mock_open = mock.mock_open(read_data="some-file-content") capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with mock.patch('builtins.open', mock_open): result = CopyrightCheck.CheckCopyrightForFiles(['some-file.java'], {}, []) sys.stdout = sys.__stdout__ self.assertEqual(capturedOutput.getvalue(), "") self.assertEqual(result, 1) @mock.patch('CopyrightCheck.CheckCopyrightSignature') @mock.patch('CopyrightCheck.CheckCopyrightFormat') @mock.patch('CopyrightCheck.ParseFileCopyright') @mock.patch('CopyrightCheck.GetProjectRootDir') @mock.patch('CopyrightCheck.GetCopyrightTemplate') def test_CheckCopyrightForFilesWhichAreRight(self, mock_GetCopyrightTemplate, mock_GetProjectRootDir, mock_ParseFileCopyright, mock_CheckCopyrightFormat, mock_CheckCopyrightSignature): mock_GetCopyrightTemplate.return_value = 'some-copyright-template' mock_GetProjectRootDir.return_value = 'some/project/root/dir/' mock_ParseFileCopyright.return_value = ({1: '# =some-copyright-line'}, {2: '# =some-signature-line'}) mock_open = mock.mock_open(read_data="# =some-file-content") mock_CheckCopyrightFormat.return_value = 0 mock_CheckCopyrightSignature.return_value = 0 capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout with mock.patch('builtins.open', mock_open): result = CopyrightCheck.CheckCopyrightForFiles(['some-file.java', 'another-file.java'], {'@address.com': 'Some Company'}, '@address.com') sys.stdout = sys.__stdout__ self.assertEqual(result, 0) self.assertEqual(capturedOutput.getvalue(), "") mock_GetCopyrightTemplate.assert_called_once_with() mock_GetProjectRootDir.assert_called_once_with() self.assertEqual(mock_ParseFileCopyright.call_count, 2) mock_CheckCopyrightFormat.assert_has_calls([ mock.call({1: '=some-copyright-line'}, 'some-copyright-template', 'some/project/root/dir/some-file.java'), mock.call({1: '=some-copyright-line'}, 'some-copyright-template', 'some/project/root/dir/another-file.java') ]) mock_CheckCopyrightSignature.assert_has_calls([ mock.call({2: '# =some-signature-line'}, 'Some Company', 'some/project/root/dir/some-file.java'), mock.call({2: '# =some-signature-line'}, 'Some Company', 'some/project/root/dir/another-file.java') ]) self.assertEqual(mock_CheckCopyrightFormat.call_count, 2) self.assertEqual(mock_CheckCopyrightSignature.call_count, 2) def test_CheckCopyrightFormatWhichIsWrong(self): fileCopyright = {1: '---LICENSE_START---\n', 2: 'This is the license typo\n', 3: '', 4: '===license_end===\n'} templateCopyright = ['===LICENSE_START===\n', 'This is the license\n', '\n', '===LICENSE_END===\n'] capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCopyrightFormat(fileCopyright, templateCopyright, 'some/file/path') sys.stdout = sys.__stdout__ expectedOutput = ("some/file/path | line 1 read \t '---LICENSE_START---\\n'\n" + "some/file/path | line 1 expected '===LICENSE_START===\\n'\n" + "some/file/path | line 2 read \t 'This is the license typo\\n'\n" + "some/file/path | line 2 expected 'This is the license\\n'\n" + "some/file/path | line 3 read \t ''\n" + "some/file/path | line 3 expected '\\n'\n" + "some/file/path | line 4 read \t '===license_end===\\n'\n" + "some/file/path | line 4 expected '===LICENSE_END===\\n'\n") self.assertEqual(capturedOutput.getvalue(), expectedOutput) self.assertEqual(result, 4) def test_CheckCopyrightFormatWhichIsCorrect(self): fileCopyright = {1: '===LICENSE_START===\n', 2: 'This is the license\n', 3: '\n', 4: '===LICENSE_END===\n'} templateCopyright = ['===LICENSE_START===\n', 'This is the license\n', '\n', '===LICENSE_END===\n'] capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCopyrightFormat(fileCopyright, templateCopyright, 'some/file/path') sys.stdout = sys.__stdout__ self.assertEqual(capturedOutput.getvalue(), "") self.assertEqual(result, 0) def test_CheckCopyrightSignatureWhichIsWrong(self): fileSignatures = {1: "Trigger expected Copy-right", 2: "Trigger expected Mod Copy-right"} capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCopyrightSignature(fileSignatures, 'Some-Company', 'some/file/path') sys.stdout = sys.__stdout__ expectedOutput = ("some/file/path | line 1 expected Copyright\n" + "some/file/path | line 2 expected Modifications Copyright\n" + "some/file/path | missing company name and year for Some-Company\n") self.assertEqual(capturedOutput.getvalue(), expectedOutput) self.assertEqual(result, 3) def test_CheckCopyrightSignatureWhichHasWrongYear(self): currentYear = datetime.date.today().year fileSignatures = {1: "Copyright (C) 1999 Some-Company"} capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCopyrightSignature(fileSignatures, 'Some-Company', 'some/file/path') sys.stdout = sys.__stdout__ self.assertEqual(capturedOutput.getvalue(), "some/file/path | line 1 update year to include " + str(currentYear) + "\n") self.assertEqual(result, 1) def test_CheckCopyrightSignatureWhichIsRight(self): currentYear = datetime.date.today().year fileSignatures = {1: "Copyright (C) " + str(currentYear) + " Some-Company"} capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout result = CopyrightCheck.CheckCopyrightSignature(fileSignatures, 'Some-Company', 'some/file/path') sys.stdout = sys.__stdout__ self.assertEqual(capturedOutput.getvalue(), "") self.assertEqual(result, 0) @mock.patch('CopyrightCheck.CheckCopyrightForFiles') @mock.patch('CopyrightCheck.FindAlteredFiles') @mock.patch('CopyrightCheck.CheckCommitterInConfigFile') @mock.patch('CopyrightCheck.ReadProjectCommittersConfigFile') @mock.patch('CopyrightCheck.GetCommitterEmailExtension') @mock.patch('CopyrightCheck.PermissionsCheck') def test_Main(self, mock_PermissionsCheck, mock_GetCommitterEmailExtension, mock_ReadProjectCommittersConfigFile, mock_CheckCommitterInConfigFile, mock_FindAlteredFiles, mock_CheckCopyrightForFiles): mock_GetCommitterEmailExtension.return_value = '@address.com' mock_ReadProjectCommittersConfigFile.return_value = {'@address.com', 'Some Company'} mock_FindAlteredFiles.return_value = ['some-file.java'] mock_CheckCopyrightForFiles.return_value = 5 capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout CopyrightCheck.main() sys.stdout = sys.__stdout__ expectedOutput = (BANNER + '\nCopyright Check Python Script:\n' + '5 issue(s) found after 1 altered file(s) checked\n' + BANNER + '\n') self.assertEqual(capturedOutput.getvalue(), expectedOutput) mock_PermissionsCheck.assert_called_once_with() mock_GetCommitterEmailExtension.assert_called_once_with() mock_ReadProjectCommittersConfigFile.assert_called_once_with() mock_CheckCommitterInConfigFile.assert_called_once_with('@address.com', {'@address.com', 'Some Company'}) mock_FindAlteredFiles.assert_called_once_with() mock_CheckCopyrightForFiles.assert_called_once_with(['some-file.java'], {'@address.com', 'Some Company'}, '@address.com') @mock.patch('CopyrightCheck.CheckCopyrightForFiles') @mock.patch('CopyrightCheck.FindAlteredFiles') @mock.patch('CopyrightCheck.CheckCommitterInConfigFile') @mock.patch('CopyrightCheck.ReadProjectCommittersConfigFile') @mock.patch('CopyrightCheck.GetCommitterEmailExtension') @mock.patch('CopyrightCheck.PermissionsCheck') def test_MainNoFiles(self, mock_PermissionsCheck, mock_GetCommitterEmailExtension, mock_ReadProjectCommittersConfigFile, mock_CheckCommitterInConfigFile, mock_FindAlteredFiles, mock_CheckCopyrightForFiles): mock_GetCommitterEmailExtension.return_value = '@address.com' mock_ReadProjectCommittersConfigFile.return_value = {'@address.com', 'Some Company'} mock_FindAlteredFiles.return_value = [] capturedOutput = io.StringIO() sys.stdout = capturedOutput # Capture output to stdout CopyrightCheck.main() sys.stdout = sys.__stdout__ expectedOutput = (BANNER + '\nCopyright Check Python Script:\n' + '0 issue(s) found after 0 altered file(s) checked\n' + BANNER + '\n') self.assertEqual(capturedOutput.getvalue(), expectedOutput) mock_PermissionsCheck.assert_called_once_with() mock_GetCommitterEmailExtension.assert_called_once_with() mock_ReadProjectCommittersConfigFile.assert_called_once_with() mock_CheckCommitterInConfigFile.assert_called_once_with('@address.com', {'@address.com', 'Some Company'}) mock_FindAlteredFiles.assert_called_once_with() mock_CheckCopyrightForFiles.assert_not_called() if __name__ == '__main__': unittest.main()