Wizards/Custom Wizards: Add code.

Task-number: QTCREATORBUG-423

src/plugins/coreplugin/basefilewizard.cpp

@@ -185,6 +185,7 @@ class BaseFileWizardParameterData : public QSharedData
 {
 public:
     explicit BaseFileWizardParameterData(IWizard::WizardKind kind = IWizard::FileWizard);
+    void clear();
 
     IWizard::WizardKind kind;
     QIcon icon;
@@ -200,6 +201,17 @@ BaseFileWizardParameterData::BaseFileWizardParameterData(IWizard::WizardKind k)
 {
 }
 
+void BaseFileWizardParameterData::clear()
+{
+    kind = IWizard::FileWizard;
+    icon = QIcon();
+    description.clear();
+    displayName.clear();
+    id.clear();
+    category.clear();
+    displayCategory.clear();
+}
+
 BaseFileWizardParameters::BaseFileWizardParameters(IWizard::WizardKind kind) :
    m_d(new BaseFileWizardParameterData(kind))
 {
@@ -221,6 +233,21 @@ BaseFileWizardParameters::~BaseFileWizardParameters()
 {
 }
 
+void BaseFileWizardParameters::clear()
+{
+    m_d->clear();
+}
+
+CORE_EXPORT QDebug operator<<(QDebug d, const BaseFileWizardParameters &p)
+{
+    d.nospace() << "Kind: " << p.kind() << " Id: " << p.id()
+                << " Category: " << p.category()
+                << " DisplayName: " << p.displayName()
+                << " Description: " << p.description()
+                << " DisplayCategory: " << p.displayCategory();
+    return d;
+}
+
 IWizard::WizardKind BaseFileWizardParameters::kind() const
 {
     return m_d->kind;

src/plugins/coreplugin/basefilewizard.h

@@ -42,6 +42,7 @@
 QT_BEGIN_NAMESPACE
 class QWizard;
 class QWizardPage;
+class QDebug;
 QT_END_NAMESPACE
 
 namespace Core {
@@ -105,6 +106,8 @@ public:
     BaseFileWizardParameters &operator=(const BaseFileWizardParameters&);
    ~BaseFileWizardParameters();
 
+    void clear();
+
     IWizard::WizardKind kind() const;
     void setKind(IWizard::WizardKind k);
 
@@ -130,6 +133,8 @@ private:
     QSharedDataPointer<BaseFileWizardParameterData> m_d;
 };
 
+CORE_EXPORT QDebug operator<<(QDebug d, const BaseFileWizardParameters &);
+
 /* A generic wizard for creating files.
  *
  * The abstract methods:

src/plugins/projectexplorer/baseprojectwizarddialog.h

@@ -51,12 +51,13 @@ class PROJECTEXPLORER_EXPORT BaseProjectWizardDialog : public QWizard
     Q_OBJECT
 
 protected:
-    explicit BaseProjectWizardDialog(QWidget *parent = 0);
     explicit BaseProjectWizardDialog(Utils::ProjectIntroPage *introPage,
                                      int introId = -1,
                                      QWidget *parent = 0);
 
 public:
+    explicit BaseProjectWizardDialog(QWidget *parent = 0);
+
     virtual ~BaseProjectWizardDialog();
 
     QString projectName() const;

src/plugins/projectexplorer/customwizard/customwizard.cpp

+/**************************************************************************
+**
+** This file is part of Qt Creator
+**
+** Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
+**
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** Commercial Usage
+**
+** Licensees holding valid Qt Commercial licenses may use this file in
+** accordance with the Qt Commercial License Agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Nokia.
+**
+** GNU Lesser General Public License Usage
+**
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at http://qt.nokia.com/contact.
+**
+**************************************************************************/
+
+#include "customwizard.h"
+#include "customwizardparameters.h"
+#include "customwizardpage.h"
+#include "projectexplorer.h"
+#include "baseprojectwizarddialog.h"
+
+#include <coreplugin/icore.h>
+#include <coreplugin/mimedatabase.h>
+#include <cpptools/cpptoolsconstants.h>
+#include <utils/qtcassert.h>
+
+#include <QtCore/QDebug>
+#include <QtCore/QFile>
+#include <QtCore/QMap>
+#include <QtCore/QDir>
+#include <QtCore/QFileInfo>
+
+enum { debug = 0 };
+
+static const char templatePathC[] = "templates/wizards";
+static const char configFileC[] = "wizard.xml";
+
+namespace ProjectExplorer {
+
+struct CustomWizardPrivate {
+    QSharedPointer<Internal::CustomWizardParameters> m_parameters;
+};
+
+CustomWizard::CustomWizard(const Core::BaseFileWizardParameters& baseFileParameters,
+                           QObject *parent) :
+    Core::BaseFileWizard(baseFileParameters, parent),
+    d(new CustomWizardPrivate)
+{
+}
+
+CustomWizard::~CustomWizard()
+{
+    delete d;
+}
+
+void CustomWizard::setParameters(const CustomWizardParametersPtr &p)
+{
+    d->m_parameters = p;
+}
+
+// Add a wizard page with an id, visibly warn if something goes wrong.
+static inline void addWizardPage(QWizard *w, QWizardPage *p, int id)
+{
+    if (id == -1) {
+        w->addPage(p);
+    } else {
+        if (w->pageIds().contains(id)) {
+            qWarning("Page %d already present in custom wizard dialog, defaulting to add.", id);
+            w->addPage(p);
+        } else {
+            w->setPage(id, p);
+        }
+    }
+}
+
+// Initialize a wizard with a custom file page.
+void CustomWizard::initWizardDialog(QWizard *wizard, const QString &defaultPath,
+                                    const WizardPageList &extensionPages) const
+{
+    QTC_ASSERT(!parameters().isNull(), return);
+    Internal::CustomWizardPage *customPage = new Internal::CustomWizardPage(parameters()->fields);
+    customPage->setPath(defaultPath);
+    addWizardPage(wizard, customPage, parameters()->firstPageId);
+    if (!parameters()->fieldPageTitle.isEmpty())
+        customPage->setTitle(parameters()->fieldPageTitle);
+    foreach(QWizardPage *ep, extensionPages)
+        wizard->addPage(ep);
+    Core::BaseFileWizard::setupWizard(wizard);
+    if (debug)
+        qDebug() << "initWizardDialog" << wizard << wizard->pageIds();
+}
+
+QWizard *CustomWizard::createWizardDialog(QWidget *parent,
+                                                 const QString &defaultPath,
+                                                 const WizardPageList &extensionPages) const
+{
+    QTC_ASSERT(!d->m_parameters.isNull(), return 0);
+    QWizard *wizard = new QWizard(parent);
+    initWizardDialog(wizard, defaultPath, extensionPages);
+    return wizard;
+}
+
+// Replace field values delimited by '%' with special modifiers:
+// %Field% -> simple replacement
+// %Field:l% -> lower case replacement, 'u' for upper case and so on.
+static void replaceFields(const CustomProjectWizard::FieldReplacementMap &fm, QString *s)
+{
+    const QChar delimiter = QLatin1Char('%');
+    const QChar modifierDelimiter = QLatin1Char(':');
+    int pos = 0;
+    while (pos < s->size()) {
+        pos = s->indexOf(delimiter, pos);
+        if (pos < 0)
+            break;
+        int nextPos = s->indexOf(delimiter, pos + 1);
+        if (nextPos == -1)
+            break;
+        nextPos++; // Point past 2nd delimiter
+        if (nextPos == pos + 2) {
+            pos = nextPos; // Skip '%%'
+            continue;
+        }
+        // Evaluate field specification for modifiers
+        // "%field:l%"
+        QString fieldSpec = s->mid(pos + 1, nextPos - pos - 2);
+        const int fieldSpecSize = fieldSpec.size();
+        char modifier = '\0';
+        if (fieldSpecSize >= 3 && fieldSpec.at(fieldSpecSize - 2) == modifierDelimiter) {
+            modifier = fieldSpec.at(fieldSpecSize - 1).toLatin1();
+            fieldSpec.truncate(fieldSpecSize - 2);
+        }
+        const CustomProjectWizard::FieldReplacementMap::const_iterator it = fm.constFind(fieldSpec);
+        if (it == fm.constEnd()) {
+            pos = nextPos; // Not found, skip
+            continue;
+        }
+        // Assign
+        QString replacement = it.value();
+        switch (modifier) {
+        case 'l':
+            replacement = it.value().toLower();
+            break;
+        case 'u':
+            replacement = it.value().toUpper();
+            break;
+        default:
+            break;
+        }
+        s->replace(pos, nextPos - pos, replacement);
+        pos += replacement.size();
+    }
+}
+
+// Read out files and store contents with field contents replaced.
+static inline bool createFile(Internal::CustomWizardFile cwFile,
+                              const QString &sourceDirectory,
+                              const QString &targetDirectory,
+                              const CustomProjectWizard::FieldReplacementMap &fm,
+                              Core::GeneratedFiles *files,
+                              QString *errorMessage)
+{
+    const QChar slash =  QLatin1Char('/');
+    const QString sourcePath = sourceDirectory + slash + cwFile.source;
+    replaceFields(fm, &cwFile.target);
+    const QString targetPath = QDir::toNativeSeparators(targetDirectory + slash + cwFile.target);
+    if (debug)
+        qDebug() << "generating " << targetPath << sourcePath << fm;
+    QFile file(sourcePath);
+    if (!file.open(QIODevice::ReadOnly|QIODevice::Text)) {
+        *errorMessage = QString::fromLatin1("Cannot open %1: %2").arg(sourcePath, file.errorString());
+        return false;
+    }
+    QString contents = QString::fromLocal8Bit(file.readAll());
+    if (!contents.isEmpty() && !fm.isEmpty())
+        replaceFields(fm, &contents);
+    Core::GeneratedFile generatedFile;
+    generatedFile.setContents(contents);
+    generatedFile.setPath(targetPath);
+    files->push_back(generatedFile);
+    return true;
+}
+
+// Helper to find a specific wizard page of a wizard by type.
+template <class WizardPage>
+        WizardPage *findWizardPage(const QWizard *w)
+{
+    foreach (int pageId, w->pageIds())
+        if (WizardPage *wp = qobject_cast<WizardPage *>(w->page(pageId)))
+            return wp;
+    return 0;
+}
+
+Core::GeneratedFiles CustomWizard::generateFiles(const QWizard *dialog, QString *errorMessage) const
+{
+    // Look for the Custom field page to find the path
+    const Internal::CustomWizardPage *cwp = findWizardPage<Internal::CustomWizardPage>(dialog);
+    QTC_ASSERT(cwp, return Core::GeneratedFiles())
+    QString path = cwp->path();
+    const FieldReplacementMap fieldMap = defaultReplacementMap(dialog);
+    if (debug)
+        qDebug() << "CustomWizard::generateFiles" << dialog << path << fieldMap;
+    return generateWizardFiles(path, fieldMap, errorMessage);
+}
+
+Core::GeneratedFiles CustomWizard::generateWizardFiles(const QString &targetPath,
+                                                       const FieldReplacementMap &fieldReplacementMap,
+                                                       QString *errorMessage) const
+{
+    if (debug)
+        qDebug() << "Replacements" << fieldReplacementMap;
+    // Create files
+    Core::GeneratedFiles rc;
+    foreach(const Internal::CustomWizardFile &file, d->m_parameters->files)
+        if (!createFile(file, d->m_parameters->directory, targetPath, fieldReplacementMap, &rc, errorMessage))
+            return Core::GeneratedFiles();
+    return rc;
+}
+
+// Create a default replacement map from the wizard dialog via fields
+// and add some useful fields.
+CustomWizard::FieldReplacementMap CustomWizard::defaultReplacementMap(const QWizard *w) const
+{
+    FieldReplacementMap fieldReplacementMap;
+    foreach(const Internal::CustomWizardField &field, d->m_parameters->fields) {
+        const QString value = w->field(field.name).toString();
+        fieldReplacementMap.insert(field.name, value);
+    }
+    const Core::MimeDatabase *mdb = Core::ICore::instance()->mimeDatabase();
+    fieldReplacementMap.insert(QLatin1String("CppSourceSuffix"),
+                               mdb->preferredSuffixByType(QLatin1String(CppTools::Constants::CPP_SOURCE_MIMETYPE)));
+    fieldReplacementMap.insert(QLatin1String("CppHeaderSuffix"),
+                               mdb->preferredSuffixByType(QLatin1String(CppTools::Constants::CPP_HEADER_MIMETYPE)));
+    return fieldReplacementMap;
+}
+
+CustomWizard::CustomWizardParametersPtr CustomWizard::parameters() const
+{
+    return d->m_parameters;
+}
+
+// Static factory map
+typedef QMap<QString, QSharedPointer<ICustomWizardFactory> > CustomWizardFactoryMap;
+Q_GLOBAL_STATIC(CustomWizardFactoryMap, customWizardFactoryMap)
+
+void CustomWizard::registerFactory(const QString &name, const ICustomWizardFactoryPtr &f)
+{
+    customWizardFactoryMap()->insert(name, f);
+}
+
+CustomWizard *CustomWizard::createWizard(const CustomWizardParametersPtr &p, const Core::BaseFileWizardParameters &b)
+{
+    CustomWizard * rc = 0;
+    if (p->klass.isEmpty()) {
+        // Use defaults for empty class names
+        switch (b.kind()) {
+            case Core::IWizard::ProjectWizard:
+                rc = new CustomProjectWizard(b);
+                break;
+            case Core::IWizard::FileWizard:
+            case Core::IWizard::ClassWizard:
+                rc = new CustomWizard(b);
+                break;
+            }
+    } else {
+        // Look up class name in map
+        const CustomWizardFactoryMap::const_iterator it = customWizardFactoryMap()->constFind(p->klass);
+        if (it != customWizardFactoryMap()->constEnd())
+            rc = it.value()->create(b);
+    }
+    if (!rc) {
+        qWarning("Unable to create custom wizard for class %s.", qPrintable(p->klass));
+        return 0;
+    }
+    rc->setParameters(p);
+    return rc;
+}
+
+// Scan the subdirectories of the template directory for directories
+// containing valid configuration files and parse them into wizards.
+QList<CustomWizard*> CustomWizard::createWizards()
+{
+    QList<CustomWizard*> rc;
+    QString errorMessage;
+    const QString templateDirName = Core::ICore::instance()->resourcePath() +
+                                    QLatin1Char('/') + QLatin1String(templatePathC);
+    const QDir templateDir(templateDirName);
+    if (!templateDir.exists()) {
+        if (debug)
+           qWarning("Custom project template path %s does not exist.", qPrintable(templateDir.absolutePath()));
+        return rc;
+    }
+
+    const QList<QFileInfo> dirs = templateDir.entryInfoList(QDir::Dirs|QDir::Readable|QDir::NoDotAndDotDot,
+                                                            QDir::Name|QDir::IgnoreCase);
+    const QString configFile = QLatin1String(configFileC);
+    // Check and parse config file in each directory.
+
+    foreach(const QFileInfo &dirFi, dirs) {
+        const QDir dir(dirFi.absoluteFilePath());
+        if (dir.exists(configFile)) {
+            CustomWizardParametersPtr parameters(new Internal::CustomWizardParameters);
+            Core::BaseFileWizardParameters baseFileParameters;
+            if (parameters->parse(dir.absoluteFilePath(configFile), &baseFileParameters, &errorMessage)) {
+                parameters->directory = dir.absolutePath();
+                if (debug)
+                    qDebug() << (*parameters);
+                if (CustomWizard *w = createWizard(parameters, baseFileParameters))
+                    rc.push_back(w);
+            } else {
+                qWarning("Failed to initialize custom project wizard in %s: %s",
+                         qPrintable(dir.absolutePath()), qPrintable(errorMessage));
+            }
+        }
+    }
+    return rc;
+}
+
+// --------------- CustomProjectWizard
+
+CustomProjectWizard::CustomProjectWizard(const Core::BaseFileWizardParameters& baseFileParameters,
+                                         QObject *parent) :
+    CustomWizard(baseFileParameters, parent)
+{
+}
+
+QWizard *CustomProjectWizard::createWizardDialog(QWidget *parent,
+                                        const QString &defaultPath,
+                                        const WizardPageList &extensionPages) const
+{
+    QTC_ASSERT(!parameters().isNull(), return 0);
+    BaseProjectWizardDialog *projectDialog = new BaseProjectWizardDialog(parent);
+    initProjectWizardDialog(projectDialog, defaultPath, extensionPages);
+    return projectDialog;
+}
+
+void CustomProjectWizard::initProjectWizardDialog(BaseProjectWizardDialog *w,
+                                                  const QString &defaultPath,
+                                                  const WizardPageList &extensionPages) const
+{
+    QTC_ASSERT(!parameters().isNull(), return);
+    if (!parameters()->fields.isEmpty()) {
+        Internal::CustomWizardFieldPage *cp = new Internal::CustomWizardFieldPage(parameters()->fields);
+        addWizardPage(w, cp, parameters()->firstPageId);
+        if (!parameters()->fieldPageTitle.isEmpty())
+            cp->setTitle(parameters()->fieldPageTitle);
+    }
+    foreach(QWizardPage *ep, extensionPages)
+        w->addPage(ep);
+    w->setPath(defaultPath);
+    w->setProjectName(BaseProjectWizardDialog::uniqueProjectName(defaultPath));
+    if (debug)
+        qDebug() << "initProjectWizardDialog" << w << w->pageIds();
+}
+
+Core::GeneratedFiles CustomProjectWizard::generateFiles(const QWizard *w, QString *errorMessage) const
+{
+    const BaseProjectWizardDialog *dialog = qobject_cast<const BaseProjectWizardDialog *>(w);
+    QTC_ASSERT(dialog, return Core::GeneratedFiles())
+    const QString targetPath = dialog->path() + QLatin1Char('/') + dialog->projectName();
+    // Add project name as macro.
+    FieldReplacementMap fieldReplacementMap = defaultReplacementMap(dialog);
+    fieldReplacementMap.insert(QLatin1String("ProjectName"), dialog->projectName());
+    if (debug)
+        qDebug() << "CustomProjectWizard::generateFiles" << dialog << targetPath << fieldReplacementMap;
+    return generateWizardFiles(targetPath, fieldReplacementMap, errorMessage);
+}
+
+bool CustomProjectWizard::postGenerateFiles(const QWizard *, const Core::GeneratedFiles &l, QString *errorMessage)
+{
+    // Post-Generate: Open the project
+    const QString proFileName = l.back().path();
+    const bool opened = ProjectExplorer::ProjectExplorerPlugin::instance()->openProject(proFileName);
+    if (debug)
+        qDebug() << "CustomProjectWizard::postGenerateFiles: opened " << proFileName << opened;
+    if (opened) {
+        *errorMessage = tr("The project %1 could not be opened.").arg(proFileName);
+        return false;
+    }
+    return true;
+}
+
+} // namespace ProjectExplorer

src/plugins/projectexplorer/customwizard/customwizard.h

+/**************************************************************************
+**
+** This file is part of Qt Creator
+**
+** Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
+**
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** Commercial Usage
+**
+** Licensees holding valid Qt Commercial licenses may use this file in
+** accordance with the Qt Commercial License Agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Nokia.
+**
+** GNU Lesser General Public License Usage
+**
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at http://qt.nokia.com/contact.
+**
+**************************************************************************/
+
+#ifndef CUSTOMPROJECTWIZARD_H
+#define CUSTOMPROJECTWIZARD_H
+
+#include "../projectexplorer_export.h"
+
+#include <coreplugin/basefilewizard.h>
+
+#include <QtCore/QSharedPointer>
+#include <QtCore/QList>
+
+QT_BEGIN_NAMESPACE
+class QDir;
+QT_END_NAMESPACE
+
+namespace ProjectExplorer {
+class CustomWizard;
+struct CustomWizardPrivate;
+class BaseProjectWizardDialog;
+
+namespace Internal {
+    struct CustomWizardParameters;
+}
+
+// Factory for creating wizard. Can be registered under a name
+// in CustomWizard.
+class ICustomWizardFactory {
+public:
+    virtual CustomWizard *create(const Core::BaseFileWizardParameters& baseFileParameters,
+                                 QObject *parent = 0) const = 0;
+    virtual ~ICustomWizardFactory() {}
+};
+
+// Convenience template to create wizard classes.
+template <class Wizard> class CustomWizardFactory : public ICustomWizardFactory {
+    virtual CustomWizard *create(const Core::BaseFileWizardParameters& baseFileParameters,
+                                 QObject *parent = 0) const
+    { return new Wizard(baseFileParameters, parent); }
+};
+
+// A custom wizard presenting CustomWizardDialog (fields page containing
+// path control) for wizards of type "class" or "file". Serves as base class
+// for project wizards.
+
+class PROJECTEXPLORER_EXPORT CustomWizard : public Core::BaseFileWizard
+{
+    Q_OBJECT
+public:
+    typedef QMap<QString, QString> FieldReplacementMap;
+    typedef QSharedPointer<ICustomWizardFactory> ICustomWizardFactoryPtr;
+
+    explicit CustomWizard(const Core::BaseFileWizardParameters& baseFileParameters,
+                          QObject *parent = 0);
+    virtual ~CustomWizard();
+
+    // Can be reimplemented to create custom wizards. initWizardDialog() needs to be
+    // called.
+    virtual QWizard *createWizardDialog(QWidget *parent,
+                                        const QString &defaultPath,
+                                        const WizardPageList &extensionPages) const;
+
+    virtual Core::GeneratedFiles generateFiles(const QWizard *w, QString *errorMessage) const;
+
+
+    // Register a factory for a derived custom widget
+    static void registerFactory(const QString &name, const ICustomWizardFactoryPtr &f);
+    template <class Wizard> static void registerFactory(const QString &name)
+        { registerFactory(name, ICustomWizardFactoryPtr(new CustomWizardFactory<Wizard>)); }
+
+    // Create all wizards. As other plugins might register factories for derived
+    // classes, call it in extensionsInitialized().
+    static QList<CustomWizard*&g