/* SETTINGS MODULE Copyright (C) 2016-2019 by Xose PĂ©rez */ #pragma once #include "espurna.h" #include #include #include #include #include #include "broker.h" BrokerDeclare(ConfigBroker, void(const String& key, const String& value)); // -------------------------------------------------------------------------- class settings_key_t { public: settings_key_t(const char* value, unsigned char index) : value(value), index(index) {} settings_key_t(const String& value, unsigned char index) : value(value), index(index) {} settings_key_t(const char* value) : value(value), index(-1) {} settings_key_t(const String& value) : value(value), index(-1) {} settings_key_t(const __FlashStringHelper* value) : value(value), index(-1) {} settings_key_t() : value(), index(-1) {} bool match(const char* _value) const { return (value == _value) || (toString() == _value); } bool match(const String& _value) const { return (value == _value) || (toString() == _value); } String toString() const; explicit operator String () const { return toString(); } private: const String value; int index; }; using settings_move_key_t = std::pair; using settings_filter_t = std::function; // -------------------------------------------------------------------------- struct settings_cfg_t { String& setting; const char* key; const char* default_value; }; using settings_cfg_list_t = std::initializer_list; // -------------------------------------------------------------------------- namespace settings { namespace internal { uint32_t u32fromString(const String& string, int base); template using convert_t = T(*)(const String& value); template T convert(const String& value); // -------------------------------------------------------------------------- template <> float convert(const String& value); template <> double convert(const String& value); template <> int convert(const String& value); template <> long convert(const String& value); template <> bool convert(const String& value); template <> unsigned long convert(const String& value); template <> unsigned int convert(const String& value); template <> unsigned short convert(const String& value); template <> unsigned char convert(const String& value); template String serialize(const T& value); template String serialize(const T& value) { return String(value); } } // namespace settings::internal } // namespace settings // -------------------------------------------------------------------------- struct settings_key_match_t { using match_f = bool(*)(const char* key); using key_f = const String(*)(const String& key); match_f match; key_f key; }; void settingsRegisterDefaults(const settings_key_match_t& matcher); String settingsQueryDefaults(const String& key); // -------------------------------------------------------------------------- void moveSetting(const String& from, const String& to); void moveSetting(const String& from, const String& to, unsigned int index); void moveSettings(const String& from, const String& to); template Rfunc = settings::internal::convert> R getSetting(const settings_key_t& key, R defaultValue) __attribute__((noinline)); template Rfunc = settings::internal::convert> R getSetting(const settings_key_t& key, R defaultValue) { String value; if (!Embedis::get(key.toString(), value)) { return defaultValue; } return Rfunc(value); } template<> String getSetting(const settings_key_t& key, String defaultValue); String getSetting(const settings_key_t& key); String getSetting(const settings_key_t& key, const char* defaultValue); String getSetting(const settings_key_t& key, const __FlashStringHelper* defaultValue); template bool setSetting(const settings_key_t& key, const T& value) { return Embedis::set(key.toString(), String(value)); } template<> bool setSetting(const settings_key_t& key, const String& value); bool delSetting(const settings_key_t& key); bool hasSetting(const settings_key_t& key); void saveSettings(); void resetSettings(); void settingsGetJson(JsonObject& data); bool settingsRestoreJson(char* json_string, size_t json_buffer_size = 1024); bool settingsRestoreJson(JsonObject& data); size_t settingsKeyCount(); String settingsKeyName(unsigned int index); std::vector settingsKeys(); void settingsProcessConfig(const settings_cfg_list_t& config, settings_filter_t filter = nullptr); unsigned long settingsSize(); void migrate(); void settingsSetup(); // ----------------------------------------------------------------------------- // Deprecated implementation // ----------------------------------------------------------------------------- template String getSetting(const String& key, unsigned char index, T defaultValue) __attribute__((deprecated("getSetting({key, index}, default) should be used instead"))); template bool setSetting(const String& key, unsigned char index, T value) __attribute__((deprecated("setSetting({key, index}, value) should be used instead"))); template bool hasSetting(const String& key, unsigned char index) __attribute__((deprecated("hasSetting({key, index}) should be used instead"))); template bool delSetting(const String& key, unsigned char index) __attribute__((deprecated("delSetting({key, index}) should be used instead"))); // -------------------------------------------------------------------------- template String getSetting(const String& key, unsigned char index, T defaultValue) { return getSetting({key, index}, defaultValue); } template bool setSetting(const String& key, unsigned char index, T value) { return setSetting({key, index}, value); } template bool hasSetting(const String& key, unsigned char index) { return hasSetting({key, index}); } template bool delSetting(const String& key, unsigned char index) { return delSetting({key, index}); }