/*
*
* Conky, a system monitor, based on torsmo
*
* Please see COPYING for details
*
* Copyright (C) 2010 Pavel Labath et al.
*
* 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 3 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; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*
*/
#ifndef SETTING_HH
#define SETTING_HH
#include
#include
#include
#include "logging.h"
#include "luamm.hh"
namespace conky {
/*
* Checks settings, and does initial calls to the setters.
* Should be called after reading the user config.
* stack on entry: | ... |
* stack on exit: | ... |
*/
void set_config_settings(lua::state &l);
/*
* Calls cleanup functions.
* Should be called before exit/restart.
* stack on entry: | ... |
* stack on exit: | ... |
*/
void cleanup_config_settings(lua::state &l);
template ::value,
bool floating_point = std::is_floating_point::value,
bool is_enum = std::is_enum::value>
struct lua_traits {
// integral is here to force the compiler to evaluate the assert at
// instantiation time
static_assert(is_integral && false,
"Only specializations for enum, string, integral and floating "
"point types are available");
};
// specialization for integral types
template
struct lua_traits {
static const lua::Type type = lua::TNUMBER;
typedef lua::integer Type;
static inline std::pair convert(lua::state &l, int index,
const std::string &) {
return {l.tointeger(index), true};
}
};
// specialization for floating point types
template
struct lua_traits {
static const lua::Type type = lua::TNUMBER;
typedef lua::number Type;
static inline std::pair convert(lua::state &l, int index,
const std::string &) {
return {l.tonumber(index), true};
}
};
// specialization for std::string
template <>
struct lua_traits {
static const lua::Type type = lua::TSTRING;
typedef std::string Type;
static inline std::pair convert(lua::state &l, int index,
const std::string &) {
return {l.tostring(index), true};
}
};
// specialization for bool
template <>
struct lua_traits {
static const lua::Type type = lua::TBOOLEAN;
typedef bool Type;
static inline std::pair convert(lua::state &l, int index,
const std::string &) {
return {l.toboolean(index), true};
}
};
// specialization for enums
// to use this, one first has to declare string<->value map
template
struct lua_traits {
static const lua::Type type = lua::TSTRING;
typedef T Type;
typedef std::initializer_list> Map;
static Map map;
static std::pair convert(lua::state &l, int index,
const std::string &name) {
std::string val = l.tostring(index);
for (auto i = map.begin(); i != map.end(); ++i) {
if (i->first == val) return {i->second, true};
}
std::string msg = "Invalid value '" + val + "' for setting '" + name +
"'. Valid values are: ";
for (auto i = map.begin(); i != map.end(); ++i) {
if (i != map.begin()) msg += ", ";
msg += "'" + i->first + "'";
}
msg += ".";
NORM_ERR("%s", msg.c_str());
return {T(), false};
}
};
namespace priv {
class config_setting_base {
private:
static void process_setting(lua::state &l, bool init);
static int config__newindex(lua::state *l);
static void make_conky_config(lua::state &l);
// copying is a REALLY bad idea
config_setting_base(const config_setting_base &) = delete;
config_setting_base &operator=(const config_setting_base &) = delete;
protected:
/*
* Set the setting, if the value is sane
* stack on entry: | ... potential_new_value old_value |
* stack on exit: | ... real_new_value |
* real_new_value can be the old value if the new value doesn't make sense
*/
virtual void lua_setter(lua::state &l, bool init) = 0;
/*
* Called on exit/restart.
* stack on entry: | ... new_value |
* stack on exit: | ... |
*/
virtual void cleanup(lua::state &l) { l.pop(); }
public:
const std::string name;
const size_t seq_no;
static bool seq_compare(const config_setting_base *a,
const config_setting_base *b) {
return a->seq_no < b->seq_no;
}
explicit config_setting_base(std::string name_);
virtual ~config_setting_base() {}
/*
* Set the setting manually.
* stack on entry: | ... new_value |
* stack on exit: | ... |
*/
void lua_set(lua::state &l);
friend void conky::set_config_settings(lua::state &l);
friend void conky::cleanup_config_settings(lua::state &l);
};
} // namespace priv
// If you need some very exotic setting, derive it from this class. Otherwise,
// scroll down.
template
class config_setting_template : public priv::config_setting_base {
public:
explicit config_setting_template(const std::string &name_)
: config_setting_base(name_) {}
// get the value of the setting as a C++ type
T get(lua::state &l);
protected:
/*
* Convert the value into a C++ type.
* stack on entry: | ... value |
* stack on exit: | ... |
*/
virtual T getter(lua::state &l) = 0;
};
template
T config_setting_template::get(lua::state &l) {
std::lock_guard guard(l);
lua::stack_sentry s(l);
l.checkstack(2);
l.getglobal("conky");
l.getfield(-1, "config");
l.replace(-2);
l.getfield(-1, name.c_str());
l.replace(-2);
return getter(l);
}
/*
* Declares a setting in the conky.config table.
* Getter function is used to translate the lua value into C++. It receives the
* value on the lua stack. It should pop it and return the C++ value. In case
* the value is nil, it should return a predefined default value. Translation
* into basic types works with the help of lua_traits template above The
* lua_setter function is called when someone tries to set the value. It
* receives the new and the old value on the stack (old one is on top). It
* should return the new value for the setting. It doesn't have to be the value
* the user set, if e.g. the value doesn't make sense. The second parameter is
* true if the assignment occurs during the initial parsing of the config file,
* and false afterwards. Some settings obviously cannot be changed (easily?)
* when conky is running, but some (e.g. x/y position of the window) can.
*/
template >
class simple_config_setting : public config_setting_template {
typedef config_setting_template Base;
public:
explicit simple_config_setting(const std::string &name_,
const T &default_value_ = T(),
bool modifiable_ = false)
: Base(name_), default_value(default_value_), modifiable(modifiable_) {}
simple_config_setting(const char *name_, const T &default_value_ = T(),
bool modifiable_ = false)
: Base(std::string(name_)),
default_value(default_value_),
modifiable(modifiable_) {}
protected:
const T default_value;
const bool modifiable;
virtual std::pair do_convert(lua::state &l,
int index);
virtual void lua_setter(lua::state &l, bool init);
virtual T getter(lua::state &l) {
lua::stack_sentry s(l, -1);
auto ret = do_convert(l, -1);
l.pop();
// setter function should make sure the value is valid
assert(ret.second);
return ret.first;
}
};
template
std::pair
simple_config_setting::do_convert(lua::state &l, int index) {
if (l.isnil(index)) return {default_value, true};
if (l.type(index) != Traits::type) {
NORM_ERR(
"Invalid value of type '%s' for setting '%s'. "
"Expected value of type '%s'.",
l.type_name(l.type(index)), Base::name.c_str(),
l.type_name(Traits::type));
return {default_value, false};
}
return Traits::convert(l, index, Base::name);
}
template
void simple_config_setting::lua_setter(lua::state &l, bool init) {
lua::stack_sentry s(l, -2);
bool ok = true;
if (!init && !modifiable) {
NORM_ERR("Setting '%s' is not modifiable", Base::name.c_str());
ok = false;
}
if (ok && do_convert(l, -2).second) {
l.pop();
} else {
l.replace(-2);
}
++s;
}
template
bool between(Signed1 value, Signed2 min,
typename std::enable_if::value,
Signed2>::type max) {
return value >= min && value <= max;
}
template
bool between(Signed1 value, Unsigned2 min,
typename std::enable_if::value,
Unsigned2>::type max) {
return value >= 0 &&
static_cast::type>(value) >=
min &&
static_cast::type>(value) <= max;
}
// Just like simple_config_setting, except that in only accepts value in the
// [min, max] range
template >
class range_config_setting : public simple_config_setting {
typedef simple_config_setting Base;
const T min;
const T max;
public:
explicit range_config_setting(const std::string &name_,
const T &min_ = std::numeric_limits::min(),
const T &max_ = std::numeric_limits::max(),
const T &default_value_ = T(),
bool modifiable_ = false)
: Base(name_, default_value_, modifiable_), min(min_), max(max_) {
assert(min <= Base::default_value && Base::default_value <= max);
}
protected:
virtual std::pair do_convert(lua::state &l,
int index) {
auto ret = Base::do_convert(l, index);
if (ret.second && !between(ret.first, min, max)) {
NORM_ERR("Value is out of range for setting '%s'", Base::name.c_str());
// we ignore out-of-range values. an alternative would be to clamp them.
// do we want to do that?
ret.second = false;
}
return ret;
}
};
} // namespace conky
#endif /* SETTING_HH */