zrb 0.24.0__py3-none-any.whl → 0.26.0__py3-none-any.whl

zrb/task/notifier.py

@@ -1,12 +1,14 @@
 import os
 import subprocess
+from collections.abc import Callable, Iterable
+from typing import Any, Optional, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.accessories.icon import get_random_icon
 from zrb.helper.log import logger
 from zrb.helper.string.modification import double_quote
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, JinjaTemplate, Optional, Union
+from zrb.helper.typing import JinjaTemplate
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,

zrb/task/parallel.py

@@ -1,9 +1,9 @@
 from abc import ABC, abstractmethod
+from typing import TypeVar, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import List, TypeVar, Union
 from zrb.task.any_task import AnyTask
 
 logger.debug(colored("Loading zrb.task.parallel", attrs=["dark"]))
@@ -13,7 +13,7 @@ TParallel = TypeVar("TParallel", bound="Parallel")
 
 class AnyParallel(ABC):
     @abstractmethod
-    def get_tasks(self) -> List[AnyTask]:
+    def get_tasks(self) -> list[AnyTask]:
         pass
 
 
@@ -22,7 +22,7 @@ class Parallel(AnyParallel):
     def __init__(self, *tasks: AnyTask):
         self.__tasks = list(tasks)
 
-    def get_tasks(self) -> List[AnyTask]:
+    def get_tasks(self) -> list[AnyTask]:
         return self.__tasks
 
     def __rshift__(
@@ -33,7 +33,7 @@ class Parallel(AnyParallel):
                 operand.add_upstream(task)
             return operand
         if isinstance(operand, AnyParallel):
-            other_tasks: List[AnyTask] = operand.get_tasks()
+            other_tasks: list[AnyTask] = operand.get_tasks()
             for task in self.__tasks:
                 for other_task in other_tasks:
                     other_task.add_upstream(task)

zrb/task/path_checker.py

@@ -1,17 +1,11 @@
+from collections.abc import Callable, Iterable
+from typing import Any, Optional, TypeVar, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.file.match import get_file_names
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import (
-    Any,
-    Callable,
-    Iterable,
-    JinjaTemplate,
-    List,
-    Optional,
-    TypeVar,
-    Union,
-)
+from zrb.helper.typing import JinjaTemplate
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,
@@ -88,7 +82,7 @@ class PathChecker(Checker):
         self._path = path
         self._ignored_path = ignored_path
         self._rendered_path: str = ""
-        self._rendered_ignored_paths: List[str] = []
+        self._rendered_ignored_paths: list[str] = []
 
     def copy(self) -> TPathChecker:
         return super().copy()
@@ -120,7 +114,7 @@ class PathChecker(Checker):
         ]
         return await super().run(*args, **kwargs)
 
-    def _get_rendered_ignored_paths(self) -> List[str]:
+    def _get_rendered_ignored_paths(self) -> list[str]:
         if isinstance(self._ignored_path, str):
             return [self.render_str(self._ignored_path)]
         return [self.render_str(ignored_path) for ignored_path in self._ignored_path]

zrb/task/path_watcher.py

@@ -1,20 +1,12 @@
 import os
+from collections.abc import Callable, Iterable, Mapping
+from typing import Any, Optional, TypeVar, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.file.match import get_file_names
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import (
-    Any,
-    Callable,
-    Iterable,
-    JinjaTemplate,
-    List,
-    Mapping,
-    Optional,
-    TypeVar,
-    Union,
-)
+from zrb.helper.typing import JinjaTemplate
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,
@@ -108,7 +100,7 @@ class PathWatcher(Watcher):
         self._watch_modified_files = watch_modified_files
         self._watch_deleted_files = watch_deleted_files
         self._rendered_path: str = ""
-        self._rendered_ignored_paths: List[str] = []
+        self._rendered_ignored_paths: list[str] = []
 
     def copy(self) -> TPathWatcher:
         return super().copy()
@@ -143,7 +135,7 @@ class PathWatcher(Watcher):
             self.__init_times[identifier] = self._get_mod_times()
         return await super().run(*args, **kwargs)
 
-    def _get_rendered_ignored_paths(self) -> List[str]:
+    def _get_rendered_ignored_paths(self) -> list[str]:
         if isinstance(self._ignored_path, str):
             return [self.render_str(self._ignored_path)]
         return [self.render_str(ignored_path) for ignored_path in self._ignored_path]

zrb/task/port_checker.py

@@ -1,17 +1,11 @@
 import socket
+from collections.abc import Callable, Iterable
+from typing import Any, Optional, TypeVar, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import (
-    Any,
-    Callable,
-    Iterable,
-    JinjaTemplate,
-    Optional,
-    TypeVar,
-    Union,
-)
+from zrb.helper.typing import JinjaTemplate
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,

zrb/task/recurring_task.py

@@ -1,11 +1,12 @@
 import asyncio
 import copy
+from collections.abc import Callable, Iterable, Mapping
+from typing import Any, Optional, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.accessories.name import get_random_name
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, List, Mapping, Optional, Union
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,
@@ -29,7 +30,7 @@ class RunConfig:
     def __init__(
         self,
         fn: Callable[..., Any],
-        args: List[Any],
+        args: list[Any],
         kwargs: Mapping[Any, Any],
         execution_id: str,
     ):
@@ -112,8 +113,8 @@ class RecurringTask(BaseTask):
             should_execute=should_execute,
             return_upstream_result=return_upstream_result,
         )
-        self._triggers: List[AnyTask] = [trigger.copy() for trigger in triggers]
-        self._run_configs: List[RunConfig] = []
+        self._triggers: list[AnyTask] = [trigger.copy() for trigger in triggers]
+        self._run_configs: list[RunConfig] = []
         self._single_execution = single_execution
         self.print_err("Deprecated, please use Server instead")
 

zrb/task/remote_cmd_task.py

@@ -1,10 +1,11 @@
 import os
 import pathlib
+from collections.abc import Callable, Iterable
+from typing import Any, Optional, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, Optional, Union
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,

zrb/task/resource_maker.py

@@ -1,18 +1,11 @@
+from collections.abc import Callable, Iterable, Mapping
+from typing import Any, Optional, TypeVar, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.file.copy_tree import copy_tree
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import (
-    Any,
-    Callable,
-    Iterable,
-    JinjaTemplate,
-    List,
-    Mapping,
-    Optional,
-    TypeVar,
-    Union,
-)
+from zrb.helper.typing import JinjaTemplate
 from zrb.helper.util import (
     to_camel_case,
     to_capitalized_human_readable,
@@ -44,7 +37,7 @@ ReplacementMutator = Callable[[AnyTask, Replacement], Replacement]
 TResourceMaker = TypeVar("TResourceMaker", bound="ResourceMaker")
 
 
-def get_default_resource_skip_parsing() -> List[str]:
+def get_default_resource_skip_parsing() -> list[str]:
     return [
         "*.mp3",
         "*.pdf",
@@ -63,7 +56,7 @@ def get_default_resource_skip_parsing() -> List[str]:
     ]
 
 
-def get_default_resource_excludes() -> List[str]:
+def get_default_resource_excludes() -> list[str]:
     return [
         "*/.git",
         "*/__pycache__",

zrb/task/rsync_task.py

@@ -1,10 +1,12 @@
 import os
 import pathlib
+from collections.abc import Callable, Iterable
+from typing import Any, Optional, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, JinjaTemplate, Optional, Union
+from zrb.helper.typing import JinjaTemplate
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,

zrb/task/server.py

@@ -1,11 +1,12 @@
 import asyncio
 import copy
+from collections.abc import Callable, Iterable, Mapping
+from typing import Any, Optional, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.accessories.name import get_random_name
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, List, Mapping, Optional, Union
 from zrb.helper.util import to_kebab_case
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
@@ -31,32 +32,32 @@ logger.debug(colored("Loading zrb.task.server", attrs=["dark"]))
 class Controller:
     def __init__(
         self,
-        trigger: Union[AnyTask, List[AnyTask]],
-        action: Union[AnyTask, List[AnyTask]],
+        trigger: Union[AnyTask, list[AnyTask]],
+        action: Union[AnyTask, list[AnyTask]],
         name: Optional[str] = None,
     ):
         self._name = get_random_name() if name is None else name
         self._triggers = self._to_task_list(trigger)
         self._actions = self._to_task_list(action)
-        self._args: List[Any] = []
+        self._args: list[Any] = []
         self._kwargs: Mapping[str, Any] = {}
-        self._inputs: List[AnyInput] = []
-        self._envs: List[Env] = []
-        self._env_files: List[EnvFile] = []
+        self._inputs: list[AnyInput] = []
+        self._envs: list[Env] = []
+        self._env_files: list[EnvFile] = []
 
-    def set_args(self, args: List[Any]):
+    def set_args(self, args: list[Any]):
         self._args = args
 
     def set_kwargs(self, kwargs: Mapping[str, Any]):
         self._kwargs = kwargs
 
-    def set_inputs(self, inputs: List[AnyInput]):
+    def set_inputs(self, inputs: list[AnyInput]):
         self._inputs = inputs
 
-    def set_envs(self, envs: List[Env]):
+    def set_envs(self, envs: list[Env]):
         self._envs = envs
 
-    def set_env_files(self, env_files: List[EnvFile]):
+    def set_env_files(self, env_files: list[EnvFile]):
         self._env_files = env_files
 
     def get_original_env_files(self) -> Iterable[EnvFile]:
@@ -93,7 +94,7 @@ class Controller:
 
         return fn
 
-    def _to_task_list(self, tasks: Union[AnyTask, List[AnyTask]]) -> List[AnyTask]:
+    def _to_task_list(self, tasks: Union[AnyTask, list[AnyTask]]) -> list[AnyTask]:
         if isinstance(tasks, AnyTask):
             return [tasks.copy()]
         return [task.copy() for task in tasks]

zrb/task/time_watcher.py

@@ -1,21 +1,14 @@
 import asyncio
 import datetime
+from collections.abc import Callable, Iterable, Mapping
+from typing import Any, Optional, TypeVar, Union
 
 import croniter
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import (
-    Any,
-    Callable,
-    Iterable,
-    JinjaTemplate,
-    Mapping,
-    Optional,
-    TypeVar,
-    Union,
-)
+from zrb.helper.typing import JinjaTemplate
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,

zrb/task/watcher.py

@@ -1,11 +1,12 @@
 import asyncio
+from collections.abc import Callable, Iterable
+from typing import Any, Optional, Union
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.accessories.name import get_random_name
 from zrb.helper.callable import run_async
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, Optional, Union
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
     OnFailed,

zrb/task/wiki_task.py

@@ -1,11 +1,12 @@
 import os
+from collections.abc import Callable, Iterable, Mapping
+from typing import Any, Optional, Union
 
 from zrb.action.runner import Runner
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.task import show_lines
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, Iterable, List, Mapping, Optional, Union
 from zrb.helper.util import to_human_readable
 from zrb.task.any_task import AnyTask
 from zrb.task.any_task_event_handler import (
@@ -49,7 +50,7 @@ def create_wiki_tasks(
 ):
     abs_directory = os.path.abspath(directory)
     directory_structure = _get_directory_structure(abs_directory)
-    tasks: List[AnyTask] = []
+    tasks: list[AnyTask] = []
     for file_name in directory_structure["files"]:
         if not file_name.endswith(".md"):
             continue
@@ -120,7 +121,7 @@ def _create_function(directory: str, file_name: str) -> Callable[..., Any]:
     return fn
 
 
-def _get_directory_structure(path) -> Mapping[str, List[str]]:
+def _get_directory_structure(path) -> Mapping[str, list[str]]:
     contents = {"files": [], "dirs": []}
     for item in os.listdir(path):
         full_path = os.path.join(path, item)

zrb/task_env/env.py

@@ -1,10 +1,11 @@
 import os
+from typing import Optional
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.string.modification import double_quote
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import JinjaTemplate, Optional
+from zrb.helper.typing import JinjaTemplate
 from zrb.task_env.constant import RESERVED_ENV_NAMES
 
 logger.debug(colored("Loading zrb.task_env.env", attrs=["dark"]))

zrb/task_env/env_file.py

@@ -1,10 +1,11 @@
+from typing import Optional
+
 from dotenv import dotenv_values
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.string.modification import double_quote
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import List, Optional
 from zrb.task_env.constant import RESERVED_ENV_NAMES
 from zrb.task_env.env import Env
 
@@ -43,25 +44,25 @@ class EnvFile:
         self.__path = path
         self.__prefix = prefix.upper() if prefix is not None else None
         self.__should_render = should_render
-        self.__env_list: List[Env] = []
+        self.__env_list: list[Env] = []
         self.__env_list_fetched: bool = False
 
-    def get_envs(self) -> List[Env]:
+    def get_envs(self) -> list[Env]:
         """
         Retrieves a list of Env objects based on the environment file. If a prefix is provided, it is
         applied to the environment variable names.
 
         Returns:
-            List[Env]: A list of Env objects representing the environment variables defined in the file.
+            list[Env]: A list of Env objects representing the environment variables defined in the file.
 
         Examples:
             >>> from zrb import Env, EnvFile
             >>> env_file = EnvFile(path='some_file.env')
-            >>> envs: List[Env] = env_file.get_envs()
+            >>> envs: list[Env] = env_file.get_envs()
         """
         if self.__env_list_fetched:
             return self.__env_list
-        env_list: List[Env] = []
+        env_list: list[Env] = []
         env_map = dotenv_values(self.__path)
         for key, value in env_map.items():
             if key in RESERVED_ENV_NAMES:

zrb/task_group/group.py

@@ -1,9 +1,10 @@
+from typing import Optional, TypeVar
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.string.conversion import to_cli_name
 from zrb.helper.string.modification import double_quote
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import List, Optional, TypeVar
 from zrb.task.any_task import AnyTask
 
 logger.debug(colored("Loading zrb.task_group.group", attrs=["dark"]))
@@ -40,8 +41,8 @@ class Group:
         self._parent = parent
         if parent is not None:
             parent.__children.append(self)
-        self.__children: List[TGroup] = []
-        self.__tasks: List[AnyTask] = []
+        self.__children: list[TGroup] = []
+        self.__tasks: list[AnyTask] = []
 
     def get_parent(self) -> Optional[TGroup]:
         """
@@ -136,12 +137,12 @@ class Group:
         """
         self.__tasks.append(task)
 
-    def get_tasks(self) -> List[AnyTask]:
+    def get_tasks(self) -> list[AnyTask]:
         """
         Get direct Tasks under this Task Group.
 
         Returns:
-            List[AnyTask]: List of direct Tasks under this Task Group.
+            list[AnyTask]: list of direct Tasks under this Task Group.
 
         Examples:
             >>> from zrb import Group, Task
@@ -153,14 +154,14 @@ class Group:
         """
         return self.__tasks
 
-    def get_children(self) -> List[TGroup]:
+    def get_children(self) -> list[TGroup]:
         """
         Retrieves the list of direct subgroups under this group.
 
         Returns a list of immediate subgroups nested within this group, helping to understand the group's hierarchical structure.
 
         Returns:
-            List[Group]: List of direct subgroups under this Task group.
+            list[Group]: list of direct subgroups under this Task group.
 
         Examples:
             >>> from zrb import Group, Task

zrb/task_input/any_input.py

@@ -1,8 +1,9 @@
 from abc import ABC, abstractmethod
+from collections.abc import Mapping
+from typing import Any
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
-from zrb.helper.typing import Any, List, Mapping
 
 logger.debug(colored("Loading zrb.task_input.any_input", attrs=["dark"]))
 
@@ -40,12 +41,12 @@ class AnyInput(ABC):
         pass
 
     @abstractmethod
-    def get_param_decl(self) -> List[str]:
+    def get_param_decl(self) -> list[str]:
         """
         Fetches a list of parameter option associated with the input (i.e., `-f` or `--file`).
 
         Returns:
-            List[str]: A list containing strings of parameter options.
+            list[str]: A list containing strings of parameter options.
         """
         pass
 

zrb/task_input/base_input.py

@@ -1,10 +1,12 @@
+from collections.abc import Callable, Mapping
+from typing import Any, Optional, Union
+
 from zrb.config.config import SHOW_PROMPT
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.string.conversion import to_variable_name
 from zrb.helper.string.jinja import is_probably_jinja
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Callable, List, Mapping, Optional, Union
 from zrb.task_input.any_input import AnyInput
 from zrb.task_input.constant import RESERVED_INPUT_NAMES
 
@@ -115,8 +117,8 @@ class BaseInput(AnyInput):
             return self._default(self.__value_cache)
         return self._default
 
-    def get_param_decl(self) -> List[str]:
-        param_decl: List[str] = [f"--{self._name}"]
+    def get_param_decl(self) -> list[str]:
+        param_decl: list[str] = [f"--{self._name}"]
         if self._shortcut is not None:
             param_decl.append(f"-{self._shortcut}")
         return param_decl

zrb/task_input/bool_input.py

@@ -1,7 +1,8 @@
+from typing import Any, Optional, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.bool_input", attrs=["dark"]))

zrb/task_input/choice_input.py

@@ -1,9 +1,11 @@
+from collections.abc import Iterable
+from typing import Any, Optional, Union
+
 import click
 
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Iterable, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.choice_input", attrs=["dark"]))

zrb/task_input/float_input.py

@@ -1,7 +1,8 @@
+from typing import Any, Optional, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.float_input", attrs=["dark"]))

zrb/task_input/int_input.py

@@ -1,7 +1,8 @@
+from typing import Any, Optional, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.int_input", attrs=["dark"]))

zrb/task_input/multiline_input.py

@@ -1,9 +1,11 @@
+from collections.abc import Mapping
+from typing import Any, Optional, Union
+
 from zrb.config.config import DEFAULT_EDITOR
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.multiline import edit
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Mapping, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.multiline_input", attrs=["dark"]))

zrb/task_input/password_input.py

@@ -1,7 +1,8 @@
+from typing import Any, Optional, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.password_input", attrs=["dark"]))

zrb/task_input/str_input.py

@@ -1,7 +1,8 @@
+from typing import Any, Optional, Union
+
 from zrb.helper.accessories.color import colored
 from zrb.helper.log import logger
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Any, Optional, Union
 from zrb.task_input.base_input import BaseInput, InputCallback, InputDefault
 
 logger.debug(colored("Loading zrb.task_input.str_input", attrs=["dark"]))

{zrb-0.24.0.dist-info → zrb-0.26.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zrb
-Version: 0.24.0
+Version: 0.26.0
 Summary: A Framework to Enhance Your Workflow
 Home-page: https://github.com/state-alchemists/zrb
 License: AGPL-3.0-or-later