KNewStuff

installation.cpp
1/*
2 This file is part of KNewStuff2.
3 SPDX-FileCopyrightText: 2007 Josef Spillner <spillner@kde.org>
4 SPDX-FileCopyrightText: 2009 Frederik Gladhorn <gladhorn@kde.org>
5
6 SPDX-License-Identifier: LGPL-2.1-or-later
7*/
8
9#include "installation_p.h"
10
11#include <QDesktopServices>
12#include <QDir>
13#include <QFile>
14#include <QProcess>
15#include <QTemporaryFile>
16#include <QUrlQuery>
17
18#include "karchive.h"
19#include "knewstuff_version.h"
20#include "qmimedatabase.h"
21#include <KRandom>
22#include <KShell>
23#include <KTar>
24#include <KZip>
25
26#include <KPackage/Package>
27#include <KPackage/PackageJob>
28
29#include <KLocalizedString>
30#include <knewstuffcore_debug.h>
31#include <qstandardpaths.h>
32
33#include "jobs/filecopyjob.h"
34#include "question.h"
35#ifdef Q_OS_WIN
36#include <shlobj.h>
37#include <windows.h>
38#endif
39
40using namespace KNSCore;
41
42Installation::Installation(QObject *parent)
43 : QObject(parent)
44{
45}
46
47bool Installation::readConfig(const KConfigGroup &group, QString &errorMessage)
48{
49 // FIXME: add support for several categories later on
50 const QString uncompression = group.readEntry("Uncompress", QStringLiteral("never"));
51 if (uncompression == QLatin1String("always") || uncompression == QLatin1String("true")) {
53 } else if (uncompression == QLatin1String("archive")) {
55 } else if (uncompression == QLatin1String("subdir")) {
57 } else if (uncompression == QLatin1String("kpackage")) {
59 } else if (uncompression == QLatin1String("subdir-archive")) {
61 } else if (uncompression == QLatin1String("never")) {
63 } else {
64 errorMessage = QStringLiteral("invalid Uncompress setting chosen, must be one of: subdir, always, archive, never, or kpackage");
65 qCCritical(KNEWSTUFFCORE) << errorMessage;
66 return false;
67 }
68
69 kpackageStructure = group.readEntry("KPackageStructure");
71 errorMessage = QStringLiteral("kpackage uncompress setting chosen, but no KPackageStructure specified");
72 qCCritical(KNEWSTUFFCORE) << errorMessage;
73 return false;
74 }
75
76 postInstallationCommand = group.readEntry("InstallationCommand");
77 uninstallCommand = group.readEntry("UninstallCommand");
78 standardResourceDirectory = group.readEntry("StandardResource");
79 targetDirectory = group.readEntry("TargetDir");
80 xdgTargetDirectory = group.readEntry("XdgTargetDir");
81
82 installPath = group.readEntry("InstallPath");
83 absoluteInstallPath = group.readEntry("AbsoluteInstallPath");
84
85 if (standardResourceDirectory.isEmpty() && targetDirectory.isEmpty() && xdgTargetDirectory.isEmpty() && installPath.isEmpty()
86 && absoluteInstallPath.isEmpty()) {
87 qCCritical(KNEWSTUFFCORE) << "No installation target set";
88 return false;
89 }
90 return true;
91}
92
93void Installation::install(const Entry &entry)
94{
95 downloadPayload(entry);
96}
97
98void Installation::downloadPayload(const KNSCore::Entry &entry)
99{
100 if (!entry.isValid()) {
101 Q_EMIT signalInstallationFailed(i18n("Invalid item."), entry);
102 return;
103 }
104 QUrl source = QUrl(entry.payload());
105
106 if (!source.isValid()) {
107 qCCritical(KNEWSTUFFCORE) << "The entry doesn't have a payload.";
108 Q_EMIT signalInstallationFailed(i18n("Download of item failed: no download URL for \"%1\".", entry.name()), entry);
109 return;
110 }
111
112 QString fileName(source.fileName());
113 QTemporaryFile tempFile(QDir::tempPath() + QStringLiteral("/XXXXXX-") + fileName);
114 tempFile.setAutoRemove(false);
115 if (!tempFile.open()) {
116 return; // ERROR
117 }
118 QUrl destination = QUrl::fromLocalFile(tempFile.fileName());
119 qCDebug(KNEWSTUFFCORE) << "Downloading payload" << source << "to" << destination;
120#ifdef Q_OS_WIN // can't write to the file if it's open, on Windows
121 tempFile.close();
122#endif
123
124 // FIXME: check for validity
125 FileCopyJob *job = FileCopyJob::file_copy(source, destination, -1, JobFlag::Overwrite | JobFlag::HideProgressInfo);
126 connect(job, &KJob::result, this, &Installation::slotPayloadResult);
127
128 entry_jobs[job] = entry;
129}
130
131void Installation::slotPayloadResult(KJob *job)
132{
133 // for some reason this slot is getting called 3 times on one job error
134 if (entry_jobs.contains(job)) {
135 Entry entry = entry_jobs[job];
136 entry_jobs.remove(job);
137
138 if (job->error()) {
139 const QString errorMessage = i18n("Download of \"%1\" failed, error: %2", entry.name(), job->errorString());
140 qCWarning(KNEWSTUFFCORE) << errorMessage;
141 Q_EMIT signalInstallationFailed(errorMessage, entry);
142 } else {
143 FileCopyJob *fcjob = static_cast<FileCopyJob *>(job);
144 qCDebug(KNEWSTUFFCORE) << "Copied to" << fcjob->destUrl();
145 QMimeDatabase db;
146 QMimeType mimeType = db.mimeTypeForFile(fcjob->destUrl().toLocalFile());
147 if (mimeType.inherits(QStringLiteral("text/html")) || mimeType.inherits(QStringLiteral("application/x-php"))) {
148 const auto error = i18n("Cannot install '%1' because it points to a web page. Click <a href='%2'>here</a> to finish the installation.",
149 entry.name(),
150 fcjob->srcUrl().toString());
151 Q_EMIT signalInstallationFailed(error, entry);
152 entry.setStatus(KNSCore::Entry::Invalid);
153 Q_EMIT signalEntryChanged(entry);
154 return;
155 }
156
157 Q_EMIT signalPayloadLoaded(fcjob->destUrl());
158 install(entry, fcjob->destUrl().toLocalFile());
159 }
160 }
161}
162
163void KNSCore::Installation::install(KNSCore::Entry entry, const QString &downloadedFile)
164{
165 qCWarning(KNEWSTUFFCORE) << "Install:" << entry.name() << "from" << downloadedFile;
167
168 if (entry.payload().isEmpty()) {
169 qCDebug(KNEWSTUFFCORE) << "No payload associated with:" << entry.name();
170 return;
171 }
172
173 // TODO Add async checksum verification
174
177
179 if (installedFiles.isEmpty()) {
180 if (entry.status() == KNSCore::Entry::Installing) {
181 entry.setStatus(KNSCore::Entry::Downloadable);
182 } else if (entry.status() == KNSCore::Entry::Updating) {
183 entry.setStatus(KNSCore::Entry::Updateable);
184 }
185 Q_EMIT signalEntryChanged(entry);
186 Q_EMIT signalInstallationFailed(i18n("Could not install \"%1\": file not found.", entry.name()), entry);
187 return;
188 }
189
190 entry.setInstalledFiles(installedFiles);
191
192 auto installationFinished = [this, entry]() {
193 Entry newentry = entry;
194 if (!newentry.updateVersion().isEmpty()) {
195 newentry.setVersion(newentry.updateVersion());
196 }
197 if (newentry.updateReleaseDate().isValid()) {
198 newentry.setReleaseDate(newentry.updateReleaseDate());
199 }
200 newentry.setStatus(KNSCore::Entry::Installed);
203 };
204 if (!postInstallationCommand.isEmpty()) {
205 QString scriptArgPath = !installedFiles.isEmpty() ? installedFiles.first() : targetPath;
206 if (scriptArgPath.endsWith(QLatin1Char('*'))) {
207 scriptArgPath = scriptArgPath.left(scriptArgPath.lastIndexOf(QLatin1Char('*')));
208 }
210 connect(p, &QProcess::finished, this, [entry, installationFinished, this](int exitCode) {
211 if (exitCode) {
212 Entry newEntry = entry;
213 newEntry.setStatus(KNSCore::Entry::Invalid);
215 } else {
217 }
218 });
219 } else {
221 }
222 }
223}
224
225QString Installation::targetInstallationPath() const
226{
227 // installdir is the target directory
229
230 const bool userScope = true;
231 // installpath also contains the file name if it's a single file, otherwise equal to installdir
232 int pathcounter = 0;
233 // wallpaper is already managed in the case of !xdgTargetDirectory.isEmpty()
234 if (!standardResourceDirectory.isEmpty() && standardResourceDirectory != QLatin1String("wallpaper")) {
236 // crude translation KStandardDirs names -> QStandardPaths enum
239 } else if (standardResourceDirectory == QLatin1String("config")) {
241 }
242
243 if (userScope) {
245 } else { // system scope
247 }
248 pathcounter++;
249 }
250 if (!targetDirectory.isEmpty() && targetDirectory != QLatin1String("/")) {
251 if (userScope) {
253 } else { // system scope
255 }
256 pathcounter++;
257 }
258 if (!xdgTargetDirectory.isEmpty() && xdgTargetDirectory != QLatin1String("/")) {
260 pathcounter++;
261 }
262 if (!installPath.isEmpty()) {
263#if defined(Q_OS_WIN)
264 WCHAR wPath[MAX_PATH + 1];
266 installdir = QString::fromUtf16((const char16_t *)wPath) + QLatin1Char('/') + installPath + QLatin1Char('/');
267 } else {
269 }
270#else
272#endif
273 pathcounter++;
274 }
275 if (!absoluteInstallPath.isEmpty()) {
277 pathcounter++;
278 }
279
280 if (pathcounter != 1) {
281 qCCritical(KNEWSTUFFCORE) << "Wrong number of installation directories given.";
282 return QString();
283 }
284
285 qCDebug(KNEWSTUFFCORE) << "installdir: " << installdir;
286
287 // create the dir if it doesn't exist (QStandardPaths doesn't create it, unlike KStandardDirs!)
289
290 return installdir;
291}
292
293QStringList Installation::installDownloadedFileAndUncompress(const KNSCore::Entry &entry, const QString &payloadfile, const QString installdir)
294{
295 // Collect all files that were installed
296 QStringList installedFiles;
297 bool isarchive = true;
299
300 // respect the uncompress flag in the knsrc
302 qCDebug(KNEWSTUFFCORE) << "Using KPackage for installation";
303 auto resetEntryStatus = [this, entry]() {
305 if (changedEntry.status() == KNSCore::Entry::Installing || changedEntry.status() == KNSCore::Entry::Installed) {
306 changedEntry.setStatus(KNSCore::Entry::Downloadable);
307 } else if (changedEntry.status() == KNSCore::Entry::Updating) {
308 changedEntry.setStatus(KNSCore::Entry::Updateable);
309 }
311 };
312
313 qCDebug(KNEWSTUFFCORE) << "About to attempt to install" << payloadfile << "as" << kpackageStructure;
315 connect(job, &KPackage::PackageJob::finished, this, [this, entry, payloadfile, resetEntryStatus, job]() {
316 if (job->error() == KJob::NoError) {
317 Entry newentry = entry;
318 newentry.setInstalledFiles(QStringList{job->package().path()});
319 // update version and release date to the new ones
320 if (newentry.status() == KNSCore::Entry::Updating) {
321 if (!newentry.updateVersion().isEmpty()) {
322 newentry.setVersion(newentry.updateVersion());
323 }
324 if (newentry.updateReleaseDate().isValid()) {
325 newentry.setReleaseDate(newentry.updateReleaseDate());
326 }
327 }
328 newentry.setStatus(KNSCore::Entry::Installed);
329 // We can remove the downloaded file, because we don't save its location and don't need it to uninstall the entry
333 qCDebug(KNEWSTUFFCORE) << "Install job finished with no error and we now have files" << job->package().path();
334 } else {
335 if (job->error() == KPackage::PackageJob::JobError::NewerVersionAlreadyInstalledError) {
336 Entry newentry = entry;
337 newentry.setStatus(KNSCore::Entry::Installed);
338 newentry.setInstalledFiles(QStringList{job->package().path()});
339 // update version and release date to the new ones
340 if (!newentry.updateVersion().isEmpty()) {
341 newentry.setVersion(newentry.updateVersion());
342 }
343 if (newentry.updateReleaseDate().isValid()) {
344 newentry.setReleaseDate(newentry.updateReleaseDate());
345 }
348 qCDebug(KNEWSTUFFCORE) << "Install job finished telling us this item was already installed with this version, so... let's "
349 "just make a small fib and say we totally installed that, honest, and we now have files"
350 << job->package().path();
351 } else {
352 Q_EMIT signalInstallationFailed(i18n("Installation of %1 failed: %2", payloadfile, job->errorText()), entry);
354 qCDebug(KNEWSTUFFCORE) << "Install job finished with error state" << job->error() << "and description" << job->error();
355 }
356 }
357 });
358 } else {
361 // this is weird but a decompression is not a single name, so take the path instead
362 QMimeDatabase db;
364 qCDebug(KNEWSTUFFCORE) << "Postinstallation: uncompress the file";
365
366 // FIXME: check for overwriting, malicious archive entries (../foo) etc.
367 // FIXME: KArchive should provide "safe mode" for this!
369
370 if (mimeType.inherits(QStringLiteral("application/zip"))) {
372 // clang-format off
373 } else if (mimeType.inherits(QStringLiteral("application/tar"))
374 || mimeType.inherits(QStringLiteral("application/x-tar")) // BUG 450662
375 || mimeType.inherits(QStringLiteral("application/x-gzip"))
376 || mimeType.inherits(QStringLiteral("application/x-bzip"))
377 || mimeType.inherits(QStringLiteral("application/x-lzma"))
378 || mimeType.inherits(QStringLiteral("application/x-xz"))
379 || mimeType.inherits(QStringLiteral("application/x-bzip-compressed-tar"))
380 || mimeType.inherits(QStringLiteral("application/x-compressed-tar"))) {
381 // clang-format on
383 } else {
384 qCCritical(KNEWSTUFFCORE) << "Could not determine type of archive file" << payloadfile;
386 Q_EMIT signalInstallationError(i18n("Could not determine the type of archive of the downloaded file %1", payloadfile), entry);
387 return QStringList();
388 }
389 isarchive = false;
390 }
391
392 if (isarchive) {
393 bool success = archive->open(QIODevice::ReadOnly);
394 if (!success) {
395 qCCritical(KNEWSTUFFCORE) << "Cannot open archive file" << payloadfile;
398 i18n("Failed to open the archive file %1. The reported error was: %2", payloadfile, archive->errorString()),
399 entry);
400 return QStringList();
401 }
402 // otherwise, just copy the file
403 isarchive = false;
404 }
405
406 if (isarchive) {
407 const KArchiveDirectory *dir = archive->directory();
408 // if there is more than an item in the file, and we are requested to do so
409 // put contents in a subdirectory with the same name as the file
411 const bool isSubdir =
413 if (isSubdir) {
415 } else {
417 }
418
419 if (dir->copyTo(installpath)) {
420 // If we extracted the subdir we want to save it using the /* notation like we would when using the "archive" option
421 // Also if we use an (un)install command we only call it once with the folder as argument and not for each file
422 if (isSubdir) {
423 installedFiles << QDir(installpath).absolutePath() + QLatin1String("/*");
424 } else {
425 installedFiles << archiveEntries(installpath, dir);
426 }
427 } else {
428 qCWarning(KNEWSTUFFCORE) << "could not install" << entry.name() << "to" << installpath;
429 }
430
431 archive->close();
433 }
434 }
435 }
436
437 qCDebug(KNEWSTUFFCORE) << "isarchive:" << isarchive;
438
439 // some wallpapers are compressed, some aren't
440 if ((!isarchive && standardResourceDirectory == QLatin1String("wallpaper"))
443 // no decompress but move to target
444
445 /// @todo when using KIO::get the http header can be accessed and it contains a real file name.
446 // FIXME: make naming convention configurable through *.knsrc? e.g. for kde-look.org image names
447 QUrl source = QUrl(entry.payload());
448 qCDebug(KNEWSTUFFCORE) << "installing non-archive from" << source;
450
451 qCDebug(KNEWSTUFFCORE) << "Install to file" << installpath;
452 // FIXME: copy goes here (including overwrite checking)
453 // FIXME: what must be done now is to update the cache *again*
454 // in order to set the new payload filename (on root tag only)
455 // - this might or might not need to take uncompression into account
456 // FIXME: for updates, we might need to force an overwrite (that is, deleting before)
457 QFile file(payloadfile);
458 bool success = true;
459 const bool update = ((entry.status() == KNSCore::Entry::Updateable) || (entry.status() == KNSCore::Entry::Updating));
460
462 if (!update) {
463 Question question(Question::YesNoQuestion);
464 question.setEntry(entry);
465 question.setQuestion(i18n("This file already exists on disk (possibly due to an earlier failed download attempt). Continuing means "
466 "overwriting it. Do you wish to overwrite the existing file?")
467 + QStringLiteral("\n'") + installpath + QLatin1Char('\''));
468 question.setTitle(i18n("Overwrite File"));
469 if (question.ask() != Question::YesResponse) {
470 return QStringList();
471 }
472 }
473 success = QFile::remove(installpath);
474 }
475 if (success) {
476 // remove in case it's already present and in a temporary directory, so we get to actually use the path again
477 if (installpath.startsWith(QDir::tempPath())) {
479 }
480 success = file.rename(installpath);
481 qCWarning(KNEWSTUFFCORE) << "move:" << file.fileName() << "to" << installpath;
482 if (!success) {
483 qCWarning(KNEWSTUFFCORE) << file.errorString();
484 }
485 }
486 if (!success) {
487 Q_EMIT signalInstallationError(i18n("Unable to move the file %1 to the intended destination %2", payloadfile, installpath), entry);
488 qCCritical(KNEWSTUFFCORE) << "Cannot move file" << payloadfile << "to destination" << installpath;
489 return QStringList();
490 }
491 installedFiles << installpath;
492 }
493 }
494
495 return installedFiles;
496}
497
498QProcess *Installation::runPostInstallationCommand(const QString &installPath, const KNSCore::Entry &entry)
499{
502 command.replace(QLatin1String("%f"), fileArg);
503
504 qCDebug(KNEWSTUFFCORE) << "Run command:" << command;
505
506 QProcess *ret = new QProcess(this);
507 auto onProcessFinished = [this, command, ret, entry](int exitcode, QProcess::ExitStatus status) {
508 const QString output{QString::fromLocal8Bit(ret->readAllStandardError())};
510 QString errorMessage = i18n("The installation failed while attempting to run the command:\n%1\n\nThe returned output was:\n%2", command, output);
511 Q_EMIT signalInstallationError(errorMessage, entry);
512 qCCritical(KNEWSTUFFCORE) << "Process crashed with command:" << command;
513 } else if (exitcode) {
514 // 130 means Ctrl+C as an exit code this is interpreted by KNewStuff as cancel operation
515 // and no error will be displayed to the user, BUG: 436355
516 if (exitcode == 130) {
517 qCCritical(KNEWSTUFFCORE) << "Command" << command << "failed was aborted by the user";
518 Q_EMIT signalInstallationFinished(entry);
519 } else {
521 i18n("The installation failed with code %1 while attempting to run the command:\n%2\n\nThe returned output was:\n%3",
522 exitcode,
523 command,
524 output),
525 entry);
526 qCCritical(KNEWSTUFFCORE) << "Command" << command << "failed with code" << exitcode;
527 }
528 }
529 sender()->deleteLater();
530 };
531 connect(ret, &QProcess::finished, this, onProcessFinished);
532
534 ret->setProgram(args.takeFirst());
535 ret->setArguments(args);
536 ret->start();
537 return ret;
538}
539
540void Installation::uninstall(Entry entry)
541{
542 const auto deleteFilesAndMarkAsUninstalled = [entry, this]() {
543 bool deletionSuccessful = true;
544 const auto lst = entry.installedFiles();
545 for (const QString &file : lst) {
546 // This is used to delete the download location if there are no more entries
547 QFileInfo info(file);
548 if (info.isDir()) {
549 QDir().rmdir(file);
550 } else if (file.endsWith(QLatin1String("/*"))) {
551 QDir dir(file.left(file.size() - 2));
552 bool worked = dir.removeRecursively();
553 if (!worked) {
554 qCWarning(KNEWSTUFFCORE) << "Couldn't remove" << dir.path();
555 continue;
556 }
557 } else {
558 if (info.exists() || info.isSymLink()) {
559 bool worked = QFile::remove(file);
560 if (!worked) {
561 qWarning() << "unable to delete file " << file;
563 i18n("The removal of %1 failed, as the installed file %2 could not be automatically removed. You can attempt to manually delete "
564 "this file, if you believe this is an error.",
565 entry.name(),
566 file),
567 entry);
568 // Assume that the uninstallation has failed, and reset the entry to an installed state
569 deletionSuccessful = false;
570 break;
571 }
572 } else {
573 qWarning() << "unable to delete file " << file << ". file does not exist.";
574 }
575 }
576 }
577 Entry newEntry = entry;
578 if (deletionSuccessful) {
579 newEntry.setEntryDeleted();
580 } else {
581 newEntry.setStatus(KNSCore::Entry::Installed);
582 }
583
585 };
586
588 const auto lst = entry.installedFiles();
589 if (lst.length() == 1) {
590 const QString installedFile{lst.first()};
591
593 connect(job, &KJob::result, this, [this, installedFile, entry, job]() {
594 Entry newEntry = entry;
595 if (job->error() == KJob::NoError) {
596 newEntry.setEntryDeleted();
597 Q_EMIT signalEntryChanged(newEntry);
598 } else {
599 Q_EMIT signalInstallationFailed(i18n("Installation of %1 failed: %2", installedFile, job->errorText()), entry);
600 }
601 });
602 }
604 } else {
605 const auto lst = entry.installedFiles();
606 // If there is an uninstall script, make sure it runs without errors
607 if (!uninstallCommand.isEmpty()) {
608 bool validFileExisted = false;
609 for (const QString &file : lst) {
610 QString filePath = file;
611 bool validFile = QFileInfo::exists(filePath);
612 // If we have uncompressed a subdir we write <path>/* in the config, but when calling a script
613 // we want to convert this to a normal path
614 if (!validFile && file.endsWith(QLatin1Char('*'))) {
615 filePath = filePath.left(filePath.lastIndexOf(QLatin1Char('*')));
616 validFile = QFileInfo::exists(filePath);
617 }
618 if (validFile) {
619 validFileExisted = true;
621 QString command(uninstallCommand);
622 command.replace(QLatin1String("%f"), fileArg);
623
625 const QString program = args.takeFirst();
626 QProcess *process = new QProcess(this);
627 process->start(program, args);
628 auto onProcessFinished = [this, command, process, entry, deleteFilesAndMarkAsUninstalled](int, QProcess::ExitStatus status) {
630 const QString processOutput = QString::fromLocal8Bit(process->readAllStandardError());
631 const QString err = i18n(
632 "The uninstallation process failed to successfully run the command %1\n"
633 "The output of was: \n%2\n"
634 "If you think this is incorrect, you can continue or cancel the uninstallation process",
635 KShell::quoteArg(command),
637 Q_EMIT signalInstallationError(err, entry);
638 // Ask the user if he wants to continue, even though the script failed
639 Question question(Question::ContinueCancelQuestion);
640 question.setEntry(entry);
641 question.setQuestion(err);
642 Question::Response response = question.ask();
643 if (response == Question::CancelResponse) {
644 // Use can delete files manually
645 Entry newEntry = entry;
646 newEntry.setStatus(KNSCore::Entry::Installed);
648 return;
649 }
650 } else {
651 qCDebug(KNEWSTUFFCORE) << "Command executed successfully:" << command;
652 }
654 };
655 connect(process, &QProcess::finished, this, onProcessFinished);
656 }
657 }
658 // If the entry got deleted, but the RemoveDeadEntries option was not selected this case can happen
659 if (!validFileExisted) {
661 }
662 } else {
664 }
665 }
666}
667
668Installation::UncompressionOptions Installation::uncompressionSetting() const
669{
670 return uncompressSetting;
671}
672
673QStringList Installation::archiveEntries(const QString &path, const KArchiveDirectory *dir)
674{
675 QStringList files;
676 const auto lst = dir->entries();
677 for (const QString &entry : lst) {
678 const auto currentEntry = dir->entry(entry);
679
680 const QString childPath = QDir(path).filePath(entry);
681 if (currentEntry->isFile()) {
682 files << childPath;
683 } else if (currentEntry->isDirectory()) {
684 files << childPath + QStringLiteral("/*");
685 }
686 }
687 return files;
688}
689
690#include "moc_installation_p.cpp"
QString readEntry(const char *key, const char *aDefault=nullptr) const
virtual QString errorString() const
int error() const
void result(KJob *job)
void finished(KJob *job)
QString errorText() const
KNewStuff data entry container.
Definition entry.h:48
void setInstalledFiles(const QStringList &files)
Set the files that have been installed by the install command.
Definition entry.cpp:388
QStringList installedFiles() const
Retrieve the locally installed files.
Definition entry.cpp:393
QString payload() const
Retrieve the file name of the object.
Definition entry.cpp:240
void setStatus(KNSCore::Entry::Status status)
Sets the entry's status.
Definition entry.cpp:383
A way to ask a user a question from inside a GUI-less library (like KNewStuffCore)
Definition question.h:47
static PackageJob * uninstall(const QString &packageFormat, const QString &pluginId, const QString &packageRoot=QString())
static PackageJob * install(const QString &packageFormat, const QString &sourcePackage, const QString &packageRoot=QString())
Q_SCRIPTABLE CaptureState status()
QString i18n(const char *text, const TYPE &arg...)
void update(Part *part, const QByteArray &data, qint64 dataSize)
KCALUTILS_EXPORT QString mimeType()
KCALUTILS_EXPORT QString errorMessage(const KCalendarCore::Exception &exception)
QVariant location(const QVariant &res)
QString path(const QString &relativePath)
void error(QWidget *parent, const QString &text, const QString &title, const KGuiItem &buttonOk, Options options=Notify)
KIOCORE_EXPORT QString dir(const QString &fileClass)
KCOREADDONS_EXPORT QStringList splitArgs(const QString &cmd, Options flags=NoOptions, Errors *err=nullptr)
KCOREADDONS_EXPORT QString quoteArg(const QString &arg)
QString absolutePath() const const
QString filePath(const QString &fileName) const const
QString homePath()
bool mkpath(const QString &dirPath) const const
bool rmdir(const QString &dirName) const const
QString tempPath()
bool exists() const const
bool remove()
QString baseName() const const
bool exists() const const
const T & constLast() const const
T & first()
bool isEmpty() const const
QMimeType mimeTypeForFile(const QString &fileName, QMimeDatabase::MatchMode mode) const const
void finished(int exitCode)
void start(const QString &program, const QStringList &arguments, QIODevice::OpenMode mode)
QString locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options)
QStringList standardLocations(QStandardPaths::StandardLocation type)
QString writableLocation(QStandardPaths::StandardLocation type)
QString fromLocal8Bit(const char *str, int size)
QString fromUtf16(const ushort *unicode, int size)
bool isEmpty() const const
int lastIndexOf(QChar ch, int from, Qt::CaseSensitivity cs) const const
QString left(int n) const const
QString fileName(QUrl::ComponentFormattingOptions options) const const
QUrl fromLocalFile(const QString &localFile)
bool isValid() const const
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Sun Feb 25 2024 18:48:13 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.