Rope Refactoring: RefactoringRope/Refactoring.py@3be1b4662b48

# -*- coding: utf-8 -*-

# Copyright (c) 2011 Detlev Offenbach <detlev@die-offenbachs.de>
#

"""
Module implementing the refactoring interface to rope.
"""

import os
import sys

sys.path.insert(0, os.path.dirname(__file__))
import rope
import rope.base.libutils
import rope.base.project
import rope.base.exceptions

import rope.refactor.rename
##import rope.refactor.extract
##import rope.refactor.usefunction
##import rope.refactor.inline
##import rope.refactor.move
##import rope.refactor.change_signature
##import rope.refactor.introduce_factory
##import rope.refactor.introduce_parameter
##import rope.refactor.method_object
##import rope.refactor.encapsulate_field
##import rope.refactor.localtofield
##import rope.refactor.topackage
##from rope.refactor.importutils import ImportOrganizer

import rope.contrib.findit
##import rope.contrib.finderrors

from PyQt4.QtCore import QObject, SIGNAL
from PyQt4.QtGui import QMenu, QApplication, QMessageBox

from E5Gui.E5Application import e5App

from E5Gui import E5MessageBox
from E5Gui.E5Action import E5Action

from QScintilla.MiniEditor import MiniEditor

from FileSystemCommands import e5FileSystemCommands
from ProgressHandle import ProgressHandle
from HelpDialog import HelpDialog
from MatchesDialog import MatchesDialog
from RenameDialog import RenameDialog
from ChangeOccurrencesDialog import ChangeOccurrencesDialog

import Utilities


class Refactoring(QObject):
    """
    Class implementing the refactoring interface to rope.
    """
    def __init__(self, plugin, newStyle, parent=None):
        """
        Constructor

        @param plugin reference to the plugin object
        @param newStyle flag indicating usage of new style signals (bool)
        @param parent parent (QObject)
        """
        QObject.__init__(self, parent)

        self.__plugin = plugin
        self.__newStyle = newStyle
        self.__ui = parent
        self.__e5project = e5App().getObject("Project")
        self.__projectpath = ''
        self.__projectLanguage = ""
        self.__projectopen = False

        self.__mainMenu = None
        self.__helpDialog = None

        # Rope objects
        self.__project = None
        self.__fsCommands = e5FileSystemCommands(self.__e5project)

    def initActions(self):
        """
        Public method to define the refactoring actions.
        """
        self.actions = []

        #####################################################
        ## Rename refactoring actions
        #####################################################

        self.refactoringRenameAct = E5Action(self.trUtf8('Rename'),
                self.trUtf8('&Rename'),
                0, 0,
                self,'refactoring_rename')
        self.refactoringRenameAct.setStatusTip(self.trUtf8(
            'Rename the highlighted object'))
        self.refactoringRenameAct.setWhatsThis(self.trUtf8(
            """<b>Rename</b>"""
            """<p>Rename the highlighted Python object.</p>"""
        ))
        if self.__newStyle:
            self.refactoringRenameAct.triggered[()].connect(
                self.__rename)
        else:
            self.connect(self.refactoringRenameAct, SIGNAL('triggered()'),
                self.__rename)
        self.actions.append(self.refactoringRenameAct)

        self.refactoringRenameLocalAct = E5Action(self.trUtf8('Local Rename'),
                self.trUtf8('&Local Rename'),
                0, 0,
                self,'refactoring_rename_local')
        self.refactoringRenameLocalAct.setStatusTip(self.trUtf8(
            'Rename the highlighted object in the current module only'))
        self.refactoringRenameLocalAct.setWhatsThis(self.trUtf8(
            """<b>Local Rename</b>"""
            """<p>Rename the highlighted Python object in the current"""
            """ module only.</p>"""
        ))
        if self.__newStyle:
            self.refactoringRenameLocalAct.triggered[()].connect(
                self.__renameLocal)
        else:
            self.connect(self.refactoringRenameLocalAct,
                SIGNAL('triggered()'), self.__renameLocal)
        self.actions.append(self.refactoringRenameLocalAct)

        self.refactoringRenameModuleAct = E5Action(
                self.trUtf8('Rename Current Module'),
                self.trUtf8('Rename Current Module'),
                0, 0,
                self,'refactoring_rename_module')
        self.refactoringRenameModuleAct.setStatusTip(self.trUtf8(
            'Rename the current module'))
        self.refactoringRenameModuleAct.setWhatsThis(self.trUtf8(
            """<b>Rename Current Module</b>"""
            """<p>Rename the current module.</p>"""
        ))
        if self.__newStyle:
            self.refactoringRenameModuleAct.triggered[()].connect(
                self.__renameModule)
        else:
            self.connect(self.refactoringRenameModuleAct,
                SIGNAL('triggered()'), self.__renameModule)
        self.actions.append(self.refactoringRenameModuleAct)

        self.refactoringChangeOccurrencesAct = E5Action(
                self.trUtf8('Change Occurrences'),
                self.trUtf8('Change &Occurrences'),
                0, 0,
                self,'refactoring_change_occurrences')
        self.refactoringChangeOccurrencesAct.setStatusTip(self.trUtf8(
            'Change all occurrences in the local scope'))
        self.refactoringChangeOccurrencesAct.setWhatsThis(self.trUtf8(
            """<b>Change Occurrences</b>"""
            """<p>Change all occurrences in the local scope.</p>"""
        ))
        if self.__newStyle:
            self.refactoringChangeOccurrencesAct.triggered[()].connect(
                self.__changeOccurrences)
        else:
            self.connect(self.refactoringChangeOccurrencesAct,
                SIGNAL('triggered()'), self.__changeOccurrences)
        self.actions.append(self.refactoringChangeOccurrencesAct)

        #####################################################
        ## Query actions
        #####################################################

        self.queryReferencesAct = E5Action(self.trUtf8('Find occurrences'),
                self.trUtf8('Find &Occurrences'),
                0, 0,
                self,'refactoring_find_occurrences')
        self.queryReferencesAct.setStatusTip(self.trUtf8(
            'Find occurrences of the highlighted object'))
        self.queryReferencesAct.setWhatsThis(self.trUtf8(
            """<b>Find occurrences</b>"""
            """<p>Find occurrences of the highlighted class, method,"""
            """ function or variable.</p>"""
        ))
        if self.__newStyle:
            self.queryReferencesAct.triggered[()].connect(
                self.__queryReferences)
        else:
            self.connect(self.queryReferencesAct, SIGNAL('triggered()'),
                self.__queryReferences)
        self.actions.append(self.queryReferencesAct)

        self.queryDefinitionAct = E5Action(self.trUtf8('Find definition'),
                self.trUtf8('Find &Definition'),
                0, 0,
                self,'refactoring_find_definition')
        self.queryDefinitionAct.setStatusTip(self.trUtf8(
            'Find definition of the highlighted item'))
        self.queryDefinitionAct.setWhatsThis(self.trUtf8(
            """<b>Find definition</b>"""
            """<p>Find the definition of the highlighted class, method,"""
            """ function or variable.</p>"""
        ))
        if self.__newStyle:
            self.queryDefinitionAct.triggered[()].connect(
                self.__queryDefinition)
        else:
            self.connect(self.queryDefinitionAct, SIGNAL('triggered()'),
                self.__queryDefinition)
        self.actions.append(self.queryDefinitionAct)

        self.queryImplementationsAct = E5Action(
                self.trUtf8('Find implementations'),
                self.trUtf8('Find &Implementations'),
                0, 0,
                self,'refactoring_find_implementations')
        self.queryImplementationsAct.setStatusTip(self.trUtf8(
            'Find places where the selected method is overridden'))
        self.queryImplementationsAct.setWhatsThis(self.trUtf8(
            """<b>Find implementations</b>"""
            """<p>Find places where the selected method is overridden.</p>"""
        ))
        if self.__newStyle:
            self.queryImplementationsAct.triggered[()].connect(
                self.__queryImplementations)
        else:
            self.connect(self.queryImplementationsAct, SIGNAL('triggered()'),
                self.__queryImplementations)
        self.actions.append(self.queryImplementationsAct)

        #####################################################
        ## Various actions
        #####################################################

        self.refactoringEditConfigAct = E5Action(self.trUtf8('Configure Rope'),
                self.trUtf8('&Configure Rope'),
                0, 0,
                self,'refactoring_edit_config')
        self.refactoringEditConfigAct.setStatusTip(self.trUtf8(
            'Open the rope configuration file'))
        self.refactoringEditConfigAct.setWhatsThis(self.trUtf8(
            """<b>Configure Rope</b>"""
            """<p>Opens the rope configuration file in an editor.</p>"""
        ))
        if self.__newStyle:
            self.refactoringEditConfigAct.triggered[()].connect(
                self.__editConfig)
        else:
            self.connect(self.refactoringEditConfigAct, SIGNAL('triggered()'),
                self.__editConfig)
        self.actions.append(self.refactoringEditConfigAct)

        self.refactoringHelpAct = E5Action(self.trUtf8('Rope help'),
                self.trUtf8('Rope &Help'),
                0, 0,
                self,'refactoring_help')
        self.refactoringHelpAct.setStatusTip(self.trUtf8(
            'Show help about the rope refactorings'))
        self.refactoringHelpAct.setWhatsThis(self.trUtf8(
            """<b>Rope help</b>"""
            """<p>Show some help text about the rope refactorings.</p>"""
        ))
        if self.__newStyle:
            self.refactoringHelpAct.triggered[()].connect(
                self.__showRopeHelp)
        else:
            self.connect(self.refactoringHelpAct, SIGNAL('triggered()'),
                self.__showRopeHelp)
        self.actions.append(self.refactoringHelpAct)

        for act in self.actions:
            act.setEnabled(False)

    def initMenu(self):
        """
        Public slot to initialize the refactoring menu.

        @return the menu generated (QMenu)
        """
        menu = QMenu(self.trUtf8('&Refactoring'), self.__ui)
        menu.setTearOffEnabled(True)

        act = menu.addAction('rope', self.__ropeInfo)
        font = act.font()
        font.setBold(True)
        act.setFont(font)
        menu.addSeparator()

        smenu = menu.addMenu(self.trUtf8("&Query"))
        smenu.addAction(self.queryReferencesAct)
        smenu.addAction(self.queryDefinitionAct)
        smenu.addAction(self.queryImplementationsAct)

        smenu = menu.addMenu(self.trUtf8("&Refactoring"))
        if self.__newStyle:
            smenu.aboutToShow.connect(self.__showRefactoringMenu)
        else:
            self.connect(smenu, SIGNAL("aboutToShow()"),
                         self.__showRefactoringMenu)
        smenu.addAction(self.refactoringRenameAct)
        smenu.addAction(self.refactoringRenameLocalAct)
        smenu.addAction(self.refactoringChangeOccurrencesAct)
        smenu.addSeparator()
        smenu.addAction(self.refactoringRenameModuleAct)
        smenu.addSeparator()

        menu.addSeparator()
        menu.addAction(self.refactoringEditConfigAct)
        menu.addAction(self.refactoringHelpAct)

        self.__mainMenu = menu
        return menu

    ##################################################################
    ## slots below implement general functionality
    ##################################################################

    def __ropeInfo(self):
        """
        Private slot to show some info about rope.
        """
        E5MessageBox.about(self.__ui,
            self.trUtf8("About rope"),
            self.trUtf8("{0}\nVersion {1}\n\n{2}".format(
                rope.INFO, rope.VERSION, rope.COPYRIGHT)))

    def __canUndo(self):
        """
        Private slot to check, if there are changes to be undone.

        @return flag indicating, that undoable changes are available (boolean)
        """
        return self.__project is not None and \
               len(self.__project.history.undo_list) > 0

    def __canRedo(self):
        """
        Private slot to check, if there are changes to be redone.

        @return flag indicating, that redoable changes are available (boolean)
        """
        return self.__project is not None and \
               len(self.__project.history.redo_list) > 0

    def __getFileUndoList(self, resource):
        """
        Private slot to get a list of undoable changes.

        @param resource file resource to filter against
            (rope.base.resources.File)
        @return list of change objects (list of rope.base.change.Change)
        """
        undoList = []
        for change in self.__project.history.undo_list:
            if resource in change.get_changed_resources():
                undoList.append(change)
        return undoList

    def __getFileRedoList(self, resource):
        """
        Private slot to get a list of redoable changes.

        @param resource file resource to filter against
            (rope.base.resources.File)
        @return list of change objects (list of rope.base.change.Change)
        """
        redoList = []
        for change in self.__project.history.redo_list:
            if resource in change.get_changed_resources():
                redoList.append(change)
        return redoList

    def __canUndoFile(self, resource):
        """
        Private slot to check, if there are undoable changes for a resource.

        @param resource file resource to check against
            (rope.base.resources.File)
        @return flag indicating, that undoable changes are available (boolean)
        """
        return self.__canUndo() and len(self.__getFileUndoList(resource)) > 0

    def __canRedoFile(self, resource):
        """
        Private slot to check, if there are redoable changes for a resource.

        @param resource file resource to check against
            (rope.base.resources.File)
        @return flag indicating, that redoable changes are available (boolean)
        """
        return self.__canRedo() and len(self.__getFileRedoList(resource)) > 0

    def __showRefactoringMenu(self):
        """
        Private slot called before the refactoring menu is shown.
        """
        # TODO: enable these once undo/redo has been implemented
##        self.refactoringUndoAct.setEnabled(self.__canUndo())
##        self.refactoringRedoAct.setEnabled(self.__canRedo())

    def handleRopeError(self, err, title, handle=None):
        """
        Public slot to handle a rope error.

        @param err rope exception object (Exception)
        @param title title to be displayed (string)
        @param handle reference to a taskhandle (ProgressHandle)
        """
        if handle is not None:
            handle.reset()
        if str(type(err)).split()[-1][1:-2].split('.')[-1] == \
                                                    'ModuleSyntaxError':
            res = E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Rope error: {0}").format(str(err)),
                QMessageBox.Ok | QMessageBox.Open)
            if res == QMessageBox.Open:
                e5App().getObject("ViewManager").openSourceFile(
                    os.path.join(self.__e4project.getProjectPath(),
                                 err.filename),
                    err.lineno)
        else:
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Rope error: {0}").format(str(err)))

    ##################################################################
    ## slots below implement the various refactorings
    ##################################################################

    #####################################################
    ## Rename refactorings
    #####################################################

    def __rename(self):
        """
        Private slot to handle the Rename action.
        """
        self.__doRename(self.trUtf8('Rename'))

    def __renameLocal(self):
        """
        Private slot to handle the Local Rename action.
        """
        self.__doRename(self.trUtf8('Local Rename'), isLocal=True)

    def __renameModule(self):
        """
        Private slot to handle the Rename Current Module action.
        """
        self.__doRename(self.trUtf8('Rename Current Module'),
            renameModule=True)

    def __doRename(self, title, isLocal=False, renameModule=False):
        """
        Private method to perform the various renaming refactorings.

        @param title title of the refactoring (string)
        @param isLocal flag indicating to restrict refactoring to
            the local file (boolean)
        @param renameModule flag indicating a module rename refactoring
            (boolean)
        """
        aw = e5App().getObject("ViewManager").activeWindow()

        if aw is None:
            return

        if not renameModule and not aw.hasSelectedText():
            # no selection available
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Highlight the declaration you want to rename"
                    " and try again."))
            return

        if isLocal:
            if not self.confirmBufferIsSaved(aw):
                return
        else:
            if not self.confirmAllBuffersSaved():
                return

        filename = aw.getFileName()
        if renameModule:
            offset = None
        else:
            line, index, line1, index1 = aw.getSelection()
            if line != line1:
                # selection span more than one line
                E5MessageBox.warning(self.__ui, title,
                    self.trUtf8("The selection must not extend beyond"
                                " one line."))
                return
            index = int(index  + (index1 - index) / 2)
            # keep it inside the object
            offset = aw.positionFromLineIndex(line, index)

        resource = rope.base.libutils.path_to_resource(
            self.__project, filename)
        try:
            renamer = rope.refactor.rename.Rename(
                self.__project, resource, offset)
        except Exception as err:
            self.handleRopeError(err, title)
            return

        if isLocal:
            localResource = resource
        else:
            localResource = None
        self.dlg = RenameDialog(self, title, renamer, resource=localResource,
                                parent=self.__ui)
        self.dlg.show()

    def __changeOccurrences(self):
        """
        Private slot to perform the Change Occurrences refactoring.
        """
        aw = e5App().getObject("ViewManager").activeWindow()

        if aw is None:
            return

        title = self.trUtf8("Change Occurrences")
        if not aw.hasSelectedText():
            # no selection available
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Highlight an occurrence to be changed"
                    " and try again."))
            return

        if not self.confirmBufferIsSaved(aw):
            return

        filename = aw.getFileName()
        line, index, line1, index1 = aw.getSelection()
        offset = aw.positionFromLineIndex(line, index)

        resource = rope.base.libutils.path_to_resource(
            self.__project, filename)
        try:
            renamer = rope.refactor.rename.ChangeOccurrences(
                        self.__project, resource, offset)
        except Exception as err:
            self.handleRopeError(err, title)
            return

        self.dlg = ChangeOccurrencesDialog(self, title, renamer,
                                           parent=self.__ui)
        self.dlg.show()

    #####################################################
    ## Find actions
    #####################################################

    def __queryReferences(self):
        """
        Private slot to handle the Find References action.
        """
        aw = e5App().getObject("ViewManager").activeWindow()

        if aw is None:
            return

        title = self.trUtf8("Find Occurrences")
        if not aw.hasSelectedText():
            # no selection available
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Highlight the class, method, function or variable"
                    " to search for and try again."))
            return

        if not self.confirmAllBuffersSaved():
            return

        filename = aw.getFileName()
        line, index, line1, index1 = aw.getSelection()
        offset = aw.positionFromLineIndex(line, index)

        resource = rope.base.libutils.path_to_resource(
            self.__project, filename)
        handle = ProgressHandle(title, True, self.__ui)
        handle.show()
        QApplication.processEvents()
        try:
            occurrences = rope.contrib.findit.find_occurrences(
                self.__project, resource, offset,
                unsure = True, in_hierarchy = True, task_handle = handle)
        except Exception as err:
            self.handleRopeError(err, title, handle)
            return
        handle.reset()

        if occurrences:
            self.dlg = MatchesDialog(self.__ui, True)
            self.dlg.show()
            for occurrence in occurrences:
                self.dlg.addEntry(occurrence.resource,
                    occurrence.lineno, occurrence.unsure)
        else:
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("No occurrences found."))

    def __queryDefinition(self):
        """
        Private slot to handle the Find Definition action
        """
        aw = e5App().getObject("ViewManager").activeWindow()

        if aw is None:
            return

        title = self.trUtf8("Find &Definition")
        if not aw.hasSelectedText():
            # no selection available
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Highlight the class, method, function or"
                    " variable reference to search definition for and"
                    " try again."))
            return

        if not self.confirmAllBuffersSaved():
            return

        filename = aw.getFileName()
        line, index, line1, index1 = aw.getSelection()
        offset = aw.positionFromLineIndex(line, index)

        resource = rope.base.libutils.path_to_resource(
            self.__project, filename)
        try:
            location = rope.contrib.findit.find_definition(
                self.__project, aw.text(), offset, resource)
        except Exception as err:
            self.handleRopeError(err, title)
            return

        if location is not None:
            self.dlg = MatchesDialog(self.__ui, False)
            self.dlg.show()
            self.dlg.addEntry(location.resource, location.lineno)
        else:
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("No matching definition found."))

    def __queryImplementations(self):
        """
        Private slot to handle the Find Implementations action.
        """
        aw = e5App().getObject("ViewManager").activeWindow()

        if aw is None:
            return

        title = self.trUtf8("Find Implementations")
        if not aw.hasSelectedText():
            # no selection available
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("Highlight the method to search for"
                            " and try again."))
            return

        if not self.confirmAllBuffersSaved():
            return

        filename = aw.getFileName()
        line, index, line1, index1 = aw.getSelection()
        offset = aw.positionFromLineIndex(line, index)

        resource = rope.base.libutils.path_to_resource(self.__project,
            filename)
        handle = ProgressHandle(title, True, self.__ui)
        handle.show()
        QApplication.processEvents()
        try:
            occurrences = rope.contrib.findit.find_implementations(
                self.__project, resource, offset, task_handle = handle)
        except Exception as err:
            self.handleRopeError(err, title, handle)
            return
        handle.reset()

        if occurrences:
            self.dlg = MatchesDialog(self.__ui, True)
            self.dlg.show()
            for occurrence in occurrences:
                self.dlg.addEntry(occurrence.resource,
                    occurrence.lineno, occurrence.unsure)
        else:
            E5MessageBox.warning(self.__ui, title,
                self.trUtf8("No occurrences found."))

    #####################################################
    ## Various actions
    #####################################################

    def __editConfig(self):
        """
        Private slot to open the rope configuration file in an editor.
        """
        ropedir = self.__project.ropefolder
        configfile = ""
        if ropedir is not None:
            configfile = os.path.join(ropedir.real_path, "config.py")
            if os.path.exists(configfile):
                self.__editor = MiniEditor(configfile)
                self.__editor.show()
                if self.__newStyle:
                    self.__editor.editorSaved.connect(self.__configChanged)
                else:
                    self.connect(self.__editor, SIGNAL("editorSaved"),
                        self.__configChanged)
            else:
                E5MessageBox.critical(self.__ui,
                    self.trUtf8("Configure Rope"),
                    self.trUtf8("""The Rope configuration file '{0}' does"""
                                """ not exist.""").format(configfile))
        else:
            E5MessageBox.critical(self.__ui,
                self.trUtf8("Configure Rope"),
                self.trUtf8("""The Rope admin directory does not exist."""))

    def __showRopeHelp(self):
        """
        Private slot to show help about the refactorings offered by Rope.
        """
        if self.__helpDialog is None:
            helpfile = os.path.join(os.path.dirname(__file__),
                                    "rope", "docs", "overview.txt")
            self.__helpDialog = \
                HelpDialog(self.trUtf8("Help about rope refactorings"),
                           helpfile)
        self.__helpDialog.show()

    ##################################################################
    ## methods below are private utility methods
    ##################################################################

    def __ropeConfigFile(self):
        """
        Private method to get the name of the rope configuration file.

        @return name of the rope configuration file (string)
        """
        configfile = None
        if self.__project is not None:
            ropedir = self.__project.ropefolder
            if ropedir is not None:
                configfile = os.path.join(ropedir.real_path, "config.py")
                if not os.path.exists(configfile):
                    configfile = None
        return configfile

    def __configChanged(self):
        """
        Private slot called, when the rope config file has changed.
        """
        self.__project.close()
        self.__project = rope.base.project.Project(self.__projectpath,
            fscommands = self.__fsCommands)

    def __defaultConfig(self):
        """
        Private slot to return the contents of rope's default configuration.

        @return string containing the source of rope's default
            configuration (string)
        """
        if self.__project is not None:
            return self.__project._default_config()
        else:
            return ""

    ##################################################################
    ## methods below are public utility methods
    ##################################################################

    def getActions(self):
        """
        Public method to get a list of all actions.

        @return list of all actions (list of E5Action)
        """
        return self.actions[:]

    def projectOpened(self):
        """
        Public slot to handle the projectOpened signal.
        """
        if self.__projectopen:
            self.projectClosed()

        self.__projectopen = True
        self.__projectpath = self.__e5project.getProjectPath()
        self.__projectLanguage = self.__e5project.getProjectLanguage()

        if self.__projectLanguage in ["Python3"]:
            self.__project = rope.base.project.Project(self.__projectpath,
                fscommands = self.__fsCommands)
            for act in self.actions:
                act.setEnabled(True)

    def projectClosed(self):
        """
        Public slot to handle the projectClosed signal.
        """
        for act in self.actions:
            act.setEnabled(False)

        if self.__project is not None:
            self.__project.close()
            self.__project = None

        self.__projectopen = False
        self.__projectpath = ''
        self.__projectLanguage = ""

    def getProject(self):
        """
        Public method to get a reference to the rope project object.

        @return reference to the rope project object (RopeProject)
        """
        return self.__project

    def confirmBufferIsSaved(self, editor):
        """
        Public method to check, if an editor has unsaved changes.

        @param editor reference to the editor to be checked
        @return flag indicating, that the editor doesn't contain
            unsaved edits (boolean)
        """
        res = editor.checkDirty()
        self.__project.validate(self.__project.root)
        return res

    def confirmAllBuffersSaved(self):
        """
        Private method to check, if any editor has unsaved changes.

        @return flag indicating, that no editor contains unsaved edits
            (boolean)
        """
        res = e5App().getObject("ViewManager").checkAllDirty()
        self.__project.validate(self.__project.root)
        return res

    def refreshEditors(self, changes):
        """
        Public method to refresh modified editors.

        @param reference to the Changes object (rope.base.change.ChangeSet)
        """
        vm = e5App().getObject("ViewManager")

        changedFiles = []
        for resource in changes.get_changed_resources():
            if not resource.is_folder():
                changedFiles.append(resource.real_path)

        openFiles = [Utilities.normcasepath(f) for f in vm.getOpenFilenames()]

        for file in changedFiles:
            normfile = Utilities.normcasepath(file)
            if normfile in openFiles:
                editor = vm.getEditor(normfile)[1]
                editor.refresh()

        aw = vm.activeWindow()
        if aw is not None:
            filename = aw.getFileName()
            if filename is not None:
                vm.openSourceFile(filename, aw.getCursorPosition()[0] + 1)