/************************************************************************** ** ** Copyright (C) 2021 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Installer Framework. ** ** $QT_BEGIN_LICENSE:GPL-EXCEPT$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** **************************************************************************/ #include "loggingutils.h" #include "component.h" #include "localpackagehub.h" #include "globals.h" #include "fileutils.h" #include "remoteclient.h" #include "remotefileengine.h" #include #include #include #if defined(Q_OS_UNIX) #include #elif defined(Q_OS_WIN) #include #include #endif namespace QInstaller { /*! \class QInstaller::LoggingHandler \inmodule QtInstallerFramework \brief The LoggingHandler class provides methods for manipulating the application-wide verbosiveness and format of printed debug messages. The class also contains utility methods for printing common preformatted messages. */ /*! \inmodule QtInstallerFramework \class QInstaller::Uptime \internal */ /*! \inmodule QtInstallerFramework \class QInstaller::VerboseWriter \internal */ /*! \inmodule QtInstallerFramework \class QInstaller::VerboseWriterOutput \internal */ /*! \inmodule QtInstallerFramework \class QInstaller::PlainVerboseWriterOutput \internal */ /*! \inmodule QtInstallerFramework \class QInstaller::VerboseWriterAdminOutput \internal */ /*! \enum LoggingHandler::VerbosityLevel \brief This enum holds the possible levels of output verbosity. \value Silent \value Normal \value Detailed \value Minimum Minimum possible verbosity level. Synonym for \c VerbosityLevel::Silent. \value Maximum Maximum possible verbosity level. Synonym for \c VerbosityLevel::Detailed. */ // start timer on construction (so we can use it as static member) class Uptime : public QElapsedTimer { public: Uptime() { start(); } }; /*! \internal */ LoggingHandler::LoggingHandler() : m_verbLevel(VerbosityLevel::Silent) { #if defined(Q_OS_UNIX) m_outputRedirected = !isatty(fileno(stdout)); #elif defined(Q_OS_WIN) m_outputRedirected = !_isatty(_fileno(stdout)); #endif } /*! \internal */ LoggingHandler::~LoggingHandler() { } /*! Prints out preformatted debug messages, warnings, critical and fatal error messages specified by \a msg and \a type. The message \a context provides information about the source code location the message was generated. */ void LoggingHandler::messageHandler(QtMsgType type, const QMessageLogContext &context, const QString &msg) { // suppress warning from QPA minimal plugin if (msg.contains(QLatin1String("This plugin does not support propagateSizeHints"))) return; if (context.category == lcProgressIndicator().categoryName()) { if (!outputRedirected()) std::cout << msg.toStdString() << "\r" << std::flush; return; } static Uptime uptime; QString ba; if (context.category != lcPackageInfo().categoryName()) { ba = QLatin1Char('[') + QString::number(uptime.elapsed()) + QStringLiteral("] "); } ba += trimAndPrepend(type, msg); if (type != QtDebugMsg && context.file) { ba += QString(QStringLiteral(" (%1:%2, %3)")).arg( QString::fromLatin1(context.file)).arg(context.line).arg( QString::fromLatin1(context.function)); } if (VerboseWriter *log = VerboseWriter::instance()) log->appendLine(ba); if (type != QtDebugMsg || isVerbose()) std::cout << qPrintable(ba) << std::endl; if (type == QtFatalMsg) { QtMessageHandler oldMsgHandler = qInstallMessageHandler(nullptr); qt_message_output(type, context, msg); qInstallMessageHandler(oldMsgHandler); } } /*! Trims the trailing space character and surrounding quotes from \a msg. Also prepends the message \a type to the message. */ QString LoggingHandler::trimAndPrepend(QtMsgType type, const QString &msg) const { QString ba(msg); // last character is a space from qDebug if (ba.endsWith(QLatin1Char(' '))) ba.chop(1); // remove quotes if the whole message is surrounded with them if (ba.startsWith(QLatin1Char('"')) && ba.endsWith(QLatin1Char('"'))) ba = ba.mid(1, ba.length() - 2); // prepend the message type, skip QtDebugMsg switch (type) { case QtWarningMsg: ba.prepend(QStringLiteral("Warning: ")); break; case QtCriticalMsg: ba.prepend(QStringLiteral("Critical: ")); break; case QtFatalMsg: ba.prepend(QStringLiteral("Fatal: ")); break; default: break; } return ba; } /*! Returns the only instance of this class. */ LoggingHandler &LoggingHandler::instance() { static LoggingHandler instance; return instance; } /*! Sets to verbose output if \a v is set to \c true. Calling this multiple times increases or decreases the verbosity level accordingly. */ void LoggingHandler::setVerbose(bool v) { if (v) m_verbLevel++; else m_verbLevel--; } /*! Returns \c true if the installer is set to verbose output. */ bool LoggingHandler::isVerbose() const { return m_verbLevel != VerbosityLevel::Silent; } /*! Returns the current verbosity level. */ LoggingHandler::VerbosityLevel LoggingHandler::verboseLevel() const { return m_verbLevel; } /*! Returns \c true if output is redirected, i.e. to a file. */ bool LoggingHandler::outputRedirected() const { return m_outputRedirected; } /*! Prints basic information about \a components. */ void LoggingHandler::printComponentInfo(const QList components) const { QDomDocument doc; QDomElement root = doc.createElement(QLatin1String("updates")); doc.appendChild(root); foreach (Component *component, components) { QDomElement update = doc.createElement(QLatin1String("update")); update.setAttribute(QLatin1String("name"), component->value(scDisplayName)); update.setAttribute(QLatin1String("version"), component->value(scVersion)); update.setAttribute(QLatin1String("size"), component->value(scUncompressedSize)); update.setAttribute(QLatin1String("id"), component->value(scName)); root.appendChild(update); } qCDebug(lcPackageInfo) << qPrintable(doc.toString(4)); } /*! Prints basic or more detailed information about local \a packages, depending on the current verbosity level. */ void LoggingHandler::printLocalPackageInformation(const QList &packages) const { QDomDocument doc; QDomElement root = doc.createElement(QLatin1String("localpackages")); doc.appendChild(root); foreach (KDUpdater::LocalPackage package, packages) { QDomElement update = doc.createElement(QLatin1String("package")); update.setAttribute(QLatin1String("name"), package.name); update.setAttribute(QLatin1String("displayname"), package.title); update.setAttribute(QLatin1String("version"), package.version); if (verboseLevel() == VerbosityLevel::Detailed) { update.setAttribute(QLatin1String("description"), package.description); update.setAttribute(QLatin1String("dependencies"), package.dependencies.join(QLatin1Char(','))); update.setAttribute(QLatin1String("autoDependencies"), package.autoDependencies.join(QLatin1Char(','))); update.setAttribute(QLatin1String("virtual"), package.virtualComp); update.setAttribute(QLatin1String("forcedInstallation"), package.forcedInstallation); update.setAttribute(QLatin1String("checkable"), package.checkable); update.setAttribute(QLatin1String("uncompressedSize"), package.uncompressedSize); update.setAttribute(QLatin1String("installDate"), package.installDate.toString()); update.setAttribute(QLatin1String("lastUpdateDate"), package.lastUpdateDate.toString()); } root.appendChild(update); } qCDebug(lcPackageInfo) << qPrintable(doc.toString(4)); } /*! Prints basic or more detailed information about available \a matchedPackages, depending on the current verbosity level. If a package is also present in \a installedPackages, the installed version will be included in printed information. */ void LoggingHandler::printPackageInformation(const PackagesList &matchedPackages, const LocalPackagesHash &installedPackages) const { QDomDocument doc; QDomElement root = doc.createElement(QLatin1String("availablepackages")); doc.appendChild(root); foreach (Package *package, matchedPackages) { const QString name = package->data(scName).toString(); QDomElement update = doc.createElement(QLatin1String("package")); update.setAttribute(QLatin1String("name"), name); update.setAttribute(QLatin1String("displayname"), package->data(scDisplayName).toString()); update.setAttribute(QLatin1String("version"), package->data(scVersion).toString()); //Check if package already installed if (installedPackages.contains(name)) update.setAttribute(QLatin1String("installedVersion"), installedPackages.value(name).version); if (verboseLevel() == VerbosityLevel::Detailed) { update.setAttribute(QLatin1String("description"), package->data(scDescription).toString()); update.setAttribute(QLatin1String("dependencies"), package->data(scDependencies).toString()); update.setAttribute(QLatin1String("autoDependencies"), package->data(scAutoDependOn).toString()); update.setAttribute(QLatin1String("virtual"), package->data(scVirtual).toString()); update.setAttribute(QLatin1String("forcedInstallation"), package->data(QLatin1String("ForcedInstallation")).toString()); update.setAttribute(QLatin1String("checkable"), package->data(scCheckable).toString()); update.setAttribute(QLatin1String("default"), package->data(scDefault).toString()); update.setAttribute(QLatin1String("essential"), package->data(scEssential).toString()); update.setAttribute(QLatin1String("forcedUpdate"), package->data(scForcedUpdate).toString()); update.setAttribute(QLatin1String("compressedsize"), package->data(QLatin1String("CompressedSize")).toString()); update.setAttribute(QLatin1String("uncompressedsize"), package->data(QLatin1String("UncompressedSize")).toString()); update.setAttribute(QLatin1String("releaseDate"), package->data(scReleaseDate).toString()); update.setAttribute(QLatin1String("downloadableArchives"), package->data(scDownloadableArchives).toString()); update.setAttribute(QLatin1String("licenses"), package->data(QLatin1String("Licenses")).toString()); update.setAttribute(QLatin1String("script"), package->data(scScript).toString()); update.setAttribute(QLatin1String("sortingPriority"), package->data(scSortingPriority).toString()); update.setAttribute(QLatin1String("replaces"), package->data(scReplaces).toString()); update.setAttribute(QLatin1String("requiresAdminRights"), package->data(scRequiresAdminRights).toString()); } root.appendChild(update); } qCDebug(lcPackageInfo) << qPrintable(doc.toString(4)); } /*! \internal */ VerboseWriter::VerboseWriter() { m_preFileBuffer.open(QIODevice::ReadWrite); m_stream.setDevice(&m_preFileBuffer); m_currentDateTimeAsString = QDateTime::currentDateTime().toString(); } /*! \internal */ VerboseWriter::~VerboseWriter() { if (m_preFileBuffer.isOpen()) { PlainVerboseWriterOutput output; (void)flush(&output); } } /*! \internal */ bool VerboseWriter::flush(VerboseWriterOutput *output) { m_stream.flush(); if (m_logFileName.isEmpty()) // binarycreator return true; if (!m_preFileBuffer.isOpen()) return true; //if the installer installed nothing - there is no target directory - where the logfile can be saved if (!QFileInfo(m_logFileName).absoluteDir().exists()) return true; QString logInfo; logInfo += QLatin1String("************************************* Invoked: "); logInfo += m_currentDateTimeAsString; logInfo += QLatin1String("\n"); QBuffer buffer; buffer.open(QIODevice::WriteOnly); buffer.write(logInfo.toLocal8Bit()); buffer.write(m_preFileBuffer.data()); buffer.close(); if (output->write(m_logFileName, QIODevice::ReadWrite | QIODevice::Append | QIODevice::Text, buffer.data())) { m_preFileBuffer.close(); m_stream.setDevice(nullptr); return true; } return false; } /*! \internal */ void VerboseWriter::setFileName(const QString &fileName) { m_logFileName = fileName; } Q_GLOBAL_STATIC(VerboseWriter, verboseWriter) /*! \internal */ VerboseWriter *VerboseWriter::instance() { return verboseWriter(); } /*! \internal */ void VerboseWriter::appendLine(const QString &msg) { m_stream << msg << endl; } /*! \internal */ VerboseWriterOutput::~VerboseWriterOutput() { } /*! \internal */ bool PlainVerboseWriterOutput::write(const QString &fileName, QIODevice::OpenMode openMode, const QByteArray &data) { QFile output(fileName); if (output.open(openMode)) { output.write(data); setDefaultFilePermissions(&output, DefaultFilePermissions::NonExecutable); return true; } return false; } /*! \internal */ bool VerboseWriterAdminOutput::write(const QString &fileName, QIODevice::OpenMode openMode, const QByteArray &data) { bool gainedAdminRights = false; if (!RemoteClient::instance().isActive()) { m_core->gainAdminRights(); gainedAdminRights = true; } RemoteFileEngine file; file.setFileName(fileName); if (file.open(openMode)) { file.write(data.constData(), data.size()); file.close(); if (gainedAdminRights) m_core->dropAdminRights(); return true; } if (gainedAdminRights) m_core->dropAdminRights(); return false; } /*! \internal Increments verbosity \a level. */ LoggingHandler::VerbosityLevel &operator++(LoggingHandler::VerbosityLevel &level, int) { const int i = static_cast(level) + 1; level = (i > LoggingHandler::VerbosityLevel::Maximum) ? LoggingHandler::VerbosityLevel::Maximum : static_cast(i); return level; } /*! \internal Decrements verbosity \a level. */ LoggingHandler::VerbosityLevel &operator--(LoggingHandler::VerbosityLevel &level, int) { const int i = static_cast(level) - 1; level = (i < LoggingHandler::VerbosityLevel::Minimum) ? LoggingHandler::VerbosityLevel::Minimum : static_cast(i); return level; } } // namespace QInstaller