Task
====

.. currentmodule:: deepfos.lib.subtask

.. autoclass:: Task

   :exclude-members:



子任务对象

    Args:
        arg: 执行参数
        task_name_tmpl: 任务名模板，支持替换的字段为counter（自增任务编号）
           和 arg（任务使用的参数），默认以 Task-{counter:03} 格式产生
        swallow_exc: 在任务出现异常时是否忽略（不中断程序执行）
        check_started: 是否检查任务启动过

    .. admonition:: 示例

        .. code-block:: python

            with Task():
                time.sleep(1)

            with Task(swallow_exc=True):
                raise ValueError('an error occurs')

            with Task(task_name_tmpl="Your task name"):
                time.sleep(1)

    Note:
        - 若不通过 :class:`TaskContainer` 或 :function:`create_tasks`，
           而是直接实例化Task对象，则只有其中任务被执行时，
           记录才会创建更新，作业界面进度条不能反映实际运行进度
        - 如需看到稳定进度条的情况，建议从 :class:`TaskContainer` 调用或使用
           :function:`create_tasks` 方法

    See Also:
        :class:`TaskContainer`
        :func:`create_tasks`

    

.. autosummary::