cppcheck/gui/projectfiledialog.h

/*
 * Cppcheck - A tool for static C/C++ code analysis
 * Copyright (C) 2007-2023 Cppcheck team.
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 */

#ifndef PROJECTFILE_DIALOG_H
#define PROJECTFILE_DIALOG_H

#include "suppressions.h"

#include <QDialog>
#include <QList>
#include <QObject>
#include <QString>
#include <QStringList>

class QModelIndex;
class QWidget;
namespace Ui {
    class ProjectFile;
}

/// @addtogroup GUI
/// @{


class ProjectFile;

/**
 * @brief A dialog for editing project file data.
 */
class ProjectFileDialog : public QDialog {
    Q_OBJECT
public:
    explicit ProjectFileDialog(ProjectFile *projectFile, bool premium, QWidget *parent = nullptr);
    ~ProjectFileDialog() override;

private:
    void loadFromProjectFile(const ProjectFile *projectFile);
    void saveToProjectFile(ProjectFile *projectFile) const;

    /** Enable and disable widgets in the 'Paths and Defines' tab */
    void updatePathsAndDefines();

    /**
     * @brief Return project root path from the dialog control.
     * @return Project root path.
     */
    QString getRootPath() const;

    QStringList getProjectConfigurations() const;
    void setProjectConfigurations(const QStringList &configs);

    QString getImportProject() const;

    /** Get Cppcheck build dir */
    QString getBuildDir() const;

    /**
     * @brief Return include paths from the dialog control.
     * @return List of include paths.
     */
    QStringList getIncludePaths() const;

    /**
     * @brief Return define names from the dialog control.
     * @return List of define names.
     */
    QStringList getDefines() const;

    /**
     * @brief Return undefine names from the dialog control.
     * @return List of undefine names.
     */
    QStringList getUndefines() const;

    /**
     * @brief Return check paths from the dialog control.
     * @return List of check paths.
     */
    QStringList getCheckPaths() const;

    /**
     * @brief Return excluded paths from the dialog control.
     * @return List of excluded paths.
     */
    QStringList getExcludedPaths() const;

    /**
     * @brief Return selected libraries from the dialog control.
     * @return List of libraries.
     */
    QStringList getLibraries() const;

    /**
     * @brief Return suppressions from the dialog control.
     * @return List of suppressions.
     */
    QList<Suppressions::Suppression> getSuppressions() const {
        return mSuppressions;
    }

    /**
     * @brief Set project root path to dialog control.
     * @param root Project root path to set to dialog control.
     */
    void setRootPath(const QString &root);

    /** Set build dir */
    void setBuildDir(const QString &buildDir);

    void setImportProject(const QString &importProject);

    /**
     * @brief Set include paths to dialog control.
     * @param includes List of include paths to set to dialog control.
     */
    void setIncludepaths(const QStringList &includes);

    /**
     * @brief Set define names to dialog control.
     * @param defines List of define names to set to dialog control.
     */
    void setDefines(const QStringList &defines);

    /**
     * @brief Set undefine names to dialog control.
     * @param undefines List of undefine names to set to dialog control.
     */
    void setUndefines(const QStringList &undefines);

    /**
     * @brief Set check paths to dialog control.
     * @param paths List of path names to set to dialog control.
     */
    void setCheckPaths(const QStringList &paths);

    /**
     * @brief Set excluded paths to dialog control.
     * @param paths List of path names to set to dialog control.
     */
    void setExcludedPaths(const QStringList &paths);

    /**
     * @brief Set libraries to dialog control.
     * @param libraries List of libraries to set to dialog control.
     */
    void setLibraries(const QStringList &libraries);

    /**
     * @brief Add a single suppression to dialog control.
     * @param suppression A suppressions to add to dialog control.
     */
    void addSingleSuppression(const Suppressions::Suppression &suppression);

    /**
     * @brief Set suppressions to dialog control.
     * @param suppressions List of suppressions to set to dialog control.
     */
    void setSuppressions(const QList<Suppressions::Suppression> &suppressions);

protected slots:

    /** ok button pressed, save changes and accept */
    void ok();

    /**
     * @brief Browse for build dir.
     */
    void browseBuildDir();

    /**
     * @brief Clear 'import project'.
     */
    void clearImportProject();

    /**
     * @brief Browse for solution / project / compile database.
     */
    void browseImportProject();

    /**
     * @brief Add new path to check.
     */
    void addCheckPath();

    /**
     * @brief Edit path in the list.
     */
    void editCheckPath();

    /**
     * @brief Remove path from the list.
     */
    void removeCheckPath();

    /**
     * @brief Browse for include directory.
     * Allow user to add new include directory to the list.
     */
    void addIncludeDir();

    /**
     * @brief Remove include directory from the list.
     */
    void removeIncludeDir();

    /**
     * @brief Edit include directory in the list.
     */
    void editIncludeDir();

    /**
     * @brief Add new path to exclude list.
     */
    void addExcludePath();

    /**
     * @brief Add new file to exclude list.
     */
    void addExcludeFile();

    /**
     * @brief Edit excluded path in the list.
     */
    void editExcludePath();

    /**
     * @brief Remove excluded path from the list.
     */
    void removeExcludePath();

    /**
     * @brief Move include path up in the list.
     */
    void moveIncludePathUp();

    /**
     * @brief Move include path down in the list.
     */
    void moveIncludePathDown();

    /**
     * @brief Add suppression to the list
     */
    void addSuppression();

    /**
     * @brief Remove selected suppression from the list
     */
    void removeSuppression();

    /**
     * @brief Edit suppression (double clicking on suppression)
     */
    void editSuppression(const QModelIndex &index);

    /**
     * @brief Browse for misra file
     */
    void browseMisraFile();

    /**
     * @brief Check for all VS configurations
     */
    void checkAllVSConfigs();

protected:

    /**
     * @brief Save dialog settings.
     */
    void loadSettings();

    /**
     * @brief Load dialog settings.
     */
    void saveSettings() const;

    /**
     * @brief Add new indlude directory.
     * @param dir Directory to add.
     */
    void addIncludeDir(const QString &dir);

    /**
     * @brief Add new path to check.
     * @param path Path to add.
     */
    void addCheckPath(const QString &path);

    /**
     * @brief Add new path to ignore list.
     * @param path Path to add.
     */
    void addExcludePath(const QString &path);

    /**
     * @brief Get mSuppressions index that match the
     * given short text
     * @param shortText text as generated by Suppression::getText
     * @return index of matching suppression, -1 if not found
     */
    int getSuppressionIndex(const QString &shortText) const;

private:
    static QStringList getProjectConfigs(const QString &fileName);

    Ui::ProjectFile *mUI;

    /**
     * @brief Projectfile path.
     */
    ProjectFile *mProjectFile;

    /** Is this Cppcheck Premium? */
    bool mPremium;

    QString getExistingDirectory(const QString &caption, bool trailingSlash);

    QList<Suppressions::Suppression> mSuppressions;
};

/// @}
#endif // PROJECTFILE_DIALOG_H