/****************************************************************************** * Copyright 2007 by Aaron Seigo * * Copyright 2010 by Marco Martin * * Copyright 2010 by Kevin Ottens * * Copyright 2009 by Rob Scheepmaker * * * * This library is free software; you can redistribute it and/or * * modify it under the terms of the GNU Library General Public * * License as published by the Free Software Foundation; either * * version 2 of the License, or (at your option) any later version. * * * * This library 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 * * Library General Public License for more details. * * * * You should have received a copy of the GNU Library General Public License * * along with this library; see the file COPYING.LIB. If not, write to * * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * * Boston, MA 02110-1301, USA. * *******************************************************************************/ #include "package.h" #include #include #include #include #include #include #include #include #include "config-plasma.h" #include #include #include "packagestructure.h" #include "pluginloader.h" #include "private/package_p.h" #include "private/packages_p.h" #include "private/packagejob_p.h" namespace Plasma { Package::Package(PackageStructure *structure) : d(new PackagePrivate()) { d->structure = structure; if (d->structure) { d->structure.data()->initPackage(this); } } Package::Package(const Package &other) : d(other.d) { } Package::~Package() { } Package &Package::operator=(const Package &rhs) { if (&rhs != this) { d = rhs.d; } return *this; } bool Package::isValid() const { if (d->checkedValid) { return d->valid; } d->valid = true; //search for the file in all prefixes and in all possible paths for each prefix //even if it's a big nested loop, usually there is one prefix and one location //so shouldn't cause too much disk access QHashIterator it(d->contents); while (it.hasNext()) { it.next(); if (!it.value().required) { continue; } bool failed = true; foreach (const QString &path, it.value().paths) { foreach (const QString &prefix, d->contentsPrefixPaths) { if (QFile::exists(d->path + prefix + path)) { failed = false; break; } } if (!failed) { break; } } if (failed) { kWarning() << "Could not find required" << (it.value().directory ? "directory" : "file") << it.key(); d->valid = false; break; } } return d->valid; } QString Package::name(const char *key) const { #ifndef PLASMA_NO_PACKAGE_EXTRADATA QHash::const_iterator it = d->contents.constFind(key); if (it == d->contents.constEnd()) { return QString(); } return it.value().name; #else Q_UNUSED(key); return QString(); #endif } bool Package::isRequired(const char *key) const { QHash::const_iterator it = d->contents.constFind(key); if (it == d->contents.constEnd()) { return false; } return it.value().required; } QStringList Package::mimeTypes(const char *key) const { #ifndef PLASMA_NO_PACKAGE_EXTRADATA QHash::const_iterator it = d->contents.constFind(key); if (it == d->contents.constEnd()) { return QStringList(); } if (it.value().mimeTypes.isEmpty()) { return d->mimeTypes; } return it.value().mimeTypes; #else return QStringList(); #endif } QString Package::defaultPackageRoot() const { return d->defaultPackageRoot; } void Package::setDefaultPackageRoot(const QString &packageRoot) { d.detach(); d->defaultPackageRoot = packageRoot; if (!d->defaultPackageRoot.isEmpty() && !d->defaultPackageRoot.endsWith('/')) { d->defaultPackageRoot.append('/'); } } QString Package::servicePrefix() const { return d->servicePrefix; } void Package::setServicePrefix(const QString &servicePrefix) { d.detach(); d->servicePrefix = servicePrefix; } bool Package::allowExternalPaths() const { return d->externalPaths; } void Package::setAllowExternalPaths(bool allow) { d.detach(); d->externalPaths = allow; } KPluginInfo Package::metadata() const { if (!d->metadata && !d->path.isEmpty()) { const QString metadataPath = filePath("metadata"); if (!metadataPath.isEmpty()) { d->createPackageMetadata(metadataPath); } else { QFileInfo fileInfo(d->path); if (fileInfo.isDir()) { d->createPackageMetadata(d->path); } else if (fileInfo.exists()) { KArchive *archive = 0; QMimeDatabase db; QMimeType mimeType = db.mimeTypeForFile(d->path); if (mimeType.inherits("application/zip")) { archive = new KZip(d->path); } else if (mimeType.inherits("application/x-compressed-tar") || mimeType.inherits("application/x-gzip") || mimeType.inherits("application/x-tar") || mimeType.inherits("application/x-bzip-compressed-tar") || mimeType.inherits("application/x-xz") || mimeType.inherits("application/x-lzma")) { archive = new KTar(d->path); } else { kWarning() << "Could not open package file, unsupported archive format:" << d->path << mimeType.name(); } if (archive && archive->open(QIODevice::ReadOnly)) { const KArchiveDirectory *source = archive->directory(); QTemporaryDir tempdir; source->copyTo(tempdir.path() + '/'); d->createPackageMetadata(tempdir.path() + '/'); } else { kWarning() << "Could not open package file:" << d->path; } delete archive; } } } if (!d->metadata) { d->metadata = new KPluginInfo(); } return *d->metadata; } QString Package::filePath(const char *fileType, const QString &filename) const { if (!d->valid) { //kDebug() << "package is not valid"; return QString(); } const QString discoveryKey(fileType + filename); if (d->discoveries.contains(discoveryKey)) { //qDebug() << "looking for" << discoveryKey << d->discoveries.value(discoveryKey); return d->discoveries[discoveryKey]; } QStringList paths; if (qstrlen(fileType) != 0) { kDebug()<contents.keys(); if (!d->contents.contains(fileType)) { kDebug() << "package does not contain" << fileType << filename; return QString(); } paths = d->contents[fileType].paths; if (paths.isEmpty()) { //kDebug() << "no matching path came of it, while looking for" << fileType << filename; d->discoveries.insert(discoveryKey, QString()); return QString(); } } else { //when filetype is empty paths is always empty, so try with an empty string paths << QString(); } //Nested loop, but in the medium case resolves to just one iteration //kDebug() << "prefixes:" << prefixes.count() << prefixes; foreach (const QString &contentsPrefix, d->contentsPrefixPaths) { const QString prefix(d->path + contentsPrefix); foreach (const QString &path, paths) { QString file = prefix + path; if (!filename.isEmpty()) { file.append("/").append(filename); } //kDebug() << "testing" << file << QFile::exists("/bin/ls") << QFile::exists(file); if (QFile::exists(file)) { if (d->externalPaths) { //kDebug() << "found" << file; d->discoveries.insert(discoveryKey, file); return file; } // ensure that we don't return files outside of our base path // due to symlink or ../ games QDir dir(file); QString canonicalized = dir.canonicalPath() + QDir::separator(); //kDebug() << "testing that" << canonicalized << "is in" << d->path; if (canonicalized.startsWith(d->path)) { //kDebug() << "found" << file; d->discoveries.insert(discoveryKey, file); return file; } } } } //kDebug() << fileType << filename << "does not exist in" << prefixes << "at root" << d->path; return QString(); } QStringList Package::entryList(const char *key) const { if (!d->valid) { return QStringList(); } QHash::const_iterator it = d->contents.constFind(key); if (it == d->contents.constEnd()) { //kDebug() << "couldn't find" << key; return QStringList(); } //kDebug() << "going to list" << key; QStringList list; foreach (const QString &prefix, d->contentsPrefixPaths) { //kDebug() << " looking in" << prefix; foreach (const QString &path, it.value().paths) { //kDebug() << " looking in" << path; if (it.value().directory) { //kDebug() << "it's a directory, so trying out" << d->path + prefix + path; QDir dir(d->path + prefix + path); if (d->externalPaths) { list += dir.entryList(QDir::Files | QDir::Readable); } else { // ensure that we don't return files outside of our base path // due to symlink or ../ games QString canonicalized = dir.canonicalPath(); if (canonicalized.startsWith(d->path)) { list += dir.entryList(QDir::Files | QDir::Readable); } } } else { const QString fullPath = d->path + prefix + path; //kDebug() << "it's a file at" << fullPath << QFile::exists(fullPath); if (!QFile::exists(fullPath)) { continue; } if (d->externalPaths) { list += fullPath; } else { QDir dir(fullPath); QString canonicalized = dir.canonicalPath() + QDir::separator(); //kDebug() << "testing that" << canonicalized << "is in" << d->path; if (canonicalized.startsWith(d->path)) { list += fullPath; } } } } } return list; } void Package::setPath(const QString &path) { kDebug() << "Package::setPath() " << path; // if the path is already what we have, don't bother if (path == d->path) { return; } // our dptr is shared, and it is almost certainly doing to change. // hold onto the old pointer just incase! QExplicitlySharedDataPointer oldD(d); d.detach(); // whithout structure we doomed if (!d->structure) { d->path.clear(); d->discoveries.clear(); d->valid = false; d->checkedValid = true; return; } // empty path => nothing to do if (path.isEmpty()) { d->path.clear(); d->discoveries.clear(); d->valid = false; d->structure.data()->pathChanged(this); return; } // now we look for all possible paths, including resolving // relative paths against the system search paths QStringList paths; if (QDir::isRelativePath(path)) { QString p; if (d->defaultPackageRoot.isEmpty()) { p = path % "/"; } else { p = d->defaultPackageRoot % path % "/"; } if (QDir::isRelativePath(p)) { paths << QStandardPaths::locateAll(QStandardPaths::GenericDataLocation, p, QStandardPaths::LocateDirectory); } else { const QDir dir(p); if (QFile::exists(dir.canonicalPath())) { paths << p; } } } else { const QDir dir(path); if (QFile::exists(dir.canonicalPath())) { paths << path; } } // now we search each path found, caching our previous path to know if // anything actually really changed const QString previousPath = d->path; foreach (const QString &p, paths) { d->checkedValid = false; d->path = p; if (!d->path.endsWith('/')) { d->path.append('/'); } // we need to tell the structure we're changing paths ... d->structure.data()->pathChanged(this); // ... and then testing the results for validity if (isValid()) { break; } } // if nothing did change, then we go back to the old dptr if (d->path == previousPath) { d = oldD; return; } // .. but something did change, so we get rid of our discovery cache d->discoveries.clear(); delete d->metadata; d->metadata = 0; // uh-oh, but we didn't end up with anything valid, so we sadly reset ourselves // to futility. if (!d->valid) { d->path.clear(); d->structure.data()->pathChanged(this); } } const QString Package::path() const { return d->path; } QStringList Package::contentsPrefixPaths() const { return d->contentsPrefixPaths; } void Package::setContentsPrefixPaths(const QStringList &prefixPaths) { d.detach(); d->contentsPrefixPaths = prefixPaths; if (d->contentsPrefixPaths.isEmpty()) { d->contentsPrefixPaths << QString(); } else { // the code assumes that the prefixes have a trailing slash // so let's make that true here QMutableStringListIterator it(d->contentsPrefixPaths); while (it.hasNext()) { it.next(); if (!it.value().endsWith('/')) { it.setValue(it.value() % '/'); } } } } QString Package::contentsHash() const { if (!d->valid) { kWarning() << "can not create hash due to Package being invalid"; return QString(); } QCryptographicHash hash(QCryptographicHash::Sha1); QString metadataPath = d->path + "metadata.desktop"; if (QFile::exists(metadataPath)) { QFile f(metadataPath); if (f.open(QIODevice::ReadOnly)) { while (!f.atEnd()) { hash.addData(f.read(1024)); } } else { kWarning() << "could not add" << f.fileName() << "to the hash; file could not be opened for reading."; } } else { kWarning() << "no metadata at" << metadataPath; } foreach (QString prefix, d->contentsPrefixPaths) { const QString basePath = d->path + prefix; QDir dir(basePath); if (!dir.exists()) { return QString(); } d->updateHash(basePath, QString(), dir, hash); } return hash.result().toHex(); } void Package::addDirectoryDefinition(const char *key, const QString &path, const QString &name) { ContentStructure s; if (d->contents.contains(key)) { s = d->contents[key]; } #ifndef PLASMA_NO_PACKAGE_EXTRADATA if (!name.isEmpty()) { s.name = name; } #else Q_UNUSED(name) #endif s.paths.append(path); s.directory = true; d->contents[key] = s; } void Package::addFileDefinition(const char *key, const QString &path, const QString &name) { ContentStructure s; if (d->contents.contains(key)) { s = d->contents[key]; } #ifndef PLASMA_NO_PACKAGE_EXTRADATA if (!name.isEmpty()) { s.name = name; } #else Q_UNUSED(name) #endif s.paths.append(path); s.directory = false; d->contents[key] = s; } void Package::removeDefinition(const char *key) { d->contents.remove(key); } void Package::setRequired(const char *key, bool required) { QHash::iterator it = d->contents.find(key); if (it == d->contents.end()) { return; } d.detach(); it.value().required = required; } void Package::setDefaultMimeTypes(QStringList mimeTypes) { #ifndef PLASMA_NO_PACKAGE_EXTRADATA d.detach(); d->mimeTypes = mimeTypes; #endif } void Package::setMimeTypes(const char *key, QStringList mimeTypes) { #ifndef PLASMA_NO_PACKAGE_EXTRADATA QHash::iterator it = d->contents.find(key); if (it == d->contents.end()) { return; } d.detach(); it.value().mimeTypes = mimeTypes; #endif } QList Package::directories() const { QList dirs; QHash::const_iterator it = d->contents.constBegin(); while (it != d->contents.constEnd()) { if (it.value().directory) { dirs << it.key(); } ++it; } return dirs; } QList Package::requiredDirectories() const { QList dirs; QHash::const_iterator it = d->contents.constBegin(); while (it != d->contents.constEnd()) { if (it.value().directory && it.value().required) { dirs << it.key(); } ++it; } return dirs; } QList Package::files() const { QList files; QHash::const_iterator it = d->contents.constBegin(); while (it != d->contents.constEnd()) { if (!it.value().directory) { files << it.key(); } ++it; } return files; } QList Package::requiredFiles() const { QList files; QHash::const_iterator it = d->contents.constBegin(); while (it != d->contents.constEnd()) { if (!it.value().directory && it.value().required) { files << it.key(); } ++it; } return files; } KJob* Package::install(const QString &sourcePackage, const QString &packageRoot) { const QString src = sourcePackage; const QString dest = packageRoot.isEmpty() ? defaultPackageRoot() : packageRoot; //kDebug() << "Source: " << src; //kDebug() << "PackageRoot: " << dest; d->path = packageRoot + "plasma-applet-org.kde.microblog-qml"; KJob *j = d->structure.data()->install(this, src, dest); //connect(j, SIGNAL(finished(bool)), SLOT(installFinished(bool))); return j; } KJob* Package::uninstall(const QString &packageName, const QString &packageRoot) { const QString pname = metadata().pluginName(); QString proot = path(); proot.replace(pname, ""); kDebug() << "Package::uninstalling ... " << packageRoot << proot << pname << packageName; return d->structure.data()->uninstall(this, packageRoot); } PackagePrivate::PackagePrivate() : QSharedData(), servicePrefix("plasma-applet-"), metadata(0), externalPaths(false), valid(false), checkedValid(false) { contentsPrefixPaths << "contents/"; } PackagePrivate::PackagePrivate(const PackagePrivate &other) : QSharedData() { *this = other; metadata = 0; } PackagePrivate::~PackagePrivate() { delete metadata; } PackagePrivate &PackagePrivate::operator=(const PackagePrivate &rhs) { if (&rhs == this) { return *this; } structure = rhs.structure; path = rhs.path; contentsPrefixPaths = rhs.contentsPrefixPaths; servicePrefix = rhs.servicePrefix; contents = rhs.contents; #ifndef PLASMA_NO_PACKAGE_EXTRADATA mimeTypes = rhs.mimeTypes; #endif defaultPackageRoot = rhs.defaultPackageRoot; servicePrefix = rhs.servicePrefix; metadata = 0; externalPaths = rhs.externalPaths; valid = rhs.valid; return *this; } void PackagePrivate::updateHash(const QString &basePath, const QString &subPath, const QDir &dir, QCryptographicHash &hash) { // hash is calculated as a function of: // * files ordered alphabetically by name, with each file's: // * path relative to the content root // * file data // * directories ordered alphabetically by name, with each dir's: // * path relative to the content root // * file listing (recursing) // symlinks (in both the file and dir case) are handled by adding // the name of the symlink itself and the abs path of what it points to const QDir::SortFlags sorting = QDir::Name | QDir::IgnoreCase; const QDir::Filters filters = QDir::Hidden | QDir::System | QDir::NoDotAndDotDot; foreach (const QString &file, dir.entryList(QDir::Files | filters, sorting)) { if (!subPath.isEmpty()) { hash.addData(subPath.toUtf8()); } hash.addData(file.toUtf8()); QFileInfo info(dir.path() + '/' + file); if (info.isSymLink()) { hash.addData(info.symLinkTarget().toUtf8()); } else { QFile f(info.filePath()); if (f.open(QIODevice::ReadOnly)) { while (!f.atEnd()) { hash.addData(f.read(1024)); } } else { kWarning() << "could not add" << f.fileName() << "to the hash; file could not be opened for reading. " << "permissions fail?" << info.permissions() << info.isFile(); } } } foreach (const QString &subDirPath, dir.entryList(QDir::Dirs | filters, sorting)) { const QString relativePath = subPath + subDirPath + '/'; hash.addData(relativePath.toUtf8()); QDir subDir(dir.path()); subDir.cd(subDirPath); if (subDir.path() != subDir.canonicalPath()) { hash.addData(subDir.canonicalPath().toUtf8()); } else { updateHash(basePath, relativePath, subDir, hash); } } } void PackagePrivate::createPackageMetadata(const QString &path) { delete metadata; QString metadataPath(path + "/metadata.desktop"); if (!QFile::exists(metadataPath)) { kWarning() << "No metadata file in the package, expected it at:" << metadataPath; metadataPath.clear(); } metadata = new KPluginInfo(metadataPath); } } // Namespace