modal 0.72.4__py3-none-any.whl → 0.72.48__py3-none-any.whl

modal/image.py

@@ -26,6 +26,7 @@ from grpclib.exceptions import GRPCError, StreamTerminatedError
 
 from modal_proto import api_pb2
 
+from ._object import _Object, live_method_gen
 from ._resolver import Resolver
 from ._serialization import serialize
 from ._utils.async_utils import synchronize_api
@@ -46,7 +47,6 @@ from .file_pattern_matcher import NON_PYTHON_FILES, FilePatternMatcher, _ignore_
 from .gpu import GPU_T, parse_gpu_config
 from .mount import _Mount, python_standalone_mount_name
 from .network_file_system import _NetworkFileSystem
-from .object import _Object, live_method_gen
 from .output import _get_output_manager
 from .scheduler_placement import SchedulerPlacement
 from .secret import _Secret
@@ -82,6 +82,11 @@ class _AutoDockerIgnoreSentinel:
 
 AUTO_DOCKERIGNORE = _AutoDockerIgnoreSentinel()
 
+COPY_DEPRECATION_MESSAGE_PATTERN = """modal.Image.copy_* methods will soon be deprecated.
+
+Use {replacement} instead, which is functionally and performance-wise equivalent.
+"""
+
 
 def _validate_python_version(
     python_version: Optional[str], builder_version: ImageBuilderVersion, allow_micro_granularity: bool = True
@@ -657,13 +662,16 @@ class _Image(_Object, type_prefix="im"):
         return obj
 
     def copy_mount(self, mount: _Mount, remote_path: Union[str, Path] = ".") -> "_Image":
-        """Copy the entire contents of a `modal.Mount` into an image.
+        """
+        **Deprecated**: Use image.add_local_dir(..., copy=True) or similar instead.
+
+        Copy the entire contents of a `modal.Mount` into an image.
         Useful when files only available locally are required during the image
         build process.
 
         **Example**
 
-        ```python
+        ```python notest
         static_images_dir = "./static"
         # place all static images in root of mount
         mount = modal.Mount.from_local_dir(static_images_dir, remote_path="/")
@@ -736,7 +744,6 @@ class _Image(_Object, type_prefix="im"):
         **Usage:**
 
         ```python
-        from pathlib import Path
         from modal import FilePatternMatcher
 
         image = modal.Image.debian_slim().add_local_dir(
@@ -768,7 +775,7 @@ class _Image(_Object, type_prefix="im"):
         image = modal.Image.debian_slim().add_local_dir(
             "~/assets",
             remote_path="/assets",
-            ignore=FilePatternMatcher.from_file(Path("/path/to/ignorefile")),
+            ignore=FilePatternMatcher.from_file("/path/to/ignorefile"),
         )
         ```
         """
@@ -786,7 +793,9 @@ class _Image(_Object, type_prefix="im"):
         This works in a similar way to [`COPY`](https://docs.docker.com/engine/reference/builder/#copy)
         works in a `Dockerfile`.
         """
-        # TODO(elias): add pending deprecation with suggestion to use add_* instead
+        deprecation_warning(
+            (2024, 1, 13), COPY_DEPRECATION_MESSAGE_PATTERN.format(replacement="image.add_local_file"), pending=True
+        )
         basename = str(Path(local_path).name)
 
         def build_dockerfile(version: ImageBuilderVersion) -> DockerfileSpec:
@@ -845,14 +854,17 @@ class _Image(_Object, type_prefix="im"):
         # Which follows dockerignore syntax.
         ignore: Union[Sequence[str], Callable[[Path], bool]] = [],
     ) -> "_Image":
-        """Copy a directory into the image as a part of building the image.
+        """
+        **Deprecated**: Use image.add_local_dir instead
+
+        Copy a directory into the image as a part of building the image.
 
         This works in a similar way to [`COPY`](https://docs.docker.com/engine/reference/builder/#copy)
         works in a `Dockerfile`.
 
         **Usage:**
 
-        ```python
+        ```python notest
         from pathlib import Path
         from modal import FilePatternMatcher
 
@@ -885,10 +897,13 @@ class _Image(_Object, type_prefix="im"):
         image = modal.Image.debian_slim().copy_local_dir(
             "~/assets",
             remote_path="/assets",
-            ignore=FilePatternMatcher.from_file(Path("/path/to/ignorefile")),
+            ignore=FilePatternMatcher.from_file("/path/to/ignorefile"),
         )
         ```
         """
+        deprecation_warning(
+            (2024, 1, 13), COPY_DEPRECATION_MESSAGE_PATTERN.format(replacement="image.add_local_dir"), pending=True
+        )
 
         def build_dockerfile(version: ImageBuilderVersion) -> DockerfileSpec:
             return DockerfileSpec(commands=["FROM base", f"COPY . {remote_path}"], context_files={})
@@ -1282,7 +1297,6 @@ class _Image(_Object, type_prefix="im"):
         **Usage:**
 
         ```python
-        from pathlib import Path
         from modal import FilePatternMatcher
 
         # By default a .dockerignore file is used if present in the current working directory
@@ -1314,10 +1328,17 @@ class _Image(_Object, type_prefix="im"):
         # You can also read ignore patterns from a file.
         image = modal.Image.debian_slim().dockerfile_commands(
             ["COPY data /data"],
-            ignore=FilePatternMatcher.from_file(Path("/path/to/dockerignore")),
+            ignore=FilePatternMatcher.from_file("/path/to/dockerignore"),
         )
         ```
         """
+        if context_mount is not None:
+            deprecation_warning(
+                (2025, 1, 13),
+                "`context_mount` is deprecated."
+                + " Files are now automatically added to the build context based on the commands.",
+                pending=True,
+            )
         cmds = _flatten_str_args("dockerfile_commands", "dockerfile_commands", dockerfile_commands)
         if not cmds:
             return self
@@ -1506,7 +1527,8 @@ class _Image(_Object, type_prefix="im"):
                 "COPY /python/. /usr/local",
                 "ENV TERMINFO_DIRS=/etc/terminfo:/lib/terminfo:/usr/share/terminfo:/usr/lib/terminfo",
             ]
-            if add_python < "3.13":
+            python_minor = add_python.split(".")[1]
+            if int(python_minor) < 13:
                 # Previous versions did not include the `python` binary, but later ones do.
                 # (The important factor is not the Python version itself, but the standalone dist version.)
                 # We insert the command in the list at the position it was previously always added
@@ -1712,7 +1734,6 @@ class _Image(_Object, type_prefix="im"):
         **Usage:**
 
         ```python
-        from pathlib import Path
         from modal import FilePatternMatcher
 
         # By default a .dockerignore file is used if present in the current working directory
@@ -1750,10 +1771,17 @@ class _Image(_Object, type_prefix="im"):
         image = modal.Image.from_dockerfile(
             "./Dockerfile",
             add_python="3.12",
-            ignore=FilePatternMatcher.from_file(Path("/path/to/dockerignore")),
+            ignore=FilePatternMatcher.from_file("/path/to/dockerignore"),
         )
         ```
         """
+        if context_mount is not None:
+            deprecation_warning(
+                (2025, 1, 13),
+                "`context_mount` is deprecated."
+                + " Files are now automatically added to the build context based on the commands in the Dockerfile.",
+                pending=True,
+            )
 
         # --- Build the base dockerfile
 
@@ -2025,11 +2053,11 @@ class _Image(_Object, type_prefix="im"):
         try:
             yield
         except Exception as exc:
-            if self.object_id is None:
-                # Might be initialized later
+            if not self.is_hydrated:
+                # Might be hydrated later
                 self.inside_exceptions.append(exc)
             elif env_image_id == self.object_id:
-                # Image is already initialized (we can remove this case later
+                # Image is already hydrated (we can remove this case later
                 # when we don't hydrate objects so early)
                 raise
             if not isinstance(exc, ImportError):
@@ -2044,9 +2072,9 @@ class _Image(_Object, type_prefix="im"):
         last_entry_id: str = ""
 
         request = api_pb2.ImageJoinStreamingRequest(
-            image_id=self._object_id, timeout=55, last_entry_id=last_entry_id, include_logs_for_finished=True
+            image_id=self.object_id, timeout=55, last_entry_id=last_entry_id, include_logs_for_finished=True
         )
-        async for response in self._client.stub.ImageJoinStreaming.unary_stream(request):
+        async for response in self.client.stub.ImageJoinStreaming.unary_stream(request):
             if response.result.status:
                 return
             if response.entry_id:

modal/image.pyi

@@ -1,5 +1,6 @@
 import collections.abc
 import google.protobuf.message
+import modal._object
 import modal.client
 import modal.cloud_bucket_mount
 import modal.functions
@@ -52,11 +53,11 @@ def _get_image_builder_version(
 ) -> typing.Literal["2023.12", "2024.04", "2024.10"]: ...
 def _create_context_mount(
     docker_commands: collections.abc.Sequence[str],
-    ignore_fn: typing.Callable[[pathlib.Path], bool],
+    ignore_fn: collections.abc.Callable[[pathlib.Path], bool],
     context_dir: pathlib.Path,
 ) -> typing.Optional[modal.mount._Mount]: ...
 def _create_context_mount_function(
-    ignore: typing.Union[collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]],
+    ignore: typing.Union[collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]],
     dockerfile_cmds: list[str] = [],
     dockerfile_path: typing.Optional[pathlib.Path] = None,
     context_mount: typing.Optional[modal.mount._Mount] = None,
@@ -78,7 +79,7 @@ async def _image_await_build_result(
     image_id: str, client: modal.client._Client
 ) -> modal_proto.api_pb2.ImageJoinStreamingResponse: ...
 
-class _Image(modal.object._Object):
+class _Image(modal._object._Object):
     force_build: bool
     inside_exceptions: list[Exception]
     _serve_mounts: frozenset[modal.mount._Mount]
@@ -97,14 +98,16 @@ class _Image(modal.object._Object):
         *,
         base_images: typing.Optional[dict[str, _Image]] = None,
         dockerfile_function: typing.Optional[
-            typing.Callable[[typing.Literal["2023.12", "2024.04", "2024.10"]], DockerfileSpec]
+            collections.abc.Callable[[typing.Literal["2023.12", "2024.04", "2024.10"]], DockerfileSpec]
         ] = None,
         secrets: typing.Optional[collections.abc.Sequence[modal.secret._Secret]] = None,
         gpu_config: typing.Optional[modal_proto.api_pb2.GPUConfig] = None,
         build_function: typing.Optional[modal.functions._Function] = None,
         build_function_input: typing.Optional[modal_proto.api_pb2.FunctionInput] = None,
         image_registry_config: typing.Optional[_ImageRegistryConfig] = None,
-        context_mount_function: typing.Optional[typing.Callable[[], typing.Optional[modal.mount._Mount]]] = None,
+        context_mount_function: typing.Optional[
+            collections.abc.Callable[[], typing.Optional[modal.mount._Mount]]
+        ] = None,
         force_build: bool = False,
         _namespace: int = 1,
         _do_assert_no_mount_layers: bool = True,
@@ -119,7 +122,7 @@ class _Image(modal.object._Object):
         remote_path: str,
         *,
         copy: bool = False,
-        ignore: typing.Union[collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]] = [],
+        ignore: typing.Union[collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]] = [],
     ) -> _Image: ...
     def copy_local_file(
         self, local_path: typing.Union[str, pathlib.Path], remote_path: typing.Union[str, pathlib.Path] = "./"
@@ -129,14 +132,14 @@ class _Image(modal.object._Object):
         *module_names: str,
         copy: bool = False,
         ignore: typing.Union[
-            collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]
+            collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]
         ] = modal.file_pattern_matcher.NON_PYTHON_FILES,
     ) -> _Image: ...
     def copy_local_dir(
         self,
         local_path: typing.Union[str, pathlib.Path],
         remote_path: typing.Union[str, pathlib.Path] = ".",
-        ignore: typing.Union[collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]] = [],
+        ignore: typing.Union[collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]] = [],
     ) -> _Image: ...
     @staticmethod
     async def from_id(image_id: str, client: typing.Optional[modal.client._Client] = None) -> _Image: ...
@@ -215,7 +218,7 @@ class _Image(modal.object._Object):
         context_mount: typing.Optional[modal.mount._Mount] = None,
         force_build: bool = False,
         ignore: typing.Union[
-            collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]
+            collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]
         ] = modal.image.AUTO_DOCKERIGNORE,
     ) -> _Image: ...
     def entrypoint(self, entrypoint_commands: list[str]) -> _Image: ...
@@ -303,7 +306,7 @@ class _Image(modal.object._Object):
         gpu: typing.Union[None, bool, str, modal.gpu._GPUConfig] = None,
         add_python: typing.Optional[str] = None,
         ignore: typing.Union[
-            collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]
+            collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]
         ] = modal.image.AUTO_DOCKERIGNORE,
     ) -> _Image: ...
     @staticmethod
@@ -317,7 +320,7 @@ class _Image(modal.object._Object):
     ) -> _Image: ...
     def run_function(
         self,
-        raw_f: typing.Callable[..., typing.Any],
+        raw_f: collections.abc.Callable[..., typing.Any],
         secrets: collections.abc.Sequence[modal.secret._Secret] = (),
         gpu: typing.Union[
             None, bool, str, modal.gpu._GPUConfig, list[typing.Union[None, bool, str, modal.gpu._GPUConfig]]
@@ -344,6 +347,8 @@ class _Image(modal.object._Object):
     def imports(self): ...
     def _logs(self) -> typing.AsyncGenerator[str, None]: ...
 
+SUPERSELF = typing.TypeVar("SUPERSELF", covariant=True)
+
 class Image(modal.object.Object):
     force_build: bool
     inside_exceptions: list[Exception]
@@ -364,14 +369,16 @@ class Image(modal.object.Object):
         *,
         base_images: typing.Optional[dict[str, Image]] = None,
         dockerfile_function: typing.Optional[
-            typing.Callable[[typing.Literal["2023.12", "2024.04", "2024.10"]], DockerfileSpec]
+            collections.abc.Callable[[typing.Literal["2023.12", "2024.04", "2024.10"]], DockerfileSpec]
         ] = None,
         secrets: typing.Optional[collections.abc.Sequence[modal.secret.Secret]] = None,
         gpu_config: typing.Optional[modal_proto.api_pb2.GPUConfig] = None,
         build_function: typing.Optional[modal.functions.Function] = None,
         build_function_input: typing.Optional[modal_proto.api_pb2.FunctionInput] = None,
         image_registry_config: typing.Optional[_ImageRegistryConfig] = None,
-        context_mount_function: typing.Optional[typing.Callable[[], typing.Optional[modal.mount.Mount]]] = None,
+        context_mount_function: typing.Optional[
+            collections.abc.Callable[[], typing.Optional[modal.mount.Mount]]
+        ] = None,
         force_build: bool = False,
         _namespace: int = 1,
         _do_assert_no_mount_layers: bool = True,
@@ -386,7 +393,7 @@ class Image(modal.object.Object):
         remote_path: str,
         *,
         copy: bool = False,
-        ignore: typing.Union[collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]] = [],
+        ignore: typing.Union[collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]] = [],
     ) -> Image: ...
     def copy_local_file(
         self, local_path: typing.Union[str, pathlib.Path], remote_path: typing.Union[str, pathlib.Path] = "./"
@@ -396,14 +403,14 @@ class Image(modal.object.Object):
         *module_names: str,
         copy: bool = False,
         ignore: typing.Union[
-            collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]
+            collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]
         ] = modal.file_pattern_matcher.NON_PYTHON_FILES,
     ) -> Image: ...
     def copy_local_dir(
         self,
         local_path: typing.Union[str, pathlib.Path],
         remote_path: typing.Union[str, pathlib.Path] = ".",
-        ignore: typing.Union[collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]] = [],
+        ignore: typing.Union[collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]] = [],
     ) -> Image: ...
 
     class __from_id_spec(typing_extensions.Protocol):
@@ -487,7 +494,7 @@ class Image(modal.object.Object):
         context_mount: typing.Optional[modal.mount.Mount] = None,
         force_build: bool = False,
         ignore: typing.Union[
-            collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]
+            collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]
         ] = modal.image.AUTO_DOCKERIGNORE,
     ) -> Image: ...
     def entrypoint(self, entrypoint_commands: list[str]) -> Image: ...
@@ -575,7 +582,7 @@ class Image(modal.object.Object):
         gpu: typing.Union[None, bool, str, modal.gpu._GPUConfig] = None,
         add_python: typing.Optional[str] = None,
         ignore: typing.Union[
-            collections.abc.Sequence[str], typing.Callable[[pathlib.Path], bool]
+            collections.abc.Sequence[str], collections.abc.Callable[[pathlib.Path], bool]
         ] = modal.image.AUTO_DOCKERIGNORE,
     ) -> Image: ...
     @staticmethod
@@ -589,7 +596,7 @@ class Image(modal.object.Object):
     ) -> Image: ...
     def run_function(
         self,
-        raw_f: typing.Callable[..., typing.Any],
+        raw_f: collections.abc.Callable[..., typing.Any],
         secrets: collections.abc.Sequence[modal.secret.Secret] = (),
         gpu: typing.Union[
             None, bool, str, modal.gpu._GPUConfig, list[typing.Union[None, bool, str, modal.gpu._GPUConfig]]
@@ -615,10 +622,10 @@ class Image(modal.object.Object):
     def workdir(self, path: typing.Union[str, pathlib.PurePosixPath]) -> Image: ...
     def imports(self): ...
 
-    class ___logs_spec(typing_extensions.Protocol):
+    class ___logs_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self) -> typing.Generator[str, None, None]: ...
         def aio(self) -> typing.AsyncGenerator[str, None]: ...
 
-    _logs: ___logs_spec
+    _logs: ___logs_spec[typing_extensions.Self]
 
 SUPPORTED_PYTHON_SERIES: dict[typing.Literal["2023.12", "2024.04", "2024.10"], list[str]]

modal/io_streams.pyi

@@ -50,6 +50,8 @@ class _StreamWriter:
 
 T_INNER = typing.TypeVar("T_INNER", covariant=True)
 
+SUPERSELF = typing.TypeVar("SUPERSELF", covariant=True)
+
 class StreamReader(typing.Generic[T]):
     _stream: typing.Optional[collections.abc.AsyncGenerator[typing.Optional[bytes], None]]
 
@@ -66,25 +68,25 @@ class StreamReader(typing.Generic[T]):
     @property
     def file_descriptor(self) -> int: ...
 
-    class __read_spec(typing_extensions.Protocol[T_INNER]):
+    class __read_spec(typing_extensions.Protocol[T_INNER, SUPERSELF]):
         def __call__(self) -> T_INNER: ...
         async def aio(self) -> T_INNER: ...
 
-    read: __read_spec[T]
+    read: __read_spec[T, typing_extensions.Self]
 
-    class ___consume_container_process_stream_spec(typing_extensions.Protocol):
+    class ___consume_container_process_stream_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self): ...
         async def aio(self): ...
 
-    _consume_container_process_stream: ___consume_container_process_stream_spec
+    _consume_container_process_stream: ___consume_container_process_stream_spec[typing_extensions.Self]
 
-    class ___stream_container_process_spec(typing_extensions.Protocol):
+    class ___stream_container_process_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self) -> typing.Generator[tuple[typing.Optional[bytes], str], None, None]: ...
         def aio(self) -> collections.abc.AsyncGenerator[tuple[typing.Optional[bytes], str], None]: ...
 
-    _stream_container_process: ___stream_container_process_spec
+    _stream_container_process: ___stream_container_process_spec[typing_extensions.Self]
 
-    class ___get_logs_spec(typing_extensions.Protocol):
+    class ___get_logs_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(
             self, skip_empty_messages: bool = True
         ) -> typing.Generator[typing.Optional[bytes], None, None]: ...
@@ -92,13 +94,13 @@ class StreamReader(typing.Generic[T]):
             self, skip_empty_messages: bool = True
         ) -> collections.abc.AsyncGenerator[typing.Optional[bytes], None]: ...
 
-    _get_logs: ___get_logs_spec
+    _get_logs: ___get_logs_spec[typing_extensions.Self]
 
-    class ___get_logs_by_line_spec(typing_extensions.Protocol):
+    class ___get_logs_by_line_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self) -> typing.Generator[typing.Optional[bytes], None, None]: ...
         def aio(self) -> collections.abc.AsyncGenerator[typing.Optional[bytes], None]: ...
 
-    _get_logs_by_line: ___get_logs_by_line_spec
+    _get_logs_by_line: ___get_logs_by_line_spec[typing_extensions.Self]
 
     def __iter__(self) -> typing.Iterator[T]: ...
     def __aiter__(self) -> collections.abc.AsyncIterator[T]: ...
@@ -115,8 +117,8 @@ class StreamWriter:
     def write(self, data: typing.Union[bytes, bytearray, memoryview, str]) -> None: ...
     def write_eof(self) -> None: ...
 
-    class __drain_spec(typing_extensions.Protocol):
+    class __drain_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self) -> None: ...
         async def aio(self) -> None: ...
 
-    drain: __drain_spec
+    drain: __drain_spec[typing_extensions.Self]

modal/mount.py

@@ -20,6 +20,7 @@ import modal.file_pattern_matcher
 from modal_proto import api_pb2
 from modal_version import __version__
 
+from ._object import _get_environment_name, _Object
 from ._resolver import Resolver
 from ._utils.async_utils import aclosing, async_map, synchronize_api
 from ._utils.blob_utils import FileUploadSpec, blob_upload_file, get_file_upload_spec_from_path
@@ -31,7 +32,6 @@ from .client import _Client
 from .config import config, logger
 from .exception import InvalidError, ModuleNotMountable
 from .file_pattern_matcher import FilePatternMatcher
-from .object import _get_environment_name, _Object
 
 ROOT_DIR: PurePosixPath = PurePosixPath("/root")
 MOUNT_PUT_FILE_CLIENT_TIMEOUT = 10 * 60  # 10 min max for transferring files
@@ -258,12 +258,15 @@ class NonLocalMountError(Exception):
 
 
 class _Mount(_Object, type_prefix="mo"):
-    """Create a mount for a local directory or file that can be attached
+    """
+    **Deprecated**: Mounts should not be used explicitly anymore, use `Image.add_local_*` commands instead.
+
+    Create a mount for a local directory or file that can be attached
     to one or more Modal functions.
 
     **Usage**
 
-    ```python
+    ```python notest
     import modal
     import os
     app = modal.App()
@@ -394,11 +397,13 @@ class _Mount(_Object, type_prefix="mo"):
         recursive: bool = True,
     ) -> "_Mount":
         """
+        **Deprecated:** Use image.add_local_dir() instead
+
         Create a `Mount` from a local directory.
 
         **Usage**
 
-        ```python
+        ```python notest
         assets = modal.Mount.from_local_dir(
             "~/assets",
             condition=lambda pth: not ".venv" in pth,
@@ -449,11 +454,13 @@ class _Mount(_Object, type_prefix="mo"):
     @staticmethod
     def from_local_file(local_path: Union[str, Path], remote_path: Union[str, PurePosixPath, None] = None) -> "_Mount":
         """
+        **Deprecated**: Use image.add_local_file() instead
+
         Create a `Mount` mounting a single local file.
 
         **Usage**
 
-        ```python
+        ```python notest
         # Mount the DBT profile in user's home directory into container.
         dbt_profiles = modal.Mount.from_local_file(
             local_path="~/profiles.yml",
@@ -611,6 +618,8 @@ class _Mount(_Object, type_prefix="mo"):
         ignore: Optional[Union[Sequence[str], Callable[[Path], bool]]] = None,
     ) -> "_Mount":
         """
+        **Deprecated**: Use image.add_local_python_source instead
+
         Returns a `modal.Mount` that makes local modules listed in `module_names` available inside the container.
         This works by mounting the local path of each module's package to a directory inside the container
         that's on `PYTHONPATH`.