Method get_compare_against

modules/handler.py:226–242

Return the compare target for a view. If interactivly specified a compare target for the view's repository, use it first, then try view's settings, which includes project settings and preferences. Finally try GitGutter.sublime-settings or fall back to HEAD if everyth

(self)

            os.path.join(self._git_tree, '.git', 'rebase-merge'))

    def get_compare_against(self):
        """Return the compare target for a view.

        If interactivly specified a compare target for the view's repository,
        use it first, then try view's settings, which includes project
        settings and preferences. Finally try GitGutter.sublime-settings or
        fall back to HEAD if everything goes wrong to avoid exceptions.

        Returns:
            string: HEAD/branch/tag/remote/commit
                The reference to compare the view against.
        """
        # Interactively specified compare target overrides settings.
        if self._git_tree in self._compare_against_mapping:
            return self._compare_against_mapping[self._git_tree]
        # Project settings and Preferences override plugin settings if set.
        return self.settings.get('compare_against', 'HEAD')

    def set_compare_against(self, compare_against, refresh=False):
        """Apply a new branch/commit/tag string the view is compared to.