zrb 1.0.0a16__py3-none-any.whl → 1.0.0a18__py3-none-any.whl

zrb/builtin/todo.py

@@ -4,19 +4,21 @@ import os
 from typing import Any
 
 from zrb.builtin.group import todo_group
-from zrb.config import TODO_DIR, TODO_VISUAL_FILTER
+from zrb.config import TODO_DIR, TODO_RETENTION, TODO_VISUAL_FILTER
 from zrb.context.any_context import AnyContext
 from zrb.input.str_input import StrInput
 from zrb.input.text_input import TextInput
 from zrb.task.make_task import make_task
+from zrb.util.file import read_file, write_file
 from zrb.util.todo import (
     TodoTaskModel,
-    add_durations,
+    add_duration,
     cascade_todo_task,
     get_visual_todo_card,
     get_visual_todo_list,
     line_to_todo_task,
     load_todo_list,
+    parse_duration,
     save_todo_list,
     select_todo_task,
     todo_task_to_line,
@@ -119,8 +121,7 @@ def show_todo(ctx: AnyContext):
     log_work_path = os.path.join(TODO_DIR, "log-work", f"{task_id}.json")
     log_work_list = []
     if os.path.isfile(log_work_path):
-        with open(log_work_path, "r") as f:
-            log_work_list = json.loads(f.read())
+        log_work_list = json.loads(read_file(log_work_path))
     return get_visual_todo_card(todo_task, log_work_list)
 
 
@@ -165,11 +166,17 @@ def archive_todo(ctx: AnyContext):
     todo_list: list[TodoTaskModel] = []
     if os.path.isfile(todo_file_path):
         todo_list = load_todo_list(todo_file_path)
-    working_todo_list = [
-        todo_task for todo_task in todo_list if not todo_task.completed
-    ]
+    retention_duration = datetime.timedelta(seconds=parse_duration(TODO_RETENTION))
+    threshold_date = datetime.date.today() - retention_duration
     new_archived_todo_list = [
-        todo_task for todo_task in todo_list if todo_task.completed
+        todo_task
+        for todo_task in todo_list
+        if todo_task.completed
+        and todo_task.completion_date is not None
+        and todo_task.completion_date < threshold_date
+    ]
+    working_todo_list = [
+        todo_task for todo_task in todo_list if todo_task not in new_archived_todo_list
     ]
     if len(new_archived_todo_list) == 0:
         ctx.print("No completed task to archive")
@@ -204,10 +211,10 @@ def archive_todo(ctx: AnyContext):
             default_str="30m",
         ),
         StrInput(
-            name="start",
-            prompt="Working start time (%Y-%m-%d %H:%M:%S)",
-            description="Working start time",
-            default_str=lambda _: _get_default_start(),
+            name="stop",
+            prompt="Working stop time (%Y-%m-%d %H:%M:%S)",
+            description="Working stop time",
+            default_str=lambda _: _get_default_stop_work_time_str(),
         ),
     ],
     description="🕒 Log work todo",
@@ -226,8 +233,10 @@ def log_todo(ctx: AnyContext):
         return get_visual_todo_list(todo_list, TODO_VISUAL_FILTER)
     # Update todo task
     todo_task = cascade_todo_task(todo_task)
-    current_duration = todo_task.keyval.get("duration", "0")
-    todo_task.keyval["duration"] = add_durations(current_duration, ctx.input.duration)
+    current_duration_str = todo_task.keyval.get("duration", "0")
+    todo_task.keyval["duration"] = add_duration(
+        current_duration_str, ctx.input.duration
+    )
     # Save todo list
     save_todo_list(todo_file_path, todo_list)
     # Add log work
@@ -237,24 +246,26 @@ def log_todo(ctx: AnyContext):
         log_work_dir, f"{todo_task.keyval.get('id')}.json"
     )
     if os.path.isfile(log_work_file_path):
-        with open(log_work_file_path, "r") as f:
-            log_work_json = f.read()
+        log_work_json = read_file(log_work_file_path)
     else:
         log_work_json = "[]"
     log_work: list[dict[str, Any]] = json.loads(log_work_json)
+    start_work_time_str = _get_start_work_time_str(ctx.input.stop, ctx.input.duration)
     log_work.append(
-        {"log": ctx.input.log, "duration": ctx.input.duration, "start": ctx.input.start}
+        {
+            "log": ctx.input.log,
+            "duration": ctx.input.duration,
+            "start": start_work_time_str,
+        }
     )
     # save todo with log work
-    with open(log_work_file_path, "w") as f:
-        f.write(json.dumps(log_work, indent=2))
+    write_file(log_work_file_path, json.dumps(log_work, indent=2))
     # get log work list
     task_id = todo_task.keyval.get("id", "")
     log_work_path = os.path.join(TODO_DIR, "log-work", f"{task_id}.json")
     log_work_list = []
     if os.path.isfile(log_work_path):
-        with open(log_work_path, "r") as f:
-            log_work_list = json.loads(f.read())
+        log_work_list = json.loads(read_file(log_work_path))
     return "\n".join(
         [
             get_visual_todo_list(todo_list, TODO_VISUAL_FILTER),
@@ -264,7 +275,14 @@ def log_todo(ctx: AnyContext):
     )
 
 
-def _get_default_start() -> str:
+def _get_start_work_time_str(stop_work_time_str: str, work_duration_str: str) -> str:
+    work_duration = parse_duration(work_duration_str)
+    stop_work_time = datetime.datetime.strptime(stop_work_time_str, "%Y-%m-%d %H:%M:%S")
+    start_work_time = stop_work_time - datetime.timedelta(seconds=work_duration)
+    return start_work_time.strftime("%Y-%m-%d %H:%M:%S")
+
+
+def _get_default_stop_work_time_str() -> str:
     return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
 
@@ -290,8 +308,7 @@ def edit_todo(ctx: AnyContext):
     ]
     new_content = "\n".join(todo_task_to_line(todo_task) for todo_task in todo_list)
     todo_file_path = os.path.join(TODO_DIR, "todo.txt")
-    with open(todo_file_path, "w") as f:
-        f.write(new_content)
+    write_file(todo_file_path, new_content)
     todo_list = load_todo_list(todo_file_path)
     return get_visual_todo_list(todo_list, TODO_VISUAL_FILTER)
 
@@ -300,5 +317,4 @@ def _get_todo_txt_content() -> str:
     todo_file_path = os.path.join(TODO_DIR, "todo.txt")
     if not os.path.isfile(todo_file_path):
         return ""
-    with open(todo_file_path, "r") as f:
-        return f.read()
+    return read_file(todo_file_path)

zrb/callback/callback.py

@@ -8,7 +8,6 @@ from zrb.util.attr import get_str_dict_attr
 
 
 class Callback(AnyCallback):
-
     def __init__(
         self,
         input_mapping: StrDictAttr,

zrb/cmd/cmd_val.py

@@ -3,6 +3,7 @@ from collections.abc import Callable
 
 from zrb.attr.type import fstring
 from zrb.context.context import Context
+from zrb.util.file import read_file
 
 
 class AnyCmdVal(ABC):
@@ -18,8 +19,7 @@ class CmdPath(AnyCmdVal):
 
     def to_str(self, ctx: Context) -> str:
         file_path = ctx.render(self._path) if self._auto_render else self._path
-        with open(file_path) as file:
-            return file.read()
+        return read_file(file_path)
 
 
 class Cmd(AnyCmdVal):

zrb/config.py

@@ -56,6 +56,7 @@ SESSION_LOG_DIR = os.getenv(
 )
 TODO_DIR = os.getenv("ZRB_TODO_DIR", os.path.expanduser(os.path.join("~", "todo")))
 TODO_VISUAL_FILTER = os.getenv("ZRB_TODO_FILTER", "")
+TODO_RETENTION = os.getenv("ZRB_TODO_RETENTION", "2w")
 VERSION = metadata.version("zrb")
 WEB_HTTP_PORT = int(os.getenv("ZRB_WEB_HTTP_PORT", "21213"))
 LLM_MODEL = os.getenv("ZRB_LLM_MODEL", "ollama_chat/llama3.1")

zrb/content_transformer/content_transformer.py

@@ -4,16 +4,16 @@ from collections.abc import Callable
 
 from zrb.content_transformer.any_content_transformer import AnyContentTransformer
 from zrb.context.any_context import AnyContext
+from zrb.util.file import read_file, write_file
 
 
 class ContentTransformer(AnyContentTransformer):
-
     def __init__(
         self,
         match: list[str] | str | Callable[[AnyContext, str], bool],
         transform: (
             dict[str, str | Callable[[AnyContext], str]]
-            | Callable[[AnyContext, str], str]
+            | Callable[[AnyContext, str], None]
         ),
         auto_render: bool = True,
     ):
@@ -24,7 +24,10 @@ class ContentTransformer(AnyContentTransformer):
     def match(self, ctx: AnyContext, file_path: str) -> bool:
         if callable(self._match):
             return self._match(ctx, file_path)
-        patterns = [self._match] if isinstance(self._match, str) else self._match
+        if isinstance(self._match, str):
+            patterns = [self._match]
+        else:
+            patterns = self._match
         for pattern in patterns:
             try:
                 if re.fullmatch(pattern, file_path):
@@ -40,12 +43,10 @@ class ContentTransformer(AnyContentTransformer):
             keyword: self._get_str_replacement(ctx, replacement)
             for keyword, replacement in self._transform_file.items()
         }
-        with open(file_path, "r") as f:
-            content = f.read()
+        content = read_file(file_path)
         for keyword, replacement in transform_map.items():
             content = content.replace(keyword, replacement)
-        with open(file_path, "w") as f:
-            f.write(content)
+        write_file(file_path, content)
 
     def _get_str_replacement(
         self, ctx: AnyContext, replacement: str | Callable[[AnyContext], str]

zrb/context/any_context.py

@@ -42,7 +42,7 @@ class AnyContext(AnySharedContext):
         sep: str | None = " ",
         end: str | None = "\n",
         file: TextIO | None = sys.stderr,
-        flush: bool = True
+        flush: bool = True,
     ):
         """Prints values to the specified output stream.
 
@@ -62,7 +62,7 @@ class AnyContext(AnySharedContext):
         sep: str | None = " ",
         end: str | None = "\n",
         file: TextIO | None = sys.stderr,
-        flush: bool = True
+        flush: bool = True,
     ):
         """Logs debug-level messages.
 
@@ -82,7 +82,7 @@ class AnyContext(AnySharedContext):
         sep: str | None = " ",
         end: str | None = "\n",
         file: TextIO | None = sys.stderr,
-        flush: bool = True
+        flush: bool = True,
     ):
         """Logs info-level messages.
 
@@ -102,7 +102,7 @@ class AnyContext(AnySharedContext):
         sep: str | None = " ",
         end: str | None = "\n",
         file: TextIO | None = sys.stderr,
-        flush: bool = True
+        flush: bool = True,
     ):
         """Logs warning-level messages.
 
@@ -122,7 +122,7 @@ class AnyContext(AnySharedContext):
         sep: str | None = " ",
         end: str | None = "\n",
         file: TextIO | None = sys.stderr,
-        flush: bool = True
+        flush: bool = True,
     ):
         """Logs error-level messages.
 
@@ -142,7 +142,7 @@ class AnyContext(AnySharedContext):
         sep: str | None = " ",
         end: str | None = "\n",
         file: TextIO | None = sys.stderr,
-        flush: bool = True
+        flush: bool = True,
     ):
         """Logs critical-level messages.
 

zrb/group/group.py

@@ -3,7 +3,6 @@ from zrb.task.any_task import AnyTask
 
 
 class Group(AnyGroup):
-
     def __init__(
         self, name: str, description: str | None = None, banner: str | None = None
     ):

zrb/input/base_input.py

@@ -4,6 +4,7 @@ from zrb.attr.type import StrAttr
 from zrb.context.any_shared_context import AnySharedContext
 from zrb.input.any_input import AnyInput
 from zrb.util.attr import get_str_attr
+from zrb.util.string.conversion import to_snake_case
 
 
 class BaseInput(AnyInput):
@@ -49,7 +50,18 @@ class BaseInput(AnyInput):
     ):
         if str_value is None:
             str_value = self._get_default_str(shared_ctx)
-        shared_ctx.input[self.name] = self._parse_str_value(str_value)
+        value = self._parse_str_value(str_value)
+        if self.name in shared_ctx.input:
+            raise ValueError(f"Input already defined in the context: {self.name}")
+        shared_ctx.input[self.name] = value
+        # We want to be able to access ctx.input["project-name"] as
+        # ctx.input.project_name
+        snake_key = to_snake_case(self.name)
+        if snake_key == self.name:
+            return
+        if snake_key in shared_ctx.input:
+            raise ValueError("Input already defined in the context: {snake_key}")
+        shared_ctx.input[snake_key] = value
 
     def _parse_str_value(self, str_value: str) -> Any:
         """Override this to transform str_value"""

zrb/input/text_input.py

@@ -6,6 +6,7 @@ from collections.abc import Callable
 from zrb.config import DEFAULT_EDITOR
 from zrb.context.any_shared_context import AnySharedContext
 from zrb.input.base_input import BaseInput
+from zrb.util.file import read_file
 
 
 class TextInput(BaseInput):
@@ -83,9 +84,8 @@ class TextInput(BaseInput):
         # Open the editor
         subprocess.call([self._editor, temp_file_name])
         # Read the edited content
-        with open(temp_file_name, "r") as temp_file:
-            edited_content = temp_file.read()
-            parts = [text.strip() for text in edited_content.split(prompt_message, 1)]
-            edited_content = "\n".join(parts).lstrip()
+        edited_content = read_file(temp_file_name)
+        parts = [text.strip() for text in edited_content.split(prompt_message, 1)]
+        edited_content = "\n".join(parts).lstrip()
         os.remove(temp_file_name)
         return edited_content

zrb/runner/cli.py

@@ -20,7 +20,6 @@ from zrb.util.string.conversion import double_quote
 
 
 class Cli(Group):
-
     def run(self, args: list[str] = []):
         load_zrb_init()
         kwargs, args = self._extract_kwargs_from_args(args)

zrb/runner/web_app.py

@@ -75,7 +75,7 @@ def create_app(root_group: AnyGroup, port: int = WEB_HTTP_PORT):
             return handle_group_info_ui(root_group, node, url)
         raise HTTPException(status_code=404, detail="Not Found")
 
-    @app.post("/api/{path:path}")
+    @app.post("/api/sessions/{path:path}")
     async def create_new_session(
         path: str, request: Request = None
     ) -> NewSessionResponse:
@@ -96,7 +96,10 @@ def create_app(root_group: AnyGroup, port: int = WEB_HTTP_PORT):
                 return NewSessionResponse(session_name=session.name)
         raise HTTPException(status_code=404, detail="Not Found")
 
-    @app.get("/api/{path:path}", response_model=SessionStateLog | SessionStateLogList)
+    @app.get(
+        "/api/sessions/{path:path}",
+        response_model=SessionStateLog | SessionStateLogList,
+    )
     async def get_session(
         path: str,
         min_start_query: str = Query(default=None, alias="from"),

zrb/runner/web_controller/group_info_ui/controller.py

@@ -1,25 +1,17 @@
 import os
 
 from zrb.group.any_group import AnyGroup
+from zrb.util.file import read_file
 from zrb.util.group import get_non_empty_subgroups, get_subtasks
 from zrb.util.string.format import fstring_format
 
 _DIR = os.path.dirname(__file__)
 
-with open(os.path.join(_DIR, "view.html"), "r") as f:
-    _VIEW_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "group_info.html")) as f:
-    _GROUP_INFO_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "group_li.html")) as f:
-    _GROUP_LI_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "task_info.html")) as f:
-    _TASK_INFO_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "task_li.html")) as f:
-    _TASK_LI_TEMPLATE = f.read()
+_VIEW_TEMPLATE = read_file(os.path.join(_DIR, "view.html"))
+_GROUP_INFO_TEMPLATE = read_file(os.path.join(_DIR, "partial", "group_info.html"))
+_GROUP_LI_TEMPLATE = read_file(os.path.join(_DIR, "partial", "group_li.html"))
+_TASK_INFO_TEMPLATE = read_file(os.path.join(_DIR, "partial", "task_info.html"))
+_TASK_LI_TEMPLATE = read_file(os.path.join(_DIR, "partial", "task_li.html"))
 
 
 def handle_group_info_ui(root_group: AnyGroup, group: AnyGroup, url: str):

zrb/runner/web_controller/home_page/controller.py

@@ -1,25 +1,17 @@
 import os
 
 from zrb.group.any_group import AnyGroup
+from zrb.util.file import read_file
 from zrb.util.group import get_non_empty_subgroups, get_subtasks
 from zrb.util.string.format import fstring_format
 
 _DIR = os.path.dirname(__file__)
 
-with open(os.path.join(_DIR, "view.html"), "r") as f:
-    _VIEW_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "group_info.html")) as f:
-    _GROUP_INFO_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "group_li.html")) as f:
-    _GROUP_LI_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "task_info.html")) as f:
-    _TASK_INFO_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "task_li.html")) as f:
-    _TASK_LI_TEMPLATE = f.read()
+_VIEW_TEMPLATE = read_file(os.path.join(_DIR, "view.html"))
+_GROUP_INFO_TEMPLATE = read_file(os.path.join(_DIR, "partial", "group_info.html"))
+_GROUP_LI_TEMPLATE = read_file(os.path.join(_DIR, "partial", "group_li.html"))
+_TASK_INFO_TEMPLATE = read_file(os.path.join(_DIR, "partial", "task_info.html"))
+_TASK_LI_TEMPLATE = read_file(os.path.join(_DIR, "partial", "task_li.html"))
 
 
 def handle_home_page(root_group: AnyGroup):

zrb/runner/web_controller/task_ui/controller.py

@@ -1,30 +1,23 @@
 import os
 
-from zrb.context.shared_context import SharedContext
 from zrb.group.any_group import AnyGroup
 from zrb.session.any_session import AnySession
 from zrb.task.any_task import AnyTask
+from zrb.util.file import read_file
 from zrb.util.string.format import fstring_format
 
 _DIR = os.path.dirname(__file__)
 
-with open(os.path.join(_DIR, "view.html"), "r") as f:
-    _VIEW_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "input.html")) as f:
-    _TASK_INPUT_TEMPLATE = f.read()
-
-with open(os.path.join(_DIR, "partial", "main.js")) as f:
-    _MAIN_SCRIPT = f.read()
-
-with open(os.path.join(_DIR, "partial", "show-existing-session.js")) as f:
-    _SHOW_EXISTING_SESSION_SCRIPT = f.read()
-
-with open(os.path.join(_DIR, "partial", "visualize-history.js")) as f:
-    _VISUALIZE_HISTORY_SCRIPT = f.read()
-
-with open(os.path.join(_DIR, "partial", "common-util.js")) as f:
-    _COMMON_UTIL_SCRIPT = f.read()
+_VIEW_TEMPLATE = read_file(os.path.join(_DIR, "view.html"))
+_TASK_INPUT_TEMPLATE = read_file(os.path.join(_DIR, "partial", "input.html"))
+_MAIN_SCRIPT = read_file(os.path.join(_DIR, "partial", "main.js"))
+_SHOW_EXISTING_SESSION_SCRIPT = read_file(
+    os.path.join(_DIR, "partial", "show-existing-session.js")
+)
+_VISUALIZE_HISTORY_SCRIPT = read_file(
+    os.path.join(_DIR, "partial", "visualize-history.js")
+)
+_COMMON_UTIL_SCRIPT = read_file(os.path.join(_DIR, "partial", "common-util.js"))
 
 
 def handle_task_ui(
@@ -40,7 +33,7 @@ def handle_task_ui(
     parent_url = "/".join(parent_url_parts)
     # Assemble api url
     api_url_parts = list(url_parts)
-    api_url_parts[1] = "api"
+    api_url_parts[1] = "api/sessions"
     api_url = "/".join(api_url_parts)
     # Assemble ui url
     ui_url_parts = list(api_url_parts)

zrb/session_state_logger/any_session_state_logger.py

@@ -5,7 +5,6 @@ from zrb.session_state_log.session_state_log import SessionStateLog, SessionStat
 
 
 class AnySessionStateLogger(ABC):
-
     @abstractmethod
     def write(self, session_log: SessionStateLog):
         pass

zrb/session_state_logger/file_session_state_logger.py

@@ -3,10 +3,10 @@ import os
 
 from zrb.session_state_log.session_state_log import SessionStateLog, SessionStateLogList
 from zrb.session_state_logger.any_session_state_logger import AnySessionStateLogger
+from zrb.util.file import read_file, write_file
 
 
 class FileSessionStateLogger(AnySessionStateLogger):
-
     def __init__(self, session_log_dir: str):
         self._session_log_dir = session_log_dir
 
@@ -15,20 +15,16 @@ class FileSessionStateLogger(AnySessionStateLogger):
         session_dir_path = os.path.dirname(session_file_path)
         if not os.path.isdir(session_dir_path):
             os.makedirs(session_dir_path, exist_ok=True)
-        with open(session_file_path, "w") as f:
-            f.write(session_log.model_dump_json())
+        write_file(session_file_path, session_log.model_dump_json())
         start_time = session_log.start_time
         if start_time == "":
             return
         timeline_dir_path = self._get_timeline_dir_path(session_log)
-        os.makedirs(timeline_dir_path, exist_ok=True)
-        with open(os.path.join(timeline_dir_path, session_log.name), "w"):
-            pass
+        write_file(os.path.join(timeline_dir_path, session_log.name), "")
 
     def read(self, session_name: str) -> SessionStateLog:
         session_file_path = self._get_session_file_path(session_name)
-        with open(session_file_path, "r") as f:
-            return SessionStateLog.model_validate_json(f.read())
+        return SessionStateLog.model_validate_json(read_file(session_file_path))
 
     def list(
         self,

zrb/task/base_trigger.py

@@ -19,7 +19,6 @@ from zrb.xcom.xcom import Xcom
 
 
 class BaseTrigger(BaseTask):
-
     def __init__(
         self,
         name: str,

zrb/task/cmd_task.py

@@ -132,7 +132,7 @@ class CmdTask(BaseTask):
         if return_code != 0:
             ctx.log_error(f"Exit status: {return_code}")
             raise Exception(
-                f"Process {self._name} exited ({return_code}): {cmd_result.stderr}"
+                f"Process {self._name} exited ({return_code}): {cmd_result.error}"
             )
         ctx.log_info(f"Exit status: {return_code}")
         return cmd_result

zrb/task/llm_task.py

@@ -15,6 +15,7 @@ from zrb.task.any_task import AnyTask
 from zrb.task.base_task import BaseTask
 from zrb.util.attr import get_str_attr
 from zrb.util.cli.style import stylize_faint
+from zrb.util.file import read_file, write_file
 from zrb.util.llm.tool import callable_to_tool_schema
 
 ListOfDict = list[dict[str, Any]]
@@ -32,7 +33,6 @@ def scratchpad(thought: str) -> str:
 
 
 class LLMTask(BaseTask):
-
     def __init__(
         self,
         name: str,
@@ -171,9 +171,7 @@ class LLMTask(BaseTask):
                     messages.append(tool_call_message)
                 continue
             if history_file != "":
-                os.makedirs(os.path.dirname(history_file), exist_ok=True)
-                with open(history_file, "w") as f:
-                    f.write(json.dumps(messages, indent=2))
+                write_file(history_file, json.dumps(messages, indent=2))
             return response_message.content
 
     def _get_model(self, ctx: AnyContext) -> str:
@@ -211,8 +209,7 @@ class LLMTask(BaseTask):
             and history_file != ""
             and os.path.isfile(history_file)
         ):
-            with open(history_file, "r") as f:
-                return json.loads(f.read())
+            return json.loads(read_file(history_file))
         return self._history
 
     def _get_history_file(self, ctx: AnyContext) -> str:

zrb/task/make_task.py

@@ -32,7 +32,6 @@ def make_task(
     group: AnyGroup | None = None,
     alias: str | None = None,
 ) -> Callable[[Callable[[AnyContext], Any]], AnyTask]:
-
     def _make_task(fn: Callable[[AnyContext], Any]) -> BaseTask:
         task = BaseTask(
             name=name,