cmd_option.h

Go to the documentation of this file.

#ifndef UTIL_CLI_CMDOPTION_H
#define UTIL_CLI_CMDOPTION_H
 
#pragma once
 
#include <assert.h>
#include <cstdio>
#include <exception>
#include <set>
 
#include <map>
#include <memory>
#include <ostream>
#include <sstream>
#include <vector>
 
#include "std/ref.h"
 
// 载入绑定器
#include "cli/cmd_option_bind.h"
#include "cli/cmd_option_bindt_base.h"
#include "cli/cmd_option_string.h"
#include "cmd_option_list.h"
 
#include "shell_font.h"
 
namespace util {
namespace cli {
// 标准指令处理函数(无返回值，参数为选项的映射表)
// void function_name (cmd_option_list&, [参数]); // 函数参数可选
// void function_name (callback_param, [参数]); // 函数参数可选
 
// 值类型
typedef std::shared_ptr<cli::cmd_option_value> value_type;
 
template <typename TCmdStr>
class cmd_option_bind : public binder::cmd_option_bind_base {
 public:
  typedef unsigned char uc_t;
  typedef cmd_option_bind<TCmdStr> self_type;
  typedef binder::cmd_option_bind_base::help_msg_t help_msg_t;
  typedef binder::cmd_option_bind_base::help_list_t help_list_t;
  typedef std::shared_ptr<binder::cmd_option_bind_base> func_ptr_t;
  typedef std::map<TCmdStr, func_ptr_t> funmap_type;
 
 protected:
  static short map_value_[256];   // 记录不同字符的映射关系
  static char trans_value_[256];  // 记录特殊转义字符
 
  funmap_type callback_funcs_;     // 记录命令的映射函数
  funmap_type callback_children_;  // 子命令组额外索引
  int help_cmd_style_;
  int help_description_style_;
 
  void run_cmd(const TCmdStr &cmd_content, callback_param params) const {
    typename funmap_type::const_iterator iter = callback_funcs_.find(cmd_content);
 
    // 如果是顶层调用则添加根指令调用栈
    if (params.get_cmd_array().empty()) {
      params.append_cmd(ROOT_NODE_CMD, std::const_pointer_cast<binder::cmd_option_bind_base>(shared_from_this()));
    }
 
    if (iter == callback_funcs_.end()) {
      // 内定命令不报“找不到指令”错
      if (cmd_content == "@OnDefault") return;
 
      iter = callback_funcs_.find("@OnError");  // 查找错误处理函数
      if (iter != callback_funcs_.end()) {
        // 错误附加内容(错误内容)
        params.add("@ErrorMsg=Command Invalid");
        params.append_cmd(cmd_content.c_str(), iter->second);  // 添加当前指令调用栈
 
        (*iter->second)(params);
      }
      return;
    }
 
    // 添加当前指令调用栈
    params.append_cmd(cmd_content.c_str(), iter->second);
    (*iter->second)(params);
  }
  void run_cmd(const TCmdStr &cmd_content, callback_param params) const  {…}
 
  void on_help(callback_param) {
    std::cout << "Help:" << std::endl;
    std::cout << (*this);
  }
  void on_help(callback_param) {…}
 
 public:
  void list_help_msg(help_list_t &msg, const std::string &prefix) const {
    for (typename funmap_type::const_iterator iter = callback_funcs_.begin(); iter != callback_funcs_.end(); ++iter) {
      if (iter->first.empty() || '@' == iter->first[0]) {
        continue;
      }
 
      help_list_t::iterator iter_m;
      help_msg_t *obj;
      for (iter_m = msg.begin(), obj = nullptr; iter_m != msg.end(); ++iter_m) {
        if ((*iter_m).binded_obj == iter->second) {
          obj = &(*iter_m);
          break;
        }
      }
 
      // all children do not make a help_msg_t
      if (callback_children_.find(iter->first) != callback_children_.end()) {
#if defined(LIBCOPP_MACRO_ENABLE_RTTI) && LIBCOPP_MACRO_ENABLE_RTTI
        self_type *child = dynamic_cast<self_type *>(iter->second.get());
#else
        self_type *child = static_cast<self_type *>(iter->second.get());
#endif
        assert(child);
        child->list_help_msg(msg, (prefix + " ") + iter->first.c_str());
        continue;
      }
 
      if (nullptr == obj) {
        msg.push_back(help_msg_t());
        obj = &msg.back();
        assert(obj);
        obj->binded_obj = iter->second;
        obj->description = iter->second->get_help_msg();
      }
 
      // any string to std::string
      std::string full_cmd;
      full_cmd.reserve(prefix.capacity() + iter->first.capacity());
      if (!prefix.empty()) {
        full_cmd = prefix;
        full_cmd += " ";
      }
      full_cmd += iter->first.c_str();
      obj->cmd_paths.push_back(full_cmd);
    }
  }
  void list_help_msg(help_list_t &msg, const std::string &prefix) const  {…}
 
  static std::ostream &dump(std::ostream &os, const self_type &self, const std::string &prefix) {
    help_list_t msgs;
    self.list_help_msg(msgs, "");
 
    size_t cmd_padding = 4;
    // sort all commands of the same callback
    for (help_list_t::iterator iter = msgs.begin(); iter != msgs.end(); ++iter) {
      std::sort((*iter).cmd_paths.begin(), (*iter).cmd_paths.end());
      std::stringstream ss;
      bool not_first = false;
      for (std::vector<std::string>::iterator cmd_it = (*iter).cmd_paths.begin(); cmd_it != (*iter).cmd_paths.end();
           ++cmd_it) {
        if (not_first) {
          ss << ", ";
        }
        ss << *cmd_it;
        not_first = true;
      }
 
      (*iter).all_cmds = ss.str();
      if ((*iter).all_cmds.size() >= cmd_padding) {
        cmd_padding = (((*iter).all_cmds.size() >> 2) + 1) << 2;
      }
    }
 
    std::sort(msgs.begin(), msgs.end(), binder::cmd_option_bind_base::sort_by_all_cmds);
 
    for (help_list_t::iterator iter = msgs.begin(); iter != msgs.end(); ++iter) {
      shell_stream ss(os);
 
      ss().open(self.help_cmd_style_) << prefix << (*iter).all_cmds;
      if ((*iter).all_cmds.size() < cmd_padding) {
        std::string padding_space;
        padding_space.resize(cmd_padding - (*iter).all_cmds.size(), ' ');
        ss() << padding_space;
      }
      ss().open(self.help_description_style_) << (*iter).description << std::endl;
    }
 
    return os;
  }
  static std::ostream &dump(std::ostream &os, const self_type &self, const std::string &prefix) {…}
 
  friend std::ostream &operator<<(std::ostream &os, const self_type &self) { return dump(os, self, std::string()); }
 
  std::ostream &dump(std::ostream &os, const std::string &prefix) { return dump(os, *this, prefix); }
 
  static const char *get_segment(const char *begin_str, std::string &val) {
    val.clear();
    char flag;  // 字符串开闭字符
 
    // 去除分隔符前缀
    while (*begin_str && (map_value_[(uc_t)*begin_str] & SPLITCHAR)) ++begin_str;
 
    while (*begin_str && !(map_value_[(uc_t)*begin_str] & SPLITCHAR)) {
      if (!(map_value_[(uc_t)*begin_str] & STRINGSYM)) {
        val += *begin_str;
        ++begin_str;
      } else {
        flag = *begin_str;
        ++begin_str;
 
        while (*begin_str && *begin_str != flag) {
          char cur_byte = *begin_str;
          if (map_value_[(uc_t)*begin_str] & TRANSLATE) {
            if (*(begin_str + 1)) {
              ++begin_str;
              cur_byte = trans_value_[(uc_t)*begin_str];
            }
          }
 
          val += cur_byte;
          ++begin_str;
        }
 
        ++begin_str;
        break;  // 字符串结束后参数结束
      }
    }
 
    // 去除分隔符后缀
    while (*begin_str && (map_value_[(uc_t)*begin_str] & SPLITCHAR)) ++begin_str;
    return begin_str;
  }
  static const char *get_segment(const char *begin_str, std::string &val) {…}
 
  static std::vector<std::string> split_cmd(const char *begin_str) {
    std::vector<std::string> ret;
    for (const char *begin_ptr = begin_str; (*begin_ptr);) {
      std::string cmd_content;
      // 去除命令分隔符前缀
      while ((*begin_ptr) && (map_value_[(uc_t)*begin_ptr] & CMDSPLIT)) ++begin_ptr;
 
      // 分离命令
      while ((*begin_ptr) && !(map_value_[(uc_t)*begin_ptr] & CMDSPLIT)) {
        cmd_content.push_back(*begin_ptr);
        ++begin_ptr;
      }
 
      if (cmd_content.size() > 0) ret.push_back(cmd_content);
    }
 
    return ret;
  }
  static std::vector<std::string> split_cmd(const char *begin_str) {…}
 
 private:
  cmd_option_bind()
      : help_cmd_style_(shell_font_style::SHELL_FONT_COLOR_YELLOW |
                        static_cast<int>(shell_font_style::SHELL_FONT_SPEC_BOLD)),
        help_description_style_(0) {
    // 如果已初始化则跳过
    if (map_value_[(uc_t)' '] & SPLITCHAR) return;
 
    // 分隔符
    map_value_[(uc_t)' '] = map_value_[(uc_t)'\t'] = map_value_[(uc_t)'\r'] = map_value_[(uc_t)'\n'] = SPLITCHAR;
    // 字符串开闭符
    map_value_[(uc_t)'\''] = map_value_[(uc_t)'\"'] = STRINGSYM;
    // 转义标记符
    map_value_[(uc_t)'\\'] = TRANSLATE;
    // 指令分隔符
    map_value_[(uc_t)' '] |= CMDSPLIT;
    map_value_[(uc_t)','] = map_value_[(uc_t)';'] = CMDSPLIT;
 
    // 转义字符设置
    for (int i = 0; i < 256; ++i) trans_value_[i] = static_cast<char>(i);
 
    trans_value_[(uc_t)'0'] = '\0';
    trans_value_[(uc_t)'a'] = '\a';
    trans_value_[(uc_t)'b'] = '\b';
    trans_value_[(uc_t)'f'] = '\f';
    trans_value_[(uc_t)'r'] = '\r';
    trans_value_[(uc_t)'n'] = '\n';
    trans_value_[(uc_t)'t'] = '\t';
    trans_value_[(uc_t)'v'] = '\v';
    trans_value_[(uc_t)'\\'] = '\\';
    trans_value_[(uc_t)'\''] = '\'';
    trans_value_[(uc_t)'\"'] = '\"';
  }
  cmd_option_bind() {…}
 
 public:
  typedef std::shared_ptr<cmd_option_bind> ptr_type;
  static ptr_type create() { return ptr_type(new cmd_option_bind()); }
 
  std::shared_ptr<std::vector<const char *> > get_cmd_names() const {
    typename funmap_type::const_iterator iter = callback_funcs_.begin();
    std::shared_ptr<std::vector<const char *> > ret_ptr =
        std::shared_ptr<std::vector<const char *> >(new std::vector<const char *>());
    while (iter != callback_funcs_.end()) {
      ret_ptr->push_back(iter->first.c_str());
      ++iter;
    }
    return ret_ptr;
  }
  std::shared_ptr<std::vector<const char *> > get_cmd_names() const  {…}
 
  std::shared_ptr<binder::cmd_option_bind_base> get_binded_cmd(const char *cmd_name) const {
    typename funmap_type::const_iterator iter = callback_funcs_.find(cmd_name);
    if (iter == callback_funcs_.end()) return std::shared_ptr<binder::cmd_option_bind_base>();
    return iter->second;
  }
  std::shared_ptr<binder::cmd_option_bind_base> get_binded_cmd(const char *cmd_name) const  {…}
 
  size_t size() const { return callback_funcs_.size(); }
  size_t empty() const { return callback_funcs_.empty(); }
  const funmap_type &get_all() const { return callback_funcs_; }
 
  size_t children_size() const { return callback_children_.size(); }
  size_t children_empty() const { return callback_children_.empty(); }
  const funmap_type &get_all_children() const { return callback_children_; }
 
  int get_help_cmd_style() const { return help_cmd_style_; }
  void set_help_cmd_style(int style) { help_cmd_style_ = style; }
  int get_help_description_style() const { return help_description_style_; }
  void set_help_description_style(int style) { help_description_style_ = style; }
 
  void start(callback_param args, bool is_single_cmd = false) const {
    int argv = static_cast<int>(args.get_params_number());
    cmd_option_list cmd_args;
    TCmdStr cmd_content = is_single_cmd ? "@OnError" : "@OnDefault";
    for (int i = -1; i < argv;) {
      ++i;
      cmd_args.clear();
      cmd_args.load_cmd_array(args.get_cmd_array());
      cmd_args.set_ext_param(args.get_ext_param());
 
      for (; i < argv; ++i) {
        // 把所有的非指令字符串设为指令参数
        if (callback_funcs_.find(args[static_cast<size_t>(i)]->to_string()) == callback_funcs_.end()) {
          cmd_args.add(args[static_cast<size_t>(i)]->to_string());
        } else {
          // 如果是单指令且有未知参数则分发@OnError错误处理
          if (is_single_cmd && cmd_args.get_params_number() > 0) {
            run_cmd(cmd_content, cmd_args);
            cmd_args.clear();
            cmd_args.load_cmd_array(args.get_cmd_array());
            cmd_args.set_ext_param(args.get_ext_param());
          }
 
          // 追加所有参数，执行单指令
          if (is_single_cmd) {
            cmd_content = TCmdStr(args[static_cast<size_t>(i)]->to_cpp_string().c_str(),
                                  args[static_cast<size_t>(i)]->to_cpp_string().size());
            for (++i; i < argv; ++i) cmd_args.add(args[static_cast<size_t>(i)]->to_string());
          }
          break;
        }
      }
 
      run_cmd(cmd_content, cmd_args);
      if (i >= argv) break;
      cmd_content = TCmdStr(args[static_cast<size_t>(i)]->to_cpp_string().c_str(),
                            args[static_cast<size_t>(i)]->to_cpp_string().size());
    }
  }
  void start(callback_param args, bool is_single_cmd = false) const  {…}
 
  inline void start(int argv, const char *argc[], bool is_single_cmd = false, void *ext_param = nullptr) const {
    cmd_option_list copt_list(argv, argc);
    copt_list.set_ext_param(ext_param);
 
    start(copt_list, is_single_cmd);
  }
  inline void start(int argv, const char *argc[], bool is_single_cmd = false, void *ext_param = nullptr) const  {…}
 
  inline void start(int argv, char *argc[], bool is_single_cmd = false, void *ext_param = nullptr) const {
    typedef const char *conv_char_t;
 
    start(argv, const_cast<conv_char_t *>(argc), is_single_cmd, ext_param);
  }
  inline void start(int argv, char *argc[], bool is_single_cmd = false, void *ext_param = nullptr) const  {…}
 
  inline void start(const std::vector<std::string> &cmds, bool is_single_cmd = false, void *ext_param = nullptr) const {
    cmd_option_list copt_list(cmds);
    copt_list.set_ext_param(ext_param);
 
    start(copt_list, is_single_cmd);
  }
  inline void start(const std::vector<std::string> &cmds, bool is_single_cmd = false, void *ext_param = nullptr) const  {…}
 
  void start(const char *cmd_content, bool is_single_cmd = false, void *ext_param = nullptr) const {
    cmd_option_list cmds;
    std::string seg;
 
    // 分离指令
    while (*cmd_content) {
      cmd_content = get_segment(cmd_content, seg);
      cmds.add(seg.c_str());
    }
 
    cmds.set_ext_param(ext_param);
 
    start(cmds, is_single_cmd);
  }
  void start(const char *cmd_content, bool is_single_cmd = false, void *ext_param = nullptr) const  {…}
 
  inline void start(const std::string &cmd_content, bool is_single_cmd = false, void *ext_param = nullptr) const {
    start(cmd_content.c_str(), is_single_cmd, ext_param);
  }
  inline void start(const std::string &cmd_content, bool is_single_cmd = false, void *ext_param = nullptr) const  {…}
 
  inline void unbind_cmd(const std::string &cmd_content) {
    TCmdStr cmd_obj = TCmdStr(cmd_content.c_str(), cmd_content.size());
    callback_funcs_.erase(cmd_obj);
    callback_children_.erase(cmd_content);
  }
  inline void unbind_cmd(const std::string &cmd_content) {…}
 
  inline void unbind_all_cmd() {
    callback_funcs_.clear();
    callback_children_.clear();
  }
  inline void unbind_all_cmd() {…}
 
  inline std::shared_ptr<binder::cmd_option_bindt<
      typename binder::maybe_wrap_member_pointer<void (cmd_option_bind<TCmdStr>::*)(callback_param)>::caller_type,
      binder::cmd_option_bind_param_list<cmd_option_bind<TCmdStr> *> > >
  bind_help_cmd(const char *help_cmd_content) {
    return bind_cmd(help_cmd_content, &cmd_option_bind<TCmdStr>::on_help, this);
  }
  bind_help_cmd(const char *help_cmd_content) {…}
 
  void operator()(callback_param arg) override {
    // 响应@OnCallFunc事件
    typename funmap_type::const_iterator iter = callback_funcs_.find("@OnCallFunc");
    if (iter != callback_funcs_.end()) (*iter->second)(arg);
 
    // 重新执行指令集, 进入子结构的一定是单指令
    start(arg, true);
  }
  void operator()(callback_param arg) override  {…}
 
  std::string get_help_msg(const char *prefix_data = "") const override {
    std::set<typename funmap_type::mapped_type> set_obj;
    std::string help_msg_content;
 
    for (typename funmap_type::const_iterator iter = callback_funcs_.begin(); iter != callback_funcs_.end(); ++iter) {
      // 删除重复的引用对象
      if (set_obj.find(iter->second) != set_obj.end()) continue;
 
      // 跳过内置命令
      if ('@' == *iter->first.c_str()) continue;
 
      set_obj.insert(iter->second);
      std::string cmd_help = iter->second->get_help_msg((prefix_data + help_msg_).c_str());
 
      if (cmd_help.size() > 0) {
        if (help_msg_content.size() > 0 && '\n' != *help_msg_content.rbegin()) help_msg_content += "\r\n";
        help_msg_content += cmd_help;
      }
    }
    return help_msg_content;
  }
  std::string get_help_msg(const char *prefix_data = "") const override  {…}
 
  template <typename _F,
            typename... _Args>  // 绑定函数(_Arg:参数[注意值的复制发生在本函数执行时], _R: 绑定函数返回值类型)
  std::shared_ptr<binder::cmd_option_bindt<typename binder::maybe_wrap_member_pointer<_F>::caller_type,
                                           binder::cmd_option_bind_param_list<_Args...> > >
  bind_cmd(const std::string &cmd_content, _F raw_fn, _Args... args) {
    typedef binder::cmd_option_bind_param_list<_Args...> list_type;
    typedef typename binder::maybe_wrap_member_pointer<_F>::caller_type caller_type;
    typedef std::shared_ptr<binder::cmd_option_bindt<caller_type, list_type> > obj_type;
 
    obj_type fn =
        obj_type(new binder::cmd_option_bindt<caller_type, list_type>(caller_type(raw_fn), list_type(args...)));
 
    std::vector<std::string> cmds = split_cmd(cmd_content.c_str());
    for (std::vector<std::string>::size_type index = 0; index < cmds.size(); ++index) {
      TCmdStr cmd_obj = TCmdStr(cmds[index].c_str(), cmds[index].size());
      callback_funcs_[cmd_obj] = fn;
    }
 
    return fn;
  }
  bind_cmd(const std::string &cmd_content, _F raw_fn, _Args... args) {…}
 
  std::shared_ptr<binder::cmd_option_bind_base> bind_child_cmd(
      const std::string cmd_content, std::shared_ptr<binder::cmd_option_bind_base> base_node) {
    std::vector<std::string> cmds = split_cmd(cmd_content.c_str());
    for (std::vector<std::string>::size_type index = 0; index < cmds.size(); ++index) {
      TCmdStr cmd_obj = TCmdStr(cmds[index].c_str(), cmds[index].size());
      callback_funcs_[cmd_obj] = base_node;
      callback_children_[cmd_obj] = base_node;
    }
 
    return base_node;
  }
  std::shared_ptr<binder::cmd_option_bind_base> bind_child_cmd( {…}
 
  std::shared_ptr<binder::cmd_option_bind_base> bind_child_cmd(const std::string cmd_content, ptr_type cmd_opt) {
#if defined(LIBATFRAME_UTILS_ENABLE_RTTI) && LIBATFRAME_UTILS_ENABLE_RTTI
    std::shared_ptr<binder::cmd_option_bind_base> base_node =
        std::dynamic_pointer_cast<binder::cmd_option_bind_base>(cmd_opt);
#else
    std::shared_ptr<binder::cmd_option_bind_base> base_node =
        std::static_pointer_cast<binder::cmd_option_bind_base>(cmd_opt);
#endif
    std::vector<std::string> cmds = split_cmd(cmd_content.c_str());
    for (std::vector<std::string>::size_type index = 0; index < cmds.size(); ++index) {
      TCmdStr cmd_obj = TCmdStr(cmds[index].c_str(), cmds[index].size());
      callback_funcs_[cmd_obj] = base_node;
      callback_children_[cmd_obj] = base_node;
    }
 
    return base_node;
  }
  std::shared_ptr<binder::cmd_option_bind_base> bind_child_cmd(const std::string cmd_content, ptr_type cmd_opt) {…}
};
class cmd_option_bind : public binder::cmd_option_bind_base {…};
 
template <typename Ty>
short cmd_option_bind<Ty>::map_value_[256] = {0};
 
template <typename Ty>
char cmd_option_bind<Ty>::trans_value_[256] = {0};
 
// 类型重定义
typedef cmd_option_bind<std::string> cmd_option;
typedef cmd_option_bind<cmd_option_ci_string> cmd_option_ci;
}  // namespace cli
namespace cli {…}
}  // namespace util
#endif /* CMDOPTION_H_ */