/*************************************************************************** * Copyright (C) 2009 by Peter Penz * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * * the Free Software Foundation; either version 2 of the License, or * * (at your option) any later version. * * * * This program is distributed in the hope that it will be useful, * * but WITHOUT ANY WARRANTY; without even the implied warranty of * * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * * GNU General Public License for more details. * * * * You should have received a copy of the GNU General Public License * * along with this program; if not, write to the * * Free Software Foundation, Inc., * * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * ***************************************************************************/ #include "versioncontrolobserver.h" #include "dolphin_versioncontrolsettings.h" #include #include #include #include #include #include "updateitemstatesthread.h" #include #include #include VersionControlObserver::VersionControlObserver(QObject* parent) : QObject(parent), m_pendingItemStatesUpdate(false), m_versionedDirectory(false), m_silentUpdate(false), m_model(0), m_dirVerificationTimer(0), m_plugin(0), m_updateItemStatesThread(0) { // The verification timer specifies the timeout until the shown directory // is checked whether it is versioned. Per default it is assumed that users // don't iterate through versioned directories and a high timeout is used // The timeout will be decreased as soon as a versioned directory has been // found (see verifyDirectory()). m_dirVerificationTimer = new QTimer(this); m_dirVerificationTimer->setSingleShot(true); m_dirVerificationTimer->setInterval(500); connect(m_dirVerificationTimer, SIGNAL(timeout()), this, SLOT(verifyDirectory())); } VersionControlObserver::~VersionControlObserver() { if (m_plugin) { m_plugin->disconnect(this); m_plugin = 0; } } void VersionControlObserver::setModel(KFileItemModel* model) { if (m_model) { disconnect(m_model, SIGNAL(itemsInserted(KItemRangeList)), this, SLOT(delayedDirectoryVerification())); disconnect(m_model, SIGNAL(itemsChanged(KItemRangeList,QSet)), this, SLOT(delayedDirectoryVerification())); } m_model = model; if (model) { connect(m_model, SIGNAL(itemsInserted(KItemRangeList)), this, SLOT(delayedDirectoryVerification())); connect(m_model, SIGNAL(itemsChanged(KItemRangeList,QSet)), this, SLOT(delayedDirectoryVerification())); } } KFileItemModel* VersionControlObserver::model() const { return m_model; } QList VersionControlObserver::actions(const KFileItemList& items) const { QList actions; bool hasNullItems = false; foreach (const KFileItem& item, items) { if (item.isNull()) { kWarning() << "Requesting version-control-actions for empty items"; hasNullItems = true; break; } } if (!m_model || hasNullItems) { return actions; } KVersionControlPlugin2* pluginV2 = qobject_cast(m_plugin); if (pluginV2) { // Use version 2 of the KVersionControlPlugin which allows providing actions // also for non-versioned directories. actions = pluginV2->actions(items); } else if (isVersioned()) { // Support deprecated interfaces from KVersionControlPlugin version 1. // Context menu actions where only available for versioned directories. QString directory; if (items.count() == 1) { const KFileItem rootItem = m_model->rootItem(); if (!rootItem.isNull() && items.first().url() == rootItem.url()) { directory = rootItem.url().path(KUrl::AddTrailingSlash); } } actions = directory.isEmpty() ? m_plugin->contextMenuActions(items) : m_plugin->contextMenuActions(directory); } return actions; } void VersionControlObserver::delayedDirectoryVerification() { m_silentUpdate = false; m_dirVerificationTimer->start(); } void VersionControlObserver::silentDirectoryVerification() { m_silentUpdate = true; m_dirVerificationTimer->start(); } void VersionControlObserver::verifyDirectory() { if (!m_model) { return; } const KFileItem rootItem = m_model->rootItem(); if (rootItem.isNull() || !rootItem.url().isLocalFile()) { return; } if (m_plugin) { m_plugin->disconnect(this); } m_plugin = searchPlugin(rootItem.url()); if (m_plugin) { KVersionControlPlugin2* pluginV2 = qobject_cast(m_plugin); if (pluginV2) { connect(pluginV2, SIGNAL(itemVersionsChanged()), this, SLOT(silentDirectoryVerification())); } else { connect(m_plugin, SIGNAL(versionStatesChanged()), this, SLOT(silentDirectoryVerification())); } connect(m_plugin, SIGNAL(infoMessage(QString)), this, SIGNAL(infoMessage(QString))); connect(m_plugin, SIGNAL(errorMessage(QString)), this, SIGNAL(errorMessage(QString))); connect(m_plugin, SIGNAL(operationCompletedMessage(QString)), this, SIGNAL(operationCompletedMessage(QString))); if (!m_versionedDirectory) { m_versionedDirectory = true; // The directory is versioned. Assume that the user will further browse through // versioned directories and decrease the verification timer. m_dirVerificationTimer->setInterval(100); } updateItemStates(); } else if (m_versionedDirectory) { m_versionedDirectory = false; // The directory is not versioned. Reset the verification timer to a higher // value, so that browsing through non-versioned directories is not slown down // by an immediate verification. m_dirVerificationTimer->setInterval(500); } } void VersionControlObserver::slotThreadFinished() { UpdateItemStatesThread* thread = m_updateItemStatesThread; m_updateItemStatesThread = 0; // The thread deletes itself automatically (see updateItemStates()) if (!m_plugin || !thread) { return; } if (!thread->retrievedItems()) { // Ignore m_silentUpdate for an error message emit errorMessage(i18nc("@info:status", "Update of version information failed.")); return; } const QList itemStates = thread->itemStates(); foreach (const ItemState& itemState, itemStates) { QHash values; values.insert("version", QVariant(itemState.version)); m_model->setData(itemState.index, values); } if (!m_silentUpdate) { // Using an empty message results in clearing the previously shown information message and showing // the default status bar information. This is useful as the user already gets feedback that the // operation has been completed because of the icon emblems. emit operationCompletedMessage(QString()); } if (m_pendingItemStatesUpdate) { m_pendingItemStatesUpdate = false; updateItemStates(); } } void VersionControlObserver::updateItemStates() { Q_ASSERT(m_plugin); if (m_updateItemStatesThread) { // An update is currently ongoing. Wait until the thread has finished // the update (see slotThreadFinished()). m_pendingItemStatesUpdate = true; return; } QList itemStates; const int itemCount = m_model->count(); itemStates.reserve(itemCount); for (int i = 0; i < itemCount; ++i) { ItemState itemState; itemState.index = i; itemState.item = m_model->fileItem(i); itemState.version = KVersionControlPlugin2::UnversionedVersion; itemStates.append(itemState); } if (!itemStates.isEmpty()) { if (!m_silentUpdate) { emit infoMessage(i18nc("@info:status", "Updating version information...")); } m_updateItemStatesThread = new UpdateItemStatesThread(m_plugin, itemStates); connect(m_updateItemStatesThread, SIGNAL(finished()), this, SLOT(slotThreadFinished())); connect(m_updateItemStatesThread, SIGNAL(finished()), m_updateItemStatesThread, SLOT(deleteLater())); m_updateItemStatesThread->start(); // slotThreadFinished() is called when finished } } KVersionControlPlugin* VersionControlObserver::searchPlugin(const KUrl& directory) const { static bool pluginsAvailable = true; static QList plugins; if (!pluginsAvailable) { // A searching for plugins has already been done, but no // plugins are installed return 0; } if (plugins.isEmpty()) { // No searching for plugins has been done yet. Query the KServiceTypeTrader for // all fileview version control plugins and remember them in 'plugins'. const QStringList enabledPlugins = VersionControlSettings::enabledPlugins(); const KService::List pluginServices = KServiceTypeTrader::self()->query("FileViewVersionControlPlugin"); for (KService::List::ConstIterator it = pluginServices.constBegin(); it != pluginServices.constEnd(); ++it) { if (enabledPlugins.contains((*it)->name())) { KVersionControlPlugin* plugin = (*it)->createInstance(); if (plugin) { plugins.append(plugin); } } } if (plugins.isEmpty()) { pluginsAvailable = false; return 0; } } // Verify whether the current directory contains revision information // like .svn, .git, ... foreach (KVersionControlPlugin* plugin, plugins) { const QString fileName = directory.path(KUrl::AddTrailingSlash) + plugin->fileName(); if (QFile::exists(fileName)) { return plugin; } // Version control systems like Git provide the version information // file only in the root directory. Check whether the version information file can // be found in one of the parent directories. For performance reasons this // step is only done, if the previous directory was marked as versioned by // m_versionedDirectory. Drawback: Until e. g. Git is recognized, the root directory // must be shown at least once. if (m_versionedDirectory) { KUrl dirUrl(directory); KUrl upUrl = dirUrl.upUrl(); while (upUrl != dirUrl) { const QString fileName = dirUrl.path(KUrl::AddTrailingSlash) + plugin->fileName(); if (QFile::exists(fileName)) { return plugin; } dirUrl = upUrl; upUrl = dirUrl.upUrl(); } } } return 0; } bool VersionControlObserver::isVersioned() const { return m_versionedDirectory && m_plugin; } #include "versioncontrolobserver.moc"