QuLab 2.4.14__cp311-cp311-macosx_10_9_universal2.whl → 2.4.16__cp311-cp311-macosx_10_9_universal2.whl

{QuLab-2.4.14.dist-info → QuLab-2.4.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: QuLab
-Version: 2.4.14
+Version: 2.4.16
 Summary: contral instruments and manage data
 Author-email: feihoo87 <feihoo87@gmail.com>
 Maintainer-email: feihoo87 <feihoo87@gmail.com>

{QuLab-2.4.14.dist-info → QuLab-2.4.16.dist-info}/RECORD

@@ -1,11 +1,13 @@
 qulab/__init__.py,sha256=P-Mx2p4TVmL91SoxoeXcj8Qm0x4xUf5Q_FLk0Yc_gIQ,138
-qulab/__main__.py,sha256=ThCRooT22_qpwFtbAvVOyHzpBCuGlfDVkXBXvApzgps,597
+qulab/__main__.py,sha256=JgErYkiskih8Y6oRwowALtR-rwQhAAdqOYWjQraRIPI,59
 qulab/dicttree.py,sha256=tRRMpGZYVOLw0TEByE3_2Ss8FdOmzuGL9e1DWbs8qoY,13684
-qulab/fun.cpython-311-darwin.so,sha256=Zan2hz21EKAeISkNUXH5DEHkVv9u-1qrYE-utWNCj9Q,126848
-qulab/version.py,sha256=IPQCIOITfbX8l3dhIiuTYy89V7yOtf70dflfUCn6Dgk,22
+qulab/fun.cpython-311-darwin.so,sha256=4UizSKt5rDt7vdZVD0pkpw5COMzc0CVh4OpeSim3jFU,126848
+qulab/version.py,sha256=rVOnxEJVvl0ZWvCblBzVBGcp0VALbV_koS5W-UB9zfk,22
+qulab/cli/__init__.py,sha256=tgDIkkeIoasQXAifJZ6NU8jDgpNgb2a-B0C4nF0evrE,559
+qulab/cli/config.py,sha256=QksTYD3-RBYBG8xnKLAh7EXrNOwxr128XXr30ZTFW6A,2983
 qulab/executor/__init__.py,sha256=LosPzOMaljSZY1thy_Fxtbrgq7uubJszMABEB7oM7tU,101
-qulab/executor/__main__.py,sha256=qgZcdmx1wBZInHf6ionpuuZytIJnaDje9WRv-a8o2OM,5870
-qulab/executor/load.py,sha256=WNpJmHAxXaQKPkmycsqbqeuAuiudNi-4GscmBKfdKlw,9713
+qulab/executor/cli.py,sha256=LRSb5-J8Tn7dj-fxwCp3OP_6YUgPRoY-f8O18sbWG8I,5164
+qulab/executor/load.py,sha256=yTLoWOtTvmCTuYFZ6qFsjBM_CvsrKgmUkBSHHz3223A,10899
 qulab/executor/schedule.py,sha256=SfMZys8WdmIvfW5fPM42g-F6XwewTdpC0-puhf5TA54,11721
 qulab/executor/storage.py,sha256=M66Q5_Uc5MMfc_QAuuaaexwAz7wxBPMkeleB5nRpQmI,4621
 qulab/executor/transform.py,sha256=inaOn6eqCs22ZZ0xAQl8s8YCoEACaXSwFNNu7jqdwAk,2148
@@ -89,9 +91,9 @@ qulab/visualization/plot_seq.py,sha256=UWTS6p9nfX_7B8ehcYo6UnSTUCjkBsNU9jiOeW2ca
 qulab/visualization/qdat.py,sha256=ZeevBYWkzbww4xZnsjHhw7wRorJCBzbG0iEu-XQB4EA,5735
 qulab/visualization/rot3d.py,sha256=lMrEJlRLwYe6NMBlGkKYpp_V9CTipOAuDy6QW_cQK00,734
 qulab/visualization/widgets.py,sha256=6KkiTyQ8J-ei70LbPQZAK35wjktY47w2IveOa682ftA,3180
-QuLab-2.4.14.dist-info/LICENSE,sha256=PRzIKxZtpQcH7whTG6Egvzl1A0BvnSf30tmR2X2KrpA,1065
-QuLab-2.4.14.dist-info/METADATA,sha256=TThc_IP0lzmpuuWgCsvPExFvPQ7a-to9Zscte5sjtq8,3699
-QuLab-2.4.14.dist-info/WHEEL,sha256=K10eKSN6_vzvMOgXxWbVOQNR7Orfl6gBTCpCI8bcYx4,114
-QuLab-2.4.14.dist-info/entry_points.txt,sha256=b0v1GXOwmxY-nCCsPN_rHZZvY9CtTbWqrGj8u1m8yHo,45
-QuLab-2.4.14.dist-info/top_level.txt,sha256=3T886LbAsbvjonu_TDdmgxKYUn939BVTRPxPl9r4cEg,6
-QuLab-2.4.14.dist-info/RECORD,,
+QuLab-2.4.16.dist-info/LICENSE,sha256=PRzIKxZtpQcH7whTG6Egvzl1A0BvnSf30tmR2X2KrpA,1065
+QuLab-2.4.16.dist-info/METADATA,sha256=6JcU_aAzDy5e3eGklWSR_xUELNWTZukNp65w5mch6ws,3699
+QuLab-2.4.16.dist-info/WHEEL,sha256=K10eKSN6_vzvMOgXxWbVOQNR7Orfl6gBTCpCI8bcYx4,114
+QuLab-2.4.16.dist-info/entry_points.txt,sha256=b0v1GXOwmxY-nCCsPN_rHZZvY9CtTbWqrGj8u1m8yHo,45
+QuLab-2.4.16.dist-info/top_level.txt,sha256=3T886LbAsbvjonu_TDdmgxKYUn939BVTRPxPl9r4cEg,6
+QuLab-2.4.16.dist-info/RECORD,,

qulab/__main__.py

@@ -1,32 +1,4 @@
-import click
-
-from .executor.__main__ import create, get, maintain, run, set
-from .monitor.__main__ import main as monitor
-from .scan.server import server
-from .sys.net.cli import dht
-from .visualization.__main__ import plot
-
-
-@click.group()
-def cli():
-    pass
-
-
-@cli.command()
-def hello():
-    """Print hello world."""
-    click.echo('hello, world')
-
-
-cli.add_command(monitor)
-cli.add_command(plot)
-cli.add_command(dht)
-cli.add_command(server)
-cli.add_command(maintain)
-cli.add_command(run)
-cli.add_command(create)
-cli.add_command(set)
-cli.add_command(get)
+from .cli import cli
 
 if __name__ == '__main__':
     cli()

qulab/cli/__init__.py

@@ -0,0 +1,29 @@
+import click
+
+from ..executor.cli import create, get, maintain, run, set
+from ..monitor.__main__ import main as monitor
+from ..scan.server import server
+from ..sys.net.cli import dht
+from ..visualization.__main__ import plot
+
+
+@click.group()
+def cli():
+    pass
+
+
+@cli.command()
+def hello():
+    """Print hello world."""
+    click.echo('hello, world')
+
+
+cli.add_command(monitor)
+cli.add_command(plot)
+cli.add_command(dht)
+cli.add_command(server)
+cli.add_command(maintain)
+cli.add_command(run)
+cli.add_command(create)
+cli.add_command(set)
+cli.add_command(get)

qulab/cli/config.py

@@ -0,0 +1,88 @@
+import configparser
+import functools
+import os
+import sys
+from pathlib import Path
+
+import click
+from loguru import logger
+
+CONFIG_PATH = os.path.expanduser("~/.qulab.ini")
+ENV_PREFIX = "QULAB_"
+
+
+def _get_config_value(option_name, type_cast=str, command_name=None):
+    """支持命令专属配置的优先级获取"""
+    # 构造环境变量名
+    if command_name:
+        env_var = f"{ENV_PREFIX}{command_name.upper()}_{option_name.upper()}"
+        config_section = command_name
+    else:
+        env_var = f"{ENV_PREFIX}{option_name.upper()}"
+        config_section = "common"
+
+    # 1. 检查环境变量
+    if env_value := os.getenv(env_var):
+        if type_cast is bool:
+            return env_value.lower() in ("true", "1", "yes")
+        if "path" in option_name:
+            return os.path.expanduser(env_value)
+        return type_cast(env_value)
+
+    # 2. 检查配置文件
+    config = configparser.ConfigParser()
+    # 先加载默认配置防止段不存在
+    config.read_dict({config_section: {}})
+    if Path(CONFIG_PATH).exists():
+        config.read(CONFIG_PATH)
+
+    # 从对应配置段读取
+    if config.has_section(config_section):
+        if config_value := config.get(config_section,
+                                      option_name,
+                                      fallback=None):
+            if type_cast is bool:
+                return config_value.lower() in ("true", "1", "yes")
+            if "path" in option_name:
+                return os.path.expanduser(config_value)
+            return type_cast(config_value)
+
+    return None  # 交给 Click 处理默认值
+
+
+def get_config_value(option_name, type_cast=str, command_name=None):
+    value = _get_config_value(option_name, type_cast, command_name)
+    if value is None and command_name is not None:
+        return _get_config_value(option_name, type_cast)
+    return value
+
+
+def log_options(func):
+    """通用配置装饰器（所有命令共用）"""
+
+    @click.option("--debug",
+                  is_flag=True,
+                  default=lambda: get_config_value("debug", bool) or False,
+                  help=f"Enable debug mode")
+    @click.option("--log",
+                  type=click.Path(),
+                  default=lambda: get_config_value("log"),
+                  help=f"Log file path")
+    @functools.wraps(func)
+    def wrapper(*args, log=None, debug=False, **kwargs):
+        if log is None and not debug:
+            logger.remove()
+            logger.add(sys.stderr, level='INFO')
+        elif log is None and debug:
+            logger.remove()
+            logger.add(sys.stderr, level='DEBUG')
+        elif log is not None and not debug:
+            logger.configure(handlers=[dict(sink=log, level='INFO')])
+        elif log is not None and debug:
+            logger.configure(handlers=[
+                dict(sink=log, level='DEBUG'),
+                dict(sink=sys.stderr, level='DEBUG')
+            ])
+        return func(*args, **kwargs)
+
+    return wrapper

qulab/executor/cli.py

@@ -0,0 +1,178 @@
+import functools
+import importlib
+import os
+import sys
+from pathlib import Path
+
+import click
+from loguru import logger
+
+from ..cli.config import ENV_PREFIX, get_config_value, log_options
+from .load import find_unreferenced_workflows, get_entries, load_workflow
+from .schedule import maintain as maintain_workflow
+from .schedule import run as run_workflow
+from .transform import set_config_api
+from .utils import workflow_template
+
+
+def command_option(command_name):
+    """命令专属配置装饰器工厂"""
+
+    def decorator(func):
+
+        @click.option(
+            '--code',
+            '-c',
+            default=lambda: get_config_value("code", str, command_name),
+            help='The path of the code.')
+        @click.option(
+            '--data',
+            '-d',
+            default=lambda: get_config_value("data", str, command_name),
+            help='The path of the data.')
+        @click.option(
+            '--api',
+            '-a',
+            default=lambda: get_config_value("api", str, command_name),
+            help='The modlule name of the api.')
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
+@click.command()
+@click.argument('workflow')
+@click.option('--code',
+              '-c',
+              default=lambda: get_config_value("code", str, 'create'),
+              help='The path of the code.')
+def create(workflow, code):
+    """
+    Create a new workflow file.
+    """
+    if code is None:
+        code = Path.cwd()
+
+    fname = Path(code) / f'{workflow}'
+    fname = Path(os.path.expanduser(fname))
+    if fname.exists():
+        click.echo(f'{workflow} already exists')
+        return
+
+    fname.parent.mkdir(parents=True, exist_ok=True)
+    deps = find_unreferenced_workflows(code)
+
+    with open(fname, 'w') as f:
+        f.write(workflow_template(list(deps)))
+    click.echo(f'{workflow} created')
+
+
+@click.command()
+@click.argument('key')
+@click.argument('value', type=str)
+@click.option('--api',
+              '-a',
+              default=lambda: get_config_value("api", str, 'set'),
+              help='The modlule name of the api.')
+def set(key, value, api):
+    """
+    Set a config.
+    """
+    from . import transform
+    if api is not None:
+        api = importlib.import_module(api)
+        set_config_api(api.query_config, api.update_config)
+    try:
+        value = eval(value)
+    except:
+        pass
+    transform.update_config({key: value})
+
+
+@click.command()
+@click.argument('key')
+@click.option('--api',
+              '-a',
+              default=lambda: get_config_value("api", str, 'get'),
+              help='The modlule name of the api.')
+def get(key, api):
+    """
+    Get a config.
+    """
+    from . import transform
+    if api is not None:
+        api = importlib.import_module(api)
+        set_config_api(api.query_config, api.update_config)
+    click.echo(transform.query_config(key))
+
+
+@click.command()
+@click.argument('workflow')
+@click.option('--plot', '-p', is_flag=True, help='Plot the result.')
+@click.option('--no-dependents',
+              '-n',
+              is_flag=True,
+              help='Do not run dependents.')
+@log_options
+@command_option('run')
+def run(workflow, code, data, api, plot, no_dependents):
+    """
+    Run a workflow.
+    """
+    if api is not None:
+        api = importlib.import_module(api)
+        set_config_api(api.query_config, api.update_config)
+    if code is None:
+        code = Path.cwd()
+    if data is None:
+        data = Path(code) / 'logs'
+
+    code = Path(os.path.expanduser(code))
+    data = Path(os.path.expanduser(data))
+
+    wf = load_workflow(workflow, code)
+
+    if no_dependents:
+        if hasattr(wf, 'entries'):
+            for entry in get_entries(wf, code):
+                run_workflow(entry, code, data, plot=plot)
+        else:
+            run_workflow(wf, code, data, plot=plot)
+    else:
+        if hasattr(wf, 'entries'):
+            for entry in get_entries(wf, code):
+                maintain_workflow(entry, code, data, run=True, plot=plot)
+        else:
+            maintain_workflow(wf, code, data, run=True, plot=plot)
+
+
+@click.command()
+@click.argument('workflow')
+@click.option('--plot', '-p', is_flag=True, help='Plot the result.')
+@log_options
+@command_option('maintain')
+def maintain(workflow, code, data, api, plot):
+    """
+    Maintain a workflow.
+    """
+    if api is not None:
+        api = importlib.import_module(api)
+        set_config_api(api.query_config, api.update_config)
+    if code is None:
+        code = Path.cwd()
+    if data is None:
+        data = Path(code) / 'logs'
+
+    code = Path(os.path.expanduser(code))
+    data = Path(os.path.expanduser(data))
+
+    wf = load_workflow(workflow, code)
+    if hasattr(wf, 'entries'):
+        for entry in get_entries(wf, code):
+            maintain_workflow(entry, code, data, run=False, plot=plot)
+    else:
+        maintain_workflow(wf, code, data, run=False, plot=plot)

qulab/executor/load.py

@@ -15,6 +15,7 @@ from .storage import Result
 
 class SetConfigWorkflow():
     __timeout__ = None
+    __mtime__ = 0
 
     def __init__(self, key):
         self.key = key
@@ -119,6 +120,17 @@ def is_workflow(module: ModuleType) -> bool:
         return False
 
 
+def is_template(path: str | Path) -> bool:
+    path = Path(path)
+    if path.name == 'template.py':
+        return True
+    if path.name.endswith('_template.py'):
+        return True
+    if 'templates' in path.parts:
+        return True
+    return False
+
+
 def find_unreferenced_workflows(path: str) -> list[str]:
     root = Path(path).resolve()
     workflows = []
@@ -128,8 +140,7 @@ def find_unreferenced_workflows(path: str) -> list[str]:
     for file_path in root.rglob("*.py"):
         if file_path.name == "__init__.py":
             continue
-        if file_path.name == 'template.py' or file_path.name.endswith(
-                "_template.py"):
+        if is_template(file_path):
             continue
         try:
             rel_path = file_path.relative_to(root)
@@ -188,14 +199,18 @@ def find_unreferenced_workflows(path: str) -> list[str]:
 def load_workflow_from_file(file_name: str,
                             base_path: str | Path,
                             package='workflows') -> WorkflowType:
-    if file_name.startswith('cfg:'):
-        return SetConfigWorkflow(file_name[4:])
     base_path = Path(base_path)
     path = Path(file_name)
+    if not (base_path / path).exists():
+        raise FileNotFoundError(f"File not found: {base_path / path}")
     module_name = f"{package}.{'.'.join([*path.parts[:-1], path.stem])}"
     spec = spec_from_file_location(module_name, base_path / path)
     module = module_from_spec(spec)
     spec.loader.exec_module(module)
+    module.__mtime__ = (base_path / path).stat().st_mtime
+
+    if hasattr(module, 'entries'):
+        return module
 
     if not hasattr(module, '__timeout__'):
         module.__timeout__ = None
@@ -209,17 +224,20 @@ def load_workflow_from_file(file_name: str,
     return module
 
 
-def load_workflow_from_template(file_name: str,
+def load_workflow_from_template(template_path: str,
                                 mappping: dict[str, str],
                                 base_path: str | Path,
-                                subtitle: str | None = None,
-                                package='workflows') -> WorkflowType:
+                                target_path: str | None = None,
+                                package='workflows',
+                                mtime: float = 0) -> WorkflowType:
     base_path = Path(base_path)
-    path = Path(file_name)
+    path = Path(template_path)
 
     with open(base_path / path) as f:
         content = f.read()
 
+    mtime = max(Path(template_path).stat().st_mtime, mtime)
+
     def replace(text):
         """
         将给定文本中的所有 _D_("var") 替换为 ${var}。
@@ -239,41 +257,51 @@ def load_workflow_from_template(file_name: str,
     content = template.substitute(mappping)
 
     hash_str = hashlib.md5(pickle.dumps(mappping)).hexdigest()[:8]
-    if subtitle is None:
+    if target_path is None:
         if path.stem == 'template':
             path = path.parent / f'tmp{hash_str}.py'
-        else:
+        elif path.stem.endswith('_template'):
             path = path.parent / path.stem.replace('_template',
                                                    f'_tmp{hash_str}.py')
-    else:
-        if path.stem == 'template':
-            path = path.parent / f'{subtitle}.py'
         else:
-            path = path.parent / path.stem.replace('_template',
-                                                   f'_{subtitle}.py')
+            path = path.parent / f'{path.stem}_tmp{hash_str}.py'
+    else:
+        path = target_path
 
     file = base_path / path
     if not file.exists():
+        file.parent.mkdir(parents=True, exist_ok=True)
         with open(file, 'w') as f:
             f.write(content)
+    else:
+        if file.stat().st_mtime < mtime:
+            with open(file, 'w') as f:
+                f.write(content)
+        else:
+            if file.read_text() != content:
+                logger.warning(
+                    f"`{file}` already exists and is different from the new one generated from template `{template_path}`"
+                )
 
     module = load_workflow_from_file(str(path), base_path, package)
+    module.__mtime__ = max(mtime, module.__mtime__)
 
     return module
 
 
 def load_workflow(workflow: str | tuple[str, dict],
                   base_path: str | Path,
-                  package='workflows') -> WorkflowType:
+                  package='workflows',
+                  mtime: float = 0) -> WorkflowType:
     if isinstance(workflow, tuple):
         if len(workflow) == 2:
             file_name, mapping = workflow
             w = load_workflow_from_template(file_name, mapping, base_path,
-                                            None, package)
+                                            None, package, mtime)
         elif len(workflow) == 3:
-            file_name, subtitle, mapping = workflow
-            w = load_workflow_from_template(file_name, mapping, base_path,
-                                            subtitle, package)
+            template_path, target_path, mapping = workflow
+            w = load_workflow_from_template(template_path, mapping, base_path,
+                                            target_path, package, mtime)
         else:
             raise ValueError(f"Invalid workflow: {workflow}")
         w.__workflow_id__ = str(Path(w.__file__).relative_to(base_path))
@@ -293,4 +321,14 @@ def load_workflow(workflow: str | tuple[str, dict],
 
 def get_dependents(workflow: WorkflowType,
                    code_path: str | Path) -> list[WorkflowType]:
-    return [load_workflow(n, code_path) for n in workflow.depends()[0]]
+    return [
+        load_workflow(n, code_path, mtime=workflow.__mtime__)
+        for n in workflow.depends()[0]
+    ]
+
+
+def get_entries(workflow: WorkflowType, code_path: str | Path) -> WorkflowType:
+    return [
+        load_workflow(n, code_path, mtime=workflow.__mtime__)
+        for n in workflow.entries()
+    ]

qulab/version.py

@@ -1 +1 @@
-__version__ = "2.4.14"
+__version__ = "2.4.16"

qulab/executor/__main__.py

@@ -1,200 +0,0 @@
-import functools
-import importlib
-import os
-import sys
-from pathlib import Path
-
-import click
-from loguru import logger
-
-from .load import find_unreferenced_workflows, load_workflow
-from .schedule import maintain as maintain_workflow
-from .schedule import run as run_workflow
-from .transform import set_config_api
-from .utils import workflow_template
-
-
-def load_config():
-    import yaml
-
-    config_paths = [
-        Path.home() / ".myapp/config.yaml",  # 用户主目录
-        Path("config.yaml")  # 当前目录
-    ]
-    for path in config_paths:
-        if path.exists():
-            with open(path) as f:
-                return yaml.safe_load(f)
-    return {"defaults": {"log": "default.log", "debug": False}}
-
-
-def get_config_value(option_name):
-    # 1. 尝试从环境变量读取
-    env_value = os.environ.get(f"MYAPP_{option_name.upper()}")
-    if env_value:
-        return env_value
-
-    # 2. 尝试从配置文件读取
-    config = load_config()
-    return config["defaults"].get(option_name)
-
-
-def log_options(func):
-
-    @click.option("--debug", is_flag=True, help="Enable debug mode.")
-    @click.option("--log", type=str, help="Log file path.")
-    @functools.wraps(func)  # 保持函数元信息
-    def wrapper(*args, log=None, debug=False, **kwargs):
-        if log is None and not debug:
-            logger.remove()
-            logger.add(sys.stderr, level='INFO')
-        elif log is None and debug:
-            logger.remove()
-            logger.add(sys.stderr, level='DEBUG')
-        elif log is not None and not debug:
-            logger.configure(handlers=[dict(sink=log, level='INFO')])
-        elif log is not None and debug:
-            logger.configure(handlers=[
-                dict(sink=log, level='DEBUG'),
-                dict(sink=sys.stderr, level='DEBUG')
-            ])
-        return func(*args, **kwargs)
-
-    return wrapper
-
-
-@click.group()
-def cli():
-    pass
-
-
-@click.command()
-@click.argument('workflow')
-@click.option('--code', '-c', default=None, help='The path of the code.')
-def create(workflow, code):
-    """
-    Create a new workflow file.
-    """
-    if code is None:
-        code = Path.cwd()
-
-    fname = Path(code) / f'{workflow}'
-    fname = Path(os.path.expanduser(fname))
-    if fname.exists():
-        click.echo(f'{workflow} already exists')
-        return
-
-    fname.parent.mkdir(parents=True, exist_ok=True)
-    deps = find_unreferenced_workflows(code)
-
-    with open(fname, 'w') as f:
-        f.write(workflow_template(list(deps)))
-    click.echo(f'{workflow} created')
-
-
-@click.command()
-@click.argument('key')
-@click.argument('value', type=str)
-@click.option('--api', '-a', default=None, help='The modlule name of the api.')
-def set(key, value, api):
-    """
-    Set a config.
-    """
-    from . import transform
-    if api is not None:
-        api = importlib.import_module(api)
-        set_config_api(api.query_config, api.update_config)
-    try:
-        value = eval(value)
-    except:
-        pass
-    transform.update_config({key: value})
-
-
-@click.command()
-@click.argument('key')
-@click.option('--api', '-a', default=None, help='The modlule name of the api.')
-def get(key, api):
-    """
-    Get a config.
-    """
-    from . import transform
-    if api is not None:
-        api = importlib.import_module(api)
-        set_config_api(api.query_config, api.update_config)
-    click.echo(transform.query_config(key))
-
-
-@click.command()
-@click.argument('workflow')
-@click.option('--code', '-c', default=None, help='The path of the code.')
-@click.option('--data', '-d', default=None, help='The path of the data.')
-@click.option('--api', '-a', default=None, help='The modlule name of the api.')
-@click.option('--plot', '-p', is_flag=True, help='Plot the result.')
-@click.option('--no-dependents',
-              '-n',
-              is_flag=True,
-              help='Do not run dependents.')
-@log_options
-def run(workflow, code, data, api, plot, no_dependents):
-    """
-    Run a workflow.
-    """
-    if api is not None:
-        api = importlib.import_module(api)
-        set_config_api(api.query_config, api.update_config)
-    if code is None:
-        code = Path.cwd()
-    if data is None:
-        data = Path(code) / 'logs'
-
-    code = Path(os.path.expanduser(code))
-    data = Path(os.path.expanduser(data))
-
-    if no_dependents:
-        run_workflow(load_workflow(workflow, code), code, data, plot=plot)
-    else:
-        maintain_workflow(load_workflow(workflow, code),
-                          code,
-                          data,
-                          run=True,
-                          plot=plot)
-
-
-@click.command()
-@click.argument('workflow')
-@click.option('--code', '-c', default=None, help='The path of the code.')
-@click.option('--data', '-d', default=None, help='The path of the data.')
-@click.option('--api', '-a', default=None, help='The modlule name of the api.')
-@click.option('--plot', '-p', is_flag=True, help='Plot the result.')
-@log_options
-def maintain(workflow, code, data, api, plot):
-    """
-    Maintain a workflow.
-    """
-    if api is not None:
-        api = importlib.import_module(api)
-        set_config_api(api.query_config, api.update_config)
-    if code is None:
-        code = Path.cwd()
-    if data is None:
-        data = Path(code) / 'logs'
-
-    code = Path(os.path.expanduser(code))
-    data = Path(os.path.expanduser(data))
-
-    maintain_workflow(load_workflow(workflow, code),
-                      code,
-                      data,
-                      run=False,
-                      plot=plot)
-
-
-cli.add_command(maintain)
-cli.add_command(run)
-cli.add_command(create)
-cli.add_command(set)
-cli.add_command(get)
-
-if __name__ == '__main__':
-    cli()