cmdbox 0.5.1.2__py3-none-any.whl → 0.5.3__py3-none-any.whl

cmdbox/app/options.py

@@ -1,601 +1,788 @@
-from cmdbox.app import common, feature
-from cmdbox.app.commons import module
-from fastapi.routing import APIRoute
-from pathlib import Path
-from starlette.routing import Route
-from typing import List, Dict, Any 
-import locale
-import logging
-import re
-
-
-class Options:
-    T_INT = 'int'
-    T_FLOAT = 'float'
-    T_BOOL = 'bool'
-    T_STR = 'str'
-    T_DICT = 'dict'
-    T_TEXT = 'text'
-    T_FILE = 'file'
-    T_DIR = 'dir'
-    
-    def __setattr__(self, name:str, value):
-        if name.startswith("T_") and name in self.__dict__:
-            raise ValueError(f'Cannot set attribute. ({name})')
-        self.__dict__[name] = value
-
-    _instance = None
-
-    @staticmethod
-    def getInstance(appcls=None, ver=None):
-        if Options._instance is None:
-            Options._instance = Options(appcls=appcls, ver=ver)
-        return Options._instance
-
-    def __init__(self, appcls=None, ver=None):
-        self.appcls = appcls
-        self.ver = ver
-        self.features_yml_data = None
-        self.features_loaded = dict()
-        self.aliases_loaded_cli = False
-        self.aliases_loaded_web = False
-        self.init_options()
-
-    def get_mode_keys(self) -> List[str]:
-        return [key for key,val in self._options["mode"].items() if type(val) == dict]
-
-    def get_modes(self) -> List[Dict[str, str]]:
-        """
-        起動モードの選択肢を取得します。
-        Returns:
-            List[Dict[str, str]]: 起動モードの選択肢
-        """
-        return [''] + [{key:val} for key,val in self._options["mode"].items() if type(val) == dict]
-
-    def get_cmd_keys(self, mode:str) -> List[str]:
-        if mode not in self._options["cmd"]:
-            return []
-        return [key for key,val in self._options["cmd"][mode].items() if type(val) == dict]
-
-    def get_cmds(self, mode:str) -> List[Dict[str, str]]:
-        """
-        コマンドの選択肢を取得します。
-        Args:
-            mode: 起動モード
-        Returns:
-            List[Dict[str, str]]: コマンドの選択肢
-        """
-        if mode not in self._options["cmd"]:
-            return ['Please select mode.']
-        ret = [{key:val} for key,val in self._options["cmd"][mode].items() if type(val) == dict]
-        if len(ret) > 0:
-            return [''] + ret
-        return ['Please select mode.']
-
-    def get_cmd_attr(self, mode:str, cmd:str, attr:str) -> Any:
-        """
-        コマンドの属性を取得します。
-        Args:
-            mode: 起動モード
-            cmd: コマンド
-            attr: 属性
-        Returns:
-            Any: 属性の値
-        """
-        if mode not in self._options["cmd"]:
-            return [f'Unknown mode. ({mode})']
-        if cmd is None or cmd == "" or cmd not in self._options["cmd"][mode]:
-            return []
-        if attr not in self._options["cmd"][mode][cmd]:
-            return None
-        return self._options["cmd"][mode][cmd][attr]
-    
-    def get_svcmd_feature(self, svcmd:str) -> Any:
-        """
-        サーバー側のコマンドのフューチャーを取得します。
-
-        Args:
-            svcmd: サーバー側のコマンド
-        Returns:
-            feature.Feature: フューチャー
-        """
-        if svcmd is None or svcmd == "":
-            return None
-        if svcmd not in self._options["svcmd"]:
-            return None
-        return self._options["svcmd"][svcmd]
-
-    def get_cmd_choices(self, mode:str, cmd:str, webmode:bool=False) -> List[Dict[str, Any]]:
-        """
-        コマンドのオプション一覧を取得します。
-        Args:
-            mode: 起動モード
-            cmd: コマンド
-            webmode (bool, optional): Webモードからの呼び出し. Defaults to False
-        Returns:
-            List[Dict[str, Any]]: オプションの選択肢
-        """
-        opts = self.get_cmd_attr(mode, cmd, "choice")
-        ret = []
-        for o in opts:
-            if not webmode or type(o) is not dict:
-                ret.append(o)
-                continue
-            o = o.copy()
-            if 'web' in o and o['web'] == 'mask':
-                o['default'] = '********'
-            ret.append(o)
-        return ret
-
-    def get_cmd_opt(self, mode:str, cmd:str, opt:str, webmode:bool=False) -> Dict[str, Any]:
-        """
-        コマンドのオプションを取得します。
-        Args:
-            mode: 起動モード
-            cmd: コマンド
-            opt: オプション
-            webmode (bool, optional): Webモードからの呼び出し. Defaults to False
-        Returns:
-            Dict[str, Any]: オプションの値
-        """
-        opts = self.get_cmd_choices(mode, cmd, webmode)
-        for o in opts:
-            if 'opt' in o and o['opt'] == opt:
-                return o
-        return None
-
-    def list_options(self):
-        def _list(ret, key, val):
-            if type(val) != dict or 'type' not in val:
-                return
-            opt = dict()
-            if val['type'] == Options.T_INT:
-                opt['type'] = int
-                opt['action'] = 'append' if val['multi'] else None
-            elif val['type'] == Options.T_FLOAT:
-                opt['type'] = float
-                opt['action'] = 'append' if val['multi'] else None
-            elif val['type'] == Options.T_BOOL:
-                opt['type'] = bool
-                opt['action'] = 'store_true'
-            elif val['type'] == Options.T_DICT:
-                opt['type'] = dict
-                if not val['multi']:
-                    raise ValueError(f'list_options: The multi must be True if type is dict. key={key}, val={val}')
-                opt['action'] = 'append'
-            else:
-                opt['type'] = str
-                opt['action'] = 'append' if val['multi'] else None
-            o = [f'-{val["short"]}'] if "short" in val else []
-            o += [f'--{key}']
-            language, _ = locale.getlocale()
-            opt['help'] = val['discription_en'] if language.find('Japan') < 0 and language.find('ja_JP') < 0 else val['discription_ja']
-            opt['default'] = val['default']
-            if val['multi'] and val['default'] is not None:
-                raise ValueError(f'list_options: The default value must be None if multi is True. key={key}, val={val}')
-            opt['opts'] = o
-            if val['choice'] is not None:
-                opt['choices'] = []
-                for c in val['choice']:
-                    if type(c) == dict:
-                        opt['choices'] += [c['opt']]
-                    elif c is not None and c != "":
-                        opt['choices'] += [c]
-            else:
-                opt['choices'] = None
-            ret[key] = opt
-        ret = dict()
-        for k, v in self._options.items():
-            _list(ret, k, v)
-        #for mode in self._options["mode"]['choice']:
-        for _, cmd in self._options["cmd"].items():
-            if type(cmd) is not dict:
-                continue
-            for _, opt in cmd.items():
-                if type(opt) is not dict:
-                    continue
-                for o in opt["choice"]:
-                    if type(o) is not dict:
-                        continue
-                    _list(ret, o['opt'], o)
-        return ret
-
-    def mk_opt_list(self, opt:dict, webmode:bool=False) -> List[str]:
-        opt_schema = self.get_cmd_choices(opt['mode'], opt['cmd'], webmode)
-        opt_list = ['-m', opt['mode'], '-c', opt['cmd']]
-        file_dict = dict()
-        for key, val in opt.items():
-            if key in ['stdout_log', 'capture_stdout']:
-                continue
-            schema = [schema for schema in opt_schema if type(schema) is dict and schema['opt'] == key]
-            if len(schema) == 0 or val == '':
-                continue
-            if schema[0]['type'] == Options.T_BOOL:
-                if val:
-                    opt_list.append(f"--{key}")
-                continue
-            if type(val) == list:
-                for v in val:
-                    if v is None or v == '':
-                        continue
-                    opt_list.append(f"--{key}")
-                    if str(v).find(' ') >= 0:
-                        opt_list.append(f'"{v}"')
-                    else:
-                        opt_list.append(str(v))
-            elif type(val) == dict:
-                for k,v in val.items():
-                    if k is None or k == '' or v is None or v == '':
-                        continue
-                    opt_list.append(f"--{key}")
-                    k = f'"{k}"' if str(k).find(' ') >= 0 else str(k)
-                    v = f'"{v}"' if str(v).find(' ') >= 0 else str(v)
-                    opt_list.append(f'{k}={v}')
-            elif val is not None and val != '':
-                opt_list.append(f"--{key}")
-                if str(val).find(' ') >= 0:
-                    opt_list.append(f'"{val}"')
-                else:
-                    opt_list.append(str(val))
-            if 'fileio' in schema[0] and schema[0]['fileio'] == 'in' and type(val) != str:
-                file_dict[key] = val
-        return opt_list, file_dict
-
-    def init_options(self):
-        self._options = dict()
-        self._options["version"] = dict(
-            short="v", type=Options.T_BOOL, default=None, required=False, multi=False, hide=True, choice=None,
-            discription_ja="バージョン表示",
-            discription_en="Display version")
-        self._options["useopt"] = dict(
-            short="u", type=Options.T_STR, default=None, required=False, multi=False, hide=True, choice=None,
-            discription_ja="オプションを保存しているファイルを使用します。",
-            discription_en="Use the file that saves the options.")
-        self._options["saveopt"] = dict(
-            short="s", type=Options.T_BOOL, default=None, required=False, multi=False, hide=True, choice=[True, False],
-            discription_ja="指定しているオプションを `-u` で指定したファイルに保存します。",
-            discription_en="Save the specified options to the file specified by `-u`.")
-        self._options["debug"] = dict(
-            short="d", type=Options.T_BOOL, default=False, required=False, multi=False, hide=True, choice=[True, False],
-            discription_ja="デバックモードで起動します。",
-            discription_en="Starts in debug mode.")
-        self._options["format"] = dict(
-            short="f", type=Options.T_BOOL, default=None, required=False, multi=False, hide=True,
-            discription_ja="処理結果を見やすい形式で出力します。指定しない場合json形式で出力します。",
-            discription_en="Output the processing result in an easy-to-read format. If not specified, output in json format.",
-            choice=None)
-        self._options["mode"] = dict(
-            short="m", type=Options.T_STR, default=None, required=True, multi=False, hide=True,
-            discription_ja="起動モードを指定します。",
-            discription_en="Specify the startup mode.",
-            choice=[])
-        self._options["cmd"] = dict(
-            short="c", type=Options.T_STR, default=None, required=True, multi=False, hide=True,
-            discription_ja="コマンドを指定します。",
-            discription_en="Specify the command.",
-            choice=[])
-        self._options["tag"] = dict(
-            short="t", type=Options.T_STR, default=None, required=False, multi=True, hide=True,
-            discription_ja="このコマンドのタグを指定します。",
-            discription_en="Specify the tag for this command.",
-            choice=None)
-
-    def init_debugoption(self):
-        # デバックオプションを追加
-        self._options["debug"]["opt"] = "debug"
-        self._options["tag"]["opt"] = "tag"
-        for key, mode in self._options["cmd"].items():
-            if type(mode) is not dict:
-                continue
-            mode['opt'] = key
-            for k, c in mode.items():
-                if type(c) is not dict:
-                    continue
-                c["opt"] = k
-                if "debug" not in [_o['opt'] for _o in c["choice"]]:
-                    c["choice"].append(self._options["debug"])
-                if "tag" not in [_o['opt'] for _o in c["choice"]]:
-                    c["choice"].append(self._options["tag"])
-                if c["opt"] not in [_o['opt'] for _o in self._options["cmd"]["choice"]]:
-                    self._options["cmd"]["choice"] += [c]
-            self._options["mode"][key] = mode
-            self._options["mode"]["choice"] += [mode]
-
-    def load_svcmd(self, package_name:str, prefix:str="cmdbox_", excludes:list=[], appcls=None, ver=None, logger:logging.Logger=None, isloaded:bool=True):
-        """
-        指定されたパッケージの指定された接頭語を持つモジュールを読み込みます。
-
-        Args:
-            package_name (str): パッケージ名
-            prefix (str): 接頭語
-            excludes (list): 除外するモジュール名のリスト
-            appcls (Any): アプリケーションクラス
-            ver (Any): バージョンモジュール
-            logger (logging.Logger): ロガー
-            isloaded (bool): 読み込み済みかどうか
-        """
-        if "svcmd" not in self._options:
-            self._options["svcmd"] = dict()
-        for mode, f in module.load_features(package_name, prefix, excludes, appcls=appcls, ver=ver).items():
-            if mode not in self._options["cmd"]:
-                self._options["cmd"][mode] = dict()
-            for cmd, opt in f.items():
-                self._options["cmd"][mode][cmd] = opt
-                fobj:feature.Feature = opt['feature']
-                if not isloaded and logger is not None and logger.level == logging.DEBUG:
-                    logger.debug(f"loaded features: mode={mode}, cmd={cmd}, {fobj}")
-                svcmd = fobj.get_svcmd()
-                if svcmd is not None:
-                    self._options["svcmd"][svcmd] = fobj
-        self.init_debugoption()
-    
-    def is_features_loaded(self, ftype:str) -> bool:
-        """
-        指定されたフィーチャータイプが読み込まれているかどうかを返します。
-
-        Args:
-            ftype (str): フィーチャータイプ
-        Returns:
-            bool: 読み込まれているかどうか
-        """
-        return ftype in self.features_loaded and self.features_loaded[ftype]
-
-    def load_features_file(self, ftype:str, func, appcls, ver, logger:logging.Logger=None):
-        """
-        フィーチャーファイル（features.yml）を読み込みます。
-
-        Args:
-            ftype (str): フィーチャータイプ。cli又はweb
-            func (Any): フィーチャーの処理関数
-            appcls (Any): アプリケーションクラス
-            ver (Any): バージョンモジュール
-            logger (logging.Logger): ロガー
-        """
-        # 読込み済みかどうかの判定
-        if self.is_features_loaded(ftype):
-            return
-        # cmdboxを拡張したアプリをカスタマイズするときのfeatures.ymlを読み込む
-        features_yml = Path('features.yml')
-        if not features_yml.exists() or not features_yml.is_file():
-            # cmdboxを拡張したアプリの組み込みfeatures.ymlを読み込む
-            features_yml = Path(ver.__file__).parent / 'extensions' / 'features.yml'
-        #if not features_yml.exists() or not features_yml.is_file():
-        #    features_yml = Path('.samples/features.yml')
-        if logger is not None and logger.level == logging.DEBUG:
-            logger.debug(f"load features.yml: {features_yml}, is_file={features_yml.is_file()}")
-        if features_yml.exists() and features_yml.is_file():
-            if self.features_yml_data is None:
-                self.features_yml_data = yml = common.load_yml(features_yml)
-            else:
-                yml = self.features_yml_data
-            if yml is None: return
-            if 'features' not in yml:
-                raise Exception('features.yml is invalid. (The root element must be "features".)')
-            if ftype not in yml['features']:
-                raise Exception(f'features.yml is invalid. (There is no “{ftype}” in the “features” element.)')
-            if yml['features'][ftype] is None:
-                return
-            if type(yml['features'][ftype]) is not list:
-                raise Exception(f'features.yml is invalid. (The “features.{ftype} element must be a list. {ftype}={yml["features"][ftype]})')
-            for data in yml['features'][ftype]:
-                if type(data) is not dict:
-                    raise Exception(f'features.yml is invalid. (The “features.{ftype}” element must be a list element must be a dictionary. data={data})')
-                if 'package' not in data:
-                    raise Exception(f'features.yml is invalid. (The “package” element must be in the dictionary of the list element of the “features.{ftype}” element. data={data})')
-                if 'prefix' not in data:
-                    raise Exception(f'features.yml is invalid. (The prefix element must be in the dictionary of the list element of the “features.{ftype}” element. data={data})')
-                if data['package'] is None or data['package'] == "":
-                    continue
-                if data['prefix'] is None or data['prefix'] == "":
-                    continue
-                exclude_modules = []
-                if 'exclude_modules' in data:
-                    if type(data['exclude_modules']) is not list:
-                        raise Exception(f'features.yml is invalid. (The “exclude_modules” element must be a list element. data={data})')
-                    exclude_modules = data['exclude_modules']
-                func(data['package'], data['prefix'], exclude_modules, appcls, ver, logger, self.is_features_loaded(ftype))
-                self.features_loaded[ftype] = True
-
-    def load_features_args(self, args_dict:Dict[str, Any]):
-        yml = self.features_yml_data
-        if yml is None:
-            return
-        if 'args' not in yml or 'cli' not in yml['args']:
-            return
-
-        opts = self.list_options()
-        def _cast(self, key, val):
-            for opt in opts.values():
-                if f"--{key}" in opt['opts']:
-                    if opt['type'] == int:
-                        return int(val)
-                    elif opt['type'] == float:
-                        return float(val)
-                    elif opt['type'] == bool:
-                        return True
-                    else:
-                        return eval(val)
-            return None
-
-        for rule in yml['args']['cli']:
-            if type(rule) is not dict:
-                raise Exception(f'features.yml is invalid. (The “args.cli” element must be a list element must be a dictionary. rule={rule})')
-            if 'rule' not in rule:
-                raise Exception(f'features.yml is invalid. (The “rule” element must be in the dictionary of the list element of the “args.cli” element. rule={rule})')
-            if rule['rule'] is None:
-                continue
-            if 'default' not in rule and 'coercion' not in rule:
-                raise Exception(f'features.yml is invalid. (The “default” or “coercion” element must be in the dictionary of the list element of the “args.cli” element. rule={rule})')
-            if len([rk for rk in rule['rule'] if rk not in args_dict or rule['rule'][rk] != args_dict[rk]]) > 0:
-                continue
-            if 'default' in rule and rule['default'] is not None:
-                for dk, dv in rule['default'].items():
-                    if dk not in args_dict or args_dict[dk] is None:
-                        if type(dv) == list:
-                            args_dict[dk] = [_cast(self, dk, v) for v in dv]
-                        else:
-                            args_dict[dk] = _cast(self, dk, dv)
-            if 'coercion' in rule and rule['coercion'] is not None:
-                for ck, cv in rule['coercion'].items():
-                    if type(cv) == list:
-                        args_dict[ck] = [_cast(self, ck, v) for v in cv]
-                    else:
-                        args_dict[ck] = _cast(self, ck, cv)
-
-    def load_features_aliases_cli(self, logger:logging.Logger):
-        yml = self.features_yml_data
-        if yml is None: return
-        if self.aliases_loaded_cli: return
-        if 'aliases' not in yml or 'cli' not in yml['aliases']:
-            return
-
-        opt_cmd = self._options["cmd"].copy()
-        for rule in yml['aliases']['cli']:
-            if type(rule) is not dict:
-                raise Exception(f'features.yml is invalid. (The aliases.cli” element must be a list element must be a dictionary. rule={rule})')
-            if 'source' not in rule:
-                raise Exception(f'features.yml is invalid. (The source element must be in the dictionary of the list element of the aliases.cli” element. rule={rule})')
-            if 'target' not in rule:
-                raise Exception(f'features.yml is invalid. (The target element must be in the dictionary of the list element of the aliases.cli” element. rule={rule})')
-            if rule['source'] is None or rule['target'] is None:
-                if logger.level == logging.DEBUG:
-                    logger.debug(f'Skip cli rule in features.yml. (The source or target element is None. rule={rule})')
-                continue
-            if type(rule['source']) is not dict:
-                raise Exception(f'features.yml is invalid. (The aliases.cli.source” element must be a dictionary element must. rule={rule})')
-            if type(rule['target']) is not dict:
-                raise Exception(f'features.yml is invalid. (The aliases.cli.target element must be a dictionary element must. rule={rule})')
-            if 'mode' not in rule['source'] or 'cmd' not in rule['source']:
-                raise Exception(f'features.yml is invalid. (The aliases.cli.source element must have "mode" and "cmd" specified. rule={rule})')
-            if 'mode' not in rule['target'] or 'cmd' not in rule['target']:
-                raise Exception(f'features.yml is invalid. (The aliases.cli.target element must have "mode" and "cmd" specified. rule={rule})')
-            if rule['source']['mode'] is None or rule['source']['cmd'] is None:
-                if logger.level == logging.DEBUG:
-                    logger.debug(f'Skip cli rule in features.yml. (The source mode or cmd element is None. rule={rule})')
-                continue
-            if rule['target']['mode'] is None or rule['target']['cmd'] is None:
-                if logger.level == logging.DEBUG:
-                    logger.debug(f'Skip cli rule in features.yml. (The target mode or cmd element is None. rule={rule})')
-                continue
-            tgt_move = True if 'move' in rule['target'] and rule['target']['move'] else False
-            reg_src_cmd = re.compile(rule['source']['cmd'])
-            for mk, mv in opt_cmd.items():
-                if type(mv) is not dict: continue
-                if mk != rule['source']['mode']: continue
-                src_mode = mk
-                tgt_mode = rule['target']['mode']
-                self._options["cmd"][tgt_mode] = dict() if tgt_mode not in self._options["cmd"] else self._options["cmd"][tgt_mode]
-                self._options["mode"][tgt_mode] = dict() if tgt_mode not in self._options["mode"] else self._options["mode"][tgt_mode]
-                find = False
-                for ck, cv in mv.copy().items():
-                    if type(cv) is not dict: continue
-                    ck_match:re.Match = reg_src_cmd.search(ck)
-                    if ck_match is None: continue
-                    find = True
-                    src_cmd = ck
-                    tgt_cmd = rule['target']['cmd'].format(*([ck_match.string]+list(ck_match.groups())))
-                    cv = cv.copy()
-                    cv['opt'] = tgt_cmd
-                    # cmd/[target mode]/[target cmd]に追加
-                    self._options["cmd"][tgt_mode][tgt_cmd] = cv
-                    # mode/[target mode]/[target cmd]に追加
-                    self._options["mode"][tgt_mode][tgt_cmd] = cv
-                    # mode/choiceにtarget modeがない場合は追加
-                    found_mode_choice = False
-                    for i, me in enumerate(self._options["mode"]["choice"]):
-                        if me['opt'] == tgt_mode:
-                            me[tgt_cmd] = cv.copy()
-                            found_mode_choice = True
-                        # 移動の場合は元を削除
-                        if tgt_move and me['opt'] == src_mode and src_cmd in me:
-                            del me[src_cmd]
-                    if not found_mode_choice:
-                        self._options["mode"]["choice"].append({'opt':tgt_mode, tgt_cmd:cv})
-                    # cmd/choiceにtarget cmdがない場合は追加
-                    found_cmd_choice = False
-                    for i, ce in enumerate(self._options["cmd"]["choice"]):
-                        if ce['opt'] == tgt_cmd:
-                            self._options["cmd"]["choice"][i] = cv
-                            found_cmd_choice = True
-                        # 移動の場合は元を削除(この処理をするとモード違いの同名コマンドが使えなくなるのでコメントアウト)
-                        #if tgt_move and ce['opt'] == src_cmd:
-                        #    self._options["cmd"]["choice"].remove(ce)
-                    if not found_cmd_choice:
-                        self._options["cmd"]["choice"].append(cv)
-                    # 移動の場合は元を削除
-                    if tgt_move:
-                        if logger.level == logging.DEBUG:
-                            logger.debug(f'move command: src=({src_mode},{src_cmd}) -> tgt=({tgt_mode},{tgt_cmd})')
-                        if src_cmd in self._options["cmd"][src_mode]:
-                            del self._options["cmd"][src_mode][src_cmd]
-                    else:
-                        if logger.level == logging.DEBUG:
-                            logger.debug(f'copy command: src=({src_mode},{src_cmd}) -> tgt=({tgt_mode},{tgt_cmd})')
-                if not find:
-                    logger.warning(f'Skip cli rule in features.yml. (Command matching the rule not found. rule={rule})')
-                if len(self._options["cmd"][src_mode]) == 1:
-                    del self._options["cmd"][src_mode]
-                if len(self._options["mode"][src_mode]) == 1:
-                    del self._options["mode"][src_mode]
-        self.aliases_loaded_cli = True
-
-    def load_features_aliases_web(self, routes:List[Route], logger:logging.Logger):
-        yml = self.features_yml_data
-        if yml is None: return
-        if self.aliases_loaded_web: return
-        if routes is None or type(routes) is not list or len(routes) == 0:
-            raise Exception(f'routes is invalid. (The routes must be a list element.) routes={routes}')
-        if 'aliases' not in yml or 'web' not in yml['aliases']:
-            return
-
-        for rule in yml['aliases']['web']:
-            if type(rule) is not dict:
-                raise Exception(f'features.yml is invalid. (The aliases.web element must be a list element must be a dictionary. rule={rule})')
-            if 'source' not in rule:
-                raise Exception(f'features.yml is invalid. (The source element must be in the dictionary of the list element of the aliases.web element. rule={rule})')
-            if 'target' not in rule:
-                raise Exception(f'features.yml is invalid. (The target element must be in the dictionary of the list element of the aliases.web element. rule={rule})')
-            if rule['source'] is None or rule['target'] is None:
-                if logger.level == logging.DEBUG:
-                    logger.debug(f'Skip web rule in features.yml. (The source or target element is None. rule={rule})')
-                continue
-            if type(rule['source']) is not dict:
-                raise Exception(f'features.yml is invalid. (The aliases.web.source” element must be a dictionary element must. rule={rule})')
-            if type(rule['target']) is not dict:
-                raise Exception(f'features.yml is invalid. (The aliases.web.target element must be a dictionary element must. rule={rule})')
-            if 'path' not in rule['source']:
-                raise Exception(f'features.yml is invalid. (The aliases.web.source element must have "path" specified. rule={rule})')
-            if 'path' not in rule['target']:
-                raise Exception(f'features.yml is invalid. (The aliases.web.target element must have "path" specified. rule={rule})')
-            if rule['source']['path'] is None:
-                if logger.level == logging.DEBUG:
-                    logger.debug(f'Skip web rule in features.yml. (The source path element is None. rule={rule})')
-                continue
-            if rule['target']['path'] is None:
-                if logger.level == logging.DEBUG:
-                    logger.debug(f'Skip web rule in features.yml. (The target path element is None. rule={rule})')
-                continue
-            tgt_move = True if 'move' in rule['target'] and rule['target']['move'] else False
-            reg_src_path = re.compile(rule['source']['path'])
-            find = False
-            for route in routes.copy():
-                if not isinstance(route, APIRoute):
-                    continue
-                route_path = route.path
-                path_match:re.Match = reg_src_path.search(route_path)
-                if path_match is None: continue
-                find = True
-                tgt_Path = rule['target']['path'].format(*([path_match.string]+list(path_match.groups())))
-                tgt_route = APIRoute(tgt_Path, route.endpoint, methods=route.methods, name=route.name,
-                                  include_in_schema=route.include_in_schema)
-                routes.append(tgt_route)
-                if tgt_move:
-                    if logger.level == logging.DEBUG:
-                        logger.debug(f'move route: src=({route_path}) -> tgt=({tgt_Path})')
-                    routes.remove(route)
-                else:
-                    if logger.level == logging.DEBUG:
-                        logger.debug(f'copy route: src=({route_path}) -> tgt=({tgt_Path})')
-            if not find:
-                logger.warning(f'Skip web rule in features.yml. (Command matching the rule not found. rule={rule})')
-        self.aliases_loaded_web = True
+from cmdbox.app import common, feature, web
+from cmdbox.app.commons import module
+from fastapi import Request
+from fastapi.routing import APIRoute
+from datetime import datetime
+from pathlib import Path
+from starlette.routing import Route
+from typing import List, Dict, Any 
+import argparse
+import functools
+import locale
+import logging
+import re
+import time
+import uuid
+
+
+class Options:
+    T_INT = 'int'
+    T_FLOAT = 'float'
+    T_BOOL = 'bool'
+    T_STR = 'str'
+    T_DATE = 'date'
+    T_DATETIME = 'datetime'
+    T_DICT = 'dict'
+    T_TEXT = 'text'
+    T_FILE = 'file'
+    T_DIR = 'dir'
+    
+    def __setattr__(self, name:str, value):
+        if name.startswith("T_") and name in self.__dict__:
+            raise ValueError(f'Cannot set attribute. ({name})')
+        self.__dict__[name] = value
+
+    _instance = None
+
+    @staticmethod
+    def getInstance(appcls=None, ver=None):
+        if Options._instance is None:
+            Options._instance = Options(appcls=appcls, ver=ver)
+        return Options._instance
+
+    def __init__(self, appcls=None, ver=None):
+        self.appcls = appcls
+        self.ver = ver
+        self.default_logger = common.default_logger(False, ver=self.ver, webcall=True)
+        self.features_yml_data = None
+        self.features_loaded = dict()
+        self.aliases_loaded_cli = False
+        self.aliases_loaded_web = False
+        self.audit_loaded = False
+        self.init_options()
+
+    def get_mode_keys(self) -> List[str]:
+        return [key for key,val in self._options["mode"].items() if type(val) == dict]
+
+    def get_modes(self) -> List[Dict[str, str]]:
+        """
+        起動モードの選択肢を取得します。
+        Returns:
+            List[Dict[str, str]]: 起動モードの選択肢
+        """
+        return [''] + [{key:val} for key,val in self._options["mode"].items() if type(val) == dict]
+
+    def get_cmd_keys(self, mode:str) -> List[str]:
+        if mode not in self._options["cmd"]:
+            return []
+        return [key for key,val in self._options["cmd"][mode].items() if type(val) == dict]
+
+    def get_cmds(self, mode:str) -> List[Dict[str, str]]:
+        """
+        コマンドの選択肢を取得します。
+        Args:
+            mode: 起動モード
+        Returns:
+            List[Dict[str, str]]: コマンドの選択肢
+        """
+        if mode not in self._options["cmd"]:
+            return ['Please select mode.']
+        ret = [{key:val} for key,val in self._options["cmd"][mode].items() if type(val) == dict]
+        if len(ret) > 0:
+            return [''] + ret
+        return ['Please select mode.']
+
+    def get_cmd_attr(self, mode:str, cmd:str, attr:str) -> Any:
+        """
+        コマンドの属性を取得します。
+        Args:
+            mode: 起動モード
+            cmd: コマンド
+            attr: 属性
+        Returns:
+            Any: 属性の値
+        """
+        if mode not in self._options["cmd"]:
+            return [f'Unknown mode. ({mode})']
+        if cmd is None or cmd == "" or cmd not in self._options["cmd"][mode]:
+            return []
+        if attr not in self._options["cmd"][mode][cmd]:
+            return None
+        return self._options["cmd"][mode][cmd][attr]
+    
+    def get_svcmd_feature(self, svcmd:str) -> Any:
+        """
+        サーバー側のコマンドのフューチャーを取得します。
+
+        Args:
+            svcmd: サーバー側のコマンド
+        Returns:
+            feature.Feature: フューチャー
+        """
+        if svcmd is None or svcmd == "":
+            return None
+        if svcmd not in self._options["svcmd"]:
+            return None
+        return self._options["svcmd"][svcmd]
+
+    def get_cmd_choices(self, mode:str, cmd:str, webmode:bool=False) -> List[Dict[str, Any]]:
+        """
+        コマンドのオプション一覧を取得します。
+        Args:
+            mode: 起動モード
+            cmd: コマンド
+            webmode (bool, optional): Webモードからの呼び出し. Defaults to False
+        Returns:
+            List[Dict[str, Any]]: オプションの選択肢
+        """
+        opts = self.get_cmd_attr(mode, cmd, "choice")
+        ret = []
+        for o in opts:
+            if not webmode or type(o) is not dict:
+                ret.append(o)
+                continue
+            o = o.copy()
+            if 'web' in o and o['web'] == 'mask':
+                o['default'] = '********'
+            ret.append(o)
+        return ret
+
+    def get_cmd_opt(self, mode:str, cmd:str, opt:str, webmode:bool=False) -> Dict[str, Any]:
+        """
+        コマンドのオプションを取得します。
+        Args:
+            mode: 起動モード
+            cmd: コマンド
+            opt: オプション
+            webmode (bool, optional): Webモードからの呼び出し. Defaults to False
+        Returns:
+            Dict[str, Any]: オプションの値
+        """
+        opts = self.get_cmd_choices(mode, cmd, webmode)
+        for o in opts:
+            if 'opt' in o and o['opt'] == opt:
+                return o
+        return None
+
+    def list_options(self):
+        def _list(ret, key, val):
+            if type(val) != dict or 'type' not in val:
+                return
+            opt = dict()
+            if val['type'] == Options.T_INT:
+                opt['type'] = int
+                opt['action'] = 'append' if val['multi'] else None
+            elif val['type'] == Options.T_FLOAT:
+                opt['type'] = float
+                opt['action'] = 'append' if val['multi'] else None
+            elif val['type'] == Options.T_BOOL:
+                opt['type'] = bool
+                opt['action'] = 'store_true'
+            elif val['type'] == Options.T_DICT:
+                opt['type'] = dict
+                if not val['multi']:
+                    raise ValueError(f'list_options: The multi must be True if type is dict. key={key}, val={val}')
+                opt['action'] = 'append'
+            else:
+                opt['type'] = str
+                opt['action'] = 'append' if val['multi'] else None
+            o = [f'-{val["short"]}'] if "short" in val else []
+            o += [f'--{key}']
+            language, _ = locale.getlocale()
+            opt['help'] = val['discription_en'] if language.find('Japan') < 0 and language.find('ja_JP') < 0 else val['discription_ja']
+            opt['default'] = val['default']
+            if val['multi'] and val['default'] is not None:
+                raise ValueError(f'list_options: The default value must be None if multi is True. key={key}, val={val}')
+            opt['opts'] = o
+            if val['choice'] is not None:
+                opt['choices'] = []
+                for c in val['choice']:
+                    if type(c) == dict:
+                        opt['choices'] += [c['opt']]
+                    elif c is not None and c != "":
+                        opt['choices'] += [c]
+            else:
+                opt['choices'] = None
+            ret[key] = opt
+        ret = dict()
+        for k, v in self._options.items():
+            _list(ret, k, v)
+        #for mode in self._options["mode"]['choice']:
+        for _, cmd in self._options["cmd"].items():
+            if type(cmd) is not dict:
+                continue
+            for _, opt in cmd.items():
+                if type(opt) is not dict:
+                    continue
+                for o in opt["choice"]:
+                    if type(o) is not dict:
+                        continue
+                    _list(ret, o['opt'], o)
+        return ret
+
+    def mk_opt_list(self, opt:dict, webmode:bool=False) -> List[str]:
+        opt_schema = self.get_cmd_choices(opt['mode'], opt['cmd'], webmode)
+        opt_list = ['-m', opt['mode'], '-c', opt['cmd']]
+        file_dict = dict()
+        for key, val in opt.items():
+            if key in ['stdout_log', 'capture_stdout']:
+                continue
+            schema = [schema for schema in opt_schema if type(schema) is dict and schema['opt'] == key]
+            if len(schema) == 0 or val == '':
+                continue
+            if schema[0]['type'] == Options.T_BOOL:
+                if val:
+                    opt_list.append(f"--{key}")
+                continue
+            if type(val) == list:
+                for v in val:
+                    if v is None or v == '':
+                        continue
+                    opt_list.append(f"--{key}")
+                    if str(v).find(' ') >= 0:
+                        opt_list.append(f'"{v}"')
+                    else:
+                        opt_list.append(str(v))
+            elif type(val) == dict:
+                for k,v in val.items():
+                    if k is None or k == '' or v is None or v == '':
+                        continue
+                    opt_list.append(f"--{key}")
+                    k = f'"{k}"' if str(k).find(' ') >= 0 else str(k)
+                    v = f'"{v}"' if str(v).find(' ') >= 0 else str(v)
+                    opt_list.append(f'{k}={v}')
+            elif val is not None and val != '':
+                opt_list.append(f"--{key}")
+                if str(val).find(' ') >= 0:
+                    opt_list.append(f'"{val}"')
+                else:
+                    opt_list.append(str(val))
+            if 'fileio' in schema[0] and schema[0]['fileio'] == 'in' and type(val) != str:
+                file_dict[key] = val
+        return opt_list, file_dict
+
+    def init_options(self):
+        self._options = dict()
+        self._options["version"] = dict(
+            short="v", type=Options.T_BOOL, default=None, required=False, multi=False, hide=True, choice=None,
+            discription_ja="バージョン表示",
+            discription_en="Display version")
+        self._options["useopt"] = dict(
+            short="u", type=Options.T_STR, default=None, required=False, multi=False, hide=True, choice=None,
+            discription_ja="オプションを保存しているファイルを使用します。",
+            discription_en="Use the file that saves the options.")
+        self._options["saveopt"] = dict(
+            short="s", type=Options.T_BOOL, default=None, required=False, multi=False, hide=True, choice=[True, False],
+            discription_ja="指定しているオプションを `-u` で指定したファイルに保存します。",
+            discription_en="Save the specified options to the file specified by `-u`.")
+        self._options["debug"] = dict(
+            short="d", type=Options.T_BOOL, default=False, required=False, multi=False, hide=True, choice=[True, False],
+            discription_ja="デバックモードで起動します。",
+            discription_en="Starts in debug mode.")
+        self._options["format"] = dict(
+            short="f", type=Options.T_BOOL, default=None, required=False, multi=False, hide=True,
+            discription_ja="処理結果を見やすい形式で出力します。指定しない場合json形式で出力します。",
+            discription_en="Output the processing result in an easy-to-read format. If not specified, output in json format.",
+            choice=None)
+        self._options["mode"] = dict(
+            short="m", type=Options.T_STR, default=None, required=True, multi=False, hide=True,
+            discription_ja="起動モードを指定します。",
+            discription_en="Specify the startup mode.",
+            choice=[])
+        self._options["cmd"] = dict(
+            short="c", type=Options.T_STR, default=None, required=True, multi=False, hide=True,
+            discription_ja="コマンドを指定します。",
+            discription_en="Specify the command.",
+            choice=[])
+        self._options["tag"] = dict(
+            short="t", type=Options.T_STR, default=None, required=False, multi=True, hide=True,
+            discription_ja="このコマンドのタグを指定します。",
+            discription_en="Specify the tag for this command.",
+            choice=None)
+        self._options["clmsg_id"] = dict(
+            type=Options.T_STR, default=None, required=False, multi=False, hide=True,
+            discription_ja="クライアントのメッセージIDを指定します。省略した場合はuuid4で生成されます。",
+            discription_en="Specifies the message ID of the client. If omitted, uuid4 will be generated.",
+            choice=None)
+
+    def init_debugoption(self):
+        # デバックオプションを追加
+        self._options["debug"]["opt"] = "debug"
+        self._options["tag"]["opt"] = "tag"
+        self._options["clmsg_id"]["opt"] = "clmsg_id"
+        for key, mode in self._options["cmd"].items():
+            if type(mode) is not dict:
+                continue
+            mode['opt'] = key
+            for k, c in mode.items():
+                if type(c) is not dict:
+                    continue
+                c["opt"] = k
+                if "debug" not in [_o['opt'] for _o in c["choice"]]:
+                    c["choice"].append(self._options["debug"])
+                if "tag" not in [_o['opt'] for _o in c["choice"]]:
+                    c["choice"].append(self._options["tag"])
+                if "clmsg_id" not in [_o['opt'] for _o in c["choice"]]:
+                    c["choice"].append(self._options["clmsg_id"])
+                if c["opt"] not in [_o['opt'] for _o in self._options["cmd"]["choice"]]:
+                    self._options["cmd"]["choice"] += [c]
+            self._options["mode"][key] = mode
+            self._options["mode"]["choice"] += [mode]
+
+    def load_svcmd(self, package_name:str, prefix:str="cmdbox_", excludes:list=[], appcls=None, ver=None, logger:logging.Logger=None, isloaded:bool=True):
+        """
+        指定されたパッケージの指定された接頭語を持つモジュールを読み込みます。
+
+        Args:
+            package_name (str): パッケージ名
+            prefix (str): 接頭語
+            excludes (list): 除外するモジュール名のリスト
+            appcls (Any): アプリケーションクラス
+            ver (Any): バージョンモジュール
+            logger (logging.Logger): ロガー
+            isloaded (bool): 読み込み済みかどうか
+        """
+        if "svcmd" not in self._options:
+            self._options["svcmd"] = dict()
+        for mode, f in module.load_features(package_name, prefix, excludes, appcls=appcls, ver=ver).items():
+            if mode not in self._options["cmd"]:
+                self._options["cmd"][mode] = dict()
+            for cmd, opt in f.items():
+                self._options["cmd"][mode][cmd] = opt
+                fobj:feature.Feature = opt['feature']
+                if not isloaded and logger is not None and logger.level == logging.DEBUG:
+                    logger.debug(f"loaded features: mode={mode}, cmd={cmd}, {fobj}")
+                svcmd = fobj.get_svcmd()
+                if svcmd is not None:
+                    self._options["svcmd"][svcmd] = fobj
+        self.init_debugoption()
+    
+    def is_features_loaded(self, ftype:str) -> bool:
+        """
+        指定されたフィーチャータイプが読み込まれているかどうかを返します。
+
+        Args:
+            ftype (str): フィーチャータイプ
+        Returns:
+            bool: 読み込まれているかどうか
+        """
+        return ftype in self.features_loaded and self.features_loaded[ftype]
+
+    def load_features_file(self, ftype:str, func, appcls, ver, logger:logging.Logger=None):
+        """
+        フィーチャーファイル（features.yml）を読み込みます。
+
+        Args:
+            ftype (str): フィーチャータイプ。cli又はweb
+            func (Any): フィーチャーの処理関数
+            appcls (Any): アプリケーションクラス
+            ver (Any): バージョンモジュール
+            logger (logging.Logger): ロガー
+        """
+        # 読込み済みかどうかの判定
+        if self.is_features_loaded(ftype):
+            return
+        # cmdboxを拡張したアプリをカスタマイズするときのfeatures.ymlを読み込む
+        features_yml = Path(f'.{ver.__appid__}/features.yml')
+        if not features_yml.exists() or not features_yml.is_file():
+            # cmdboxを拡張したアプリの組み込みfeatures.ymlを読み込む
+            features_yml = Path(ver.__file__).parent / 'extensions' / 'features.yml'
+        #if not features_yml.exists() or not features_yml.is_file():
+        #    features_yml = Path('.samples/features.yml')
+        logger.info(f"load features.yml: {features_yml}, is_file={features_yml.is_file()}")
+        if features_yml.exists() and features_yml.is_file():
+            if self.features_yml_data is None:
+                self.features_yml_data = yml = common.load_yml(features_yml)
+                if logger.level == logging.DEBUG:
+                    logger.debug(f"features.yml data: {yml}")
+            else:
+                yml = self.features_yml_data
+            if yml is None: return
+            if 'features' not in yml:
+                raise Exception('features.yml is invalid. (The root element must be "features".)')
+            if ftype not in yml['features']:
+                raise Exception(f'features.yml is invalid. (There is no “{ftype}” in the “features” element.)')
+            if yml['features'][ftype] is None:
+                return
+            if type(yml['features'][ftype]) is not list:
+                raise Exception(f'features.yml is invalid. (The “features.{ftype} element must be a list. {ftype}={yml["features"][ftype]})')
+            for data in yml['features'][ftype]:
+                if type(data) is not dict:
+                    raise Exception(f'features.yml is invalid. (The “features.{ftype}” element must be a list element must be a dictionary. data={data})')
+                if 'package' not in data:
+                    raise Exception(f'features.yml is invalid. (The “package” element must be in the dictionary of the list element of the “features.{ftype}” element. data={data})')
+                if 'prefix' not in data:
+                    raise Exception(f'features.yml is invalid. (The prefix element must be in the dictionary of the list element of the “features.{ftype}” element. data={data})')
+                if data['package'] is None or data['package'] == "":
+                    continue
+                if data['prefix'] is None or data['prefix'] == "":
+                    continue
+                exclude_modules = []
+                if 'exclude_modules' in data:
+                    if type(data['exclude_modules']) is not list:
+                        raise Exception(f'features.yml is invalid. (The “exclude_modules” element must be a list element. data={data})')
+                    exclude_modules = data['exclude_modules']
+                func(data['package'], data['prefix'], exclude_modules, appcls, ver, logger, self.is_features_loaded(ftype))
+                self.features_loaded[ftype] = True
+
+    def load_features_args(self, args_dict:Dict[str, Any]):
+        yml = self.features_yml_data
+        if yml is None:
+            return
+        if 'args' not in yml or 'cli' not in yml['args']:
+            return
+
+        opts = self.list_options()
+        def _cast(self, key, val):
+            for opt in opts.values():
+                if f"--{key}" in opt['opts']:
+                    if opt['type'] == int:
+                        return int(val)
+                    elif opt['type'] == float:
+                        return float(val)
+                    elif opt['type'] == bool:
+                        return True
+                    else:
+                        return eval(val)
+            return None
+
+        for rule in yml['args']['cli']:
+            if type(rule) is not dict:
+                raise Exception(f'features.yml is invalid. (The “args.cli” element must be a list element must be a dictionary. rule={rule})')
+            if 'rule' not in rule:
+                raise Exception(f'features.yml is invalid. (The “rule” element must be in the dictionary of the list element of the “args.cli” element. rule={rule})')
+            if rule['rule'] is None:
+                continue
+            if 'default' not in rule and 'coercion' not in rule:
+                raise Exception(f'features.yml is invalid. (The “default” or “coercion” element must be in the dictionary of the list element of the “args.cli” element. rule={rule})')
+            if len([rk for rk in rule['rule'] if rk not in args_dict or rule['rule'][rk] != args_dict[rk]]) > 0:
+                continue
+            if 'default' in rule and rule['default'] is not None:
+                for dk, dv in rule['default'].items():
+                    if dk not in args_dict or args_dict[dk] is None:
+                        if type(dv) == list:
+                            args_dict[dk] = [_cast(self, dk, v) for v in dv]
+                        else:
+                            args_dict[dk] = _cast(self, dk, dv)
+            if 'coercion' in rule and rule['coercion'] is not None:
+                for ck, cv in rule['coercion'].items():
+                    if type(cv) == list:
+                        args_dict[ck] = [_cast(self, ck, v) for v in cv]
+                    else:
+                        args_dict[ck] = _cast(self, ck, cv)
+
+    def load_features_aliases_cli(self, logger:logging.Logger):
+        yml = self.features_yml_data
+        if yml is None: return
+        if self.aliases_loaded_cli: return
+        if 'aliases' not in yml or 'cli' not in yml['aliases']:
+            return
+
+        opt_cmd = self._options["cmd"].copy()
+        for rule in yml['aliases']['cli']:
+            if type(rule) is not dict:
+                raise Exception(f'features.yml is invalid. (The aliases.cli” element must be a list element must be a dictionary. rule={rule})')
+            if 'source' not in rule:
+                raise Exception(f'features.yml is invalid. (The source element must be in the dictionary of the list element of the aliases.cli” element. rule={rule})')
+            if 'target' not in rule:
+                raise Exception(f'features.yml is invalid. (The target element must be in the dictionary of the list element of the aliases.cli” element. rule={rule})')
+            if rule['source'] is None or rule['target'] is None:
+                if logger.level == logging.DEBUG:
+                    logger.debug(f'Skip cli rule in features.yml. (The source or target element is None. rule={rule})')
+                continue
+            if type(rule['source']) is not dict:
+                raise Exception(f'features.yml is invalid. (The aliases.cli.source” element must be a dictionary element must. rule={rule})')
+            if type(rule['target']) is not dict:
+                raise Exception(f'features.yml is invalid. (The aliases.cli.target element must be a dictionary element must. rule={rule})')
+            if 'mode' not in rule['source'] or 'cmd' not in rule['source']:
+                raise Exception(f'features.yml is invalid. (The aliases.cli.source element must have "mode" and "cmd" specified. rule={rule})')
+            if 'mode' not in rule['target'] or 'cmd' not in rule['target']:
+                raise Exception(f'features.yml is invalid. (The aliases.cli.target element must have "mode" and "cmd" specified. rule={rule})')
+            if rule['source']['mode'] is None or rule['source']['cmd'] is None:
+                if logger.level == logging.DEBUG:
+                    logger.debug(f'Skip cli rule in features.yml. (The source mode or cmd element is None. rule={rule})')
+                continue
+            if rule['target']['mode'] is None or rule['target']['cmd'] is None:
+                if logger.level == logging.DEBUG:
+                    logger.debug(f'Skip cli rule in features.yml. (The target mode or cmd element is None. rule={rule})')
+                continue
+            tgt_move = True if 'move' in rule['target'] and rule['target']['move'] else False
+            reg_src_cmd = re.compile(rule['source']['cmd'])
+            for mk, mv in opt_cmd.items():
+                if type(mv) is not dict: continue
+                if mk != rule['source']['mode']: continue
+                src_mode = mk
+                tgt_mode = rule['target']['mode']
+                self._options["cmd"][tgt_mode] = dict() if tgt_mode not in self._options["cmd"] else self._options["cmd"][tgt_mode]
+                self._options["mode"][tgt_mode] = dict() if tgt_mode not in self._options["mode"] else self._options["mode"][tgt_mode]
+                find = False
+                for ck, cv in mv.copy().items():
+                    if type(cv) is not dict: continue
+                    ck_match:re.Match = reg_src_cmd.search(ck)
+                    if ck_match is None: continue
+                    find = True
+                    src_cmd = ck
+                    tgt_cmd = rule['target']['cmd'].format(*([ck_match.string]+list(ck_match.groups())))
+                    cv = cv.copy()
+                    cv['opt'] = tgt_cmd
+                    # cmd/[target mode]/[target cmd]に追加
+                    self._options["cmd"][tgt_mode][tgt_cmd] = cv
+                    # mode/[target mode]/[target cmd]に追加
+                    self._options["mode"][tgt_mode][tgt_cmd] = cv
+                    # mode/choiceにtarget modeがない場合は追加
+                    found_mode_choice = False
+                    for i, me in enumerate(self._options["mode"]["choice"]):
+                        if me['opt'] == tgt_mode:
+                            me[tgt_cmd] = cv.copy()
+                            found_mode_choice = True
+                        # 移動の場合は元を削除
+                        if tgt_move and me['opt'] == src_mode and src_cmd in me:
+                            del me[src_cmd]
+                    if not found_mode_choice:
+                        self._options["mode"]["choice"].append({'opt':tgt_mode, tgt_cmd:cv})
+                    # cmd/choiceにtarget cmdがない場合は追加
+                    found_cmd_choice = False
+                    for i, ce in enumerate(self._options["cmd"]["choice"]):
+                        if ce['opt'] == tgt_cmd:
+                            self._options["cmd"]["choice"][i] = cv
+                            found_cmd_choice = True
+                        # 移動の場合は元を削除(この処理をするとモード違いの同名コマンドが使えなくなるのでコメントアウト)
+                        #if tgt_move and ce['opt'] == src_cmd:
+                        #    self._options["cmd"]["choice"].remove(ce)
+                    if not found_cmd_choice:
+                        self._options["cmd"]["choice"].append(cv)
+                    # 移動の場合は元を削除
+                    if tgt_move:
+                        if logger.level == logging.DEBUG:
+                            logger.debug(f'move command: src=({src_mode},{src_cmd}) -> tgt=({tgt_mode},{tgt_cmd})')
+                        if src_cmd in self._options["cmd"][src_mode]:
+                            del self._options["cmd"][src_mode][src_cmd]
+                    else:
+                        if logger.level == logging.DEBUG:
+                            logger.debug(f'copy command: src=({src_mode},{src_cmd}) -> tgt=({tgt_mode},{tgt_cmd})')
+                if not find:
+                    logger.warning(f'Skip cli rule in features.yml. (Command matching the rule not found. rule={rule})')
+                if len(self._options["cmd"][src_mode]) == 1:
+                    del self._options["cmd"][src_mode]
+                if len(self._options["mode"][src_mode]) == 1:
+                    del self._options["mode"][src_mode]
+        self.aliases_loaded_cli = True
+
+    def load_features_aliases_web(self, routes:List[Route], logger:logging.Logger):
+        yml = self.features_yml_data
+        if yml is None: return
+        if self.aliases_loaded_web: return
+        if routes is None or type(routes) is not list or len(routes) == 0:
+            raise Exception(f'routes is invalid. (The routes must be a list element.) routes={routes}')
+        if 'aliases' not in yml or 'web' not in yml['aliases']:
+            return
+
+        for rule in yml['aliases']['web']:
+            if type(rule) is not dict:
+                raise Exception(f'features.yml is invalid. (The aliases.web element must be a list element must be a dictionary. rule={rule})')
+            if 'source' not in rule:
+                raise Exception(f'features.yml is invalid. (The source element must be in the dictionary of the list element of the aliases.web element. rule={rule})')
+            if 'target' not in rule:
+                raise Exception(f'features.yml is invalid. (The target element must be in the dictionary of the list element of the aliases.web element. rule={rule})')
+            if rule['source'] is None or rule['target'] is None:
+                if logger.level == logging.DEBUG:
+                    logger.debug(f'Skip web rule in features.yml. (The source or target element is None. rule={rule})')
+                continue
+            if type(rule['source']) is not dict:
+                raise Exception(f'features.yml is invalid. (The aliases.web.source” element must be a dictionary element must. rule={rule})')
+            if type(rule['target']) is not dict:
+                raise Exception(f'features.yml is invalid. (The aliases.web.target element must be a dictionary element must. rule={rule})')
+            if 'path' not in rule['source']:
+                raise Exception(f'features.yml is invalid. (The aliases.web.source element must have "path" specified. rule={rule})')
+            if 'path' not in rule['target']:
+                raise Exception(f'features.yml is invalid. (The aliases.web.target element must have "path" specified. rule={rule})')
+            if rule['source']['path'] is None:
+                if logger.level == logging.DEBUG:
+                    logger.debug(f'Skip web rule in features.yml. (The source path element is None. rule={rule})')
+                continue
+            if rule['target']['path'] is None:
+                if logger.level == logging.DEBUG:
+                    logger.debug(f'Skip web rule in features.yml. (The target path element is None. rule={rule})')
+                continue
+            tgt_move = True if 'move' in rule['target'] and rule['target']['move'] else False
+            reg_src_path = re.compile(rule['source']['path'])
+            find = False
+            for route in routes.copy():
+                if not isinstance(route, APIRoute):
+                    continue
+                route_path = route.path
+                path_match:re.Match = reg_src_path.search(route_path)
+                if path_match is None: continue
+                find = True
+                tgt_Path = rule['target']['path'].format(*([path_match.string]+list(path_match.groups())))
+                tgt_route = APIRoute(tgt_Path, route.endpoint, methods=route.methods, name=route.name,
+                                  include_in_schema=route.include_in_schema)
+                routes.append(tgt_route)
+                if tgt_move:
+                    if logger.level == logging.DEBUG:
+                        logger.debug(f'move route: src=({route_path}) -> tgt=({tgt_Path})')
+                    routes.remove(route)
+                else:
+                    if logger.level == logging.DEBUG:
+                        logger.debug(f'copy route: src=({route_path}) -> tgt=({tgt_Path})')
+            if not find:
+                logger.warning(f'Skip web rule in features.yml. (Command matching the rule not found. rule={rule})')
+        self.aliases_loaded_web = True
+
+    def load_features_audit(self, logger:logging.Logger):
+        yml = self.features_yml_data
+        if yml is None: return
+        if self.audit_loaded: return
+        if 'audit' not in yml: return
+        if 'enabled' not in yml['audit']:
+            raise Exception('features.yml is invalid. (The audit element must have "enabled" specified.)')
+        if not yml['audit']['enabled']: return
+        # writeフューチャー
+        if 'write' not in yml['audit']:
+            raise Exception('features.yml is invalid. (The audit element must have "write" specified.)')
+        if 'mode' not in yml['audit']['write']:
+            raise Exception('features.yml is invalid. (The audit.write element must have "mode" specified.)')
+        mode = yml['audit']['write']['mode']
+        if 'cmd' not in yml['audit']['write']:
+            raise Exception('features.yml is invalid. (The audit.write element must have "cmd" specified.)')
+        cmd = yml['audit']['write']['cmd']
+        self.audit_write:feature.Feature = self.get_cmd_attr(mode, cmd, 'feature')
+        # searchフューチャー
+        if 'search' not in yml['audit']:
+            raise Exception('features.yml is invalid. (The audit element must have "search" specified.)')
+        if 'mode' not in yml['audit']['search']:
+            raise Exception('features.yml is invalid. (The audit.search element must have "mode" specified.)')
+        mode = yml['audit']['search']['mode']
+        if 'cmd' not in yml['audit']['search']:
+            raise Exception('features.yml is invalid. (The audit.search element must have "cmd" specified.)')
+        cmd = yml['audit']['search']['cmd']
+        self.audit_search:feature.Feature = self.get_cmd_attr(mode, cmd, 'feature')
+        # フューチャーのoptions
+        if 'options' not in yml['audit']:
+            raise Exception('features.yml is invalid. (The audit element must have "options" specified.)')
+        self.audit_write_args = yml['audit']['options'].copy()
+        self.audit_write_args['mode'] = mode
+        self.audit_write_args['cmd'] = cmd
+        self.audit_search_args = yml['audit']['options'].copy()
+        self.audit_search_args['mode'] = mode
+        self.audit_search_args['cmd'] = cmd
+        self.audit_loaded = True
+
+    AT_USER = 'user'
+    AT_ADMIN = 'admin'
+    AT_SYSTEM = 'system'
+    AT_AUTH = 'auth'
+    AT_EVENT = 'event'
+    AUDITS = [AT_USER, AT_ADMIN, AT_SYSTEM, AT_AUTH, AT_EVENT]
+
+    @staticmethod
+    def audit(body:Dict[str, Any]=None, audit_type:str=None, tags:List[str]=None, src:str=None) -> int:
+        """
+        監査ログを書き込む関数を返します。
+        デコレーターとして使用することができます。
+
+        Args:
+            body (Dict[str, Any]): 監査ログの内容
+            audit_type (str): 監査の種類
+            tags (List[str]): メッセージのタグ
+            src (str): メッセージの発生源
+
+        Returns:
+            int: レスポンスコード
+        """
+        self = Options.getInstance()
+        if body is None:
+            body = dict()
+        if body is not None and type(body) is not dict:
+            raise Exception('body is invalid. (The body must be a dictionary element.)')
+        if audit_type is not None and audit_type not in Options.AUDITS:
+            raise Exception(f'audit_type is invalid. (The audit_type must be one of the following: {Options.AUDITS})')
+        tags = tags if tags is not None else []
+        if tags is not None and type(tags) is not list:
+            raise Exception('clmsg_tags is invalid. (The clmsg_tags must be a list element.)')
+        def _audit_write(func):
+            @functools.wraps(func)
+            def _wrapper(*args, **kwargs):
+                self.audit_exec(*args, body=body, audit_type=audit_type, tags=tags, src=src, **kwargs)
+                ret = func(*args, **kwargs)
+                return ret
+            return _wrapper
+        return _audit_write
+
+    def audit_exec(self, *args, body:Dict[str, Any]=None, audit_type:str=None, tags:List[str]=None, src:str=None, title:str=None, user:str=None, **kwargs) -> None:
+        """
+        監査ログを書き込みます。
+
+        Args:
+            args (Any): 呼び出し元で使用している引数
+            body (Dict[str, Any]): 監査ログの内容
+            audit_type (str): 監査の種類
+            tags (List[str]): メッセージのタグ
+            src (str): メッセージの発生源
+            title (str): メッセージのタイトル
+            user (str): メッセージを発生させたユーザー名
+            kwargs (Any): 呼び出し元で使用しているキーワード引数
+        """
+        if not hasattr(self, 'audit_write') or self.audit_write is None:
+            raise Exception('audit write feature is not found.')
+        clmsg_date = datetime.now().strftime('%Y-%m-%d %H:%M:%S') + common.get_tzoffset_str()
+        opt = self.audit_write_args.copy()
+        opt['audit_type'] = audit_type
+        opt['clmsg_id'] = str(uuid.uuid4())
+        opt['clmsg_date'] = clmsg_date
+        opt['clmsg_src'] = opt['clmsg_src'] if 'clmsg_src' in opt else None
+        opt['clmsg_title'] = opt['clmsg_title'] if 'clmsg_title' in opt else None
+        opt['clmsg_user'] = user
+        opt['clmsg_tag'] = tags
+        opt['format'] = False if opt.get('format') is None else opt['format']
+        opt['output_json'] = None if opt.get('output_json') is None else opt['output_json']
+        opt['output_json_append'] = False if opt.get('output_json_append') is None else opt['output_json_append']
+        opt['host'] = 'localhost' if opt.get('host') is None else opt['host']
+        opt['port'] = 6379 if opt.get('port') is None else opt['port']
+        opt['password'] = 'password' if opt.get('password') is None else opt['password']
+        opt['svname'] = 'server' if opt.get('svname') is None else opt['svname']
+        opt['retry_count'] = 1 if opt.get('retry_count') is None else opt['retry_count']
+        opt['retry_interval'] = 1 if opt.get('retry_interval') is None else opt['retry_interval']
+        opt['timeout'] = 5 if opt.get('timeout') is None else opt['timeout']
+        opt['pg_enabled'] = False if opt.get('pg_enabled') is None else opt['pg_enabled']
+        opt['pg_host'] = 'localhost' if opt.get('pg_host') is None else opt['pg_host']
+        opt['pg_port'] = 5432 if opt.get('pg_port') is None else opt['pg_port']
+        opt['pg_user'] = 'postgres' if opt.get('pg_user') is None else opt['pg_user']
+        opt['pg_password'] = 'postgres' if opt.get('pg_password') is None else opt['pg_password']
+        opt['pg_dbname'] = 'audit' if opt.get('pg_dbname') is None else opt['pg_dbname']
+        logger = self.default_logger
+        clmsg_body = body.copy() if body is not None else dict()
+        func_feature = None
+        for arg in list(args) + list(kwargs.values()):
+            if isinstance(arg, logging.Logger): logger = arg
+            elif isinstance(arg, argparse.Namespace):
+                mode = arg.mode if hasattr(arg, 'mode') else None
+                cmd = arg.cmd if hasattr(arg, 'cmd') else None
+                if mode is not None and cmd is not None:
+                    opt_schema = self.get_cmd_choices(mode, cmd, True)
+                    for key, val in arg.__dict__.items():
+                        if key in ['stdout_log', 'capture_stdout']:
+                            continue
+                        schema = [schema for schema in opt_schema if type(schema) is dict and schema['opt'] == key]
+                        if len(schema) == 0 or val == '' or val is None:
+                            continue
+                        if 'web' in schema[0] and schema[0]['web'] == 'mask':
+                            clmsg_body[key] = '********'
+                        else:
+                            clmsg_body[key] = common.to_str(val, 100)
+                        opt[key] = val
+                if hasattr(arg, 'clmsg_id'): opt['clmsg_id'] = arg.clmsg_id
+            elif isinstance(arg, web.Web):
+                opt['host'] = arg.redis_host
+                opt['port'] = arg.redis_port
+                opt['password'] = arg.redis_password
+                opt['svname'] = arg.svname
+            elif isinstance(arg, feature.Feature):
+                func_feature = arg
+                opt['clmsg_src'] = func_feature.__class__.__name__
+            elif isinstance(arg, Request):
+                if 'signin' in arg.session and arg.session['signin'] is not None and 'name' in arg.session['signin']:
+                    opt['clmsg_user'] = arg.session['signin']['name']
+                    if opt['audit_type'] is None:
+                        opt['audit_type'] = Options.AT_ADMIN if 'admin' in arg.session['signin']['groups'] else Options.AT_USER
+                    opt['clmsg_id'] = arg.session['signin']['clmsg_id'] if 'clmsg_id' in arg.session['signin'] else opt['clmsg_id']
+                    arg.session['signin']['clmsg_id'] = opt['clmsg_id']
+                opt['clmsg_src'] = arg.url.path
+        opt['clmsg_body'] = clmsg_body
+        opt['audit_type'] = opt['audit_type'] if opt['audit_type'] else Options.AT_EVENT
+        if src is not None and src != "":
+            opt['clmsg_src'] = src
+        if title is not None and title != "":
+            opt['clmsg_title'] = title
+        audit_write_args = argparse.Namespace(**{k:common.chopdq(v) for k,v in opt.items()})
+        self.audit_write.apprun(logger, audit_write_args, tm=0.0, pf=[])