metaflow-stubs 2.18.12__py2.py3-none-any.whl → 2.19.0__py2.py3-none-any.whl

metaflow-stubs/cards.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.083586                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.730941                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/cli.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.093084                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.741868                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/cli_components/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.092012                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.740568                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/cli_components/utils.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.125046                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.771560                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/client/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.083854                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.731236                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -15,6 +15,7 @@ from .core import default_namespace as default_namespace
 from .core import metadata as metadata
 from .core import get_metadata as get_metadata
 from .core import default_metadata as default_metadata
+from .core import inspect_spin as inspect_spin
 from .core import Metaflow as Metaflow
 from .core import Flow as Flow
 from .core import Run as Run

metaflow-stubs/client/core.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.089101                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.737200                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -9,12 +9,11 @@ from __future__ import annotations
 import typing
 import metaflow
 if typing.TYPE_CHECKING:
-    import tarfile
-    import tempfile
-    import datetime
-    import metaflow.events
     import metaflow.client.core
     import typing
+    import datetime
+    import tarfile
+    import tempfile
 
 from ..metaflow_current import current as current
 from ..events import Trigger as Trigger
@@ -126,7 +125,7 @@ def default_metadata() -> str:
     """
     ...
 
-def namespace(ns: typing.Optional[str]) -> typing.Optional[str]:
+def namespace(ns: str | None) -> str | None:
     """
     Switch namespace to the one provided.
     
@@ -146,7 +145,7 @@ def namespace(ns: typing.Optional[str]) -> typing.Optional[str]:
     """
     ...
 
-def get_namespace() -> typing.Optional[str]:
+def get_namespace() -> str | None:
     """
     Return the current namespace that is currently being used to filter objects.
     
@@ -171,6 +170,18 @@ def default_namespace() -> str:
     """
     ...
 
+def inspect_spin(datastore_root: str = '.'):
+    """
+    Set metadata provider to spin metadata so that users can inspect spin
+    steps, tasks, and artifacts.
+    
+    Parameters
+    ----------
+    datastore_root : str, default "."
+        The root path to the spin datastore.
+    """
+    ...
+
 class MetaflowObject(object, metaclass=type):
     """
     Base class for all Metaflow objects.
@@ -211,7 +222,7 @@ class MetaflowObject(object, metaclass=type):
         Pathspec of the original object this object was cloned from (in the case of a resume).
         None if not applicable.
     """
-    def __init__(self, pathspec: typing.Optional[str] = None, attempt: typing.Optional[int] = None, _object: typing.Optional["MetaflowObject"] = None, _parent: typing.Optional["MetaflowObject"] = None, _namespace_check: bool = True, _metaflow: typing.Optional["Metaflow"] = None, _current_namespace: typing.Optional[str] = None, _current_metadata: typing.Optional[str] = None):
+    def __init__(self, pathspec: str | None = None, attempt: int | None = None, _object: ForwardRef('MetaflowObject') | None = None, _parent: ForwardRef('MetaflowObject') | None = None, _namespace_check: bool = True, _metaflow: ForwardRef('Metaflow') | None = None, _current_namespace: str | None = None, _current_metadata: str | None = None):
         ...
     def __iter__(self) -> typing.Iterator["MetaflowObject"]:
         """
@@ -344,7 +355,7 @@ class MetaflowObject(object, metaclass=type):
         """
         ...
     @property
-    def origin_pathspec(self) -> typing.Optional[str]:
+    def origin_pathspec(self) -> str | None:
         """
         The pathspec of the object from which the current object was cloned.
         
@@ -354,7 +365,7 @@ class MetaflowObject(object, metaclass=type):
         """
         ...
     @property
-    def parent(self) -> typing.Optional["MetaflowObject"]:
+    def parent(self) -> ForwardRef('MetaflowObject') | None:
         """
         Returns the parent object of this object or None if none exists.
         
@@ -672,7 +683,27 @@ class Task(MetaflowObject, metaclass=type):
     environment_info : Dict[str, str]
         Information about the execution environment.
     """
-    def __init__(self, *args, **kwargs):
+    @property
+    def parent_task_pathspecs(self) -> typing.Iterator[str]:
+        """
+        Yields pathspecs of all parent tasks of the current task.
+        
+        Yields
+        ------
+        str
+            Pathspec of the parent task of the current task
+        """
+        ...
+    @property
+    def child_task_pathspecs(self) -> typing.Iterator[str]:
+        """
+        Yields pathspecs of all child tasks of the current task.
+        
+        Yields
+        ------
+        str
+            Pathspec of the child task of the current task
+        """
         ...
     @property
     def parent_tasks(self) -> typing.Iterator["Task"]:
@@ -688,7 +719,7 @@ class Task(MetaflowObject, metaclass=type):
     @property
     def child_tasks(self) -> typing.Iterator["Task"]:
         """
-        Yield all child tasks of the current task if one exists.
+        Yields all child tasks of the current task if one exists.
         
         Yields
         ------
@@ -728,7 +759,7 @@ class Task(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def index(self) -> typing.Optional[int]:
+    def index(self) -> int | None:
         """
         Returns the index of the innermost foreach loop if this task is run inside at least
         one foreach.
@@ -805,7 +836,7 @@ class Task(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def exception(self) -> typing.Optional[typing.Any]:
+    def exception(self) -> typing.Any | None:
         """
         Returns the exception that caused the task to fail, if any.
         
@@ -820,7 +851,7 @@ class Task(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def finished_at(self) -> typing.Optional[datetime.datetime]:
+    def finished_at(self) -> datetime.datetime | None:
         """
         Returns the datetime object of when the task finished (successfully or not).
         
@@ -834,7 +865,7 @@ class Task(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def runtime_name(self) -> typing.Optional[str]:
+    def runtime_name(self) -> str | None:
         """
         Returns the name of the runtime this task executed on.
         
@@ -926,7 +957,7 @@ class Task(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def code(self) -> typing.Optional[metaflow.client.core.MetaflowCode]:
+    def code(self) -> metaflow.client.core.MetaflowCode | None:
         """
         Returns the MetaflowCode object for this task, if present.
         
@@ -953,7 +984,7 @@ class Task(MetaflowObject, metaclass=type):
             Dictionary describing the environment
         """
         ...
-    def loglines(self, stream: str, as_unicode: bool = True, meta_dict: typing.Optional[typing.Dict[str, typing.Any]] = None) -> typing.Iterator[typing.Tuple[datetime.datetime, str]]:
+    def loglines(self, stream: str, as_unicode: bool = True, meta_dict: typing.Dict[str, typing.Any] | None = None) -> typing.Iterator[typing.Tuple[datetime.datetime, str]]:
         """
         Return an iterator over (utc_timestamp, logline) tuples.
         
@@ -1026,7 +1057,7 @@ class Step(MetaflowObject, metaclass=type):
         Information about the execution environment.
     """
     @property
-    def task(self) -> typing.Optional[metaflow.client.core.Task]:
+    def task(self) -> metaflow.client.core.Task | None:
         """
         Returns a Task object belonging to this step.
         
@@ -1060,7 +1091,7 @@ class Step(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def control_task(self) -> typing.Optional[metaflow.client.core.Task]:
+    def control_task(self) -> metaflow.client.core.Task | None:
         """
         [Unpublished API - use with caution!]
         
@@ -1127,7 +1158,7 @@ class Step(MetaflowObject, metaclass=type):
     def __setstate__(self, state):
         ...
     @property
-    def finished_at(self) -> typing.Optional[datetime.datetime]:
+    def finished_at(self) -> datetime.datetime | None:
         """
         Returns the datetime object of when the step finished (successfully or not).
         
@@ -1141,7 +1172,7 @@ class Step(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def environment_info(self) -> typing.Optional[typing.Dict[str, typing.Any]]:
+    def environment_info(self) -> typing.Dict[str, typing.Any] | None:
         """
         Returns information about the environment that was used to execute this step. As an
         example, if the Conda environment is selected, this will return information about the
@@ -1223,7 +1254,7 @@ class Run(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def code(self) -> typing.Optional[metaflow.client.core.MetaflowCode]:
+    def code(self) -> metaflow.client.core.MetaflowCode | None:
         """
         Returns the MetaflowCode object for this run, if present.
         Code is packed if atleast one `Step` runs remotely, else None is returned.
@@ -1235,7 +1266,7 @@ class Run(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def data(self) -> typing.Optional[metaflow.client.core.MetaflowData]:
+    def data(self) -> metaflow.client.core.MetaflowData | None:
         """
         Returns a container of data artifacts produced by this run.
         
@@ -1279,7 +1310,7 @@ class Run(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def finished_at(self) -> typing.Optional[datetime.datetime]:
+    def finished_at(self) -> datetime.datetime | None:
         """
         Returns the datetime object of when the run finished (successfully or not).
         
@@ -1293,7 +1324,7 @@ class Run(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def end_task(self) -> typing.Optional[metaflow.client.core.Task]:
+    def end_task(self) -> metaflow.client.core.Task | None:
         """
         Returns the Task corresponding to the 'end' step.
         
@@ -1418,7 +1449,7 @@ class Run(MetaflowObject, metaclass=type):
     def __setstate__(self, state):
         ...
     @property
-    def trigger(self) -> typing.Optional[metaflow.events.Trigger]:
+    def trigger(self) -> metaflow.events.Trigger | None:
         """
         Returns a container of events that triggered this run.
         
@@ -1447,7 +1478,7 @@ class Flow(MetaflowObject, metaclass=type):
     def __init__(self, *args, **kwargs):
         ...
     @property
-    def latest_run(self) -> typing.Optional[metaflow.client.core.Run]:
+    def latest_run(self) -> metaflow.client.core.Run | None:
         """
         Returns the latest run (either in progress or completed) of this flow.
         
@@ -1461,7 +1492,7 @@ class Flow(MetaflowObject, metaclass=type):
         """
         ...
     @property
-    def latest_successful_run(self) -> typing.Optional[metaflow.client.core.Run]:
+    def latest_successful_run(self) -> metaflow.client.core.Run | None:
         """
         Returns the latest successful run of this flow.
         
@@ -1543,7 +1574,7 @@ class Metaflow(object, metaclass=type):
         flows present in the current namespace will be returned. A `Flow` is present in a namespace
         if it has at least one run in the namespace.
     """
-    def __init__(self, _current_metadata: typing.Optional[str] = None):
+    def __init__(self, _current_metadata: str | None = None):
         ...
     @property
     def flows(self) -> typing.List[metaflow.client.core.Flow]:

metaflow-stubs/client/filecache.pyi

@@ -1,16 +1,19 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.123701                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.771101                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
+import abc
 import metaflow
 import typing
 if typing.TYPE_CHECKING:
     import metaflow.datastore.content_addressed_store
     import metaflow.exception
+    import abc
+    import metaflow.datastore.flow_datastore
 
 from ..exception import MetaflowException as MetaflowException
 
@@ -20,8 +23,6 @@ CLIENT_CACHE_MAX_SIZE: int
 
 CLIENT_CACHE_MAX_FLOWDATASTORE_COUNT: int
 
-CLIENT_CACHE_MAX_TASKDATASTORE_COUNT: int
-
 DATASTORES: list
 
 NEW_FILE_QUARANTINE: int
@@ -70,6 +71,21 @@ class FileCache(object, metaclass=type):
         ...
     def read_file(self, path):
         ...
+    @staticmethod
+    def flow_ds_id(ds_type, ds_root, flow_name):
+        ...
+    @staticmethod
+    def task_ds_id(ds_type, ds_root, flow_name, run_id, step_name, task_id, attempt):
+        ...
+    ...
+
+class TaskMetadataCache(metaflow.datastore.flow_datastore.MetadataCache, metaclass=abc.ABCMeta):
+    def __init__(self, filecache, ds_type, ds_root, flow_name):
+        ...
+    def load_metadata(self, run_id, step_name, task_id, attempt):
+        ...
+    def store_metadata(self, run_id, step_name, task_id, attempt, metadata_dict):
+        ...
     ...
 
 class FileBlobCache(metaflow.datastore.content_addressed_store.BlobCache, metaclass=type):

metaflow-stubs/events.pyi

@@ -1,14 +1,13 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.077096                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.724449                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.events
     import metaflow
 
 
@@ -58,7 +57,7 @@ class Trigger(object, metaclass=type):
     def from_runs(cls, run_objs: typing.List["metaflow.Run"]):
         ...
     @property
-    def event(self) -> typing.Optional[metaflow.events.MetaflowEvent]:
+    def event(self) -> metaflow.events.MetaflowEvent | None:
         """
         The `MetaflowEvent` object corresponding to the triggering event.
         
@@ -71,7 +70,7 @@ class Trigger(object, metaclass=type):
         """
         ...
     @property
-    def events(self) -> typing.Optional[typing.List[metaflow.events.MetaflowEvent]]:
+    def events(self) -> typing.List[metaflow.events.MetaflowEvent] | None:
         """
         The list of `MetaflowEvent` objects correspondings to all the triggering events.
         
@@ -82,7 +81,7 @@ class Trigger(object, metaclass=type):
         """
         ...
     @property
-    def run(self) -> typing.Optional["metaflow.Run"]:
+    def run(self) -> ForwardRef('metaflow.Run') | None:
         """
         The corresponding `Run` object if the triggering event is a Metaflow run.
         
@@ -96,7 +95,7 @@ class Trigger(object, metaclass=type):
         """
         ...
     @property
-    def runs(self) -> typing.Optional[typing.List["metaflow.Run"]]:
+    def runs(self) -> typing.List[ForwardRef('metaflow.Run')] | None:
         """
         The list of `Run` objects in the triggering events.
         Returns `None` if none of the triggering events are `Run` objects.
@@ -107,7 +106,7 @@ class Trigger(object, metaclass=type):
             List of runs that triggered this run, if applicable.
         """
         ...
-    def __getitem__(self, key: str) -> typing.Union["metaflow.Run", metaflow.events.MetaflowEvent]:
+    def __getitem__(self, key: str) -> ForwardRef('metaflow.Run') | metaflow.events.MetaflowEvent:
         """
         If triggering events are runs, `key` corresponds to the flow name of the triggering run.
         Otherwise, `key` corresponds to the event name and a `MetaflowEvent` object is returned.

metaflow-stubs/exception.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.064961                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.711233                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/flowspec.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.070748                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.717164                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -10,10 +10,9 @@ import typing
 import metaflow
 if typing.TYPE_CHECKING:
     import metaflow.flowspec
-    import typing
-    import metaflow.unbounded_foreach
     import metaflow.exception
     import metaflow.datastore.inputs
+    import metaflow.unbounded_foreach
 
 from . import parameters as parameters
 from .parameters import DelayedEvaluationParameter as DelayedEvaluationParameter
@@ -108,7 +107,7 @@ class FlowSpec(object, metaclass=FlowSpecMeta):
         """
         ...
     @property
-    def index(self) -> typing.Optional[int]:
+    def index(self) -> int | None:
         """
         The index of this foreach branch.
         
@@ -126,7 +125,7 @@ class FlowSpec(object, metaclass=FlowSpecMeta):
         """
         ...
     @property
-    def input(self) -> typing.Optional[typing.Any]:
+    def input(self) -> typing.Any | None:
         """
         The value of the foreach artifact in this foreach branch.
         
@@ -143,7 +142,7 @@ class FlowSpec(object, metaclass=FlowSpecMeta):
             Input passed to the foreach task.
         """
         ...
-    def foreach_stack(self) -> typing.Optional[typing.List[typing.Tuple[int, int, typing.Any]]]:
+    def foreach_stack(self) -> typing.List[typing.Tuple[int, int, typing.Any]] | None:
         """
         Returns the current stack of foreach indexes and values for the current step.
         
@@ -191,7 +190,7 @@ class FlowSpec(object, metaclass=FlowSpecMeta):
             An array describing the current stack of foreach steps.
         """
         ...
-    def merge_artifacts(self, inputs: metaflow.datastore.inputs.Inputs, exclude: typing.Optional[typing.List[str]] = None, include: typing.Optional[typing.List[str]] = None):
+    def merge_artifacts(self, inputs: metaflow.datastore.inputs.Inputs, exclude: typing.List[str] | None = None, include: typing.List[str] | None = None):
         """
         Helper function for merging artifacts in a join step.
         

metaflow-stubs/generated_for.txt

@@ -1 +1 @@
-2.18.12 2025-10-15T20:44:18.059302
+2.19.0 2025-10-26T02:29:29.705523

metaflow-stubs/includefile.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.082783                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.730109                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -9,9 +9,9 @@ from __future__ import annotations
 import typing
 import metaflow
 if typing.TYPE_CHECKING:
-    import metaflow.parameters
     import metaflow._vendor.click.types
     import typing
+    import metaflow.parameters
 
 from ._vendor import click as click
 from ._vendor import yaml as yaml
@@ -86,7 +86,7 @@ class IncludeFile(metaflow.parameters.Parameter, metaclass=type):
         be able to parse the file contents. If the name starts with a ".", it is assumed
         to be relative to "metaflow".
     """
-    def __init__(self, name: str, required: typing.Optional[bool] = None, is_text: typing.Optional[bool] = None, encoding: typing.Optional[str] = None, help: typing.Optional[str] = None, parser: typing.Union[str, typing.Callable[[str], typing.Any], None] = None, **kwargs: typing.Dict[str, str]):
+    def __init__(self, name: str, required: bool | None = None, is_text: bool | None = None, encoding: str | None = None, help: str | None = None, parser: str | typing.Callable[[str], typing.Any] | None = None, **kwargs: typing.Dict[str, str]):
         ...
     def init(self, ignore_errors = False):
         ...

metaflow-stubs/meta_files.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.060133                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.706341                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.069517                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.715855                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/heartbeat.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.104569                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.751296                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/metadata.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.104028                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.750737                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/metadata_provider/util.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.104267                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.750973                                                            #
 ######################################################################################################
 
 from __future__ import annotations