vcs/git: Add GitIgnoreBear

Closes coala#2610

bears/vcs/git/GitIgnoreBear.py

@@ -0,0 +1,36 @@
+import shutil
+
+from coalib.bears.GlobalBear import GlobalBear
+from coalib.misc.Shell import run_shell_command
+
+
+class GitIgnoreBear(GlobalBear):
+    AUTHORS = {'The coala developers'}
+    AUTHORS_EMAILS = {'[email protected]'}
+    LICENSE = 'AGPL-3.0'
+    CAN_DETECT = {'Formatting'}
+
+    @classmethod
+    def check_prerequisites(cls):
+        if shutil.which('git') is None:
+            return 'git is not installed.'
+        else:
+            return True
+
+    @staticmethod
+    def get_ignored_files():
+        files, _ = run_shell_command("git ls-files")
+        files = files.strip().split('\n')
+        ignored = list(map(
+            lambda file: run_shell_command("git check-ignore --no-index -v {}".format(file))[0].strip(), files
+        ))
+        return list(filter(lambda f: f != '', ignored))
+
+    def run(self):
+        for line in GitIgnoreBear.get_ignored_files():
+            pattern, filename = line.split('\t')
+            ignore_filename, line_number, ignore_regex = pattern.split(':')
+            yield self.new_result(
+                message="File {} is being tracked which was ignored in line number {} in file {}.".format(
+                    filename, line_number, filename),
+                file=filename)

tests/vcs/git/GitIgnoreBearTest.py

@@ -0,0 +1,118 @@
+import os
+import platform
+import shutil
+import stat
+import unittest
+import unittest.mock
+from queue import Queue
+from tempfile import mkdtemp, NamedTemporaryFile
+from pathlib import Path
+
+from coalib.testing.BearTestHelper import generate_skip_decorator
+from bears.vcs.git.GitCommitBear import GitCommitBear
+from coala_utils.string_processing.Core import escape
+from coalib.misc.Shell import run_shell_command
+from coalib.settings.ConfigurationGathering import get_config_directory
+from coalib.settings.Section import Section
+from coalib.settings.Setting import Setting
+
+
+@generate_skip_decorator(GitCommitBear)
+class GitCommitBearTest(unittest.TestCase):
+
+    @staticmethod
+    def run_git_command(*args, stdin=None):
+        run_shell_command(' '.join(('git',) + args), stdin)
+
+    # @staticmethod
+    # def git_commit(msg):
+    #     # Use stdin mode from git, since -m on Windows cmd does not support
+    #     # multiline messages.
+    #     GitCommitBearTest.run_git_command('commit',
+    #                                       '--allow-empty',
+    #                                       '--allow-empty-message',
+    #                                       '--file=-',
+    #                                       stdin=msg)
+
+    def run_uut(self, *args, **kwargs):
+        """
+        Runs the unit-under-test (via `self.uut.run()`) and collects the
+        messages of the yielded results as a list.
+
+        :param args:   Positional arguments to forward to the run function.
+        :param kwargs: Keyword arguments to forward to the run function.
+        :return:       A list of the message strings.
+        """
+        return list(result.message for result in self.uut.run(*args, **kwargs))
+
+    def assert_no_msgs(self):
+        """
+        Assert that there are no messages in the message queue of the bear, and
+        show the messages in the failure messgae if it is not empty.
+        """
+        self.assertTrue(
+            self.msg_queue.empty(),
+            'Expected no messages in bear message queue, but got: ' +
+            str(list(str(i) for i in self.msg_queue.queue)))
+
+    def setUp(self):
+        self.msg_queue = Queue()
+        self.section = Section('')
+        self.uut = GitIgnoreBear(None, self.section, self.msg_queue)
+
+        self._old_cwd = os.getcwd()
+        self.gitdir = mkdtemp()
+        os.chdir(self.gitdir)
+        self.run_git_command('init')
+        self.run_git_command('config', 'user.email [email protected]')
+        self.run_git_command('config', 'user.name coala')
+
+    @staticmethod
+    def _windows_rmtree_remove_readonly(func, path, excinfo):
+        os.chmod(path, stat.S_IWRITE)
+        func(path)
+
+    def tearDown(self):
+        os.chdir(self._old_cwd)
+        if platform.system() == 'Windows':
+            onerror = self._windows_rmtree_remove_readonly
+        else:
+            onerror = None
+        shutil.rmtree(self.gitdir, onerror=onerror)
+
+    def test_no_tracked_files(self):
+        self.assertEqual(self.run_uut(),[])
+        self.assert_no_msgs()
+
+    def test_no_gitignore_file(self):
+        file = open('test_file.txt', 'w')
+        file.close()
+        self.run_git_command('add', 'test_file.txt')
+
+        self.assertEqual(self.run_uut(),[])
+        self.assert_no_msgs()
+
+    def test_already_tracked_file(self):
+        file = open('test_file.txt', 'w')
+        file.close()
+        self.run_git_command('add', 'test_file.txt')
+
+        file = open('.gitignore', 'w')
+        file.write("test_file.txt")
+        file.close()
+
+        self.run_git_command('add', '.gitignore')
+        self.assertEqual(self.run_uut(),[])
+        self.assert_no_msgs()
+
+    def test_untracked_file(self):
+        file = open('test_file.txt', 'w')
+        file.close()
+
+        file = open('.gitignore', 'w')
+        file.write("test_file.txt")
+        file.close()
+
+        self.run_git_command('add', '.gitignore')
+        self.assertEqual(self.run_uut(),[])
+        self.assert_no_msgs()