metaflow-stubs 2.12.7__py2.py3-none-any.whl → 2.12.9__py2.py3-none-any.whl

metaflow-stubs/runner/deployer.pyi

@@ -0,0 +1,354 @@
+##################################################################################
+#                       Auto-generated Metaflow stub file                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.257396                                        #
+##################################################################################
+
+from __future__ import annotations
+
+import typing
+if typing.TYPE_CHECKING:
+    import metaflow.runner.subprocess_manager
+    import metaflow.exception
+    import metaflow.runner.deployer
+
+class MetaflowNotFound(metaflow.exception.MetaflowException, metaclass=type):
+    ...
+
+class CommandManager(object, metaclass=type):
+    def __init__(self, command: typing.List[str], env: typing.Optional[typing.Dict[str, str]] = None, cwd: typing.Optional[str] = None):
+        """
+        Create a new CommandManager object.
+        This does not run the process itself but sets it up.
+        
+        Parameters
+        ----------
+        command : List[str]
+            The command to run in List form.
+        env : Optional[Dict[str, str]], default None
+            Environment variables to set for the subprocess; if not specified,
+            the current enviornment variables are used.
+        cwd : Optional[str], default None
+            The directory to run the subprocess in; if not specified, the current
+            directory is used.
+        """
+        ...
+    def __aenter__(self) -> metaflow.runner.subprocess_manager.CommandManager:
+        ...
+    def __aexit__(self, exc_type, exc_value, traceback):
+        ...
+    def wait(self, timeout: typing.Optional[float] = None, stream: typing.Optional[str] = None):
+        """
+        Wait for the subprocess to finish, optionally with a timeout
+        and optionally streaming its output.
+        
+        You can only call `wait` if `async_run` has already been called.
+        
+        Parameters
+        ----------
+        timeout : Optional[float], default None
+            The maximum time to wait for the subprocess to finish.
+            If the timeout is reached, the subprocess is killed.
+        stream : Optional[str], default None
+            If specified, the specified stream is printed to stdout. `stream` can
+            be one of `stdout` or `stderr`.
+        """
+        ...
+    def run(self, show_output: bool = False):
+        """
+        Run the subprocess synchronously. This can only be called once.
+        
+        This also waits on the process implicitly.
+        
+        Parameters
+        ----------
+        show_output : bool, default False
+            Suppress the 'stdout' and 'stderr' to the console by default.
+            They can be accessed later by reading the files present in:
+                - self.log_files["stdout"]
+                - self.log_files["stderr"]
+        """
+        ...
+    def async_run(self):
+        """
+        Run the subprocess asynchronously. This can only be called once.
+        
+        Once this is called, you can then wait on the process (using `wait`), stream
+        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]]:
+        """
+        Stream logs from the subprocess line by line.
+        
+        Parameters
+        ----------
+        stream : str
+            The stream to stream logs from. Can be one of "stdout" or "stderr".
+        position : Optional[int], default None
+            The position in the log file to start streaming from. If None, it starts
+            from the beginning of the log file. This allows resuming streaming from
+            a previously known position
+        timeout_per_line : Optional[float], default None
+            The time to wait for a line to be read from the log file. If None, it
+            waits indefinitely. If the timeout is reached, a LogReadTimeoutError
+            is raised. Note that this timeout is *per line* and not cumulative so this
+            function may take significantly more time than `timeout_per_line`
+        log_write_delay : float, default 0.01
+            Improves the probability of getting whole lines. This setting is for
+            advanced use cases.
+        
+        Yields
+        ------
+        Tuple[int, str]
+            A tuple containing the position in the log file and the line read. The
+            position returned can be used to feed into another `stream_logs` call
+            for example.
+        """
+        ...
+    def emit_logs(self, stream: str = "stdout", custom_logger: typing.Callable[..., None] = print):
+        """
+        Helper function that can easily emit all the logs for a given stream.
+        
+        This function will only terminate when all the log has been printed.
+        
+        Parameters
+        ----------
+        stream : str, default "stdout"
+            The stream to emit logs for. Can be one of "stdout" or "stderr".
+        custom_logger : Callable[..., None], default print
+            A custom logger function that takes in a string and "emits" it. By default,
+            the log is printed to stdout.
+        """
+        ...
+    def cleanup(self):
+        """
+        Clean up log files for a running subprocesses.
+        """
+        ...
+    def kill(self, termination_timeout: float = 1):
+        """
+        Kill the subprocess and its descendants.
+        
+        Parameters
+        ----------
+        termination_timeout : float, default 1
+            The time to wait after sending a SIGTERM to the process and its descendants
+            before sending a SIGKILL.
+        """
+        ...
+    ...
+
+class SubprocessManager(object, metaclass=type):
+    def __init__(self):
+        ...
+    def __aenter__(self) -> metaflow.runner.subprocess_manager.SubprocessManager:
+        ...
+    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:
+        """
+        Run a command synchronously and return its process ID.
+        
+        Parameters
+        ----------
+        command : List[str]
+            The command to run in List form.
+        env : Optional[Dict[str, str]], default None
+            Environment variables to set for the subprocess; if not specified,
+            the current enviornment variables are used.
+        cwd : Optional[str], default None
+            The directory to run the subprocess in; if not specified, the current
+            directory is used.
+        show_output : bool, default False
+            Suppress the 'stdout' and 'stderr' to the console by default.
+            They can be accessed later by reading the files present in the
+            CommandManager object:
+                - command_obj.log_files["stdout"]
+                - command_obj.log_files["stderr"]
+        Returns
+        -------
+        int
+            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:
+        """
+        Run a command asynchronously and return its process ID.
+        
+        Parameters
+        ----------
+        command : List[str]
+            The command to run in List form.
+        env : Optional[Dict[str, str]], default None
+            Environment variables to set for the subprocess; if not specified,
+            the current enviornment variables are used.
+        cwd : Optional[str], default None
+            The directory to run the subprocess in; if not specified, the current
+            directory is used.
+        
+        Returns
+        -------
+        int
+            The process ID of the subprocess.
+        """
+        ...
+    def get(self, pid: int) -> typing.Optional["CommandManager"]:
+        """
+        Get one of the CommandManager managed by this SubprocessManager.
+        
+        Parameters
+        ----------
+        pid : int
+            The process ID of the subprocess (returned by run_command or async_run_command).
+        
+        Returns
+        -------
+        Optional[CommandManager]
+            The CommandManager object for the given process ID, or None if not found.
+        """
+        ...
+    def cleanup(self):
+        """
+        Clean up log files for all running subprocesses.
+        """
+        ...
+    ...
+
+def read_from_file_when_ready(file_path: str, timeout: float = 5):
+    ...
+
+def handle_timeout(tfp_runner_attribute, command_obj: metaflow.runner.subprocess_manager.CommandManager):
+    """
+    Handle the timeout for a running subprocess command that reads a file
+    and raises an error with appropriate logs if a TimeoutError occurs.
+    
+    Parameters
+    ----------
+    tfp_runner_attribute : NamedTemporaryFile
+        Temporary file that stores runner attribute data.
+    command_obj : CommandManager
+        Command manager object that encapsulates the running command details.
+    
+    Returns
+    -------
+    str
+        Content read from the temporary file.
+    
+    Raises
+    ------
+    RuntimeError
+        If a TimeoutError occurs, it raises a RuntimeError with the command's
+        stdout and stderr logs.
+    """
+    ...
+
+def get_lower_level_group(api, top_level_kwargs: typing.Dict, _type: typing.Optional[str], deployer_kwargs: typing.Dict):
+    """
+    Retrieve a lower-level group from the API based on the type and provided arguments.
+    
+    Parameters
+    ----------
+    api : MetaflowAPI
+        Metaflow API instance.
+    top_level_kwargs : Dict
+        Top-level keyword arguments to pass to the API.
+    _type : str
+        Type of the deployer implementation to target.
+    deployer_kwargs : Dict
+        Keyword arguments specific to the deployer.
+    
+    Returns
+    -------
+    Any
+        The lower-level group object retrieved from the API.
+    
+    Raises
+    ------
+    ValueError
+        If the `_type` is None.
+    """
+    ...
+
+class Deployer(object, metaclass=type):
+    def __init__(self, flow_file: str, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, cwd: typing.Optional[str] = None, **kwargs):
+        ...
+    def _Deployer__make_function(self, deployer_class):
+        """
+        Create a function for the given deployer class.
+        
+        Parameters
+        ----------
+        deployer_class : Type[DeployerImpl]
+            Deployer implementation class.
+        
+        Returns
+        -------
+        Callable
+            Function that initializes and returns an instance of the deployer class.
+        """
+        ...
+    ...
+
+class TriggeredRun(object, metaclass=type):
+    def __init__(self, deployer: DeployerImpl, content: str):
+        ...
+    @property
+    def run(self):
+        """
+        Retrieve the `Run` object for the triggered run.
+        
+        Note that Metaflow `Run` becomes available only when the `start` task
+        has started executing.
+        
+        Returns
+        -------
+        Run, optional
+            Metaflow Run object if the `start` step has started executing, otherwise None.
+        """
+        ...
+    ...
+
+class DeployedFlow(object, metaclass=type):
+    def __init__(self, deployer: DeployerImpl):
+        ...
+    ...
+
+class DeployerImpl(object, metaclass=type):
+    def __init__(self, flow_file: str, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, cwd: typing.Optional[str] = None, **kwargs):
+        ...
+    def __enter__(self) -> DeployerImpl:
+        ...
+    def create(self, **kwargs) -> DeployedFlow:
+        """
+        Create a deployed flow using the deployer implementation.
+        
+        Parameters
+        ----------
+        **kwargs : Any
+            Additional arguments to pass to `create` corresponding to the
+            command line arguments of `create`
+        
+        Returns
+        -------
+        DeployedFlow
+            DeployedFlow object representing the deployed flow.
+        
+        Raises
+        ------
+        Exception
+            If there is an error during deployment.
+        """
+        ...
+    def __exit__(self, exc_type, exc_value, traceback):
+        """
+        Cleanup resources on exit.
+        """
+        ...
+    def cleanup(self):
+        """
+        Cleanup resources.
+        """
+        ...
+    ...
+

metaflow-stubs/runner/metaflow_runner.pyi

@@ -1,17 +1,17 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.601724                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.254443                                        #
 ##################################################################################
 
 from __future__ import annotations
 
 import typing
 if typing.TYPE_CHECKING:
-    import metaflow.client.core
     import metaflow.runner.metaflow_runner
     import metaflow.runner.subprocess_manager
     import datetime
+    import metaflow.client.core
     import metaflow.events
 
 class Run(metaflow.client.core.MetaflowObject, metaclass=type):
@@ -274,6 +274,12 @@ def metadata(ms: str) -> str:
     """
     ...
 
+def clear_and_set_os_environ(env: typing.Dict):
+    ...
+
+def read_from_file_when_ready(file_path: str, timeout: float = 5):
+    ...
+
 class CommandManager(object, metaclass=type):
     def __init__(self, command: typing.List[str], env: typing.Optional[typing.Dict[str, str]] = None, cwd: typing.Optional[str] = None):
         """
@@ -474,12 +480,6 @@ class SubprocessManager(object, metaclass=type):
         ...
     ...
 
-def clear_and_set_os_environ(env: typing.Dict):
-    ...
-
-def read_from_file_when_ready(file_path: str, timeout: float = 5):
-    ...
-
 class ExecutingRun(object, metaclass=type):
     def __init__(self, runner: Runner, command_obj: metaflow.runner.subprocess_manager.CommandManager, run_obj: metaflow.client.core.Run):
         """

metaflow-stubs/runner/nbdeploy.pyi

@@ -0,0 +1,54 @@
+##################################################################################
+#                       Auto-generated Metaflow stub file                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.257951                                        #
+##################################################################################
+
+from __future__ import annotations
+
+import typing
+
+class Deployer(object, metaclass=type):
+    def __init__(self, flow_file: str, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, cwd: typing.Optional[str] = None, **kwargs):
+        ...
+    def _Deployer__make_function(self, deployer_class):
+        """
+        Create a function for the given deployer class.
+        
+        Parameters
+        ----------
+        deployer_class : Type[DeployerImpl]
+            Deployer implementation class.
+        
+        Returns
+        -------
+        Callable
+            Function that initializes and returns an instance of the deployer class.
+        """
+        ...
+    ...
+
+def get_current_cell(ipython):
+    ...
+
+def format_flowfile(cell):
+    """
+    Formats the given cell content to create a valid Python script that can be executed as a Metaflow flow.
+    """
+    ...
+
+DEFAULT_DIR: str
+
+class NBDeployerInitializationError(Exception, metaclass=type):
+    ...
+
+class NBDeployer(object, metaclass=type):
+    def __init__(self, flow, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, base_dir: str = "/tmp", **kwargs):
+        ...
+    def cleanup(self):
+        """
+        Delete any temporary files created during execution.
+        """
+        ...
+    ...
+

metaflow-stubs/runner/nbrun.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.602825                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.255527                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -102,11 +102,6 @@ class Runner(object, metaclass=type):
         ...
     ...
 
-DEFAULT_DIR: str
-
-class NBRunnerInitializationError(Exception, metaclass=type):
-    ...
-
 def get_current_cell(ipython):
     ...
 
@@ -116,6 +111,11 @@ def format_flowfile(cell):
     """
     ...
 
+DEFAULT_DIR: str
+
+class NBRunnerInitializationError(Exception, metaclass=type):
+    ...
+
 class NBRunner(object, metaclass=type):
     def __init__(self, flow, show_output: bool = True, profile: typing.Optional[str] = None, env: typing.Optional[typing.Dict] = None, base_dir: str = "/tmp", **kwargs):
         ...

metaflow-stubs/runner/subprocess_manager.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.632157                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.265821                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/runner/utils.pyi

@@ -0,0 +1,25 @@
+##################################################################################
+#                       Auto-generated Metaflow stub file                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.266175                                        #
+##################################################################################
+
+from __future__ import annotations
+
+import typing
+
+def get_current_cell(ipython):
+    ...
+
+def format_flowfile(cell):
+    """
+    Formats the given cell content to create a valid Python script that can be executed as a Metaflow flow.
+    """
+    ...
+
+def clear_and_set_os_environ(env: typing.Dict):
+    ...
+
+def read_from_file_when_ready(file_path: str, timeout: float = 5):
+    ...
+

metaflow-stubs/system/__init__.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.603889                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.258839                                        #
 ##################################################################################
 
 from __future__ import annotations
@@ -9,8 +9,8 @@ from __future__ import annotations
 import typing
 if typing.TYPE_CHECKING:
     import metaflow.monitor
-    import metaflow.event_logger
     import typing
+    import metaflow.event_logger
 
 class SystemMonitor(object, metaclass=type):
     def __init__(self):

metaflow-stubs/system/system_logger.pyi

@@ -1,15 +1,15 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.633212                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.287781                                        #
 ##################################################################################
 
 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):
     def __init__(self):

metaflow-stubs/system/system_monitor.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.632751                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.287323                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/tagging_util.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.574729                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.228233                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/tuple_util.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.583506                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.235902                                        #
 ##################################################################################
 
 from __future__ import annotations

metaflow-stubs/version.pyi

@@ -1,7 +1,7 @@
 ##################################################################################
 #                       Auto-generated Metaflow stub file                        #
-# MF version: 2.12.7                                                             #
-# Generated on 2024-07-03T19:20:47.602954                                        #
+# MF version: 2.12.9                                                             #
+# Generated on 2024-07-25T18:20:16.258069                                        #
 ##################################################################################
 
 from __future__ import annotations

{metaflow_stubs-2.12.7.dist-info → metaflow_stubs-2.12.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: metaflow-stubs
-Version: 2.12.7
+Version: 2.12.9
 Summary: Metaflow Stubs: Stubs for the metaflow package
 Author: Metaflow Developers
 Author-email: help@metaflow.org
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.7.0
 Description-Content-Type: text/markdown
-Requires-Dist: metaflow ==2.12.7
+Requires-Dist: metaflow ==2.12.9
 
 # Metaflow Stubs