| #!/usr/bin/env python2 |
| # -*- coding: utf-8 -*- |
| # Copyright 2019 The Chromium OS Authors. All rights reserved. |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| |
| """Unit tests when handling patches.""" |
| |
| from __future__ import print_function |
| |
| import json |
| import mock |
| import os |
| import patch_manager |
| import subprocess |
| import unittest |
| |
| from failure_modes import FailureModes |
| from test_helpers import CallCountsToMockFunctions |
| from test_helpers import CreateTemporaryJsonFile |
| from test_helpers import WritePrettyJsonFile |
| |
| |
| class PatchManagerTest(unittest.TestCase): |
| """Test class when handling patches of packages.""" |
| |
| # Simulate behavior of 'os.path.isdir()' when the path is not a directory. |
| @mock.patch.object(os.path, 'isdir', return_value=False) |
| def testInvalidDirectoryPassedAsCommandLineArgument(self, mock_isdir): |
| # Verify the exception is raised when the command line argument for |
| # '--filesdir_path' or '--src_path' is not a directory. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.is_directory('/some/path/that/is/not/a/directory') |
| |
| self.assertEqual( |
| err.exception.message, 'Path is not a directory: ' |
| '/some/path/that/is/not/a/directory') |
| |
| mock_isdir.assert_called_once() |
| |
| # Simulate the behavior of 'os.path.isdir()' when a path to a directory is |
| # passed as the command line argument for '--filesdir_path' or '--src_path'. |
| @mock.patch.object(os.path, 'isdir', return_value=True) |
| def testValidDirectoryPassedAsCommandLineArgument(self, mock_isdir): |
| self.assertEqual( |
| patch_manager.is_directory('/some/path/that/is/a/directory'), |
| '/some/path/that/is/a/directory') |
| |
| mock_isdir.assert_called_once() |
| |
| # Simulate behavior of 'os.path.isfile()' when the patch metadata file is does |
| # not exist. |
| @mock.patch.object(os.path, 'isfile', return_value=False) |
| def testInvalidPathToPatchMetadataFilePassedAsCommandLineArgument( |
| self, mock_isfile): |
| |
| # Verify the exception is raised when the command line argument for |
| # '--patch_metadata_file' does not exist or is not a file. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.is_patch_metadata_file('/abs/path/to/PATCHES.json') |
| |
| self.assertEqual( |
| err.exception.message, 'Invalid patch metadata file provided: ' |
| '/abs/path/to/PATCHES.json') |
| |
| mock_isfile.assert_called_once() |
| |
| # Simulate the behavior of 'os.path.isfile()' when the path to the patch |
| # metadata file exists and is a file. |
| @mock.patch.object(os.path, 'isfile', return_value=True) |
| def testPatchMetadataFileDoesNotEndInJson(self, mock_isfile): |
| # Verify the exception is raises when the command line argument for |
| # '--patch_metadata_file' exists and is a file but does not end in |
| # '.json'. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.is_patch_metadata_file('/abs/path/to/PATCHES') |
| |
| self.assertEqual( |
| err.exception.message, 'Patch metadata file does not end in \'.json\': ' |
| '/abs/path/to/PATCHES') |
| |
| mock_isfile.assert_called_once() |
| |
| # Simulate the behavior of 'os.path.isfile()' when the command line argument |
| # for '--patch_metadata_file' exists and is a file. |
| @mock.patch.object(os.path, 'isfile', return_value=True) |
| def testValidPatchMetadataFilePassedAsCommandLineArgument(self, mock_isfile): |
| self.assertEqual( |
| patch_manager.is_patch_metadata_file('/abs/path/to/PATCHES.json'), |
| '/abs/path/to/PATCHES.json') |
| |
| mock_isfile.assert_called_once() |
| |
| # Simulate behavior of 'os.path.isdir()' when the path to $FILESDIR |
| # does not exist. |
| @mock.patch.object(os.path, 'isdir', return_value=False) |
| def testInvalidPathToFilesDirWhenConstructingPathToPatch(self, mock_isdir): |
| # Verify the exception is raised when the the absolute path to $FILESDIR of |
| # a package is not a directory. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.GetPathToPatch('/abs/path/to/filesdir', |
| 'cherry/fixes_stdout.patch') |
| |
| self.assertEqual( |
| err.exception.message, 'Invalid path to $FILESDIR provided: ' |
| '/abs/path/to/filesdir') |
| |
| mock_isdir.assert_called_once() |
| |
| # Simulate behavior of 'os.path.isdir()' when the absolute path to the |
| # $FILESDIR of a package exists and is a directory. |
| @mock.patch.object(os.path, 'isdir', return_value=True) |
| # Simulate the behavior of 'os.path.isfile()' when the absolute path to the |
| # patch does not exist. |
| @mock.patch.object(os.path, 'isfile', return_value=False) |
| def testConstructedPathToPatchDoesNotExist(self, mock_isfile, mock_isdir): |
| # Verify the exception is raised when the absolute path to the patch does |
| # not exist. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.GetPathToPatch('/abs/path/to/filesdir', |
| 'cherry/fixes_stdout.patch') |
| |
| self.assertEqual( |
| err.exception.message, 'The absolute path /abs/path/to/filesdir/cherry/' |
| 'fixes_stdout.patch to the patch ' |
| 'cherry/fixes_stdout.patch does not exist') |
| |
| mock_isdir.assert_called_once() |
| |
| mock_isfile.assert_called_once() |
| |
| # Simulate behavior of 'os.path.isdir()' when the absolute path to the |
| # $FILESDIR of a package exists and is a directory. |
| @mock.patch.object(os.path, 'isdir', return_value=True) |
| # Simulate behavior of 'os.path.isfile()' when the absolute path to the |
| # patch exists and is a file. |
| @mock.patch.object(os.path, 'isfile', return_value=True) |
| def testConstructedPathToPatchSuccessfully(self, mock_isfile, mock_isdir): |
| self.assertEqual( |
| patch_manager.GetPathToPatch('/abs/path/to/filesdir', |
| 'cherry/fixes_stdout.patch'), |
| '/abs/path/to/filesdir/cherry/fixes_stdout.patch') |
| |
| mock_isdir.assert_called_once() |
| |
| mock_isfile.assert_called_once() |
| |
| def testSuccessfullyGetPatchMetadataForPatchWithNoMetadata(self): |
| expected_patch_metadata = 0, None, False |
| |
| test_patch = { |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_stdout.patch" |
| } |
| |
| self.assertEqual( |
| patch_manager.GetPatchMetadata(test_patch), expected_patch_metadata) |
| |
| def testSuccessfullyGetPatchMetdataForPatchWithSomeMetadata(self): |
| expected_patch_metadata = 0, 1000, False |
| |
| test_patch = { |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_stdout.patch", |
| "end_version": 1000 |
| } |
| |
| self.assertEqual( |
| patch_manager.GetPatchMetadata(test_patch), expected_patch_metadata) |
| |
| def testFailedToApplyPatchWhenInvalidSrcPathIsPassedIn(self): |
| # Verify the exception is raised when the absolute path to the unpacked |
| # sources of a package is not a directory. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.ApplyPatch( |
| '/abs/path/to/src', '/abs/path/to/filesdir/cherry/fixes_stdout.patch') |
| |
| self.assertEqual(err.exception.message, |
| 'Invalid src path provided: /abs/path/to/src') |
| |
| # Simulate behavior of 'os.path.isdir()' when the absolute path to the |
| # unpacked sources of the package is valid and exists. |
| @mock.patch.object(os.path, 'isdir', return_value=True) |
| def testFailedToApplyPatchWhenPatchPathIsInvalid(self, mock_isdir): |
| # Verify the exception is raised when the absolute path to the patch does |
| # not exist or is not a file. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.ApplyPatch( |
| '/abs/path/to/src', '/abs/path/to/filesdir/cherry/fixes_stdout.patch') |
| |
| self.assertEqual( |
| err.exception.message, 'Invalid patch file provided: ' |
| '/abs/path/to/filesdir/cherry/fixes_stdout.patch') |
| |
| mock_isdir.assert_called_once() |
| |
| # Simulate behavior of 'os.path.isdir()' when the absolute path to the |
| # unpacked sources of the package is valid and exists. |
| @mock.patch.object(os.path, 'isdir', return_value=True) |
| @mock.patch.object(os.path, 'isfile', return_value=True) |
| # Simulate behavior of 'os.path.isfile()' when the absolute path to the |
| # patch exists and is a file. |
| @mock.patch.object(subprocess, 'check_output') |
| def testFailedToApplyPatchInDryRun(self, mock_dry_run, mock_isfile, |
| mock_isdir): |
| |
| # Simulate behavior of 'subprocess.check_output()' when '--dry-run' |
| # fails on the applying patch. |
| def FailedToApplyPatch(test_patch_cmd): |
| # First argument is the return error code, the second argument is the |
| # command that was run, and the third argument is the output. |
| raise subprocess.CalledProcessError(1, test_patch_cmd, None) |
| |
| mock_dry_run.side_effect = FailedToApplyPatch |
| |
| self.assertEqual( |
| patch_manager.ApplyPatch( |
| '/abs/path/to/src', '/abs/path/to/filesdir/cherry/' |
| 'fixes_stdout.patch'), False) |
| |
| mock_isdir.assert_called_once() |
| |
| mock_isfile.assert_called_once() |
| |
| mock_dry_run.assert_called_once() |
| |
| # Simulate behavior of 'os.path.isdir()' when the absolute path to the |
| # unpacked sources of the package is valid and exists. |
| @mock.patch.object(os.path, 'isdir', return_value=True) |
| @mock.patch.object(os.path, 'isfile', return_value=True) |
| # Simulate behavior of 'os.path.isfile()' when the absolute path to the |
| # patch exists and is a file. |
| @mock.patch.object(subprocess, 'check_output') |
| def testSuccessfullyAppliedPatch(self, mock_dry_run, mock_isfile, mock_isdir): |
| |
| self.assertEqual( |
| patch_manager.ApplyPatch( |
| '/abs/path/to/src', '/abs/path/to/filesdir/cherry/' |
| 'fixes_stdout.patch'), True) |
| |
| mock_isdir.assert_called_once() |
| |
| mock_isfile.assert_called_once() |
| |
| self.assertEqual(mock_dry_run.call_count, 2) |
| |
| def testFailedToUpdatePatchMetadataFileWhenPatchFileNotEndInJson(self): |
| patch = [{ |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 10 |
| }] |
| |
| # Verify the exception is raised when the absolute path to the patch |
| # metadata file does not end in '.json'. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.UpdatePatchMetadataFile('/abs/path/to/filesdir/PATCHES', |
| patch) |
| |
| self.assertEqual( |
| err.exception.message, 'File does not end in \'.json\': ' |
| '/abs/path/to/filesdir/PATCHES') |
| |
| def testSuccessfullyUpdatedPatchMetadataFile(self): |
| test_updated_patch_metadata = [{ |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 10 |
| }] |
| |
| expected_patch_metadata = { |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 10 |
| } |
| |
| with CreateTemporaryJsonFile() as json_test_file: |
| patch_manager.UpdatePatchMetadataFile(json_test_file, |
| test_updated_patch_metadata) |
| |
| # Make sure the updated patch metadata was written into the temporary |
| # .json file. |
| with open(json_test_file) as patch_file: |
| patch_contents = patch_manager._ConvertToASCII(json.load(patch_file)) |
| |
| self.assertEqual(len(patch_contents), 1) |
| |
| self.assertDictEqual(patch_contents[0], expected_patch_metadata) |
| |
| @mock.patch.object(patch_manager, 'GetPathToPatch') |
| def testExceptionThrownWhenHandlingPatches(self, mock_get_path_to_patch): |
| # Simulate behavior of 'GetPathToPatch()' when the absolute path to the |
| # patch does not exist. |
| def PathToPatchDoesNotExist(filesdir_path, rel_patch_path): |
| raise ValueError('The absolute path to /abs/path/to/filesdir/cherry/' |
| 'fix_output.patch does not exist') |
| |
| # Use the test function to simulate the behavior of 'GetPathToPatch()'. |
| mock_get_path_to_patch.side_effect = PathToPatchDoesNotExist |
| |
| test_patch_metadata = [{ |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 10 |
| }] |
| |
| with CreateTemporaryJsonFile() as json_test_file: |
| # Write the test patch metadata to the temporary .json file. |
| with open(json_test_file, 'w') as json_file: |
| WritePrettyJsonFile(test_patch_metadata, json_file) |
| |
| # Verify the exception is raised when the absolute path to a patch does |
| # not exist. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.HandlePatches(1000, json_test_file, |
| '/abs/path/to/filesdir', |
| '/some/path/to/src', FailureModes.FAIL) |
| |
| self.assertEqual( |
| err.exception.message, |
| 'The absolute path to /abs/path/to/filesdir/cherry/' |
| 'fix_output.patch does not exist') |
| |
| mock_get_path_to_patch.assert_called_once_with('/abs/path/to/filesdir', |
| 'cherry/fixes_output.patch') |
| |
| @mock.patch.object(patch_manager, 'GetPathToPatch') |
| # Simulate behavior for 'ApplyPatch()' when an applicable patch failed to |
| # apply. |
| @mock.patch.object(patch_manager, 'ApplyPatch', return_value=False) |
| def testExceptionThrownOnAFailedPatchInFailMode(self, mock_apply_patch, |
| mock_get_path_to_patch): |
| # Simulate behavior for 'GetPathToPatch()' when successfully constructed the |
| # absolute path to the patch and the patch exists. |
| mock_get_path_to_patch.return_value = ('/abs/path/to/filesdir/cherry/' |
| 'fixes_output.patch') |
| |
| test_patch_metadata = [{ |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 1000 |
| }] |
| |
| with CreateTemporaryJsonFile() as json_test_file: |
| # Write the test patch metadata to the temporary .json file. |
| with open(json_test_file, 'w') as json_file: |
| WritePrettyJsonFile(test_patch_metadata, json_file) |
| |
| # Verify the exception is raised when the mode is 'fail' and an applicable |
| # patch fails to apply. |
| with self.assertRaises(ValueError) as err: |
| patch_manager.HandlePatches(1000, json_test_file, |
| '/abs/path/to/filesdir', |
| '/some/path/to/src', FailureModes.FAIL) |
| |
| self.assertEqual(err.exception.message, |
| 'Failed to apply patch: fixes_output.patch') |
| |
| mock_get_path_to_patch.assert_called_once_with('/abs/path/to/filesdir', |
| 'cherry/fixes_output.patch') |
| |
| mock_apply_patch.assert_called_once_with( |
| '/some/path/to/src', '/abs/path/to/filesdir/cherry/' |
| 'fixes_output.patch') |
| |
| @mock.patch.object(patch_manager, 'GetPathToPatch') |
| @mock.patch.object(patch_manager, 'ApplyPatch') |
| def testSomePatchesFailedToApplyInContinueMode(self, mock_apply_patch, |
| mock_get_path_to_patch): |
| # Simulate behavior for 'GetPathToPatch()' when successfully constructed the |
| # absolute path to the patch and the patch exists. |
| @CallCountsToMockFunctions |
| def MultipleCallsToGetPatchPath(call_count, filesdir_path, rel_patch_path): |
| # First patch to call 'GetPathToPatch()'. |
| if call_count == 0: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'cherry/fixes_output.patch') |
| |
| return '/abs/path/to/filesdir/cherry/fixes_output.patch' |
| |
| # Second patch to call 'GetPathToPatch()'. |
| if call_count == 1: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'cherry/fixes_input.patch') |
| |
| return '/abs/path/to/filesdir/cherry/fixes_input.patch' |
| |
| # Third patch to call 'GetPathToPatch()'. |
| if call_count == 2: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'add_warning.patch') |
| |
| return '/abs/path/to/filesdir/add_warning.patch' |
| |
| # Fourth (and last) patch to call 'GetPathToPatch()'. |
| if call_count == 3: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'add_helper.patch') |
| |
| return '/abs/path/to/filesdir/add_helper.patch' |
| |
| # 'GetPathToPatch()' was called more times than expected (4 times). |
| assert False, 'Unexpectedly called more than 4 times.' |
| |
| # Simulate behavior for 'ApplyPatch()' when applying multiple applicable |
| # patches. |
| @CallCountsToMockFunctions |
| def MultipleCallsToApplyPatches(call_count, src_path, path_to_patch): |
| # First applicable patch that tries to apply patch. |
| if call_count == 0: |
| self.assertEqual(path_to_patch, |
| '/abs/path/to/filesdir/cherry/fixes_output.patch') |
| |
| return True |
| |
| # Second applicable patch that tries to apply patch. |
| if call_count == 1: |
| self.assertEqual(path_to_patch, |
| '/abs/path/to/filesdir/cherry/fixes_input.patch') |
| |
| return False |
| |
| # Third applicable patch that tries to apply patch. |
| if call_count == 2: |
| self.assertEqual(path_to_patch, |
| '/abs/path/to/filesdir/add_warning.patch') |
| |
| return False |
| |
| # 'ApplyPatch()' was called more times than expected (3 times). |
| assert False, 'Unexpectedly called more than 3 times.' |
| |
| # Use test functions to simulate behavior. |
| mock_get_path_to_patch.side_effect = MultipleCallsToGetPatchPath |
| mock_apply_patch.side_effect = MultipleCallsToApplyPatches |
| |
| test_patch_1 = { |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 1000, |
| "end_version": 1250 |
| } |
| |
| test_patch_2 = { |
| "comment": "Fixes input", |
| "rel_patch_path": "cherry/fixes_input.patch", |
| "start_version": 1000 |
| } |
| |
| test_patch_3 = { |
| "comment": "Adds a warning", |
| "rel_patch_path": "add_warning.patch", |
| "start_version": 750, |
| "end_version": 1500 |
| } |
| |
| test_patch_4 = { |
| "comment": "Adds a helper function", |
| "rel_patch_path": "add_helper.patch", |
| "start_version": 20, |
| "end_version": 900 |
| } |
| |
| test_patch_metadata = [ |
| test_patch_1, test_patch_2, test_patch_3, test_patch_4 |
| ] |
| |
| expected_applied_patches = ['fixes_output.patch'] |
| expected_failed_patches = ['fixes_input.patch', 'add_warning.patch'] |
| expected_non_applicable_patches = ['add_helper.patch'] |
| |
| expected_patch_info_dict = { |
| 'applied_patches': expected_applied_patches, |
| 'failed_patches': expected_failed_patches, |
| 'non_applicable_patches': expected_non_applicable_patches, |
| 'disabled_patches': [], |
| 'removed_patches': [], |
| 'modified_metadata': None |
| } |
| |
| with CreateTemporaryJsonFile() as json_test_file: |
| # Write the test patch metadata to the temporary .json file. |
| with open(json_test_file, 'w') as json_file: |
| WritePrettyJsonFile(test_patch_metadata, json_file) |
| |
| patch_info = patch_manager.HandlePatches( |
| 1000, json_test_file, '/abs/path/to/filesdir', '/some/path/to/src', |
| FailureModes.CONTINUE) |
| |
| self.assertDictEqual(patch_info._asdict(), expected_patch_info_dict) |
| |
| self.assertEqual(mock_get_path_to_patch.call_count, 4) |
| |
| self.assertEqual(mock_apply_patch.call_count, 3) |
| |
| @mock.patch.object(patch_manager, 'GetPathToPatch') |
| @mock.patch.object(patch_manager, 'ApplyPatch') |
| def testSomePatchesAreDisabled(self, mock_apply_patch, |
| mock_get_path_to_patch): |
| # Simulate behavior for 'GetPathToPatch()' when successfully constructed the |
| # absolute path to the patch and the patch exists. |
| @CallCountsToMockFunctions |
| def MultipleCallsToGetPatchPath(call_count, filesdir_path, rel_patch_path): |
| # First patch to call 'GetPathToPatch()'. |
| if call_count == 0: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'cherry/fixes_output.patch') |
| |
| return '/abs/path/to/filesdir/cherry/fixes_output.patch' |
| |
| # Second patch to call 'GetPathToPatch()'. |
| if call_count == 1: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'cherry/fixes_input.patch') |
| |
| return '/abs/path/to/filesdir/cherry/fixes_input.patch' |
| |
| # Third patch to call 'GetPathToPatch()'. |
| if call_count == 2: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'add_warning.patch') |
| |
| return '/abs/path/to/filesdir/add_warning.patch' |
| |
| # Fourth (and last) patch to call 'GetPathToPatch()'. |
| if call_count == 3: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'add_helper.patch') |
| |
| return '/abs/path/to/filesdir/add_helper.patch' |
| |
| # 'GetPathToPatch()' was called more times than expected (4 times). |
| assert False, 'Unexpectedly called more than 4 times.' |
| |
| # Simulate behavior for 'ApplyPatch()' when applying multiple applicable |
| # patches. |
| @CallCountsToMockFunctions |
| def MultipleCallsToApplyPatches(call_count, src_path, path_to_patch): |
| # First applicable patch that tries to apply patch. |
| if call_count == 0: |
| self.assertEqual(path_to_patch, |
| '/abs/path/to/filesdir/cherry/fixes_input.patch') |
| |
| return False |
| |
| # Second applicable patch that tries to apply patch. |
| if call_count == 1: |
| self.assertEqual(path_to_patch, |
| '/abs/path/to/filesdir/add_warning.patch') |
| |
| return True |
| |
| # Third applicable patch that tries to apply patch. |
| if call_count == 2: |
| self.assertEqual(path_to_patch, |
| '/abs/path/to/filesdir/add_helper.patch') |
| |
| return False |
| |
| # 'ApplyPatch()' was called more times than expected (3 times). |
| assert False, 'Unexpectedly called more than 3 times.' |
| |
| # Use test functions to simulate behavior. |
| mock_get_path_to_patch.side_effect = MultipleCallsToGetPatchPath |
| mock_apply_patch.side_effect = MultipleCallsToApplyPatches |
| |
| test_patch_1 = { |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 1000, |
| "end_version": 1190 |
| } |
| |
| test_patch_2 = { |
| "comment": "Fixes input", |
| "rel_patch_path": "cherry/fixes_input.patch", |
| "start_version": 1000 |
| } |
| |
| test_patch_3 = { |
| "comment": "Adds a warning", |
| "rel_patch_path": "add_warning.patch", |
| "start_version": 750, |
| "end_version": 1500 |
| } |
| |
| test_patch_4 = { |
| "comment": "Adds a helper function", |
| "rel_patch_path": "add_helper.patch", |
| "start_version": 20, |
| "end_version": 2000 |
| } |
| |
| test_patch_metadata = [ |
| test_patch_1, test_patch_2, test_patch_3, test_patch_4 |
| ] |
| |
| expected_applied_patches = ['add_warning.patch'] |
| expected_failed_patches = ['fixes_input.patch', 'add_helper.patch'] |
| expected_disabled_patches = ['fixes_input.patch', 'add_helper.patch'] |
| expected_non_applicable_patches = ['fixes_output.patch'] |
| |
| # Assigned 'None' for now, but it is expected that the patch metadata file |
| # will be modified, so the 'expected_patch_info_dict's' value for the |
| # key 'modified_metadata' will get updated to the temporary .json file once |
| # the file is created. |
| expected_modified_metadata_file = None |
| |
| expected_patch_info_dict = { |
| 'applied_patches': expected_applied_patches, |
| 'failed_patches': expected_failed_patches, |
| 'non_applicable_patches': expected_non_applicable_patches, |
| 'disabled_patches': expected_disabled_patches, |
| 'removed_patches': [], |
| 'modified_metadata': expected_modified_metadata_file |
| } |
| |
| with CreateTemporaryJsonFile() as json_test_file: |
| # Write the test patch metadata to the temporary .json file. |
| with open(json_test_file, 'w') as json_file: |
| WritePrettyJsonFile(test_patch_metadata, json_file) |
| |
| expected_patch_info_dict['modified_metadata'] = json_test_file |
| |
| patch_info = patch_manager.HandlePatches( |
| 1200, json_test_file, '/abs/path/to/filesdir', '/some/path/to/src', |
| FailureModes.DISABLE_PATCHES) |
| |
| self.assertDictEqual(patch_info._asdict(), expected_patch_info_dict) |
| |
| # 'test_patch_1' and 'test_patch_3' were not modified/disabled, so their |
| # dictionary is the same, but 'test_patch_2' and 'test_patch_4' were |
| # disabled, so their 'end_version' would be set to 1200, which was the |
| # value passed into 'HandlePatches()' for the 'svn_version'. |
| test_patch_2['end_version'] = 1200 |
| test_patch_4['end_version'] = 1200 |
| |
| expected_json_file = [ |
| test_patch_1, test_patch_2, test_patch_3, test_patch_4 |
| ] |
| |
| # Make sure the updated patch metadata was written into the temporary |
| # .json file. |
| with open(json_test_file) as patch_file: |
| new_json_file_contents = patch_manager._ConvertToASCII( |
| json.load(patch_file)) |
| |
| self.assertEqual(len(new_json_file_contents), 4) |
| |
| for i in range(4): |
| self.assertDictEqual(new_json_file_contents[i], expected_json_file[i]) |
| |
| self.assertEqual(mock_get_path_to_patch.call_count, 4) |
| |
| self.assertEqual(mock_apply_patch.call_count, 3) |
| |
| @mock.patch.object(patch_manager, 'GetPathToPatch') |
| @mock.patch.object(patch_manager, 'ApplyPatch') |
| def testSomePatchesAreRemoved(self, mock_apply_patch, mock_get_path_to_patch): |
| # Simulate behavior for 'GetPathToPatch()' when successfully constructed the |
| # absolute path to the patch and the patch exists. |
| @CallCountsToMockFunctions |
| def MultipleCallsToGetPatchPath(call_count, filesdir_path, rel_patch_path): |
| # First patch to call 'GetPathToPatch()'. |
| if call_count == 0: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'cherry/fixes_output.patch') |
| |
| return '/abs/path/to/filesdir/cherry/fixes_output.patch' |
| |
| # Second patch to call 'GetPathToPatch()'. |
| if call_count == 1: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'cherry/fixes_input.patch') |
| |
| return '/abs/path/to/filesdir/cherry/fixes_input.patch' |
| |
| # Third patch to call 'GetPathToPatch()'. |
| if call_count == 2: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'add_warning.patch') |
| |
| return '/abs/path/to/filesdir/add_warning.patch' |
| |
| # Fourth (and last) patch to call 'GetPathToPatch()'. |
| if call_count == 3: |
| self.assertEqual(filesdir_path, '/abs/path/to/filesdir') |
| self.assertEqual(rel_patch_path, 'add_helper.patch') |
| |
| return '/abs/path/to/filesdir/add_helper.patch' |
| |
| # 'GetPathToPatch()' was called more times than expected (4 times). |
| assert False, 'Unexpectedly called more than 4 times.' |
| |
| # Use the test function to simulate behavior of 'GetPathToPatch()'. |
| mock_get_path_to_patch.side_effect = MultipleCallsToGetPatchPath |
| |
| # For the 'remove_patches' mode, this patch is expected to be in the |
| # 'non_applicable_patches' list and 'removed_patches' list because |
| # the 'svn_version' (1500) >= 'end_version' (1190). |
| test_patch_1 = { |
| "comment": "Redirects output to stdout", |
| "rel_patch_path": "cherry/fixes_output.patch", |
| "start_version": 1000, |
| "end_version": 1190 |
| } |
| |
| # For the 'remove_patches' mode, this patch is expected to be in the |
| # 'applicable_patches' list (which is the list that the .json file will be |
| # updated with) because the 'svn_version' < 'inf' (this patch does not have |
| # an 'end_version' value which implies 'end_version' == 'inf'). |
| test_patch_2 = { |
| "comment": "Fixes input", |
| "rel_patch_path": "cherry/fixes_input.patch", |
| "start_version": 1000 |
| } |
| |
| # For the 'remove_patches' mode, this patch is expected to be in the |
| # 'non_applicable_patches' list and 'removed_patches' list because |
| # the 'svn_version' (1500) >= 'end_version' (1500). |
| test_patch_3 = { |
| "comment": "Adds a warning", |
| "rel_patch_path": "add_warning.patch", |
| "start_version": 750, |
| "end_version": 1500 |
| } |
| |
| # For the 'remove_patches' mode, this patch is expected to be in the |
| # 'non_applicable_patches' list and 'removed_patches' list because |
| # the 'svn_version' (1500) >= 'end_version' (1400). |
| test_patch_4 = { |
| "comment": "Adds a helper function", |
| "rel_patch_path": "add_helper.patch", |
| "start_version": 20, |
| "end_version": 1400 |
| } |
| |
| test_patch_metadata = [ |
| test_patch_1, test_patch_2, test_patch_3, test_patch_4 |
| ] |
| |
| expected_applied_patches = [] |
| expected_failed_patches = [] |
| expected_disabled_patches = [] |
| expected_non_applicable_patches = [ |
| 'fixes_output.patch', 'add_warning.patch', 'add_helper.patch' |
| ] |
| expected_removed_patches = [ |
| '/abs/path/to/filesdir/cherry/fixes_output.patch', |
| '/abs/path/to/filesdir/add_warning.patch', |
| '/abs/path/to/filesdir/add_helper.patch' |
| ] |
| |
| # Assigned 'None' for now, but it is expected that the patch metadata file |
| # will be modified, so the 'expected_patch_info_dict's' value for the |
| # key 'modified_metadata' will get updated to the temporary .json file once |
| # the file is created. |
| expected_modified_metadata_file = None |
| |
| expected_patch_info_dict = { |
| 'applied_patches': expected_applied_patches, |
| 'failed_patches': expected_failed_patches, |
| 'non_applicable_patches': expected_non_applicable_patches, |
| 'disabled_patches': expected_disabled_patches, |
| 'removed_patches': expected_removed_patches, |
| 'modified_metadata': expected_modified_metadata_file |
| } |
| |
| with CreateTemporaryJsonFile() as json_test_file: |
| # Write the test patch metadata to the temporary .json file. |
| with open(json_test_file, 'w') as json_file: |
| WritePrettyJsonFile(test_patch_metadata, json_file) |
| |
| expected_patch_info_dict['modified_metadata'] = json_test_file |
| |
| patch_info = patch_manager.HandlePatches( |
| 1500, json_test_file, '/abs/path/to/filesdir', '/some/path/to/src', |
| FailureModes.REMOVE_PATCHES) |
| |
| self.assertDictEqual(patch_info._asdict(), expected_patch_info_dict) |
| |
| # 'test_patch_2' was an applicable patch, so this patch will be the only |
| # patch that is in temporary .json file. The other patches were not |
| # applicable (they failed the applicable check), so they will not be in |
| # the .json file. |
| expected_json_file = [test_patch_2] |
| |
| # Make sure the updated patch metadata was written into the temporary |
| # .json file. |
| with open(json_test_file) as patch_file: |
| new_json_file_contents = patch_manager._ConvertToASCII( |
| json.load(patch_file)) |
| |
| self.assertEqual(len(new_json_file_contents), 1) |
| |
| self.assertDictEqual(new_json_file_contents[0], expected_json_file[0]) |
| |
| self.assertEqual(mock_get_path_to_patch.call_count, 4) |
| |
| mock_apply_patch.assert_not_called() |
| |
| |
| if __name__ == '__main__': |
| unittest.main() |