Localization.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <filesystem>
#include <string>
#include <string_view>
#include <unordered_map>

 
namespace hmi {

class Localization {
public:
    explicit Localization(std::filesystem::path directory = {});

    [[nodiscard]] static std::unordered_map<std::string, std::string> parseCatalog(
        std::string_view content);

    void setDefaultCatalog(std::string language,
                           std::unordered_map<std::string, std::string> strings);

    void setActiveCatalog(std::string language,
                          std::unordered_map<std::string, std::string> strings);

    [[nodiscard]] bool loadDefaultLanguage(const std::string& language);

    [[nodiscard]] bool loadLanguage(const std::string& language);

    [[nodiscard]] std::string text(std::string_view key) const;

    [[nodiscard]] const std::string& activeLanguage() const noexcept {
        return _activeLanguage;
    }
 
private:
    [[nodiscard]] static bool readFile(const std::filesystem::path& path, std::string& out);
 
    std::filesystem::path _directory;
    std::string _defaultLanguage;
    std::string _activeLanguage;
    std::unordered_map<std::string, std::string> _defaultStrings;
    std::unordered_map<std::string, std::string> _activeStrings;
};
 
}  // namespace hmi