properties_file.hpp

Go to the documentation of this file.

#pragma once
 
// PropertiesFile — JSON-backed persistent key-value settings.
// ApplicationProperties — user + common properties with platform-standard paths.
 
#include <string>
#include <string_view>
#include <optional>
#include <vector>
#include <map>
#include <cstdint>
 
namespace pulp::state {

class PropertiesFile {
public:
    PropertiesFile() = default;

    bool load(std::string_view path);

    bool save(std::string_view path);

    bool save() const;

    std::optional<std::string> get_string(std::string_view key) const;
    void set_string(std::string_view key, std::string_view value);

    std::optional<int64_t> get_int(std::string_view key) const;
    void set_int(std::string_view key, int64_t value);

    std::optional<double> get_double(std::string_view key) const;
    void set_double(std::string_view key, double value);

    std::optional<bool> get_bool(std::string_view key) const;
    void set_bool(std::string_view key, bool value);

    void remove(std::string_view key);

    bool contains(std::string_view key) const;

    void clear();

    int size() const { return static_cast<int>(values_.size()); }

    std::vector<std::string> keys() const;

    const std::string& path() const { return path_; }
    void set_path(std::string_view p) { path_ = std::string(p); }
 
private:
    bool save_to(const std::string& dest) const;
    std::map<std::string, std::string, std::less<>> values_;
    std::string path_;
};

class ApplicationProperties {
public:
    explicit ApplicationProperties(std::string_view app_name);

    PropertiesFile& user_settings() { return user_; }
    const PropertiesFile& user_settings() const { return user_; }

    PropertiesFile& common_settings() { return common_; }
    const PropertiesFile& common_settings() const { return common_; }

    void load();

    void save();

    const std::string& app_name() const { return app_name_; }

    static std::string user_settings_dir(std::string_view app_name);

    static std::string common_settings_dir(std::string_view app_name);
 
private:
    std::string app_name_;
    PropertiesFile user_;
    PropertiesFile common_;
};
 
}  // namespace pulp::state