qSlicerExtensionsManagerModel.h

Go to the documentation of this file.

/*==============================================================================

  Program: 3D Slicer

  Copyright (c) Kitware Inc.

  See COPYRIGHT.txt
  or http://www.slicer.org/copyright/copyright.txt for details.

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.

  This file was originally developed by Jean-Christophe Fillion-Robin, Kitware Inc.
  and was partially funded by NIH grant 3P41RR013218-12S1

==============================================================================*/

#ifndef __qSlicerExtensionsManagerModel_h
#define __qSlicerExtensionsManagerModel_h

// Qt includes
#include <QHash>
#include <QStringList>
#include <QUrl>
#include <QSettings>
#include <QUuid>
#include <QVariantMap>

// CTK includes
#include <ctkErrorLogModel.h>

// QtGUI includes
#include "qSlicerBaseQTCoreExport.h"
#include "qSlicerExtensionDownloadTask.h"

class QNetworkReply;
class qSlicerExtensionsManagerModelPrivate;
class QStandardItemModel;

class Q_SLICER_BASE_QTCORE_EXPORT qSlicerExtensionsManagerModel : public QObject
{
  Q_OBJECT
  Q_PROPERTY(int numberOfInstalledExtensions READ numberOfInstalledExtensions)
  Q_PROPERTY(QStringList installedExtensions READ installedExtensions)
  Q_PROPERTY(QStringList enabledExtensions READ enabledExtensions)
  Q_PROPERTY(QUrl serverUrl READ serverUrl)
  Q_PROPERTY(QUrl serverUrlWithPackagePath READ serverUrlWithPackagePath)
  Q_PROPERTY(QUrl serverUrlWithExtensionsStorePath READ serverUrlWithExtensionsStorePath)
  Q_PROPERTY(QString extensionsInstallPath READ extensionsInstallPath)
  Q_PROPERTY(bool newExtensionEnabledByDefault READ newExtensionEnabledByDefault WRITE setNewExtensionEnabledByDefault)
  Q_PROPERTY(QString extensionsSettingsFilePath READ extensionsSettingsFilePath WRITE setExtensionsSettingsFilePath)
  Q_PROPERTY(QString slicerRevision READ slicerRevision WRITE setSlicerRevision)
  Q_PROPERTY(QString slicerOs READ slicerOs WRITE setSlicerOs)
  Q_PROPERTY(QString slicerArch READ slicerArch WRITE setSlicerArch)
  Q_PROPERTY(QString slicerVersion READ slicerVersion WRITE setSlicerVersion)
public:
  typedef QObject Superclass;

  typedef qSlicerExtensionsManagerModelPrivate Pimpl;

  typedef qSlicerExtensionsManagerModel Self;

  explicit qSlicerExtensionsManagerModel(QObject* parent = 0);

  virtual ~qSlicerExtensionsManagerModel();

  typedef QVariantMap ExtensionMetadataType;

  QUrl serverUrl()const;
  QUrl serverUrlWithPackagePath()const;
  QUrl serverUrlWithExtensionsStorePath()const;

  QString extensionsInstallPath()const;

  Q_INVOKABLE QString extensionInstallPath(const QString& extensionName) const;

  Q_INVOKABLE QStringList extensionModulePaths(const QString& extensionName)const;

  Q_INVOKABLE QString extensionDescriptionFile(const QString& extensionName) const;

  void setNewExtensionEnabledByDefault(bool value);
  bool newExtensionEnabledByDefault()const;

  Q_INVOKABLE ExtensionMetadataType extensionMetadata(const QString& extensionName)const;

  Q_INVOKABLE bool isExtensionInstalled(const QString& extensionName)const;

  int numberOfInstalledExtensions()const;

  QStringList installedExtensions()const;

  Q_INVOKABLE bool isExtensionEnabled(const QString& extensionName)const;

  QStringList scheduledForUpdateExtensions() const;

  Q_INVOKABLE bool isExtensionUpdateAvailable(const QString& extensionName)const;

  Q_INVOKABLE bool isExtensionScheduledForUpdate(const QString& extensionName)const;

  QStringList scheduledForUninstallExtensions() const;

  Q_INVOKABLE bool isExtensionScheduledForUninstall(const QString& extensionName)const;

  QStringList enabledExtensions()const;

  QString extensionsSettingsFilePath()const;
  void setExtensionsSettingsFilePath(const QString& extensionsSettingsFilePath);

  QString slicerRevision()const;
  void setSlicerRevision(const QString& revision);

  QString slicerOs()const;
  void setSlicerOs(const QString& os);

  QString slicerArch()const;
  void setSlicerArch(const QString& arch);

  void setSlicerRequirements(const QString& revision, const QString& os, const QString& arch);

  QString slicerVersion()const;
  void setSlicerVersion(const QString& version);

  Q_INVOKABLE QStringList isExtensionCompatible(const QString& extensionName, const QString& slicerRevision,
                                                const QString& slicerOs, const QString& slicerArch) const;

  Q_INVOKABLE QStringList isExtensionCompatible(const QString& extensionName) const;

  Q_INVOKABLE ExtensionMetadataType retrieveExtensionMetadata(const QString& extensionId);

  Q_INVOKABLE bool installExtension(const QString &archiveFile);

  Q_INVOKABLE bool installExtension(const QString& extensionName,
                                    ExtensionMetadataType extensionMetadata,
                                    const QString &archiveFile);

  Q_INVOKABLE bool extractExtensionArchive(const QString& extensionName,
                                           const QString& archiveFile,
                                           const QString &destinationPath);

  Q_INVOKABLE const QStandardItemModel * model()const;

  static QHash<QString, QString> serverToExtensionDescriptionKey();

  static QStringList serverKeysToIgnore();

  static ExtensionMetadataType filterExtensionMetadata(const ExtensionMetadataType &extensionMetadata);

  static QStringList readArrayValues(QSettings& settings,
                                     const QString& arrayName, const QString fieldName);

  static void writeArrayValues(QSettings& settings, const QStringList& values,
                               const QString& arrayName, const QString fieldName);

  static bool writeExtensionDescriptionFile(const QString& file,
                                            const ExtensionMetadataType& metadata);

  static ExtensionMetadataType parseExtensionDescriptionFile(const QString& file);

public slots:

  void setExtensionEnabled(const QString& extensionName, bool value);

  bool downloadAndInstallExtension(const QString& extensionId);

  bool scheduleExtensionForUninstall(const QString& extensionName);

  bool cancelExtensionScheduledForUninstall(const QString& extensionName);

  void checkForUpdates(bool installUpdates);

  bool scheduleExtensionForUpdate(const QString& extensionName);

  bool cancelExtensionScheduledForUpdate(const QString& extensionName);

  bool updateScheduledExtensions(QStringList &updatedExtensions);

  bool updateScheduledExtensions();

  bool uninstallScheduledExtensions(QStringList &uninstalledExtensions);

  bool uninstallScheduledExtensions();

  void identifyIncompatibleExtensions();

  bool exportExtensionList(QString& exportFilePath);

  QStringList checkInstallPrerequisites() const;

  void updateModel();

signals:

  void downloadStarted(QNetworkReply * reply);

  void downloadFinished(QNetworkReply * reply);

  void updateDownloadProgress(const QString& extensionName,
                              qint64 received, qint64 total);

  void modelUpdated();

  void extensionUpdateAvailable(const QString& extensionName);

  void extensionInstalled(const QString& extensionName);

  void extensionUpdated(const QString& extensionName);

  void extensionScheduledForUninstall(const QString& extensionName);

  void extensionCancelledScheduleForUninstall(const QString& extensionName);

  void extensionScheduledForUpdate(const QString& extensionName);

  void extensionCancelledScheduleForUpdate(const QString& extensionName);

  void extensionUninstalled(const QString& extensionName);

  void extensionEnabledChanged(const QString& extensionName, bool value);

  void extensionIdentifedAsIncompatible(const QString& extensionName);

  void slicerRequirementsChanged(const QString& revision, const QString& os, const QString& arch);

  void messageLogged(const QString& text, ctkErrorLogLevel::LogLevels level) const;

protected slots:

  void onInstallDownloadFinished(qSlicerExtensionDownloadTask* task);

  void onUpdateDownloadFinished(qSlicerExtensionDownloadTask* task);

  void onUpdateDownloadProgress(qSlicerExtensionDownloadTask* task,
                                qint64 received, qint64 total);

  void onUpdateCheckComplete(const QUuid& requestId,
                             const QList<QVariantMap>& results);
  void onUpdateCheckFailed(const QUuid& requestId);

protected:
  QScopedPointer<qSlicerExtensionsManagerModelPrivate> d_ptr;

private:
  Q_DECLARE_PRIVATE(qSlicerExtensionsManagerModel);
  Q_DISABLE_COPY(qSlicerExtensionsManagerModel);
};

// Metatype already declared in qSlicerIO.h
//Q_DECLARE_METATYPE(qSlicerExtensionsManagerModel::ExtensionMetadataType)

#endif