X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=senf%2FUtils%2FConsole%2FVariables.hh;h=92df05dd87262e678d0b439602e7b2103f6c2479;hb=18d987b03ac188adf6e1a82ebce2666738f0ff65;hp=4f93a93fcd3bd3d9862a1877a0a21478d4cb9a40;hpb=90f51da2398de98c2c217045f791ca7813730f48;p=senf.git diff --git a/senf/Utils/Console/Variables.hh b/senf/Utils/Console/Variables.hh index 4f93a93..92df05d 100644 --- a/senf/Utils/Console/Variables.hh +++ b/senf/Utils/Console/Variables.hh @@ -42,63 +42,34 @@ namespace console { class ScopedDirectoryBase; template class VariableAttributor; - - -#ifndef DOXYGEN - - template - VariableAttributor senf_console_add_node( - DirectoryNode & node, std::string const & name, Variable & var, int, - typename boost::disable_if< boost::is_convertible >::type * = 0, - typename boost::disable_if< boost::is_convertible >::type * = 0, - typename boost::disable_if_c::is_callable>::type * = 0); - - template - typename detail::VariableNodeCreator::result_type - senf_console_add_node(DirectoryNode & node, std::string const & name, - boost::reference_wrapper var, int); - - template - VariableAttributor senf_console_add_node( - DirectoryNode & node, Owner & owner, std::string const & name, Variable & var, int, - typename boost::disable_if< boost::is_convertible >::type * = 0, - typename boost::disable_if< boost::is_convertible >::type * = 0, - typename boost::disable_if_c::is_callable>::type * = 0); - - template - typename detail::VariableNodeCreator::result_type - senf_console_add_node(DirectoryNode & node, Owner & owner, std::string const & name, - boost::reference_wrapper var, int); - -#endif +namespace factory { /** \brief Variable command attributes (const) - \see VariableAttributor + \see VariableFactory */ template - class ConstVariableAttributor + class ConstVariableFactory + : public detail::NodeFactory { public: typedef typename detail::QueryVariable::Traits::Overload QueryOverload; typedef typename QueryOverload::Formatter Formatter; typedef OverloadedCommandNode node_type; - typedef ConstVariableAttributor return_type; - - ConstVariableAttributor doc(std::string const & doc); - ConstVariableAttributor shortdoc(std::string const & doc); - ConstVariableAttributor formatter(Formatter formatter); + typedef OverloadedCommandNode & result_type; - OverloadedCommandNode & node() const; ///< Return the node object - operator OverloadedCommandNode & () const; ///< Automatically convert to node object + ConstVariableFactory doc(std::string const & doc); + ConstVariableFactory shortdoc(std::string const & doc); + ConstVariableFactory formatter(Formatter formatter); - protected: - explicit ConstVariableAttributor(QueryOverload & queryOverload); + OverloadedCommandNode & create(DirectoryNode & dir, std::string const & name) const; + + explicit ConstVariableFactory(Variable const & var); private: - QueryOverload & queryOverload_; - - friend class detail::VariableNodeCreator; + typename QueryOverload::ptr queryOverload_; + boost::optional doc_; + boost::optional shortdoc_; }; /** \brief Variable command attributes @@ -132,65 +103,74 @@ namespace console { \ingroup console_commands */ template - class VariableAttributor - : public ConstVariableAttributor + class VariableFactory + : public ConstVariableFactory { public: typedef typename detail::SetVariable::Traits::Overload SetOverload; typedef typename detail::ArgumentInfo::Parser Parser; typedef typename detail::SetVariable::OnChangeHandler OnChangeHandler; - typedef OverloadedCommandNode node_type; - typedef VariableAttributor return_type; - - typedef typename ConstVariableAttributor::Formatter Formatter; - typedef typename ConstVariableAttributor::QueryOverload QueryOverload; - - VariableAttributor doc(std::string const & doc); ///< Set documentation of the variable - VariableAttributor shortdoc(std::string const & doc); ///< Set short documentation - VariableAttributor formatter(Formatter formatter); ///< Set formatter - /**< The \a formatter must be a callable with a signature - compatible with - \code - void formatter(Variable const & value, std::ostream & os); - \endcode - The \a formatter takes the return value of the call \a - value and writes it properly formated to \a os. */ - - VariableAttributor parser(Parser parser); ///< Set argument parser - /**< The parser is an arbitrary callable object with - the signature - \code - void parser(senf::console::ParseCommandInfo::TokensRange const & tokens, value_type & out); - \endcode - - where \c value_type is the type of the overload - parameter. The parser must read and parse the complete - \a tokens range and return the parsed value in \a - out. If the parser fails, it must raise a - senf::console::SyntaxErrorException. */ - VariableAttributor typeName(std::string const & name); ///< Set name of the variable type - VariableAttributor onChange(OnChangeHandler handler); ///< Set change callback - /**< The \a handler callback is called, whenever the value - of the variable is changed. The new value has already - been set, when the callback is called, the old value is - passed to the callback. The callback must have a - signature compatible to - \code - void handler(Variable const & oldValue); - \endcode */ - + + typedef typename ConstVariableFactory::Formatter Formatter; + typedef typename ConstVariableFactory::QueryOverload QueryOverload; + + VariableFactory doc(std::string const & doc); ///< Set documentation of the variable + VariableFactory shortdoc(std::string const & doc); ///< Set short documentation + VariableFactory formatter(Formatter formatter); ///< Set formatter + /**< The \a formatter must be a callable with a signature + compatible with + \code + void formatter(Variable const & value, std::ostream & os); + \endcode + The \a formatter takes the return value of the call \a + value and writes it properly formated to \a os. */ + VariableFactory parser(Parser parser); ///< Set argument parser + /**< The parser is an arbitrary callable object with + the signature + \code + void parser(senf::console::ParseCommandInfo::TokensRange const & tokens, value_type & out); + \endcode + + where \c value_type is the type of the overload + parameter. The parser must read and parse the complete + \a tokens range and return the parsed value in \a + out. If the parser fails, it must raise a + senf::console::SyntaxErrorException. */ + VariableFactory typeName(std::string const & name); ///< Set name of the variable type + VariableFactory onChange(OnChangeHandler handler); ///< Set change callback + /**< The \a handler callback is called, whenever the value + of the variable is changed. The new value has already + been set, when the callback is called, the old value is + passed to the callback. The callback must have a + signature compatible to + \code + void handler(Variable const & oldValue); + \endcode */ + + OverloadedCommandNode & create(DirectoryNode & dir, std::string const & name) const; + + explicit VariableFactory(Variable & var); + protected: private: - VariableAttributor(QueryOverload & queryOverload, SetOverload & setOverload, - Variable & var); - - SetOverload & setOverload_; + typename SetOverload::ptr setOverload_; Variable & var_; - - friend class detail::VariableNodeCreator; }; -}} + + template + VariableFactory Variable(Var & var); + + template + VariableFactory Variable(boost::reference_wrapper var); + + template + ConstVariableFactory Variable(Var const & var); + + template + ConstVariableFactory Variable(boost::reference_wrapper var); + +}}} ///////////////////////////////hh.e//////////////////////////////////////// //#include "Variables.cci"