Differential D3800 Diff 9351 src/common/KReportUtils_p.h

Changeset View

Standalone View

View Options

src/common/KReportUtils_p.h

  • This file was copied to src/common/KReportUtils_p.cpp.
Show All 14 Lines1/* This file is part of the KDE project
15 along with this library; see the file COPYING.LIB. If not, write to 15​ along with this library; see the file COPYING.LIB. If not, write to
16 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 16​ the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
17 Boston, MA 02110-1301, USA. 17​ Boston, MA 02110-1301, USA.
18*/ 18​*/
19 19​
20#ifndef KREPORTUTILS_P_H 20​#ifndef KREPORTUTILS_P_H
21#define KREPORTUTILS_P_H 21​#define KREPORTUTILS_P_H
22 22​
23​#include "config-kreport.h"
staniekUnsubmitted
Not Done

This include is needed in KReportUtils_p.cpp not here?

staniek: This include is needed in KReportUtils_p.cpp not here?
24​
23#include <QApplication> 25​#include <QApplication>
24 26​
25#include <KConfigGroup> 27​#include <KConfigGroup>
26#include <KSharedConfig> 28​#include <KSharedConfig>
27#include <KMessageBox> 29​#include <KMessageBox>
28 30​
29#include <QCoreApplication> 31​#include <QCoreApplication>
30#include <QDir> 32​#include <QDir>
31#include <QFileInfo> 33​#include <QFileInfo>
32#include <QRegularExpression> 34​#include <QRegularExpression>
33#include <QResource> 35​#include <QResource>
34#include <QStandardPaths> 36​#include <QStandardPaths>
35#include <QDebug> 37​#include <QDebug>
38​#include <QGlobalStatic>
39​
40​#ifdef Q_WS_X11
41​#include <QX11Info>
42​#else
43​#include <QDesktopWidget>
44​#endif
45​
36 46​
37// This is a private code made inline for use in the lib and examples. 47​// This is a private code made inline for use in the lib and examples.
38//! @todo Move to a shared lib to use in other Kexi libraries as well. 48​//! @todo Move to a shared lib to use in other Kexi libraries as well.
39 49​
40namespace KReportPrivate { 50​namespace KReportPrivate {
41 51​
42//! @todo Support other themes 52​//! @todo Support other themes
43const QString supportedIconTheme = QLatin1String("breeze"); 53​const QString supportedIconTheme = QLatin1String("breeze");
44 54​
45//! @brief @return true if @a path is readable 55​//! @brief @return true if @a path is readable
46bool fileReadable(const QString &path) 56​bool fileReadable(const QString &path);
47{ ​
48 return !path.isEmpty() && QFileInfo(path).isReadable(); ​
49} ​
50 57​
51//! @brief Used for a workaround: locations for QStandardPaths::AppDataLocation end with app name. 58​//! @brief Used for a workaround: locations for QStandardPaths::AppDataLocation end with app name.
52//! If this is not an expected app but for example a test app, replace 59​//! If this is not an expected app but for example a test app, replace
53//! the subdir name with app name so we can find resource file(s). 60​//! the subdir name with app name so we can find resource file(s).
54QStringList correctStandardLocations(const QString &privateName, 61​QStringList correctStandardLocations(const QString &privateName,
55 QStandardPaths::StandardLocation location, 62​ QStandardPaths::StandardLocation location,
56 const QString &extraLocation) 63​ const QString &extraLocation);
57{ 64​
58 QStringList result; ​
59 if (!privateName.isEmpty()) { ​
60 QRegularExpression re(QLatin1Char('/') + QCoreApplication::applicationName() + QLatin1Char('$')); ​
61 QStringList standardLocations(QStandardPaths::standardLocations(location)); ​
62 if (!extraLocation.isEmpty()) { ​
63 standardLocations.append(extraLocation); ​
64 } ​
65 for(const QString &dir : standardLocations) { ​
66 if (dir.indexOf(re) != -1) { ​
67 QString realDir(dir); ​
68 realDir.replace(re, QLatin1Char('/') + privateName); ​
69 result.append(realDir); ​
70 } ​
71 } ​
72 } ​
73 return result; ​
74} ​
75 65​
76#ifdef Q_OS_WIN ​
77#define KPATH_SEPARATOR ';' ​
78#else ​
79#define KPATH_SEPARATOR ':' ​
80#endif ​
81 66​
82/*! @brief Locates a file path for specified parameters 67​/*! @brief Locates a file path for specified parameters
83 * @param privateName Name to be used instead of application name for resource lookup 68​ * @param privateName Name to be used instead of application name for resource lookup
84 * @param path Relative path to the resource file 69​ * @param path Relative path to the resource file
85 * @param location Standard file location to use for file lookup 70​ * @param location Standard file location to use for file lookup
86 * @param extraLocation Extra directory path for file lookup 71​ * @param extraLocation Extra directory path for file lookup
87 * @return Empty string on failure 72​ * @return Empty string on failure
88 */ 73​ */
89QString locateFile(const QString &privateName, 74​QString locateFile(const QString &privateName,
90 const QString& path, QStandardPaths::StandardLocation location, 75​ const QString& path, QStandardPaths::StandardLocation location,
91 const QString &extraLocation) 76​ const QString &extraLocation);
92{ ​
93 // let QStandardPaths handle this, it will look for app local stuff ​
94 QString fullPath = QFileInfo( ​
95 QStandardPaths::locate(location, path)).canonicalFilePath(); ​
96 if (fileReadable(fullPath)) { ​
97 return fullPath; ​
98 } ​
99 ​
100 // Try extra location ​
101 fullPath = QFileInfo(extraLocation + QLatin1Char('/') + path).canonicalFilePath(); ​
102 if (fileReadable(fullPath)) { ​
103 return fullPath; ​
104 } ​
105 // Try in PATH subdirs, useful for running apps from the build dir, without installing ​
106 for(const QByteArray &pathDir : qgetenv("PATH").split(KPATH_SEPARATOR)) { ​
107 const QString dataDirFromPath = QFileInfo(QFile::decodeName(pathDir) + QStringLiteral("/data/") ​
108 + path).canonicalFilePath(); ​
109 if (fileReadable(dataDirFromPath)) { ​
110 return dataDirFromPath; ​
111 } ​
112 } ​
113 ​
114 const QStringList correctedStandardLocations(correctStandardLocations(privateName, location, extraLocation)); ​
115 for(const QString &dir : correctedStandardLocations) { ​
116 fullPath = QFileInfo(dir + QLatin1Char('/') + path).canonicalFilePath(); ​
117 if (fileReadable(fullPath)) { ​
118 return fullPath; ​
119 } ​
120 } ​
121 return QString(); ​
122} ​
123 77​
124/*! @brief Registers icons resource file 78​/*! @brief Registers icons resource file
125 * @param privateName Name to be used instead of application name for resource lookup 79​ * @param privateName Name to be used instead of application name for resource lookup
126 * @param path Relative path to the resource file 80​ * @param path Relative path to the resource file
127 * @param location Standard file location to use for file lookup 81​ * @param location Standard file location to use for file lookup
128 * @param resourceRoot A resource root for QResource::registerResource() 82​ * @param resourceRoot A resource root for QResource::registerResource()
129 * @param errorMessage On failure it is set to a brief error message. 83​ * @param errorMessage On failure it is set to a brief error message.
130 * @param errorDescription On failure it is set to a detailed error message. 84​ * @param errorDescription On failure it is set to a detailed error message.
131 * other for warning 85​ * other for warning
132 */ 86​ */
133bool registerIconsResource(const QString &privateName, const QString& path, 87​bool registerIconsResource(const QString &privateName, const QString& path,
134 QStandardPaths::StandardLocation location, 88​ QStandardPaths::StandardLocation location,
135 const QString &resourceRoot, const QString &extraLocation, 89​ const QString &resourceRoot, const QString &extraLocation,
136 QString *errorMessage, QString *detailedErrorMessage) 90​ QString *errorMessage, QString *detailedErrorMessage);
137{ ​
138 const QString fullPath = locateFile(privateName, path, location, extraLocation); ​
139 if (fullPath.isEmpty() || !QFileInfo(fullPath).isReadable() ​
140 || !QResource::registerResource(fullPath, resourceRoot)) ​
141 { ​
142 QStringList triedLocations(QStandardPaths::standardLocations(location)); ​
143 if (!extraLocation.isEmpty()) { ​
144 triedLocations.append(extraLocation); ​
145 } ​
146 triedLocations.append(correctStandardLocations(privateName, location, extraLocation)); ​
147 const QString triedLocationsString = QLocale().createSeparatedList(triedLocations); ​
148#ifdef QT_ONLY ​
149 *errorMessage = QString("Could not open icon resource file %1.").arg(path); ​
150 *detailedErrorMessage = QString("Tried to find in %1.").arg(triedLocationsString); ​
151#else ​
152 //! @todo 3.1 Re-add translation ​
153 *errorMessage = /*QObject::tr*/ QString::fromLatin1( ​
154 "Could not open icon resource file \"%1\". " ​
155 "Application will not start. " ​
156 "Please check if it is properly installed.") ​
157 .arg(QFileInfo(path).fileName()); ​
158 //! @todo 3.1 Re-add translation ​
159 *detailedErrorMessage = QString::fromLatin1("Tried to find in %1.").arg(triedLocationsString); ​
160#endif ​
161 return false; ​
162 } ​
163 *errorMessage = QString(); ​
164 *detailedErrorMessage = QString(); ​
165 return true; ​
166} ​
167 91​
168/*! @brief Registers a global icon resource file 92​/*! @brief Registers a global icon resource file
169 * @param themeName A name of icon theme to use. 93​ * @param themeName A name of icon theme to use.
170 * @param errorMessage On failure it is set to a brief error message. 94​ * @param errorMessage On failure it is set to a brief error message.
171 * @param errorDescription On failure it is set to a detailed error message. 95​ * @param errorDescription On failure it is set to a detailed error message.
172 * other for warning 96​ * other for warning
173 */ 97​ */
174bool registerGlobalIconsResource(const QString &themeName, 98​bool registerGlobalIconsResource(const QString &themeName,
175 QString *errorMessage, 99​ QString *errorMessage,
176 QString *detailedErrorMessage) 100​ QString *detailedErrorMessage);
177{ ​
178 QString extraLocation; ​
179#ifdef CMAKE_INSTALL_FULL_ICONDIR ​
180 extraLocation = QDir::fromNativeSeparators(QFile::decodeName(CMAKE_INSTALL_FULL_ICONDIR)); ​
181 if (extraLocation.endsWith("/icons")) { ​
182 extraLocation.chop(QLatin1String("/icons").size()); ​
183 } ​
184#elif defined(Q_OS_WIN) ​
185 extraLocation = QCoreApplication::applicationDirPath() + QStringLiteral("/data"); ​
186#endif ​
187 return registerIconsResource(QString(), QString::fromLatin1("icons/%1/%1-icons.rcc").arg(themeName), ​
188 QStandardPaths::GenericDataLocation, ​
189 QStringLiteral("/icons/") + themeName, ​
190 extraLocation, errorMessage, ​
191 detailedErrorMessage); ​
192} ​
193 101​
194/*! @brief Registers a global icon resource file 102​/*! @brief Registers a global icon resource file
195 * @param themeName A name of icon theme to use. 103​ * @param themeName A name of icon theme to use.
196 */ 104​ */
197bool registerGlobalIconsResource(const QString &themeName) 105​bool registerGlobalIconsResource(const QString &themeName);
198{ ​
199 QString errorMessage; ​
200 QString detailedErrorMessage; ​
201 if (!registerGlobalIconsResource(themeName, &errorMessage, &detailedErrorMessage)) { ​
202 if (detailedErrorMessage.isEmpty()) { ​
203 KMessageBox::error(nullptr, errorMessage); ​
204 } else { ​
205 KMessageBox::detailedError(nullptr, errorMessage, detailedErrorMessage); ​
206 } ​
207 qWarning() << qPrintable(errorMessage); ​
208 return false; ​
209 } ​
210 return true; ​
211} ​
212 106​
213/*! @brief Registers a global icon resource file for default theme name. 107​/*! @brief Registers a global icon resource file for default theme name.
214 */ 108​ */
215bool registerGlobalIconsResource() 109​bool registerGlobalIconsResource();
216{ ​
217 return registerGlobalIconsResource(supportedIconTheme); ​
218} ​
219 110​
220/*! @brief Sets up a private icon resource file 111​/*! @brief Sets up a private icon resource file
221 * @return @c false on failure and sets error message. Does not warn or exit on failure. 112​ * @return @c false on failure and sets error message. Does not warn or exit on failure.
222 * @param privateName Name to be used instead of application name for resource lookup 113​ * @param privateName Name to be used instead of application name for resource lookup
223 * @param path Relative path to the resource file 114​ * @param path Relative path to the resource file
224 * @param themeName Icon theme to use. It affects filename. 115​ * @param themeName Icon theme to use. It affects filename.
225 * @param errorMessage On failure it is set to a brief error message 116​ * @param errorMessage On failure it is set to a brief error message
226 * @param errorDescription On failure it is set to a detailed error message 117​ * @param errorDescription On failure it is set to a detailed error message
227 * other for warning 118​ * other for warning
228 * @param prefix Resource path prefix. The default is useful for library-global resource, 119​ * @param prefix Resource path prefix. The default is useful for library-global resource,
229 * other values is useful for plugins. 120​ * other values is useful for plugins.
230 */ 121​ */
231bool setupPrivateIconsResource(const QString &privateName, const QString& path, 122​bool setupPrivateIconsResource(const QString &privateName, const QString& path,
232 const QString &themeName, 123​ const QString &themeName,
233 QString *errorMessage, QString *detailedErrorMessage, 124​ QString *errorMessage, QString *detailedErrorMessage,
234 const QString &prefix = QLatin1String(":/icons")) 125​ const QString &prefix = QLatin1String(":/icons"));
235{ ​
236 // Register application's resource first to have priority over the theme. ​
237 // Some icons may exists in both resources. ​
238 if (!registerIconsResource(privateName, path, ​
239 QStandardPaths::AppDataLocation, ​
240 QString(), QString(), errorMessage, detailedErrorMessage)) ​
241 { ​
242 return false; ​
243 } ​
244 bool changeTheme = false; ​
245#ifdef QT_GUI_LIB ​
246 QIcon::setThemeSearchPaths(QStringList() << prefix << QIcon::themeSearchPaths()); ​
247 changeTheme = 0 != QIcon::themeName().compare(themeName, Qt::CaseInsensitive); ​
248 if (changeTheme) { ​
249 QIcon::setThemeName(themeName); ​
250 } ​
251#endif ​
252 ​
253 KConfigGroup cg(KSharedConfig::openConfig(), "Icons"); ​
254 changeTheme = changeTheme || 0 != cg.readEntry("Theme", QString()).compare(themeName, Qt::CaseInsensitive); ​
255 // tell KIconLoader an co. about the theme ​
256 if (changeTheme) { ​
257 cg.writeEntry("Theme", themeName); ​
258 cg.sync(); ​
259 } ​
260 return true; ​
261} ​
262 126​
263/*! @brief Sets up a private icon resource file 127​/*! @brief Sets up a private icon resource file
264 * @return @c false on failure and sets error message. 128​ * @return @c false on failure and sets error message.
265 * @param privateName Name to be used instead of application name for resource lookup 129​ * @param privateName Name to be used instead of application name for resource lookup
266 * @param path Relative path to the resource file 130​ * @param path Relative path to the resource file
267 * @param themeName Icon theme to use. It affects filename. 131​ * @param themeName Icon theme to use. It affects filename.
268 * @param errorMessage On failure it is set to a brief error message. 132​ * @param errorMessage On failure it is set to a brief error message.
269 * @param errorDescription On failure it is set to a detailed error message. 133​ * @param errorDescription On failure it is set to a detailed error message.
270 * other for warning 134​ * other for warning
271 * @param prefix Resource path prefix. The default is useful for library-global resource, 135​ * @param prefix Resource path prefix. The default is useful for library-global resource,
272 * other values is useful for plugins. 136​ * other values is useful for plugins.
273 */ 137​ */
274bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path, 138​bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path,
275 const QString &themeName, 139​ const QString &themeName,
276 QString *errorMessage, QString *detailedErrorMessage, 140​ QString *errorMessage, QString *detailedErrorMessage,
277 const QString &prefix = QLatin1String(":/icons")) 141​ const QString &prefix = QLatin1String(":/icons"));
278{ ​
279 if (!setupPrivateIconsResource(privateName, path, themeName, ​
280 errorMessage, detailedErrorMessage, prefix)) ​
281 { ​
282 if (detailedErrorMessage->isEmpty()) { ​
283 KMessageBox::error(nullptr, *errorMessage); ​
284 } else { ​
285 KMessageBox::detailedError(nullptr, *errorMessage, *detailedErrorMessage); ​
286 } ​
287 return false; ​
288 } ​
289 return true; ​
290} ​
291 142​
292/*! @overload setupPrivateIconsResourceWithMessage(QString &privateName, const QString& path, 143​/*! @overload setupPrivateIconsResourceWithMessage(QString &privateName, const QString& path,
293 const QString &themeName, 144​ const QString &themeName,
294 QString *errorMessage, QString *detailedErrorMessage, 145​ QString *errorMessage, QString *detailedErrorMessage,
295 const QString &prefix = QLatin1String(":/icons")) 146​ const QString &prefix = QLatin1String(":/icons"))
296 Uses default theme name. 147​ Uses default theme name.
297 */ 148​ */
298bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path, 149​bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path,
299 QString *errorMessage, QString *detailedErrorMessage, 150​ QString *errorMessage, QString *detailedErrorMessage,
300 const QString &prefix = QLatin1String(":/icons")) 151​ const QString &prefix = QLatin1String(":/icons"));
301{ ​
302 return setupPrivateIconsResourceWithMessage(privateName, path, supportedIconTheme, ​
303 errorMessage, detailedErrorMessage, prefix); ​
304} ​
305 152​
306/*! @brief Sets up a private icon resource file 153​/*! @brief Sets up a private icon resource file
307 * Warns on failure and returns @c false. 154​ * Warns on failure and returns @c false.
308 * @param privateName Name to be used instead of application name for resource lookup 155​ * @param privateName Name to be used instead of application name for resource lookup
309 * @param path Relative path to the resource file 156​ * @param path Relative path to the resource file
310 * @param messageType Type of message to use on error, QtFatalMsg for fatal exit and any 157​ * @param messageType Type of message to use on error, QtFatalMsg for fatal exit and any
311 * other for warning 158​ * other for warning
312 * @param prefix Resource path prefix. The default is useful for library-global resource, 159​ * @param prefix Resource path prefix. The default is useful for library-global resource,
313 * other values is useful for plugins. 160​ * other values is useful for plugins.
314 */ 161​ */
315bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path, 162​bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path,
316 QtMsgType messageType, 163​ QtMsgType messageType,
317 const QString &prefix = QLatin1String(":/icons")) 164​ const QString &prefix = QLatin1String(":/icons"));
318{ ​
319 QString errorMessage; ​
320 QString detailedErrorMessage; ​
321 if (!setupPrivateIconsResourceWithMessage(privateName, path, ​
322 &errorMessage, &detailedErrorMessage, prefix)) { ​
323 if (messageType == QtFatalMsg) { ​
324 qFatal("%s %s", qPrintable(errorMessage), qPrintable(detailedErrorMessage)); ​
325 } else { ​
326 qWarning() << qPrintable(errorMessage) << qPrintable(detailedErrorMessage); ​
327 } ​
328 return false; ​
329 } ​
330 return true; ​
331} ​
332 165​
333//! Sets up a global icon theme if it is different from supported. 166​//! Sets up a global icon theme if it is different from supported.
334//! Warns on failure and returns @c false. 167​//! Warns on failure and returns @c false.
335bool setupGlobalIconTheme() 168​bool setupGlobalIconTheme();
336{ 169​
337 if (0 != QIcon::themeName().compare(supportedIconTheme, Qt::CaseInsensitive)) { 170​int dpiX();
338 const QString message = QString::fromLatin1( 171​
339 "\"%1\" supports only \"%2\" icon theme but current system theme is \"%3\". " 172​int dpiY();
340 "Application's icon theme will be changed to \"%2\". " ​
341 "Please consider adding support for other themes to %4.") ​
342 .arg(QLatin1String(KREPORT_BASE_NAME)).arg(supportedIconTheme).arg(QIcon::themeName()) ​
343 .arg(QCoreApplication::applicationName()); ​
344 qDebug() << qPrintable(message); ​
345 if (!registerGlobalIconsResource()) { ​
346 // don't fail, just warn ​
347 const QString message = QString::fromLatin1( ​
348 "Failed to set icon theme to \"%1\". Icons in the application will be inconsistent. " ​
349 "Please install .rcc file(s) for the system theme.") ​
350 .arg(supportedIconTheme); ​
351 qDebug() << qPrintable(message); ​
352 return false; ​
353 } ​
354 } ​
355 return true; ​
356} ​
357 173​
358} // KReportPrivate 174​} // KReportPrivate
359 175​
360#endif 176​#endif