QGIS API Documentation 3.30.0-'s-Hertogenbosch (f186b8efe0)
qgsuserprofilemanager.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsuserprofilemanager.cpp
3 --------------------------------------
4 Date : Jul-2017
5 Copyright : (C) 2017 by Nathan Woodrow
6 Email : woodrow.nathan at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
17#include "qgsuserprofile.h"
18#include "qgsapplication.h"
19#include "qgslogger.h"
20#include "qgssettings.h"
21
22#include <QFile>
23#include <QDir>
24#include <QTextStream>
25#include <QProcess>
26#include <QStandardPaths>
27
28
29QgsUserProfileManager::QgsUserProfileManager( const QString &rootLocation, QObject *parent )
30 : QObject( parent )
31{
33}
34
35QString QgsUserProfileManager::resolveProfilesFolder( const QString &basePath )
36{
37 return basePath + QDir::separator() + "profiles";
38}
39
40QgsUserProfile *QgsUserProfileManager::getProfile( const QString &defaultProfile, bool createNew, bool initSettings )
41{
42 const QString profileName = defaultProfile.isEmpty() ? defaultProfileName() : defaultProfile;
43
44 if ( createNew && !profileExists( defaultProfile ) )
45 {
46 createUserProfile( profileName );
47 }
48
49 QgsUserProfile *profile = profileForName( profileName );
50 if ( initSettings )
51 profile->initSettings();
52
53 return profile;
54}
55
56void QgsUserProfileManager::setRootLocation( const QString &rootProfileLocation )
57{
58 mRootProfilePath = rootProfileLocation;
59
60 //updates (or removes) profile file watcher for new root location
61 setNewProfileNotificationEnabled( mWatchProfiles );
62
63 mSettings.reset( new QSettings( settingsFile(), QSettings::IniFormat ) );
64}
65
67{
68 mWatchProfiles = enabled;
69 if ( mWatchProfiles && !mRootProfilePath.isEmpty() && QDir( mRootProfilePath ).exists() )
70 {
71 mWatcher.reset( new QFileSystemWatcher() );
72 mWatcher->addPath( mRootProfilePath );
73 connect( mWatcher.get(), &QFileSystemWatcher::directoryChanged, this, [this]
74 {
75 emit profilesChanged();
76 } );
77 }
78 else
79 {
80 mWatcher.reset();
81 }
82}
83
85{
86 return static_cast< bool >( mWatcher.get() );
87}
88
90{
91 return !mRootProfilePath.isEmpty();
92}
93
95{
96 const QString defaultName = QStringLiteral( "default" );
97 // If the profiles.ini doesn't have the default profile we grab it from
98 // global settings as it might be set by the admin.
99 // If the overrideProfile flag is set then no matter what the profiles.ini says we always take the
100 // global profile.
101 const QgsSettings globalSettings;
102 if ( !mSettings->contains( QStringLiteral( "/core/defaultProfile" ) ) || globalSettings.value( QStringLiteral( "overrideLocalProfile" ), false, QgsSettings::Core ).toBool() )
103 {
104 return globalSettings.value( QStringLiteral( "defaultProfile" ), defaultName, QgsSettings::Core ).toString();
105 }
106 return mSettings->value( QStringLiteral( "/core/defaultProfile" ), defaultName ).toString();
107}
108
110{
111 mSettings->setValue( QStringLiteral( "/core/defaultProfile" ), name );
112 mSettings->sync();
113}
114
116{
118}
119
121{
122 return QDir( mRootProfilePath ).entryList( QDir::Dirs | QDir::NoDotAndDotDot );
123}
124
125bool QgsUserProfileManager::profileExists( const QString &name ) const
126{
127 return allProfiles().contains( name );
128}
129
131{
132 const QString profilePath = mRootProfilePath + QDir::separator() + name;
133 return new QgsUserProfile( profilePath );
134}
135
137{
138 QgsError error;
139
140 // TODO Replace with safe folder name
141
142 const QDir folder( mRootProfilePath + QDir::separator() + name );
143 if ( !folder.exists() )
144 {
145 if ( !QDir().mkpath( folder.absolutePath() ) )
146 {
147 error.append( tr( "Cannot write '%1'" ).arg( folder.absolutePath() ) );
148 return error;
149 }
150 }
151
152 QFile qgisPrivateDbFile( folder.absolutePath() + QDir::separator() + "qgis.db" );
153
154 // first we look for ~/.qgis/qgis.db
155 if ( !qgisPrivateDbFile.exists() )
156 {
157 // if it doesn't exist we copy it from the global resources dir
158 const QString qgisMasterDbFileName = QgsApplication::qgisMasterDatabaseFilePath();
159 QFile masterFile( qgisMasterDbFileName );
160
161 //now copy the master file into the users .qgis dir
162 masterFile.copy( qgisPrivateDbFile.fileName() );
163
164 // In some packaging systems, the master can be read-only. Make sure to make
165 // the copy user writable.
166 const QFile::Permissions perms = QFile( qgisPrivateDbFile.fileName() ).permissions();
167 if ( !( perms & QFile::WriteOwner ) )
168 {
169 if ( !qgisPrivateDbFile.setPermissions( perms | QFile::WriteOwner ) )
170 {
171 error.append( tr( "Can not make '%1' user writable" ).arg( qgisPrivateDbFile.fileName() ) );
172 }
173 }
174 }
175
176 if ( error.isEmpty() )
177 {
178 emit profilesChanged();
179 }
180
181 return error;
182}
183
185{
186 QgsError error;
187 QDir folder( mRootProfilePath + QDir::separator() + name );
188
189 // This might have to be changed to something better.
190 const bool deleted = folder.removeRecursively();
191 if ( !deleted )
192 {
193 error.append( ( tr( "Unable to fully delete user profile folder" ) ) );
194 }
195 else
196 {
197 emit profilesChanged();
198 }
199 return error;
200}
201
202QString QgsUserProfileManager::settingsFile() const
203{
204 return mRootProfilePath + QDir::separator() + "profiles.ini";
205}
206
208{
209 return mUserProfile.get();
210}
211
212void QgsUserProfileManager::loadUserProfile( const QString &name )
213{
214#if QT_CONFIG(process)
215 const QString path = QDir::toNativeSeparators( QCoreApplication::applicationFilePath() );
216 QStringList arguments;
217 arguments << QCoreApplication::arguments();
218 // The first is the path to the application
219 // on Windows this might not be case so we need to handle that
220 // http://doc.qt.io/qt-5/qcoreapplication.html#arguments
221 arguments.removeFirst();
222 arguments << QStringLiteral( "--profile" ) << name;
223 QgsDebugMsg( QStringLiteral( "Starting instance from %1 with %2" ).arg( path ).arg( arguments.join( " " ) ) );
224 QProcess::startDetached( path, arguments, QDir::toNativeSeparators( QCoreApplication::applicationDirPath() ) );
225#else
226 Q_UNUSED( name )
227 Q_ASSERT( "Starting the user profile is not supported on the platform" );
228#endif //QT_CONFIG(process)
229}
230
232{
233 if ( ! mUserProfile.get() )
234 {
235 mUserProfile.reset( profileForName( profile ) );
236 }
237}
static QString qgisMasterDatabaseFilePath()
Returns the path to the master qgis.db file.
QgsError is container for error messages (report).
Definition: qgserror.h:81
bool isEmpty() const
Test if any error is set.
Definition: qgserror.h:111
void append(const QString &message, const QString &tag)
Append new error message.
Definition: qgserror.cpp:39
This class is a composition of two QSettings instances:
Definition: qgssettings.h:63
QVariant value(const QString &key, const QVariant &defaultValue=QVariant(), Section section=NoSection) const
Returns the value for setting key.
QgsUserProfile * getProfile(const QString &defaultProfile="default", bool createNew=true, bool initSettings=true)
Returns the profile from the given root profile location.
void setRootLocation(const QString &rootProfileLocation)
Set the root profile location for the profile manager.
QgsError createUserProfile(const QString &name)
Create a user profile given by the name.
void setActiveUserProfile(const QString &profile)
Sets the active profile in the manager.
bool profileExists(const QString &name) const
Check if a profile exists.
QgsUserProfile * userProfile()
The currently active user profile.
void setDefaultProfileName(const QString &name)
Sets the default profile name.
QString rootLocation()
Returns the path to the root profiles location.
void setDefaultFromActive()
Set the default profile name from the current active profile.
QStringList allProfiles() const
Returns a list of all found profile names.
bool rootLocationIsSet() const
Check if the root location has been set for the manager.
QgsError deleteProfile(const QString &name)
Deletes a profile from the root profiles folder.
static QString resolveProfilesFolder(const QString &basePath=QString())
Resolves the profiles folder for the given path.
void setNewProfileNotificationEnabled(bool enabled)
Sets whether the manager should watch for the creation of new user profiles and emit the profilesChan...
QString defaultProfileName() const
Returns the name of the default profile that has been set in .default.
QgsUserProfileManager(const QString &rootLocation=QString(), QObject *parent=nullptr)
User profile manager used to manage user profiles for the instance of QGIS.
void profilesChanged()
Emitted when the list of profiles is changed.
QgsUserProfile * profileForName(const QString &name) const
Returns the profile found for a given name.
void loadUserProfile(const QString &name)
Starts a new instance of QGIS for the given profile.
bool isNewProfileNotificationEnabled() const
Returns whether the manager is watching for the creation of new user profiles and emitting the profil...
User profile contains information about the user profile folders on the machine.
void initSettings() const
Init the settings from the user folder.
#define QgsDebugMsg(str)
Definition: qgslogger.h:38