ob-metaflow-stubs 6.0.4.7__py2.py3-none-any.whl → 6.0.4.8rc1__py2.py3-none-any.whl

metaflow-stubs/runner/deployer.pyi

@@ -1,20 +1,20 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:15.019088                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.563921                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
-import typing
 import metaflow
+import typing
 if typing.TYPE_CHECKING:
-    import metaflow
-    import metaflow.runner.deployer
     import metaflow.plugins.argo.argo_workflows_deployer
-    import metaflow.plugins.aws.step_functions.step_functions_deployer_objects
-    import metaflow.plugins.aws.step_functions.step_functions_deployer
+    import metaflow.runner.deployer
     import metaflow.plugins.argo.argo_workflows_deployer_objects
+    import metaflow
+    import metaflow.plugins.aws.step_functions.step_functions_deployer
+    import metaflow.plugins.aws.step_functions.step_functions_deployer_objects
 
 from ..exception import MetaflowNotFound as MetaflowNotFound
 

metaflow-stubs/runner/deployer_impl.pyi

@@ -1,15 +1,15 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.888081                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.428436                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import typing
     import metaflow.runner.deployer
+    import typing
 
 from .subprocess_manager import SubprocessManager as SubprocessManager
 from .utils import get_lower_level_group as get_lower_level_group

metaflow-stubs/runner/metaflow_runner.pyi

@@ -1,17 +1,17 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.866253                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.401226                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
-import typing
 import metaflow
+import typing
 if typing.TYPE_CHECKING:
-    import metaflow.runner.subprocess_manager
     import metaflow.runner.metaflow_runner
     import metaflow.client.core
+    import metaflow.runner.subprocess_manager
 
 from ..client.core import Run as Run
 from ..plugins import get_runner_cli as get_runner_cli

metaflow-stubs/runner/nbdeploy.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.867105                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.402102                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/runner/nbrun.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.866771                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.401743                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/runner/subprocess_manager.pyi

@@ -1,13 +1,14 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.887568                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.427891                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 
+from ..packaging_sys import MetaflowCodeContent as MetaflowCodeContent
 from .utils import check_process_exited as check_process_exited
 
 def kill_processes_and_descendants(pids: typing.List[str], termination_timeout: float):

metaflow-stubs/runner/utils.pyi

@@ -1,16 +1,16 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.886477                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.426771                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.runner.subprocess_manager
     import metaflow.runner.click_api
     import typing
+    import metaflow.runner.subprocess_manager
 
 
 TYPE_CHECKING: bool

metaflow-stubs/system/__init__.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.873301                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.408392                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/system/system_logger.pyi

@@ -1,15 +1,15 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.906250                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.446741                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.event_logger
     import typing
+    import metaflow.event_logger
 
 
 class SystemLogger(object, metaclass=type):

metaflow-stubs/system/system_monitor.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.905927                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.446413                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/tagging_util.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.852183                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.386132                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/tuple_util.pyi

@@ -1,7 +1,7 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.857255                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.391569                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/user_configs/__init__.pyi

@@ -1,13 +1,12 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.851883                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.385563                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
 
 from . import config_parameters as config_parameters
-from . import config_decorators as config_decorators
 from . import config_options as config_options
 

metaflow-stubs/user_configs/config_options.pyi

@@ -1,13 +1,13 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.879331                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.417229                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
-import typing
 import metaflow
+import typing
 if typing.TYPE_CHECKING:
     import typing
     import metaflow._vendor.click.types
@@ -16,11 +16,10 @@ from .._vendor import click as click
 from .config_parameters import ConfigValue as ConfigValue
 from ..exception import MetaflowException as MetaflowException
 from ..exception import MetaflowInternalError as MetaflowInternalError
+from ..packaging_sys import MetaflowCodeContent as MetaflowCodeContent
 from ..parameters import DeployTimeField as DeployTimeField
 from ..parameters import ParameterContext as ParameterContext
 
-CONFIG_FILE: str
-
 class ConvertPath(metaflow._vendor.click.types.Path, metaclass=type):
     def convert(self, value, param, ctx):
         ...

metaflow-stubs/user_configs/config_parameters.pyi

@@ -1,21 +1,21 @@
 ######################################################################################################
 #                                 Auto-generated Metaflow stub file                                  #
-# MF version: 2.15.21.4+obcheckpoint(0.2.4);ob(v1)                                                   #
-# Generated on 2025-07-25T18:05:14.855195                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.389217                                                            #
 ######################################################################################################
 
 from __future__ import annotations
 
-import typing
 import metaflow
+import typing
 import collections
 import abc
 if typing.TYPE_CHECKING:
-    import metaflow.user_configs.config_parameters
-    import abc
-    import typing
     import collections.abc
+    import typing
     import metaflow.parameters
+    import abc
+    import metaflow.user_configs.config_parameters
 
 from ..exception import MetaflowException as MetaflowException
 from ..parameters import Parameter as Parameter
@@ -23,8 +23,6 @@ from ..parameters import ParameterContext as ParameterContext
 
 TYPE_CHECKING: bool
 
-CONFIG_FILE: str
-
 UNPACK_KEY: str
 
 def dump_config_values(flow: "FlowSpec"):

metaflow-stubs/user_decorators/__init__.pyi

@@ -0,0 +1,15 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.385782                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+
+from . import mutable_flow as mutable_flow
+from . import common as common
+from . import user_step_decorator as user_step_decorator
+from . import mutable_step as mutable_step
+from . import user_flow_decorator as user_flow_decorator
+

metaflow-stubs/user_decorators/common.pyi

@@ -0,0 +1,38 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.418459                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+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 insert(self, classpath_name: str, value: type):
+        ...
+    def search(self, classpath_name: str) -> typing.Optional[type]:
+        ...
+    def remove(self, classpath_name: str):
+        ...
+    def unique_prefix_value(self, classpath_name: str) -> typing.Optional[type]:
+        ...
+    def unique_prefix_for_type(self, value: type) -> typing.Optional[str]:
+        ...
+    def get_unique_prefixes(self) -> typing.Dict[str, type]:
+        """
+        Get all unique prefixes in the trie.
+        
+        Returns
+        -------
+        List[str]
+            A list of unique prefixes.
+        """
+        ...
+    ...
+

metaflow-stubs/user_decorators/mutable_flow.pyi

@@ -0,0 +1,223 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.418073                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+import typing
+if typing.TYPE_CHECKING:
+    import functools
+    import metaflow.user_decorators.mutable_step
+    import typing
+    import metaflow.parameters
+    import metaflow.flowspec
+    import metaflow.user_configs.config_parameters
+
+from ..exception import MetaflowException as MetaflowException
+from ..user_configs.config_parameters import ConfigValue as ConfigValue
+
+TYPE_CHECKING: bool
+
+class MutableFlow(object, metaclass=type):
+    def __init__(self, flow_spec: "metaflow.flowspec.FlowSpec", pre_mutate: bool = False, statically_defined: bool = False, inserted_by: typing.Optional[str] = None):
+        ...
+    @property
+    def decorator_specs(self) -> typing.Generator[typing.Tuple[str, str, typing.List[typing.Any], typing.Dict[str, typing.Any]], None, None]:
+        """
+        Iterate over all the decorator specifications of this flow. Note that the same
+        type of decorator may be present multiple times and no order is guaranteed.
+        
+        The returned tuple contains:
+        - The decorator's name (shortest possible)
+        - The decorator's fully qualified name (in the case of Metaflow decorators, this
+          will indicate which extension the decorator comes from)
+        - A list of positional arguments
+        - A dictionary of keyword arguments
+        
+        You can use the decorator specification to remove a decorator from the flow
+        for example.
+        
+        Yields
+        ------
+        str, str, List[Any], Dict[str, Any]
+            A tuple containing the decorator name, it's fully qualified name,
+            a list of positional arguments, and a dictionary of keyword arguments.
+        """
+        ...
+    @property
+    def configs(self) -> typing.Generator[typing.Tuple[str, metaflow.user_configs.config_parameters.ConfigValue], None, None]:
+        """
+        Iterate over all user configurations in this flow
+        
+        Use this to parameterize your flow based on configuration. As an example, the
+        `pre_mutate`/`mutate` methods can add decorators to steps in the flow that
+        depend on values in the configuration.
+        
+        ```
+        class MyDecorator(FlowMutator):
+            def mutate(flow: MutableFlow):
+                val = next(flow.configs)[1].steps.start.cpu
+                flow.start.add_decorator(environment, vars={'mycpu': val})
+                return flow
+        
+        @MyDecorator()
+        class TestFlow(FlowSpec):
+            config = Config('myconfig.json')
+        
+            @step
+            def start(self):
+                pass
+        ```
+        can be used to add an environment decorator to the `start` step.
+        
+        Yields
+        ------
+        Tuple[str, ConfigValue]
+            Iterates over the configurations of the flow
+        """
+        ...
+    @property
+    def parameters(self) -> typing.Generator[typing.Tuple[str, "metaflow.parameters.Parameter"], None, None]:
+        """
+        Iterate over all the parameters in this flow.
+        
+        Yields
+        ------
+        Tuple[str, Parameter]
+            Name of the parameter and parameter in the flow
+        """
+        ...
+    @property
+    def steps(self) -> typing.Generator[typing.Tuple[str, "metaflow.user_decorators.mutable_step.MutableStep"], None, None]:
+        """
+        Iterate over all the steps in this flow. The order of the steps
+        returned is not guaranteed.
+        
+        Yields
+        ------
+        Tuple[str, MutableStep]
+            A tuple with the step name and the step proxy
+        """
+        ...
+    def add_parameter(self, name: str, value: "metaflow.parameters.Parameter", overwrite: bool = False):
+        """
+        Add a parameter to the flow. You can only add parameters in the `pre_mutate`
+        method.
+        
+        Parameters
+        ----------
+        name : str
+            Name of the parameter
+        value : Parameter
+            Parameter to add to the flow
+        overwrite : bool, default False
+            If True, overwrite the parameter if it already exists
+        """
+        ...
+    def remove_parameter(self, parameter_name: str) -> bool:
+        """
+        Remove a parameter from the flow.
+        
+        The name given should match the name of the parameter (can be different
+        from the name of the parameter in the flow. You can not remove config parameters.
+        You can only remove parameters in the `pre_mutate` method.
+        
+        Parameters
+        ----------
+        parameter_name : str
+            Name of the parameter
+        
+        Returns
+        -------
+        bool
+            Returns True if the parameter was removed
+        """
+        ...
+    def add_decorator(self, deco_type: typing.Union[functools.partial, str], deco_args: typing.Optional[typing.List[typing.Any]] = None, deco_kwargs: typing.Optional[typing.Dict[str, typing.Any]] = None, duplicates: int = 1):
+        """
+        Add a Metaflow flow-decorator to a flow. You can only add decorators in the
+        `pre_mutate` method.
+        
+        You can either add the decorator itself or its decorator specification for it
+        (the same you would get back from decorator_specs). You can also mix and match
+        but you cannot provide arguments both through the string and the
+        deco_args/deco_kwargs.
+        
+        As an example:
+        ```
+        from metaflow import project
+        
+        ...
+        my_flow.add_decorator(project, deco_kwargs={"name":"my_project"})
+        ```
+        
+        is equivalent to:
+        ```
+        my_flow.add_decorator("project:name=my_project")
+        ```
+        
+        Note in the later case, there is no need to import the flow decorator.
+        
+        The latter syntax is useful to, for example, allow decorators to be stored as
+        strings in a configuration file.
+        
+        In terms of precedence for decorators:
+          - if a decorator can be applied multiple times all decorators
+            added are kept (this is rare for flow-decorators).
+          - if `duplicates` is set to `MutableFlow.IGNORE`, then the decorator
+            being added is ignored (in other words, the existing decorator has precedence).
+          - if `duplicates` is set to `MutableFlow.OVERRIDE`, then the *existing*
+            decorator is removed and this newly added one replaces it (in other
+            words, the newly added decorator has precedence).
+          - if `duplicates` is set to `MutableFlow.ERROR`, then an error is raised but only
+            if the newly added decorator is *static* (ie: defined directly in the code).
+            If not, it is ignored.
+        
+        Parameters
+        ----------
+        deco_type : Union[partial, str]
+            The decorator class to add to this flow. If using a string, you cannot specify
+            additional arguments as all argument will be parsed from the decorator
+            specification.
+        deco_args : List[Any], optional, default None
+            Positional arguments to pass to the decorator.
+        deco_kwargs : Dict[str, Any], optional, default None
+            Keyword arguments to pass to the decorator.
+        duplicates : int, default MutableFlow.IGNORE
+            Instruction on how to handle duplicates. It can be one of:
+            - `MutableFlow.IGNORE`: Ignore the decorator if it already exists.
+            - `MutableFlow.ERROR`: Raise an error if the decorator already exists.
+            - `MutableFlow.OVERRIDE`: Remove the existing decorator and add this one.
+        """
+        ...
+    def remove_decorator(self, deco_name: str, deco_args: typing.Optional[typing.List[typing.Any]] = None, deco_kwargs: typing.Optional[typing.Dict[str, typing.Any]] = None) -> bool:
+        """
+        Remove a flow-level decorator. To remove a decorator, you can pass the decorator
+        specification (obtained from `decorator_specs` for example).
+        Note that if multiple decorators share the same decorator specification
+        (very rare), they will all be removed.
+        
+        You can only remove decorators in the `pre_mutate` method.
+        
+        Parameters
+        ----------
+        deco_name : str
+            Decorator specification of the decorator to remove. If nothing else is
+            specified, all decorators matching that name will be removed.
+        deco_args : List[Any], optional, default None
+            Positional arguments to match the decorator specification.
+        deco_kwargs : Dict[str, Any], optional, default None
+            Keyword arguments to match the decorator specification.
+        
+        Returns
+        -------
+        bool
+            Returns True if a decorator was removed.
+        """
+        ...
+    def __getattr__(self, name):
+        ...
+    ...
+