#ifndef option_manager_hh_INCLUDED #define option_manager_hh_INCLUDED #include "completion.hh" #include "containers.hh" #include "exception.hh" #include "flags.hh" #include "option_types.hh" #include "vector.hh" #include #include namespace Kakoune { class OptionManager; enum class OptionFlags { None = 0, Hidden = 1, }; template<> struct WithBitOps : std::true_type {}; class OptionDesc { public: OptionDesc(String name, String docstring, OptionFlags flags); const String& name() const { return m_name; } const String& docstring() const { return m_docstring; } OptionFlags flags() const { return m_flags; } private: String m_name; String m_docstring; OptionFlags m_flags; }; class Option : public UseMemoryDomain { public: virtual ~Option() = default; template const T& get() const; template T& get_mutable(); template void set(const T& val, bool notify=true); template bool is_of_type() const; virtual String get_as_string() const = 0; virtual void set_from_string(StringView str) = 0; virtual void add_from_string(StringView str) = 0; virtual Option* clone(OptionManager& manager) const = 0; OptionManager& manager() const { return m_manager; } const String& name() const { return m_desc.name(); } const String& docstring() const { return m_desc.docstring(); } OptionFlags flags() const { return m_desc.flags(); } protected: Option(const OptionDesc& desc, OptionManager& manager); OptionManager& m_manager; const OptionDesc& m_desc; }; class OptionManagerWatcher { public: virtual ~OptionManagerWatcher() = default; virtual void on_option_changed(const Option& option) = 0; }; class OptionManager : private OptionManagerWatcher { public: OptionManager(OptionManager& parent); ~OptionManager() override; Option& operator[] (StringView name); const Option& operator[] (StringView name) const; Option& get_local_option(StringView name); void unset_option(StringView name); using OptionList = Vector; OptionList flatten_options() const; void register_watcher(OptionManagerWatcher& watcher) const; void unregister_watcher(OptionManagerWatcher& watcher) const; void on_option_changed(const Option& option) override; private: OptionManager() : m_parent(nullptr) {} // the only one allowed to construct a root option manager friend class Scope; friend class OptionsRegistry; Vector, MemoryDomain::Options> m_options; OptionManager* m_parent; mutable Vector m_watchers; }; template class TypedOption : public Option { public: TypedOption(OptionManager& manager, const OptionDesc& desc, const T& value) : Option(desc, manager), m_value(value) {} void set(T value, bool notify = true) { validate(value); if (m_value != value) { m_value = std::move(value); if (notify) manager().on_option_changed(*this); } } const T& get() const { return m_value; } T& get_mutable() { return m_value; } String get_as_string() const override { return option_to_string(m_value); } void set_from_string(StringView str) override { T val; option_from_string(str, val); set(std::move(val)); } void add_from_string(StringView str) override { if (option_add(m_value, str)) m_manager.on_option_changed(*this); } private: virtual void validate(const T& value) const {} T m_value; }; template class TypedCheckedOption : public TypedOption { using TypedOption::TypedOption; Option* clone(OptionManager& manager) const override { return new TypedCheckedOption{manager, this->m_desc, this->get()}; } void validate(const T& value) const override { if (validator != nullptr) validator(value); } }; template const T& Option::get() const { auto* typed_opt = dynamic_cast*>(this); if (not typed_opt) throw runtime_error(format("option '{}' is not of type '{}'", name(), typeid(T).name())); return typed_opt->get(); } template T& Option::get_mutable() { return const_cast(get()); } template void Option::set(const T& val, bool notify) { auto* typed_opt = dynamic_cast*>(this); if (not typed_opt) throw runtime_error(format("option '{}' is not of type '{}'", name(), typeid(T).name())); return typed_opt->set(val, notify); } template bool Option::is_of_type() const { return dynamic_cast*>(this) != nullptr; } template auto find_option(T& container, StringView name) -> decltype(container.begin()) { using ptr_type = decltype(*container.begin()); return find_if(container, [&name](const ptr_type& opt) { return opt->name() == name; }); } class OptionsRegistry { public: OptionsRegistry(OptionManager& global_manager) : m_global_manager(global_manager) {} template Option& declare_option(StringView name, StringView docstring, const T& value, OptionFlags flags = OptionFlags::None) { auto is_not_identifier = [](char c) { return (c < 'a' or c > 'z') and (c < 'A' or c > 'Z') and (c < '0' or c > '9') and c != '_'; }; if (contains_that(name, is_not_identifier)) throw runtime_error{format("name '{}' contains char out of [a-zA-Z0-9_]", name)}; auto& opts = m_global_manager.m_options; auto it = find_option(opts, name); if (it != opts.end()) { if ((*it)->is_of_type() and (*it)->flags() == flags) return **it; throw runtime_error{format("option '{}' already declared with different type or flags", name)}; } String doc = docstring.empty() ? format("[{}]", option_type_name::name()) : format("[{}] - {}", option_type_name::name(), docstring); m_descs.emplace_back(new OptionDesc{name.str(), std::move(doc), flags}); opts.emplace_back(new TypedCheckedOption{m_global_manager, *m_descs.back(), value}); return *opts.back(); } const OptionDesc* option_desc(StringView name) const { auto it = find_if(m_descs, [&name](const std::unique_ptr& opt) { return opt->name() == name; }); return it != m_descs.end() ? it->get() : nullptr; } bool option_exists(StringView name) const { return option_desc(name) != nullptr; } CandidateList complete_option_name(StringView prefix, ByteCount cursor_pos) const; private: OptionManager& m_global_manager; Vector, MemoryDomain::Options> m_descs; }; } #endif // option_manager_hh_INCLUDED