qgsuserprofilemanager.h

Go to the documentation of this file.

/***************************************************************************
                        qgsuserprofilemanager.h
     --------------------------------------
    Date                 :  Jul-2017
    Copyright            : (C) 2017 by Nathan Woodrow
    Email                : woodrow.nathan at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef QGSUSERPROFILEMANAGER_H
#define QGSUSERPROFILEMANAGER_H

#include <QSettings>
#include <QFileSystemWatcher>


#include "qgis_sip.h"
#include "qgis_core.h"
#include "qgserror.h"
#include "qgsuserprofile.h"

#include <memory>

class CORE_EXPORT QgsUserProfileManager : public QObject
{
    Q_OBJECT

  public:

    QgsUserProfileManager( const QString &rootLocation = QString(), QObject *parent = nullptr );

    static QString resolveProfilesFolder( const QString &basePath = QString() );

    QgsUserProfile *getProfile( const QString &defaultProfile = "default", bool createNew = true, bool initSettings = true ) SIP_FACTORY;

    void setRootLocation( const QString &rootProfileLocation );

    QString rootLocation() { return mRootProfilePath; }

    void setNewProfileNotificationEnabled( bool enabled );

    bool isNewProfileNotificationEnabled() const;

    bool rootLocationIsSet() const;

    QStringList allProfiles() const;

    bool profileExists( const QString &name ) const;

    QString defaultProfileName() const;

    void setDefaultProfileName( const QString &name );

    void setDefaultFromActive();

    QgsUserProfile *profileForName( const QString &name ) const SIP_FACTORY;

    QgsError createUserProfile( const QString &name );

    QgsError deleteProfile( const QString &name );

    QgsUserProfile *userProfile();

    void setActiveUserProfile( const QString &profile );

    void loadUserProfile( const QString &name );

  signals:

    void profilesChanged();

  private:

    bool mWatchProfiles = false;
    std::unique_ptr<QFileSystemWatcher> mWatcher;

    QString mRootProfilePath;

    std::unique_ptr<QgsUserProfile> mUserProfile;

    QString settingsFile() const;

    std::unique_ptr< QSettings > mSettings;
};

// clazy:excludeall=qstring-allocations

#endif // QGSUSERPROFILEMANAGER_H