File indexing completed on 2024-09-15 04:49:03

 /*
  *   SPDX-FileCopyrightText: 2017 Aleix Pol Gonzalez <aleixpol@kde.org>
  *
  *   SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL
  */
 
 #include "AppStreamUtils.h"
 
 #include "utils.h"
 #include <AppStreamQt/pool.h>
 #include <AppStreamQt/release.h>
 #include <AppStreamQt/screenshot.h>
 #include <AppStreamQt/spdx.h>
 #include <AppStreamQt/version.h>
 #include <Category/Category.h>
 #include <KLocalizedString>
 #include <QDebug>
 #include <QJsonArray>
 #include <QJsonObject>
 #include <QUrlQuery>
 
 using namespace AppStreamUtils;
 
 QUrl AppStreamUtils::imageOfKind(const QList<AppStream::Image> &images, AppStream::Image::Kind kind)
 {
     QUrl ret;
     for (const AppStream::Image &i : images) {
         if (i.kind() == kind) {
             ret = i.url();
             break;
         }
     }
     return ret;
 }
 
 QString AppStreamUtils::changelogToHtml(const AppStream::Component &appdata)
 {
 #if ASQ_CHECK_VERSION(1, 0, 0)
     const auto releases = appdata.releasesPlain();
 #else
     const auto releases = appdata.releases();
 #endif
     if (releases.isEmpty()) {
         return {};
     }
 
 #if ASQ_CHECK_VERSION(1, 0, 0)
     const auto release = releases.indexSafe(0).value();
 #else
     const auto release = releases.constFirst();
 #endif
     if (release.description().isEmpty())
         return {};
 
     QString changelog =
         QLatin1String("<h3>") + release.version() + QLatin1String("</h3>") + QStringLiteral("<p>") + release.description() + QStringLiteral("</p>");
     return changelog;
 }
 
 Screenshots AppStreamUtils::fetchScreenshots(const AppStream::Component &appdata)
 {
     const auto appdataScreenshots = appdata.screenshotsAll();
     Screenshots ret;
     ret.reserve(appdataScreenshots.size());
     for (const AppStream::Screenshot &s : appdataScreenshots) {
         const auto images = s.images();
         const QUrl thumbnail = AppStreamUtils::imageOfKind(images, AppStream::Image::KindThumbnail);
         const QUrl full = AppStreamUtils::imageOfKind(images, AppStream::Image::KindSource);
         if (full.isEmpty()) {
             qWarning() << "AppStreamUtils: Invalid screenshot for" << appdata.name();
         }
         const bool isAnimated = s.mediaKind() == AppStream::Screenshot::MediaKindVideo;
 
         ret.append(Screenshot{thumbnail.isEmpty() ? full : thumbnail, full, isAnimated});
     }
     return ret;
 }
 
 QJsonArray AppStreamUtils::licenses(const AppStream::Component &appdata)
 {
     return licenses(appdata.projectLicense());
 }
 
 QJsonArray AppStreamUtils::licenses(const QString &spdx)
 {
     static const QSet<QChar> tokens = {QLatin1Char('&'), QLatin1Char('+'), QLatin1Char('|'), QLatin1Char('^'), QLatin1Char('('), QLatin1Char(')')};
 
     QJsonArray ret;
     const auto licenses = AppStream::SPDX::tokenizeLicense(spdx);
     for (const auto &token : licenses) {
         if (token.size() == 1 && tokens.contains(token.at(0)))
             continue;
         ret += license(token.mid(1)); // tokenize prefixes with an @ for some reason
     }
     return ret;
 }
 
 QJsonObject AppStreamUtils::license(const QString &license)
 {
     bool publicLicense = false;
     QString name = license;
     if (license.startsWith(QLatin1String("LicenseRef-proprietary"))) {
         name = i18n("Proprietary");
     } else if (license == QLatin1String("LicenseRef-public-domain")) {
         name = i18n("Public Domain");
         publicLicense = true;
     }
 
     if (license.isEmpty()) {
         return {
             {QStringLiteral("name"), i18n("Unknown")},
             {QStringLiteral("hasFreedom"), true}, // give it the benefit of the doubt
         };
     }
     if (!AppStream::SPDX::isLicenseId(license))
         return {
             {QStringLiteral("name"), name},
             {QStringLiteral("hasFreedom"), true}, // give it the benefit of the doubt
         };
     return {
         {QStringLiteral("name"), name},
         {QStringLiteral("url"), {AppStream::SPDX::licenseUrl(license)}},
         {QStringLiteral("hasFreedom"), AppStream::SPDX::isFreeLicense(license) || publicLicense},
     };
 }
 
 QStringList AppStreamUtils::appstreamIds(const QUrl &appstreamUrl)
 {
     QStringList ret;
     ret += appstreamUrl.host().isEmpty() ? appstreamUrl.path() : appstreamUrl.host();
     if (appstreamUrl.hasQuery()) {
         QUrlQuery query(appstreamUrl);
         ret << query.queryItemValue(QStringLiteral("alt")).split(QLatin1Char(','), Qt::SkipEmptyParts);
     }
     if (ret.removeDuplicates() != 0) {
         qDebug() << "AppStreamUtils: Received malformed url" << appstreamUrl;
     }
     return ret;
 }
 
 QString AppStreamUtils::versionString(const QString &version, const AppStream::Component &appdata)
 {
     Q_UNUSED(appdata);
 
     if (version.isEmpty()) {
         return {};
     }
 
     return version;
 }
 
 QString AppStreamUtils::contentRatingDescription(const AppStream::Component &appdata)
 {
 #if ASQ_CHECK_VERSION(0, 15, 6)
     const auto ratings = appdata.contentRatings();
     QString ret;
     for (const auto &r : ratings) {
         const auto ratingIds = r.ratingIds();
         for (const auto &id : ratingIds) {
             if (r.value(id) != AppStream::ContentRating::RatingValueNone) {
                 ret += QLatin1String("* ") + r.description(id) + QLatin1Char('\n');
             }
         }
     }
 
     return ret;
 #else
     Q_UNUSED(appdata);
     return {};
 #endif
 }
 
 QString AppStreamUtils::contentRatingText(const AppStream::Component &appdata)
 {
 #if ASQ_CHECK_VERSION(0, 15, 6)
     const auto ratings = appdata.contentRatings();
     AppStream::ContentRating::RatingValue intensity = AppStream::ContentRating::RatingValueUnknown;
     for (const auto &r : ratings) {
         const auto ratingIds = r.ratingIds();
         for (const auto &id : ratingIds) {
             intensity = std::max(r.value(id), intensity);
         }
     }
 
     static QStringList texts = {
         {},
         i18nc("Open Age Ratings Service (https://hughsie.github.io/oars) description of content suitable for everyone", "All Audiences"),
         i18nc("Open Age Ratings Service (https://hughsie.github.io/oars) description of content with relatively benign themes only unsuitable for very young "
               "children, such as minor cartoon violence or mild profanity",
               "Mild Content"),
         i18nc("Open Age Ratings Service (https://hughsie.github.io/oars) description of content with some intense themes, such as somewhat realistic "
               "violence, references to sexuality, or adult profanity",
               "Moderate Content"),
         i18nc("Open Age Ratings Service (https://hughsie.github.io/oars) description of mature content that could be quite objectionable or unsuitable for "
               "young audiences, such as realistic graphic violence, extreme profanity or nudity, or glorification of drug use",
               "Intense Content"),
     };
     return texts[intensity];
 #else
     Q_UNUSED(appdata);
     return {};
 #endif
 }
 
 AbstractResource::ContentIntensity AppStreamUtils::contentRatingIntensity(const AppStream::Component &appdata)
 {
 #if ASQ_CHECK_VERSION(0, 15, 6)
     const auto ratings = appdata.contentRatings();
     AppStream::ContentRating::RatingValue intensity = AppStream::ContentRating::RatingValueUnknown;
     for (const auto &r : ratings) {
         const auto ratingIds = r.ratingIds();
         for (const auto &id : ratingIds) {
             intensity = std::max(r.value(id), intensity);
         }
     }
 
     static QVector<AbstractResource::ContentIntensity> intensities = {
         AbstractResource::Mild,
         AbstractResource::Mild,
         AbstractResource::Mild,
         AbstractResource::Intense,
         AbstractResource::Intense,
     };
     return intensities[intensity];
 #else
     Q_UNUSED(appdata);
     return {};
 #endif
 }
 
 uint AppStreamUtils::contentRatingMinimumAge(const AppStream::Component &appdata)
 {
 #if ASQ_CHECK_VERSION(0, 15, 6)
     const auto ratings = appdata.contentRatings();
     uint minimumAge = 0;
     for (const auto &r : ratings) {
         minimumAge = std::max(r.minimumAge(), minimumAge);
     }
     return minimumAge;
 #else
     Q_UNUSED(appdata);
     return 0;
 #endif
 }
 
 static void kRemoveDuplicates(AppStream::ComponentBox &input, AppStream::Bundle::Kind kind)
 {
     QSet<QString> ret;
     for (auto it = input.begin(); it != input.end();) {
         const auto key = kind == AppStream::Bundle::KindUnknown ? it->id() : it->bundle(kind).id();
         if (!ret.contains(key)) {
             ret << key;
             ++it;
         } else {
             it = input.erase(it);
         }
     }
 }
 
 AppStream::ComponentBox AppStreamUtils::componentsByCategories(AppStream::Pool *pool, Category *cat, AppStream::Bundle::Kind kind)
 {
     AppStream::ComponentBox ret(AppStream::ComponentBox::FlagNoChecks);
     for (const auto &categoryName : cat->involvedCategories()) {
         ret += pool->componentsByCategories({categoryName});
     }
     kRemoveDuplicates(ret, kind);
     return ret;
 }