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

metaflow-stubs/mf_extensions/outerbounds/toplevel/global_aliases_for_metaflow_package.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.859190                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.394039                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/multicore_utils.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.850354                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.384194                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/ob_internal.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.847875                                                            #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.378558                                                            #
 ######################################################################################################
 
 from __future__ import annotations

metaflow-stubs/packaging_sys/__init__.pyi

@@ -0,0 +1,430 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.381875                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+import metaflow
+import typing
+import enum
+if typing.TYPE_CHECKING:
+    import metaflow.packaging_sys
+    import enum
+    import typing
+    import metaflow.extension_support.metadata
+    import metaflow.packaging_sys.backend
+    import metaflow.packaging_sys.tar_backend
+
+from . import distribution_support as distribution_support
+from .distribution_support import PackagedDistributionFinder as PackagedDistributionFinder
+from . import backend as backend
+from .backend import PackagingBackend as PackagingBackend
+from . import tar_backend as tar_backend
+from .tar_backend import TarPackagingBackend as TarPackagingBackend
+from . import utils as utils
+from . import v1 as v1
+
+TYPE_CHECKING: bool
+
+MFCONTENT_MARKER: str
+
+class ContentType(enum.IntEnum, metaclass=enum.EnumType):
+    def __new__(cls, value):
+        ...
+    ...
+
+class MetaflowCodeContent(object, metaclass=type):
+    """
+    Base class for all Metaflow code packages (non user code).
+    
+    A Metaflow code package, at a minimum, contains:
+      - a special INFO file (containing a bunch of metadata about the Metaflow environment)
+      - a special CONFIG file (containing user configurations for the flow)
+    
+    Declare all other MetaflowCodeContent subclasses (versions) here to handle just the functions
+    that are not implemented here. In a *separate* file, declare any other
+    function for that specific version.
+    
+    NOTE: This file must remain as dependency-free as possible as it is loaded *very*
+    early on. This is why you must decleare a *separate* class implementing what you want
+    the Metaflow code package (non user) to do.
+    """
+    @classmethod
+    def get_info(cls) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        """
+        Get the content of the special INFO file on the local filesystem after
+        the code package has been expanded.
+        
+        Returns
+        -------
+        Optional[Dict[str, Any]]
+            The content of the INFO file -- None if there is no such file.
+        """
+        ...
+    @classmethod
+    def get_config(cls) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        """
+        Get the content of the special CONFIG file on the local filesystem after
+        the code package has been expanded.
+        
+        Returns
+        -------
+        Optional[Dict[str, Any]]
+            The content of the CONFIG file -- None if there is no such file.
+        """
+        ...
+    @classmethod
+    def get_filename(cls, filename: str, content_type: ContentType) -> typing.Optional[str]:
+        """
+        Get the path to a file extracted from the archive. The filename is the filename
+        passed in when creating the archive and content_type is the type of the content.
+        
+        This function will return the local path where the file can be found after
+        the package has been extracted.
+        
+        Parameters
+        ----------
+        filename: str
+            The name of the file on the filesystem.
+        content_type: ContentType
+        
+        Returns
+        -------
+        str
+            The path to the file on the local filesystem or None if not found.
+        """
+        ...
+    @classmethod
+    def get_env_vars_for_packaged_metaflow(cls, dest_dir: str) -> typing.Optional[typing.Dict[str, str]]:
+        """
+        Get the environment variables that are needed to run Metaflow when it is
+        packaged. This is typically used to set the PYTHONPATH to include the
+        directory where the Metaflow code package has been extracted.
+        
+        Returns
+        -------
+        Optional[Dict[str, str]]
+            The environment variables that are needed to run Metaflow when it is
+            packaged -- None if there are no such variables (not packaged for example)
+        """
+        ...
+    @classmethod
+    def get_archive_info(cls, archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        """
+        Get the content of the special INFO file in the archive.
+        
+        Returns
+        -------
+        Optional[Dict[str, Any]]
+            The content of the INFO file -- None if there is no such file.
+        """
+        ...
+    @classmethod
+    def get_archive_config(cls, archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        """
+        Get the content of the special CONFIG file in the archive.
+        
+        Returns
+        -------
+        Optional[Dict[str, Any]]
+            The content of the CONFIG file -- None if there is no such file.
+        """
+        ...
+    @classmethod
+    def get_archive_filename(cls, archive: typing.Any, filename: str, content_type: ContentType, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[str]:
+        """
+        Get the filename of the archive. This does not do any extraction but simply
+        returns where, in the archive, the file is located. This is the equivalent of
+        get_filename but for files not extracted yet.
+        
+        Parameters
+        ----------
+        archive: Any
+            The archive to get the filename from.
+        filename: str
+            The name of the file in the archive.
+        content_type: ContentType
+            The type of the content (e.g., code, other, etc.).
+        packaging_backend: Type[PackagingBackend], default TarPackagingBackend
+            The packaging backend to use.
+        
+        Returns
+        -------
+        str
+            The filename of the archive or None if not found.
+        """
+        ...
+    @classmethod
+    def get_archive_content_names(cls, archive: typing.Any, content_types: typing.Optional[int] = None, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.List[str]:
+        ...
+    @classmethod
+    def get_distribution_finder(cls) -> typing.Optional["metaflow.extension_support.metadata.DistributionFinder"]:
+        """
+        Get the distribution finder for the Metaflow code package (if applicable).
+        
+        Some packages will include distribution information to "pretend" that some packages
+        are actually distributions even if we just include them in the code package.
+        
+        Returns
+        -------
+        Optional["metaflow.extension_support.metadata.DistributionFinder"]
+            The distribution finder for the Metaflow code package -- None if there is no
+            such finder.
+        """
+        ...
+    @classmethod
+    def get_post_extract_env_vars(cls, version_id: int, dest_dir: str = '.') -> typing.Dict[str, str]:
+        """
+        Get the post-extract environment variables that are needed to access the content
+        that has been extracted into dest_dir.
+        
+        This will typically involve setting PYTHONPATH.
+        
+        Parameters
+        ----------
+        version_id: int
+            The version of MetaflowCodeContent for this package.
+        dest_dir: str, default "."
+            The directory where the content has been extracted to.
+        
+        Returns
+        -------
+        Dict[str, str]
+            The post-extract environment variables that are needed to access the content
+            that has been extracted into extracted_dir.
+        """
+        ...
+    @classmethod
+    def get_info_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_config_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_filename_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], filename: str, content_type: ContentType) -> typing.Optional[str]:
+        ...
+    @classmethod
+    def get_distribution_finder_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional["metaflow.extension_support.metadata.DistributionFinder"]:
+        ...
+    @classmethod
+    def get_archive_info_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_archive_config_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_archive_filename_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, filename: str, content_type: ContentType, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[str]:
+        ...
+    @classmethod
+    def get_archive_content_names_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, content_types: typing.Optional[int] = None, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.List[str]:
+        ...
+    @classmethod
+    def get_post_extract_env_vars_impl(cls, dest_dir: str) -> typing.Dict[str, str]:
+        ...
+    @classmethod
+    def __init_subclass__(cls, version_id, **kwargs):
+        ...
+    def get_excluded_tl_entries(self) -> typing.List[str]:
+        """
+        When packaging Metaflow from within an executing Metaflow flow, we need to
+        exclude the files that are inserted by this content from being packaged (possibly).
+        
+        Use this function to return these files or top-level directories.
+        
+        Returns
+        -------
+        List[str]
+            Files or directories to exclude
+        """
+        ...
+    def content_names(self, content_types: typing.Optional[int] = None) -> typing.Generator[typing.Tuple[str, str], None, None]:
+        """
+        Detailed list of the content of this MetaflowCodeContent. This will list all files
+        (or non files -- for the INFO or CONFIG data for example) present in the archive.
+        
+        Parameters
+        ----------
+        content_types : Optional[int]
+            The type of content to get the names of. If None, all content is returned.
+        
+        Yields
+        ------
+        Generator[Tuple[str, str], None, None]
+            Path on the filesystem and the name in the archive
+        """
+        ...
+    def contents(self, content_types: typing.Optional[int] = None) -> typing.Generator[typing.Tuple[typing.Union[bytes, str], str], None, None]:
+        """
+        Very similar to content_names but returns the content of the non-files
+        as well as bytes. For files, identical output as content_names
+        
+        Parameters
+        ----------
+        content_types : Optional[int]
+            The type of content to get the content of. If None, all content is returned.
+        
+        Yields
+        ------
+        Generator[Tuple[Union[str, bytes], str], None, None]
+            Content of the MF content
+        """
+        ...
+    def show(self) -> str:
+        """
+        Returns a more human-readable string representation of the content of this
+        MetaflowCodeContent. This will not, for example, list all files but summarize what
+        is included at a more high level.
+        
+        Returns
+        -------
+        str
+            A human-readable string representation of the content of this MetaflowCodeContent
+        """
+        ...
+    def add_info(self, info: typing.Dict[str, typing.Any]):
+        """
+        Add the content of the INFO file to the Metaflow content
+        
+        Parameters
+        ----------
+        info: Dict[str, Any]
+            The content of the INFO file
+        """
+        ...
+    def add_config(self, config: typing.Dict[str, typing.Any]):
+        """
+        Add the content of the CONFIG file to the Metaflow content
+        
+        Parameters
+        ----------
+        config: Dict[str, Any]
+            The content of the CONFIG file
+        """
+        ...
+    def add_module(self, module_path: module):
+        """
+        Add a python module to the Metaflow content
+        
+        Parameters
+        ----------
+        module_path: ModuleType
+            The module to add
+        """
+        ...
+    def add_code_file(self, file_path: str, file_name: str):
+        """
+        Add a code file to the Metaflow content
+        
+        Parameters
+        ----------
+        file_path: str
+            The path to the code file to add (on the filesystem)
+        file_name: str
+            The path in the archive to add the code file to
+        """
+        ...
+    def add_other_file(self, file_path: str, file_name: str):
+        """
+        Add a non-python file to the Metaflow content
+        
+        Parameters
+        ----------
+        file_path: str
+            The path to the file to add (on the filesystem)
+        file_name: str
+            The path in the archive to add the file to
+        """
+        ...
+    def get_package_version(self) -> int:
+        """
+        Get the version of MetaflowCodeContent for this package.
+        """
+        ...
+    ...
+
+class MetaflowCodeContentV0(MetaflowCodeContent, metaclass=type):
+    @classmethod
+    def get_info_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_config_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_filename_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], filename: str, content_type: ContentType) -> typing.Optional[str]:
+        """
+        For V0, the filename is simply the filename passed in.
+        """
+        ...
+    @classmethod
+    def get_distribution_finder_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional["metaflow.extension_support.metadata.DistributionFinder"]:
+        ...
+    @classmethod
+    def get_archive_info_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_archive_config_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_archive_filename_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, filename: str, content_type: ContentType, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> str:
+        ...
+    @classmethod
+    def get_archive_content_names_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, content_types: typing.Optional[int] = None, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.List[str]:
+        """
+        For V0, we use a static list of known files to classify the content
+        """
+        ...
+    @classmethod
+    def get_post_extract_env_vars_impl(cls, dest_dir: str) -> typing.Dict[str, str]:
+        ...
+    def get_excluded_tl_entries(self) -> typing.List[str]:
+        """
+        When packaging Metaflow from within an executing Metaflow flow, we need to
+        exclude the files that are inserted by this content from being packaged (possibly).
+        
+        Use this function to return these files or top-level directories.
+        
+        Returns
+        -------
+        List[str]
+            Files or directories to exclude
+        """
+        ...
+    ...
+
+class MetaflowCodeContentV1Base(MetaflowCodeContent, metaclass=type):
+    @classmethod
+    def __init_subclass__(cls, **kwargs):
+        ...
+    def __init__(self, code_dir: str, other_dir: str):
+        ...
+    @classmethod
+    def get_info_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_config_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_filename_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], filename: str, content_type: ContentType) -> typing.Optional[str]:
+        ...
+    @classmethod
+    def get_distribution_finder_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]]) -> typing.Optional["metaflow.extension_support.metadata.DistributionFinder"]:
+        ...
+    @classmethod
+    def get_archive_info_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_archive_config_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.Optional[typing.Dict[str, typing.Any]]:
+        ...
+    @classmethod
+    def get_archive_filename_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, filename: str, content_type: ContentType, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> str:
+        ...
+    @classmethod
+    def get_archive_content_names_impl(cls, mfcontent_info: typing.Optional[typing.Dict[str, typing.Any]], archive: typing.Any, content_types: typing.Optional[int] = None, packaging_backend: typing.Type[metaflow.packaging_sys.backend.PackagingBackend] = metaflow.packaging_sys.tar_backend.TarPackagingBackend) -> typing.List[str]:
+        ...
+    @classmethod
+    def get_post_extract_env_vars_impl(cls, dest_dir: str) -> typing.Dict[str, str]:
+        ...
+    ...
+

metaflow-stubs/packaging_sys/backend.pyi

@@ -0,0 +1,73 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.414750                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+import typing
+import abc
+if typing.TYPE_CHECKING:
+    import typing
+    import io
+    import abc
+
+
+class PackagingBackend(abc.ABC, metaclass=abc.ABCMeta):
+    @classmethod
+    def __init_subclass__(cls, **kwargs):
+        ...
+    @classmethod
+    def get_backend(cls, name: str) -> "PackagingBackend":
+        ...
+    @classmethod
+    def backend_type(cls) -> str:
+        ...
+    @classmethod
+    def get_extract_commands(cls, archive_name: str, dest_dir: str) -> typing.List[str]:
+        ...
+    def __init__(self):
+        ...
+    def create(self) -> "PackagingBackend":
+        ...
+    def add_file(self, filename: str, arcname: typing.Optional[str] = None):
+        ...
+    def add_data(self, data: io.BytesIO, arcname: str):
+        ...
+    def close(self):
+        ...
+    def get_blob(self) -> typing.Union[bytes, bytearray, None]:
+        ...
+    @classmethod
+    def cls_open(cls, content: typing.IO[bytes]) -> typing.Any:
+        """
+        Open the archive from the given content.
+        """
+        ...
+    @classmethod
+    def cls_has_member(cls, archive: typing.Any, name: str) -> bool:
+        ...
+    @classmethod
+    def cls_get_member(cls, archive: typing.Any, name: str) -> typing.Optional[bytes]:
+        ...
+    @classmethod
+    def cls_extract_members(cls, archive: typing.Any, members: typing.Optional[typing.List[str]] = None, dest_dir: str = '.'):
+        ...
+    @classmethod
+    def cls_list_members(cls, archive: typing.Any) -> typing.Optional[typing.List[str]]:
+        ...
+    def has_member(self, name: str) -> bool:
+        ...
+    def get_member(self, name: str) -> typing.Optional[bytes]:
+        ...
+    def extract_members(self, members: typing.Optional[typing.List[str]] = None, dest_dir: str = '.'):
+        ...
+    def list_members(self) -> typing.Optional[typing.List[str]]:
+        ...
+    def __enter__(self):
+        ...
+    def __exit__(self, exc_type, exc_value, traceback):
+        ...
+    ...
+

metaflow-stubs/packaging_sys/distribution_support.pyi

@@ -0,0 +1,57 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.413998                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+import typing
+import importlib
+import abc
+if typing.TYPE_CHECKING:
+    import importlib.metadata
+    import abc
+    import os
+
+
+TYPE_CHECKING: bool
+
+def modules_to_distributions() -> typing.Dict[str, typing.List[importlib.metadata.Distribution]]:
+    """
+    Return a mapping of top-level modules to their distributions.
+    
+    Returns
+    -------
+    Dict[str, List[metadata.Distribution]]
+        A mapping of top-level modules to their distributions.
+    """
+    ...
+
+class PackagedDistribution(importlib.metadata.Distribution, metaclass=type):
+    """
+    A Python Package packaged within a MetaflowCodeContent. This allows users to use use importlib
+    as they would regularly and the packaged Python Package would be considered as a
+    distribution even if it really isn't (since it is just included in the PythonPath).
+    """
+    def __init__(self, root: str, content: typing.Dict[str, str]):
+        ...
+    def read_text(self, filename: typing.Union[str, os.PathLike]) -> typing.Optional[str]:
+        """
+        Attempt to load metadata file given by the name.
+        
+        :param filename: The name of the file in the distribution info.
+        :return: The text if found, otherwise None.
+        """
+        ...
+    def locate_file(self, path: typing.Union[str, os.PathLike]):
+        ...
+    ...
+
+class PackagedDistributionFinder(importlib.metadata.DistributionFinder, metaclass=abc.ABCMeta):
+    def __init__(self, dist_info: typing.Dict[str, typing.Dict[str, str]]):
+        ...
+    def find_distributions(self, context = ...):
+        ...
+    ...
+

metaflow-stubs/packaging_sys/tar_backend.pyi

@@ -0,0 +1,53 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.415294                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+import metaflow
+import typing
+import abc
+if typing.TYPE_CHECKING:
+    import io
+    import tarfile
+    import typing
+    import abc
+    import metaflow.packaging_sys.backend
+
+from .backend import PackagingBackend as PackagingBackend
+
+class TarPackagingBackend(metaflow.packaging_sys.backend.PackagingBackend, metaclass=abc.ABCMeta):
+    @classmethod
+    def get_extract_commands(cls, archive_name: str, dest_dir: str) -> typing.List[str]:
+        ...
+    def __init__(self):
+        ...
+    def create(self):
+        ...
+    def add_file(self, filename: str, arcname: typing.Optional[str] = None):
+        ...
+    def add_data(self, data: io.BytesIO, arcname: str):
+        ...
+    def close(self):
+        ...
+    def get_blob(self) -> typing.Union[bytes, bytearray, None]:
+        ...
+    @classmethod
+    def cls_open(cls, content: typing.IO[bytes]) -> tarfile.TarFile:
+        ...
+    @classmethod
+    def cls_has_member(cls, archive: tarfile.TarFile, name: str) -> bool:
+        ...
+    @classmethod
+    def cls_get_member(cls, archive: tarfile.TarFile, name: str) -> typing.Optional[bytes]:
+        ...
+    @classmethod
+    def cls_extract_members(cls, archive: tarfile.TarFile, members: typing.Optional[typing.List[str]] = None, dest_dir: str = '.'):
+        ...
+    @classmethod
+    def cls_list_members(cls, archive: tarfile.TarFile) -> typing.Optional[typing.List[str]]:
+        ...
+    ...
+

metaflow-stubs/packaging_sys/utils.pyi

@@ -0,0 +1,26 @@
+######################################################################################################
+#                                 Auto-generated Metaflow stub file                                  #
+# MF version: 2.16.5.1+obcheckpoint(0.2.4);ob(v1)                                                    #
+# Generated on 2025-07-28T18:04:46.415618                                                            #
+######################################################################################################
+
+from __future__ import annotations
+
+import typing
+
+
+def walk_without_cycles(top_root: str, exclude_dirs: typing.Optional[typing.List[str]] = None) -> typing.Generator[typing.Tuple[str, typing.List[str]], None, None]:
+    ...
+
+def walk(root: str, exclude_hidden: bool = True, file_filter: typing.Optional[typing.Callable[[str], bool]] = None, exclude_tl_dirs: typing.Optional[typing.List[str]] = None) -> typing.Generator[typing.Tuple[str, str], None, None]:
+    ...
+
+def suffix_filter(suffixes: typing.List[str]) -> typing.Callable[[str], bool]:
+    """
+    Returns a filter function that checks if a file ends with any of the given suffixes.
+    """
+    ...
+
+def with_dir(new_dir):
+    ...
+