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

metaflow-stubs/runner/metaflow_runner.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.090451                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.739260                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -9,11 +9,12 @@ from __future__ import annotations
 import typing
 import metaflow
 if typing.TYPE_CHECKING:
-    import metaflow.client.core
-    import metaflow.runner.subprocess_manager
     import metaflow.runner.metaflow_runner
+    import metaflow.runner.subprocess_manager
+    import metaflow.client.core
 
 from ..client.core import Run as Run
+from ..client.core import Task as Task
 from ..plugins import get_runner_cli as get_runner_cli
 from .utils import temporary_fifo as temporary_fifo
 from .utils import handle_timeout as handle_timeout
@@ -24,27 +25,35 @@ from .subprocess_manager import SubprocessManager as SubprocessManager
 
 CLICK_API_PROCESS_CONFIG: bool
 
-class ExecutingRun(object, metaclass=type):
+class ExecutingProcess(object, metaclass=type):
     """
-    This class contains a reference to a `metaflow.Run` object representing
-    the currently executing or finished run, as well as metadata related
-    to the process.
+    This is a base class for `ExecutingRun` and `ExecutingTask` classes.
+    The `ExecutingRun` and `ExecutingTask` classes are returned by methods
+    in `Runner` and `NBRunner`, and they are subclasses of this class.
     
-    `ExecutingRun` is returned by methods in `Runner` and `NBRunner`. It is not
-    meant to be instantiated directly.
+    The `ExecutingRun` class for instance contains a reference to a `metaflow.Run`
+    object representing the currently executing or finished run, as well as the metadata
+    related to the process.
+    
+    Similarly, the `ExecutingTask` class contains a reference to a `metaflow.Task`
+    object representing the currently executing or finished task, as well as the metadata
+    related to the process.
+    
+    This class or its subclasses are not meant to be instantiated directly. The class
+    works as a context manager, allowing you to use a pattern like:
     
-    This class works as a context manager, allowing you to use a pattern like
     ```python
     with Runner(...).run() as running:
         ...
     ```
-    Note that you should use either this object as the context manager or
-    `Runner`, not both in a nested manner.
+    
+    Note that you should use either this object as the context manager or `Runner`, not both
+    in a nested manner.
     """
-    def __init__(self, runner: Runner, command_obj: metaflow.runner.subprocess_manager.CommandManager, run_obj: metaflow.client.core.Run):
+    def __init__(self, runner: Runner, command_obj: metaflow.runner.subprocess_manager.CommandManager):
         """
         Create a new ExecutingRun -- this should not be done by the user directly but
-        instead user Runner.run()
+        instead use Runner.run()
         
         Parameters
         ----------
@@ -56,11 +65,11 @@ class ExecutingRun(object, metaclass=type):
             Run object corresponding to this run.
         """
         ...
-    def __enter__(self) -> "ExecutingRun":
+    def __enter__(self) -> "ExecutingProcess":
         ...
     def __exit__(self, exc_type, exc_value, traceback):
         ...
-    def wait(self, timeout: typing.Optional[float] = None, stream: typing.Optional[str] = None) -> "ExecutingRun":
+    def wait(self, timeout: float | None = None, stream: str | None = None) -> "ExecutingProcess":
         """
         Wait for this run to finish, optionally with a timeout
         and optionally streaming its output.
@@ -79,12 +88,12 @@ class ExecutingRun(object, metaclass=type):
         
         Returns
         -------
-        ExecutingRun
+        ExecutingProcess
             This object, allowing you to chain calls.
         """
         ...
     @property
-    def returncode(self) -> typing.Optional[int]:
+    def returncode(self) -> int | None:
         """
         Gets the return code of the underlying subprocess. A non-zero
         code indicates a failure, `None` a currently executing run.
@@ -139,7 +148,7 @@ class ExecutingRun(object, metaclass=type):
             The current snapshot of stderr.
         """
         ...
-    def stream_log(self, stream: str, position: typing.Optional[int] = None) -> typing.Iterator[typing.Tuple[int, str]]:
+    def stream_log(self, stream: str, position: int | None = None) -> typing.Iterator[typing.Tuple[int, str]]:
         """
         Asynchronous iterator to stream logs from the subprocess line by line.
         
@@ -164,6 +173,68 @@ class ExecutingRun(object, metaclass=type):
         ...
     ...
 
+class ExecutingTask(ExecutingProcess, metaclass=type):
+    """
+    This class contains a reference to a `metaflow.Task` object representing
+    the currently executing or finished task, as well as metadata related
+    to the process.
+    `ExecutingTask` is returned by methods in `Runner` and `NBRunner`. It is not
+    meant to be instantiated directly.
+    This class works as a context manager, allowing you to use a pattern like
+    ```python
+    with Runner(...).spin() as running:
+        ...
+    ```
+    Note that you should use either this object as the context manager or
+    `Runner`, not both in a nested manner.
+    """
+    def __init__(self, runner: Runner, command_obj: metaflow.runner.subprocess_manager.CommandManager, task_obj: metaflow.client.core.Task):
+        """
+        Create a new ExecutingTask -- this should not be done by the user directly but
+        instead use Runner.spin()
+        Parameters
+        ----------
+        runner : Runner
+            Parent runner for this task.
+        command_obj : CommandManager
+            CommandManager containing the subprocess executing this task.
+        task_obj : Task
+            Task object corresponding to this task.
+        """
+        ...
+    ...
+
+class ExecutingRun(ExecutingProcess, metaclass=type):
+    """
+    This class contains a reference to a `metaflow.Run` object representing
+    the currently executing or finished run, as well as metadata related
+    to the process.
+    `ExecutingRun` is returned by methods in `Runner` and `NBRunner`. It is not
+    meant to be instantiated directly.
+    This class works as a context manager, allowing you to use a pattern like
+    ```python
+    with Runner(...).run() as running:
+        ...
+    ```
+    Note that you should use either this object as the context manager or
+    `Runner`, not both in a nested manner.
+    """
+    def __init__(self, runner: Runner, command_obj: metaflow.runner.subprocess_manager.CommandManager, run_obj: metaflow.client.core.Run):
+        """
+        Create a new ExecutingRun -- this should not be done by the user directly but
+        instead use Runner.run()
+        Parameters
+        ----------
+        runner : Runner
+            Parent runner for this run.
+        command_obj : CommandManager
+            CommandManager containing the subprocess executing this run.
+        run_obj : Run
+            Run object corresponding to this run.
+        """
+        ...
+    ...
+
 class RunnerMeta(type, metaclass=type):
     @staticmethod
     def __new__(mcs, name, bases, dct):
@@ -209,7 +280,7 @@ class Runner(object, metaclass=RunnerMeta):
         Additional arguments that you would pass to `python myflow.py` before
         the `run` command.
     """
-    def __init__(self, flow_file: str, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict[str, str]] = None, cwd: typing.Optional[str] = None, file_read_timeout: int = 3600, **kwargs):
+    def __init__(self, flow_file: str, show_output: bool = True, profile: str | None = None, env: typing.Dict[str, str] | None = None, cwd: str | None = None, file_read_timeout: int = 3600, **kwargs):
         ...
     def __enter__(self) -> "Runner":
         ...
@@ -236,6 +307,27 @@ class Runner(object, metaclass=RunnerMeta):
             ExecutingRun containing the results of the run.
         """
         ...
+    def _Runner__get_executing_task(self, attribute_file_fd, command_obj):
+        ...
+    def _Runner__async_get_executing_task(self, attribute_file_fd, command_obj):
+        ...
+    def spin(self, pathspec, **kwargs) -> ExecutingTask:
+        """
+        Blocking spin execution of the run.
+        This method will wait until the spun run has completed execution.
+        Parameters
+        ----------
+        pathspec : str
+            The pathspec of the step/task to spin.
+        **kwargs : Any
+            Additional arguments that you would pass to `python ./myflow.py` after
+            the `spin` command.
+        Returns
+        -------
+        ExecutingTask
+            ExecutingTask containing the results of the spun task.
+        """
+        ...
     def resume(self, **kwargs) -> ExecutingRun:
         """
         Blocking resume execution of the run.
@@ -291,6 +383,27 @@ class Runner(object, metaclass=RunnerMeta):
             ExecutingRun representing the resumed run that was started.
         """
         ...
+    def async_spin(self, pathspec, **kwargs) -> ExecutingTask:
+        """
+        Non-blocking spin execution of the run.
+        This method will return as soon as the spun task has launched.
+        
+        Note that this method is asynchronous and needs to be `await`ed.
+        
+        Parameters
+        ----------
+        pathspec : str
+            The pathspec of the step/task to spin.
+        **kwargs : Any
+            Additional arguments that you would pass to `python ./myflow.py` after
+            the `spin` command.
+        
+        Returns
+        -------
+        ExecutingTask
+            ExecutingTask representing the spun task that was started.
+        """
+        ...
     def __exit__(self, exc_type, exc_value, traceback):
         ...
     def __aexit__(self, exc_type, exc_value, traceback):

metaflow-stubs/runner/nbdeploy.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.091430                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.740266                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -58,7 +58,7 @@ class NBDeployer(object, metaclass=type):
         Additional arguments that you would pass to `python myflow.py` i.e. options
         listed in `python myflow.py --help`
     """
-    def __init__(self, flow, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, base_dir: typing.Optional[str] = None, file_read_timeout: int = 3600, **kwargs):
+    def __init__(self, flow, show_output: bool = True, profile: str | None = None, env: typing.Dict | None = None, base_dir: str | None = None, file_read_timeout: int = 3600, **kwargs):
         ...
     def __getattr__(self, name):
         """

metaflow-stubs/runner/nbrun.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.091055                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.739867                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -55,7 +55,7 @@ class NBRunner(object, metaclass=type):
         Additional arguments that you would pass to `python myflow.py` before
         the `run` command.
     """
-    def __init__(self, flow, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, base_dir: typing.Optional[str] = None, file_read_timeout: int = 3600, **kwargs):
+    def __init__(self, flow, show_output: bool = True, profile: str | None = None, env: typing.Dict | None = None, base_dir: str | None = None, file_read_timeout: int = 3600, **kwargs):
         ...
     def nbrun(self, **kwargs):
         """

metaflow-stubs/runner/subprocess_manager.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.106799                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.753684                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -34,7 +34,7 @@ class SubprocessManager(object, metaclass=type):
         ...
     def __aexit__(self, exc_type, exc_value, traceback):
         ...
-    def run_command(self, command: typing.List[str], env: typing.Optional[typing.Dict[str, str]] = None, cwd: typing.Optional[str] = None, show_output: bool = False) -> int:
+    def run_command(self, command: typing.List[str], env: typing.Dict[str, str] | None = None, cwd: str | None = None, show_output: bool = False) -> int:
         """
         Run a command synchronously and return its process ID.
         
@@ -63,7 +63,7 @@ class SubprocessManager(object, metaclass=type):
             The process ID of the subprocess.
         """
         ...
-    def async_run_command(self, command: typing.List[str], env: typing.Optional[typing.Dict[str, str]] = None, cwd: typing.Optional[str] = None) -> int:
+    def async_run_command(self, command: typing.List[str], env: typing.Dict[str, str] | None = None, cwd: str | None = None) -> int:
         """
         Run a command asynchronously and return its process ID.
         
@@ -84,7 +84,7 @@ class SubprocessManager(object, metaclass=type):
             The process ID of the subprocess.
         """
         ...
-    def get(self, pid: int) -> typing.Optional["CommandManager"]:
+    def get(self, pid: int) -> ForwardRef('CommandManager') | None:
         """
         Get one of the CommandManager managed by this SubprocessManager.
         
@@ -110,7 +110,7 @@ class CommandManager(object, metaclass=type):
     """
     A manager for an individual subprocess.
     """
-    def __init__(self, command: typing.List[str], env: typing.Optional[typing.Dict[str, str]] = None, cwd: typing.Optional[str] = None):
+    def __init__(self, command: typing.List[str], env: typing.Dict[str, str] | None = None, cwd: str | None = None):
         """
         Create a new CommandManager object.
         This does not run the process itself but sets it up.
@@ -131,7 +131,7 @@ class CommandManager(object, metaclass=type):
         ...
     def __aexit__(self, exc_type, exc_value, traceback):
         ...
-    def wait(self, timeout: typing.Optional[float] = None, stream: typing.Optional[str] = None):
+    def wait(self, timeout: float | None = None, stream: str | None = None):
         """
         Wait for the subprocess to finish, optionally with a timeout
         and optionally streaming its output.
@@ -173,7 +173,7 @@ class CommandManager(object, metaclass=type):
         logs (using `stream_logs`) or kill it (using `kill`).
         """
         ...
-    def stream_log(self, stream: str, position: typing.Optional[int] = None, timeout_per_line: typing.Optional[float] = None, log_write_delay: float = 0.01) -> typing.Iterator[typing.Tuple[int, str]]:
+    def stream_log(self, stream: str, position: int | None = None, timeout_per_line: float | None = None, log_write_delay: float = 0.01) -> typing.Iterator[typing.Tuple[int, str]]:
         """
         Stream logs from the subprocess line by line.
         

metaflow-stubs/runner/utils.pyi

@@ -1,17 +1,16 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.105575                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.752369                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.runner.click_api
     import metaflow.runner.subprocess_manager
-    import types
     import typing
+    import metaflow.runner.click_api
 
 
 TYPE_CHECKING: bool
@@ -29,7 +28,7 @@ def format_flowfile(cell):
 def check_process_exited(command_obj: "metaflow.runner.subprocess_manager.CommandManager") -> bool:
     ...
 
-def temporary_fifo() -> typing.ContextManager[typing.Tuple[str, int], types.bool | None]:
+def temporary_fifo() -> typing.ContextManager[typing.Tuple[str, int], bool | None]:
     """
     Create and open the read side of a temporary FIFO in a non-blocking mode.
     

metaflow-stubs/system/__init__.pyi

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

metaflow-stubs/system/system_logger.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.124640                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.772577                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -9,7 +9,6 @@ from __future__ import annotations
 import typing
 if typing.TYPE_CHECKING:
     import metaflow.event_logger
-    import typing
 
 
 class SystemLogger(object, metaclass=type):
@@ -20,9 +19,9 @@ class SystemLogger(object, metaclass=type):
     def init_system_logger(self, flow_name: str, logger: "metaflow.event_logger.NullEventLogger"):
         ...
     @property
-    def logger(self) -> typing.Optional["metaflow.event_logger.NullEventLogger"]:
+    def logger(self) -> ForwardRef('metaflow.event_logger.NullEventLogger') | None:
         ...
-    def log_event(self, level: str, module: str, name: str, payload: typing.Optional[typing.Any] = None):
+    def log_event(self, level: str, module: str, name: str, payload: typing.Any | None = None):
         """
         Log an event to the event logger.
         

metaflow-stubs/system/system_monitor.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.124249                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.772109                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -19,7 +19,7 @@ class SystemMonitor(object, metaclass=type):
     def init_system_monitor(self, flow_name: str, monitor: "metaflow.monitor.NullMonitor"):
         ...
     @property
-    def monitor(self) -> typing.Optional["metaflow.monitor.NullMonitor"]:
+    def monitor(self) -> ForwardRef('metaflow.monitor.NullMonitor') | None:
         ...
     def measure(self, name: str):
         """

metaflow-stubs/tagging_util.pyi

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

metaflow-stubs/tuple_util.pyi

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

metaflow-stubs/user_configs/__init__.pyi

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

metaflow-stubs/user_configs/config_options.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.100332                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.746732                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -10,7 +10,6 @@ import typing
 import metaflow
 if typing.TYPE_CHECKING:
     import metaflow._vendor.click.types
-    import typing
 
 from .._vendor import click as click
 from .config_parameters import ConfigValue as ConfigValue
@@ -48,7 +47,7 @@ class MultipleTuple(metaflow._vendor.click.types.Tuple, metaclass=type):
     ...
 
 class ConfigInput(object, metaclass=type):
-    def __init__(self, req_configs: typing.List[str], defaults: typing.Dict[str, typing.Tuple[typing.Union[str, typing.Dict[typing.Any, typing.Any]], bool]], parsers: typing.Dict[str, typing.Union[str, typing.Callable[[str], typing.Dict[typing.Any, typing.Any]]]]):
+    def __init__(self, req_configs: typing.List[str], defaults: typing.Dict[str, typing.Tuple[str | typing.Dict[typing.Any, typing.Any], bool]], parsers: typing.Dict[str, str | typing.Callable[[str], typing.Dict[typing.Any, typing.Any]]]):
         ...
     @staticmethod
     def make_key_name(name: str) -> str:
@@ -57,9 +56,9 @@ class ConfigInput(object, metaclass=type):
     def set_config_file(cls, config_file: str):
         ...
     @classmethod
-    def get_config(cls, config_name: str) -> typing.Optional[typing.Dict[typing.Any, typing.Any]]:
+    def get_config(cls, config_name: str) -> typing.Dict[typing.Any, typing.Any] | None:
         ...
-    def process_configs(self, flow_name: str, param_name: str, param_value: typing.Dict[str, typing.Optional[str]], quiet: bool, datastore: str, click_obj: typing.Optional[typing.Any] = None):
+    def process_configs(self, flow_name: str, param_name: str, param_value: typing.Dict[str, str | None], quiet: bool, datastore: str, click_obj: typing.Any | None = None):
         ...
     def process_configs_click(self, ctx, param, value):
         ...

metaflow-stubs/user_configs/config_parameters.pyi

@@ -1,21 +1,21 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.073240                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.719500                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
+import typing
+import abc
 import metaflow
 import collections
-import abc
-import typing
 if typing.TYPE_CHECKING:
+    import metaflow.user_configs.config_parameters
     import metaflow.parameters
+    import typing
     import abc
     import collections.abc
-    import metaflow.user_configs.config_parameters
-    import typing
 
 from ..exception import MetaflowException as MetaflowException
 from ..parameters import Parameter as Parameter
@@ -39,7 +39,7 @@ class ConfigValue(collections.abc.Mapping, dict, metaclass=abc.ABCMeta):
     
     All "keys"" need to be valid Python identifiers
     """
-    def __init__(self, data: typing.Union["ConfigValue", typing.Dict[str, typing.Any]]):
+    def __init__(self, data: ForwardRef('ConfigValue') | typing.Dict[str, typing.Any]):
         ...
     @classmethod
     def fromkeys(cls, iterable: typing.Iterable, value: typing.Any = None) -> "ConfigValue":
@@ -163,7 +163,7 @@ class DelayEvaluator(collections.abc.Mapping, metaclass=abc.ABCMeta):
         special handling in whatever this is being unpacked into, specifically the handling
         of _unpacked_delayed_*
     """
-    def __init__(self, ex: str, saved_globals: typing.Optional[typing.Dict[str, typing.Any]] = None):
+    def __init__(self, ex: str, saved_globals: typing.Dict[str, typing.Any] | None = None):
         ...
     def __copy__(self):
         ...
@@ -255,7 +255,7 @@ class Config(metaflow.parameters.Parameter, collections.abc.Mapping, metaclass=a
     show_default : bool, default True
         If True, show the default value in the help text.
     """
-    def __init__(self, name: str, default: typing.Union[str, typing.Callable[[metaflow.parameters.ParameterContext], str], None] = None, default_value: typing.Union[str, typing.Dict[str, typing.Any], typing.Callable[[metaflow.parameters.ParameterContext], typing.Union[str, typing.Dict[str, typing.Any]]], None] = None, help: typing.Optional[str] = None, required: typing.Optional[bool] = None, parser: typing.Union[str, typing.Callable[[str], typing.Dict[typing.Any, typing.Any]], None] = None, **kwargs: typing.Dict[str, str]):
+    def __init__(self, name: str, default: str | typing.Callable[[metaflow.parameters.ParameterContext], str] | None = None, default_value: str | typing.Dict[str, typing.Any] | typing.Callable[[metaflow.parameters.ParameterContext], str | typing.Dict[str, typing.Any]] | None = None, help: str | None = None, required: bool | None = None, parser: str | typing.Callable[[str], typing.Dict[typing.Any, typing.Any]] | None = None, **kwargs: typing.Dict[str, str]):
         ...
     def load_parameter(self, v):
         ...

metaflow-stubs/user_decorators/__init__.pyi

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

metaflow-stubs/user_decorators/common.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.18.12                                                                                #
-# Generated on 2025-10-15T20:44:18.101761                                                            #
+# MF version: 2.19.0                                                                                 #
+# Generated on 2025-10-26T02:29:29.748520                                                            #
 ######################################################################################################
 
 from __future__ import annotations
@@ -12,17 +12,17 @@ import typing
 class ClassPath_Trie(object, metaclass=type):
     def __init__(self):
         ...
-    def init(self, initial_nodes: typing.Optional[typing.List[typing.Tuple[str, type]]] = None):
+    def init(self, initial_nodes: typing.List[typing.Tuple[str, type]] | None = None):
         ...
     def insert(self, classpath_name: str, value: type):
         ...
-    def search(self, classpath_name: str) -> typing.Optional[type]:
+    def search(self, classpath_name: str) -> type | None:
         ...
     def remove(self, classpath_name: str):
         ...
-    def unique_prefix_value(self, classpath_name: str) -> typing.Optional[type]:
+    def unique_prefix_value(self, classpath_name: str) -> type | None:
         ...
-    def unique_prefix_for_type(self, value: type) -> typing.Optional[str]:
+    def unique_prefix_for_type(self, value: type) -> str | None:
         ...
     def get_unique_prefixes(self) -> typing.Dict[str, type]:
         """