info.cpp

Go to the documentation of this file.

/*
    Copyright (C) 2012 - 2025
    by Iris Morelle <shadowm2006@gmail.com>
    Part of the Battle for Wesnoth Project https://www.wesnoth.org/
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY.
 
    See the COPYING file for more details.
*/
 
#include "addon/info.hpp"
 
#include "config.hpp"
#include "font/pango/escape.hpp"
#include "gettext.hpp"
#include "picture.hpp"
#include "log.hpp"
#include "serialization/chrono.hpp"
#include "serialization/string_utils.hpp"
 
static lg::log_domain log_addons_client("addons-client");
#define ERR_AC LOG_STREAM(err ,  log_addons_client)
#define LOG_AC LOG_STREAM(info,  log_addons_client)
 
namespace {
    void resolve_deps_recursive(const addons_list& addons, const std::string& base_id, std::set<std::string>& dest)
    {
        addons_list::const_iterator it = addons.find(base_id);
        if(it == addons.end()) {
            LOG_AC << "resolve_deps_recursive(): " << base_id << " not in add-ons list";
            return;
        }
 
        const std::vector<std::string>& base_deps = it->second.depends;
 
        if(base_deps.empty()) {
            return;
        }
 
        for(const std::string& dep : base_deps) {
            if(base_id == dep) {
                LOG_AC << dep << " depends upon itself; breaking circular dependency";
                continue;
            } else if(dest.find(dep) != dest.end()) {
                LOG_AC << dep << " already in dependency tree; breaking circular dependency";
                continue;
            }
 
            dest.insert(dep);
 
            resolve_deps_recursive(addons, dep, dest);
        }
    }
}
 
void addon_info_translation::read(const config& cfg)
{
    supported = cfg["supported"].to_bool(true);
    title = cfg["title"].str();
    description = cfg["description"].str();
}
 
void addon_info_translation::write(config& cfg) const
{
    cfg["supported"] = supported;
    cfg["title"] = title;
    cfg["description"] = description;
}
 
void addon_info::read(const config& cfg)
{
    id = cfg["name"].str();
    title = cfg["title"].str();
    description = cfg["description"].str();
    icon = cfg["icon"].str();
    current_version = cfg["version"].str();
    versions.emplace(cfg["version"].str());
    author = cfg["author"].str();
    size = cfg["size"].to_int();
    downloads = cfg["downloads"].to_int();
    uploads = cfg["uploads"].to_int();
    type = get_addon_type(cfg["type"].str());
 
    for(const config& version : cfg.child_range("version")) {
        versions.emplace(version["version"].str());
    }
 
    const config::const_child_itors& locales_as_configs = cfg.child_range("translation");
 
    for(const config& locale : locales_as_configs) {
        if(locale["supported"].to_bool(true))
            locales.emplace_back(locale["language"].str());
        info_translations.emplace(locale["language"].str(), addon_info_translation(locale));
    }
 
    core = cfg["core"].str();
    depends = utils::split(cfg["dependencies"].str());
    tags = utils::split(cfg["tags"].str());
    feedback_url = cfg["feedback_url"].str();
 
    updated = chrono::parse_timestamp(cfg["timestamp"]);
    created = chrono::parse_timestamp(cfg["original_timestamp"]);
 
    local_only = cfg["local_only"].to_bool();
}
 
void addon_info::write(config& cfg) const
{
    cfg["id"] = id;
    cfg["title"] = title;
    cfg["description"] = description;
    cfg["icon"] = icon;
    cfg["version"] = current_version.str();
    cfg["author"] = author;
    cfg["size"] = size;
    cfg["downloads"] = downloads;
    cfg["uploads"] = uploads;
    cfg["type"] = get_addon_type_string(type);
 
    for(const version_info& version : versions) {
        config& version_cfg = cfg.add_child("version");
        version_cfg["version"] = version.str();
    }
 
    for(const auto& element : info_translations) {
        config& locale = cfg.add_child("translation");
        locale["language"] = element.first;
        element.second.write(locale);
    }
 
    cfg["core"] = core;
    cfg["dependencies"] = utils::join(depends);
    cfg["tags"] = utils::join(tags);
    cfg["feedback_url"] = feedback_url;
 
    cfg["timestamp"] = chrono::serialize_timestamp(updated);
    cfg["original_timestamp"] = chrono::serialize_timestamp(created);
}
 
void addon_info::write_minimal(config& cfg) const
{
    cfg["version"] = current_version.str();
    cfg["uploads"] = uploads;
    cfg["type"] = get_addon_type_string(type);
    cfg["title"] = title;
    cfg["dependencies"] = utils::join(depends);
    cfg["core"] = core;
}
 
std::string addon_info::display_title() const
{
    return title.empty() ? make_addon_title(id) : title;
}
 
addon_info_translation addon_info_translation::invalid = {false, "", ""};
 
addon_info_translation addon_info::translated_info() const
{
    const boost::locale::info& locale_info = translation::get_effective_locale_info();
 
    std::string lang_name_short = locale_info.language();
    std::string lang_name_long = lang_name_short;
    if(!locale_info.country().empty()) {
        lang_name_long += '_';
        lang_name_long += locale_info.country();
    }
    if(!locale_info.variant().empty()) {
        lang_name_long += '@';
        lang_name_long += locale_info.variant();
        lang_name_short += '@';
        lang_name_short += locale_info.variant();
    }
 
    auto info = info_translations.find(lang_name_long);
    if(info != info_translations.end()) {
        return info->second;
    }
 
    info = info_translations.find(lang_name_short);
    if(info != info_translations.end()) {
        return info->second;
    }
 
    return addon_info_translation::invalid;
}
 
std::string addon_info::display_title_translated() const
{
    addon_info_translation info = translated_info();
    return info.valid() ? info.title : "";
}
 
std::string addon_info::display_title_translated_or_original() const
{
    std::string title = display_title_translated();
    return title.empty() ? display_title() : title;
}
 
std::string addon_info::description_translated() const
{
    addon_info_translation info = translated_info();
    return (info.valid() && !info.description.empty()) ? info.description : description;
}
 
std::string addon_info::display_title_full() const
{
    std::string local_title = display_title_translated();
    return local_title.empty() ? display_title() : local_title + " (" + display_title() + ")";
}
 
std::string addon_info::display_icon() const
{
    std::string ret = icon;
 
    if(!image::exists(image::locator{ret}) && !ret.empty()) {
        ERR_AC << "add-on '" << id << "' has an icon which cannot be found: '" << ret << "'";
        ret = "";
    } else if(ret.find("units/") != std::string::npos && ret.find_first_of('~') == std::string::npos) {
        // HACK: prevent magenta icons, because they look awful
        LOG_AC << "add-on '" << id << "' uses a unit baseframe as icon without TC/RC specifications";
        ret += "~RC(magenta>red)";
    }
 
    return ret;
}
 
std::string addon_info::display_type() const
{
    switch (type) {
    case ADDON_SP_CAMPAIGN:
        return _("addon_type^Campaign");
    case ADDON_SP_SCENARIO:
        return _("addon_type^Scenario");
    case ADDON_SP_MP_CAMPAIGN:
        return _("addon_type^SP/MP Campaign");
    case ADDON_MP_ERA:
        return _("addon_type^MP era");
    case ADDON_MP_FACTION:
        return _("addon_type^MP faction");
    case ADDON_MP_MAPS:
        return _("addon_type^MP map-pack");
    case ADDON_MP_SCENARIO:
        return _("addon_type^MP scenario");
    case ADDON_MP_CAMPAIGN:
        return _("addon_type^MP campaign");
    case ADDON_MOD:
        return _("addon_type^Modification");
    case ADDON_CORE:
        return _("addon_type^Core");
    case ADDON_MEDIA:
        return _("addon_type^Resources");
    case ADDON_OTHER:
        return _("addon_type^Other");
    default:
        return _("addon_type^(unknown)");
    }
}
 
std::set<std::string> addon_info::resolve_dependencies(const addons_list& addons) const
{
    std::set<std::string> deps;
    resolve_deps_recursive(addons, id, deps);
 
    if(deps.find(id) != deps.end()) {
        LOG_AC << id << " depends upon itself; breaking circular dependency";
        deps.erase(id);
    }
 
    return deps;
}
 
void read_addons_list(const config& cfg, addons_list& dest)
{
    dest.clear();
 
    /** @todo FIXME: get rid of this legacy "campaign"/"campaigns" silliness
     */
    const config::const_child_itors &addon_cfgs = cfg.child_range("campaign");
    for(const config& addon_cfg : addon_cfgs) {
        const std::string& id = addon_cfg["name"].str();
        if(dest.find(id) != dest.end()) {
            ERR_AC << "add-ons list has multiple entries for '" << id << "', not good; ignoring them";
            continue;
        }
        dest[id].read(addon_cfg);
    }
}
 
std::string size_display_string(double size)
{
    return size > 0.0 ? utils::si_string(size, true, _("unit_byte^B")) : "";
}
 
std::string make_addon_title(const std::string& id)
{
    std::string ret(id);
    std::replace(ret.begin(), ret.end(), '_', ' ');
    return ret;
}