modal 0.62.16__py3-none-any.whl → 0.72.11__py3-none-any.whl

modal/app.pyi

@@ -1,287 +1,563 @@
-import google.protobuf.message
-import modal._output
+import collections.abc
+import modal._utils.function_utils
 import modal.client
+import modal.cloud_bucket_mount
+import modal.cls
+import modal.functions
+import modal.gpu
+import modal.image
+import modal.mount
+import modal.network_file_system
 import modal.object
+import modal.partial_function
+import modal.proxy
+import modal.retries
+import modal.running_app
+import modal.schedule
+import modal.scheduler_placement
+import modal.secret
+import modal.volume
 import modal_proto.api_pb2
+import pathlib
+import synchronicity.combined_types
 import typing
 import typing_extensions
 
-_Function = typing.TypeVar("_Function")
-
-class _LocalApp:
-    _tag_to_object_id: typing.Dict[str, str]
-    _client: modal.client._Client
-    _app_id: str
-    _app_page_url: str
-    _environment_name: str
-    _interactive: bool
-
-    def __init__(self, client: modal.client._Client, app_id: str, app_page_url: str, tag_to_object_id: typing.Union[typing.Dict[str, str], None] = None, environment_name: typing.Union[str, None] = None, interactive: bool = False):
-        ...
+class _LocalEntrypoint:
+    _info: modal._utils.function_utils.FunctionInfo
+    _app: _App
 
+    def __init__(self, info: modal._utils.function_utils.FunctionInfo, app: _App) -> None: ...
+    def __call__(self, *args: typing.Any, **kwargs: typing.Any) -> typing.Any: ...
     @property
-    def client(self) -> modal.client._Client:
-        ...
-
+    def info(self) -> modal._utils.function_utils.FunctionInfo: ...
     @property
-    def app_id(self) -> str:
-        ...
-
+    def app(self) -> _App: ...
     @property
-    def is_interactive(self) -> bool:
-        ...
-
-    async def _create_all_objects(self, indexed_objects: typing.Dict[str, modal.object._Object], new_app_state: int, environment_name: str, output_mgr: typing.Union[modal._output.OutputManager, None] = None):
-        ...
-
-    async def disconnect(self, reason: typing.Union[int, None] = None, exc_str: typing.Union[str, None] = None):
-        ...
-
-    async def stop(self):
-        ...
+    def stub(self) -> _App: ...
 
-    def log_url(self):
-        ...
-
-    @staticmethod
-    async def _init_existing(client: modal.client._Client, existing_app_id: str) -> _LocalApp:
-        ...
-
-    @staticmethod
-    async def _init_new(client: modal.client._Client, description: str, app_state: int, environment_name: str = '', interactive=False) -> _LocalApp:
-        ...
-
-    @staticmethod
-    async def _init_from_name(client: modal.client._Client, name: str, namespace, environment_name: str = ''):
-        ...
-
-    async def deploy(self, name: str, namespace, public: bool) -> str:
-        ...
-
-
-class _ContainerApp:
-    _client: typing.Union[modal.client._Client, None]
-    _app_id: typing.Union[str, None]
-    _environment_name: typing.Union[str, None]
-    _tag_to_object_id: typing.Dict[str, str]
-    _object_handle_metadata: typing.Dict[str, typing.Union[google.protobuf.message.Message, None]]
-    _is_interactivity_enabled: bool
-    _function_def: typing.Union[modal_proto.api_pb2.Function, None]
-    _fetching_inputs: bool
-
-    def __init__(self):
-        ...
+class LocalEntrypoint:
+    _info: modal._utils.function_utils.FunctionInfo
+    _app: App
 
+    def __init__(self, info: modal._utils.function_utils.FunctionInfo, app: App) -> None: ...
+    def __call__(self, *args: typing.Any, **kwargs: typing.Any) -> typing.Any: ...
     @property
-    def client(self) -> typing.Union[modal.client._Client, None]:
-        ...
-
+    def info(self) -> modal._utils.function_utils.FunctionInfo: ...
     @property
-    def app_id(self) -> typing.Union[str, None]:
-        ...
-
+    def app(self) -> App: ...
     @property
-    def fetching_inputs(self) -> bool:
-        ...
-
-    def associate_stub_container(self, stub):
-        ...
-
-    def _has_object(self, tag: str) -> bool:
-        ...
-
-    def _hydrate_object(self, obj, tag: str):
-        ...
-
-    def hydrate_function_deps(self, function: _Function, dep_object_ids: typing.List[str]):
-        ...
-
-    async def init(self, client: modal.client._Client, app_id: str, environment_name: str = '', function_def: typing.Union[modal_proto.api_pb2.Function, None] = None):
-        ...
-
+    def stub(self) -> App: ...
+
+def check_sequence(items: typing.Sequence[typing.Any], item_type: type[typing.Any], error_msg: str) -> None: ...
+
+CLS_T = typing.TypeVar("CLS_T", bound="type[typing.Any]")
+
+P = typing_extensions.ParamSpec("P")
+
+ReturnType = typing.TypeVar("ReturnType")
+
+OriginalReturnType = typing.TypeVar("OriginalReturnType")
+
+class _FunctionDecoratorType:
+    @typing.overload
+    def __call__(
+        self, func: modal.partial_function.PartialFunction[P, ReturnType, OriginalReturnType]
+    ) -> modal.functions.Function[P, ReturnType, OriginalReturnType]: ...
+    @typing.overload
+    def __call__(
+        self, func: typing.Callable[P, collections.abc.Coroutine[typing.Any, typing.Any, ReturnType]]
+    ) -> modal.functions.Function[P, ReturnType, collections.abc.Coroutine[typing.Any, typing.Any, ReturnType]]: ...
+    @typing.overload
+    def __call__(self, func: typing.Callable[P, ReturnType]) -> modal.functions.Function[P, ReturnType, ReturnType]: ...
+
+class _App:
+    _all_apps: typing.ClassVar[dict[typing.Optional[str], list[_App]]]
+    _container_app: typing.ClassVar[typing.Optional[_App]]
+    _name: typing.Optional[str]
+    _description: typing.Optional[str]
+    _functions: dict[str, modal.functions._Function]
+    _classes: dict[str, modal.cls._Cls]
+    _image: typing.Optional[modal.image._Image]
+    _mounts: collections.abc.Sequence[modal.mount._Mount]
+    _secrets: collections.abc.Sequence[modal.secret._Secret]
+    _volumes: dict[typing.Union[str, pathlib.PurePosixPath], modal.volume._Volume]
+    _web_endpoints: list[str]
+    _local_entrypoints: dict[str, _LocalEntrypoint]
+    _app_id: typing.Optional[str]
+    _running_app: typing.Optional[modal.running_app.RunningApp]
+    _client: typing.Optional[modal.client._Client]
+
+    def __init__(
+        self,
+        name: typing.Optional[str] = None,
+        *,
+        image: typing.Optional[modal.image._Image] = None,
+        mounts: collections.abc.Sequence[modal.mount._Mount] = [],
+        secrets: collections.abc.Sequence[modal.secret._Secret] = [],
+        volumes: dict[typing.Union[str, pathlib.PurePosixPath], modal.volume._Volume] = {},
+    ) -> None: ...
+    @property
+    def name(self) -> typing.Optional[str]: ...
+    @property
+    def is_interactive(self) -> bool: ...
+    @property
+    def app_id(self) -> typing.Optional[str]: ...
+    @property
+    def description(self) -> typing.Optional[str]: ...
     @staticmethod
-    def _reset_container():
-        ...
-
-    def stop_fetching_inputs(self):
-        ...
-
-
-class LocalApp:
-    _tag_to_object_id: typing.Dict[str, str]
-    _client: modal.client.Client
-    _app_id: str
-    _app_page_url: str
-    _environment_name: str
-    _interactive: bool
-
-    def __init__(self, client: modal.client.Client, app_id: str, app_page_url: str, tag_to_object_id: typing.Union[typing.Dict[str, str], None] = None, environment_name: typing.Union[str, None] = None, interactive: bool = False):
-        ...
-
+    async def lookup(
+        name: str,
+        client: typing.Optional[modal.client._Client] = None,
+        environment_name: typing.Optional[str] = None,
+        create_if_missing: bool = False,
+    ) -> _App: ...
+    def set_description(self, description: str): ...
+    def _validate_blueprint_value(self, key: str, value: typing.Any): ...
+    def __getitem__(self, tag: str): ...
+    def __setitem__(self, tag: str, obj: modal.object._Object): ...
+    def __getattr__(self, tag: str): ...
+    def __setattr__(self, tag: str, obj: modal.object._Object): ...
     @property
-    def client(self) -> modal.client.Client:
-        ...
-
+    def image(self) -> modal.image._Image: ...
+    @image.setter
+    def image(self, value): ...
+    def _uncreate_all_objects(self): ...
+    def _set_local_app(
+        self, client: modal.client._Client, running_app: modal.running_app.RunningApp
+    ) -> typing.AsyncContextManager[None]: ...
+    def run(
+        self,
+        client: typing.Optional[modal.client._Client] = None,
+        show_progress: typing.Optional[bool] = None,
+        detach: bool = False,
+        interactive: bool = False,
+    ) -> typing.AsyncContextManager[_App]: ...
+    def _get_default_image(self): ...
+    def _get_watch_mounts(self): ...
+    def _add_function(self, function: modal.functions._Function, is_web_endpoint: bool): ...
+    def _add_class(self, tag: str, cls: modal.cls._Cls): ...
+    def _init_container(self, client: modal.client._Client, running_app: modal.running_app.RunningApp): ...
     @property
-    def app_id(self) -> str:
-        ...
-
+    def registered_functions(self) -> dict[str, modal.functions._Function]: ...
     @property
-    def is_interactive(self) -> bool:
-        ...
-
-    class ___create_all_objects_spec(typing_extensions.Protocol):
-        def __call__(self, indexed_objects: typing.Dict[str, modal.object.Object], new_app_state: int, environment_name: str, output_mgr: typing.Union[modal._output.OutputManager, None] = None):
-            ...
-
-        async def aio(self, *args, **kwargs):
-            ...
-
-    _create_all_objects: ___create_all_objects_spec
-
-    class __disconnect_spec(typing_extensions.Protocol):
-        def __call__(self, reason: typing.Union[int, None] = None, exc_str: typing.Union[str, None] = None):
-            ...
-
-        async def aio(self, *args, **kwargs):
-            ...
-
-    disconnect: __disconnect_spec
-
-    class __stop_spec(typing_extensions.Protocol):
-        def __call__(self):
-            ...
-
-        async def aio(self, *args, **kwargs):
-            ...
-
-    stop: __stop_spec
-
-    def log_url(self):
-        ...
-
-    class ___init_existing_spec(typing_extensions.Protocol):
-        def __call__(self, client: modal.client.Client, existing_app_id: str) -> LocalApp:
-            ...
-
-        async def aio(self, *args, **kwargs) -> LocalApp:
-            ...
-
-    _init_existing: ___init_existing_spec
-
-    class ___init_new_spec(typing_extensions.Protocol):
-        def __call__(self, client: modal.client.Client, description: str, app_state: int, environment_name: str = '', interactive=False) -> LocalApp:
-            ...
-
-        async def aio(self, *args, **kwargs) -> LocalApp:
-            ...
-
-    _init_new: ___init_new_spec
-
-    class ___init_from_name_spec(typing_extensions.Protocol):
-        def __call__(self, client: modal.client.Client, name: str, namespace, environment_name: str = ''):
-            ...
-
-        async def aio(self, *args, **kwargs):
-            ...
-
-    _init_from_name: ___init_from_name_spec
-
-    class __deploy_spec(typing_extensions.Protocol):
-        def __call__(self, name: str, namespace, public: bool) -> str:
-            ...
-
-        async def aio(self, *args, **kwargs) -> str:
-            ...
-
-    deploy: __deploy_spec
-
-
-class ContainerApp:
-    _client: typing.Union[modal.client.Client, None]
-    _app_id: typing.Union[str, None]
-    _environment_name: typing.Union[str, None]
-    _tag_to_object_id: typing.Dict[str, str]
-    _object_handle_metadata: typing.Dict[str, typing.Union[google.protobuf.message.Message, None]]
-    _is_interactivity_enabled: bool
-    _function_def: typing.Union[modal_proto.api_pb2.Function, None]
-    _fetching_inputs: bool
-
-    def __init__(self):
-        ...
-
+    def registered_classes(self) -> dict[str, modal.functions._Function]: ...
     @property
-    def client(self) -> typing.Union[modal.client.Client, None]:
-        ...
-
+    def registered_entrypoints(self) -> dict[str, _LocalEntrypoint]: ...
     @property
-    def app_id(self) -> typing.Union[str, None]:
-        ...
-
+    def indexed_objects(self) -> dict[str, modal.object._Object]: ...
     @property
-    def fetching_inputs(self) -> bool:
-        ...
-
-    def associate_stub_container(self, stub):
-        ...
-
-    def _has_object(self, tag: str) -> bool:
-        ...
-
-    def _hydrate_object(self, obj, tag: str):
-        ...
-
-    def hydrate_function_deps(self, function: _Function, dep_object_ids: typing.List[str]):
-        ...
-
-    class __init_spec(typing_extensions.Protocol):
-        def __call__(self, client: modal.client.Client, app_id: str, environment_name: str = '', function_def: typing.Union[modal_proto.api_pb2.Function, None] = None):
-            ...
-
-        async def aio(self, *args, **kwargs):
-            ...
-
-    init: __init_spec
-
+    def registered_web_endpoints(self) -> list[str]: ...
+    def local_entrypoint(
+        self, _warn_parentheses_missing: typing.Any = None, *, name: typing.Optional[str] = None
+    ) -> typing.Callable[[typing.Callable[..., typing.Any]], _LocalEntrypoint]: ...
+    def function(
+        self,
+        _warn_parentheses_missing: typing.Any = None,
+        *,
+        image: typing.Optional[modal.image._Image] = None,
+        schedule: typing.Optional[modal.schedule.Schedule] = None,
+        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]]
+        ] = None,
+        serialized: bool = False,
+        mounts: collections.abc.Sequence[modal.mount._Mount] = (),
+        network_file_systems: dict[
+            typing.Union[str, pathlib.PurePosixPath], modal.network_file_system._NetworkFileSystem
+        ] = {},
+        volumes: dict[
+            typing.Union[str, pathlib.PurePosixPath],
+            typing.Union[modal.volume._Volume, modal.cloud_bucket_mount._CloudBucketMount],
+        ] = {},
+        allow_cross_region_volumes: bool = False,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
+        ephemeral_disk: typing.Optional[int] = None,
+        proxy: typing.Optional[modal.proxy._Proxy] = None,
+        retries: typing.Union[int, modal.retries.Retries, None] = None,
+        concurrency_limit: typing.Optional[int] = None,
+        allow_concurrent_inputs: typing.Optional[int] = None,
+        container_idle_timeout: typing.Optional[int] = None,
+        timeout: typing.Optional[int] = None,
+        keep_warm: typing.Optional[int] = None,
+        name: typing.Optional[str] = None,
+        is_generator: typing.Optional[bool] = None,
+        cloud: typing.Optional[str] = None,
+        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        enable_memory_snapshot: bool = False,
+        block_network: bool = False,
+        max_inputs: typing.Optional[int] = None,
+        i6pn: typing.Optional[bool] = None,
+        _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        _experimental_buffer_containers: typing.Optional[int] = None,
+        _experimental_proxy_ip: typing.Optional[str] = None,
+        _experimental_custom_scaling_factor: typing.Optional[float] = None,
+    ) -> _FunctionDecoratorType: ...
+    @typing_extensions.dataclass_transform(
+        field_specifiers=(modal.cls.parameter,),
+        kw_only_default=True,
+    )
+    def cls(
+        self,
+        _warn_parentheses_missing: typing.Optional[bool] = None,
+        *,
+        image: typing.Optional[modal.image._Image] = None,
+        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]]
+        ] = None,
+        serialized: bool = False,
+        mounts: collections.abc.Sequence[modal.mount._Mount] = (),
+        network_file_systems: dict[
+            typing.Union[str, pathlib.PurePosixPath], modal.network_file_system._NetworkFileSystem
+        ] = {},
+        volumes: dict[
+            typing.Union[str, pathlib.PurePosixPath],
+            typing.Union[modal.volume._Volume, modal.cloud_bucket_mount._CloudBucketMount],
+        ] = {},
+        allow_cross_region_volumes: bool = False,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
+        ephemeral_disk: typing.Optional[int] = None,
+        proxy: typing.Optional[modal.proxy._Proxy] = None,
+        retries: typing.Union[int, modal.retries.Retries, None] = None,
+        concurrency_limit: typing.Optional[int] = None,
+        allow_concurrent_inputs: typing.Optional[int] = None,
+        container_idle_timeout: typing.Optional[int] = None,
+        timeout: typing.Optional[int] = None,
+        keep_warm: typing.Optional[int] = None,
+        cloud: typing.Optional[str] = None,
+        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        enable_memory_snapshot: bool = False,
+        block_network: bool = False,
+        max_inputs: typing.Optional[int] = None,
+        _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        _experimental_buffer_containers: typing.Optional[int] = None,
+        _experimental_proxy_ip: typing.Optional[str] = None,
+        _experimental_custom_scaling_factor: typing.Optional[float] = None,
+    ) -> typing.Callable[[CLS_T], CLS_T]: ...
+    async def spawn_sandbox(
+        self,
+        *entrypoint_args: str,
+        image: typing.Optional[modal.image._Image] = None,
+        mounts: collections.abc.Sequence[modal.mount._Mount] = (),
+        secrets: collections.abc.Sequence[modal.secret._Secret] = (),
+        network_file_systems: dict[
+            typing.Union[str, pathlib.PurePosixPath], modal.network_file_system._NetworkFileSystem
+        ] = {},
+        timeout: typing.Optional[int] = None,
+        workdir: typing.Optional[str] = None,
+        gpu: typing.Union[None, bool, str, modal.gpu._GPUConfig] = None,
+        cloud: typing.Optional[str] = None,
+        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
+        block_network: bool = False,
+        volumes: dict[
+            typing.Union[str, pathlib.PurePosixPath],
+            typing.Union[modal.volume._Volume, modal.cloud_bucket_mount._CloudBucketMount],
+        ] = {},
+        pty_info: typing.Optional[modal_proto.api_pb2.PTYInfo] = None,
+        _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+    ) -> None: ...
+    def include(self, /, other_app: _App): ...
+    def _logs(
+        self, client: typing.Optional[modal.client._Client] = None
+    ) -> collections.abc.AsyncGenerator[str, None]: ...
+    @classmethod
+    def _get_container_app(cls) -> typing.Optional[_App]: ...
+    @classmethod
+    def _reset_container_app(cls): ...
+
+class App:
+    _all_apps: typing.ClassVar[dict[typing.Optional[str], list[App]]]
+    _container_app: typing.ClassVar[typing.Optional[App]]
+    _name: typing.Optional[str]
+    _description: typing.Optional[str]
+    _functions: dict[str, modal.functions.Function]
+    _classes: dict[str, modal.cls.Cls]
+    _image: typing.Optional[modal.image.Image]
+    _mounts: collections.abc.Sequence[modal.mount.Mount]
+    _secrets: collections.abc.Sequence[modal.secret.Secret]
+    _volumes: dict[typing.Union[str, pathlib.PurePosixPath], modal.volume.Volume]
+    _web_endpoints: list[str]
+    _local_entrypoints: dict[str, LocalEntrypoint]
+    _app_id: typing.Optional[str]
+    _running_app: typing.Optional[modal.running_app.RunningApp]
+    _client: typing.Optional[modal.client.Client]
+
+    def __init__(
+        self,
+        name: typing.Optional[str] = None,
+        *,
+        image: typing.Optional[modal.image.Image] = None,
+        mounts: collections.abc.Sequence[modal.mount.Mount] = [],
+        secrets: collections.abc.Sequence[modal.secret.Secret] = [],
+        volumes: dict[typing.Union[str, pathlib.PurePosixPath], modal.volume.Volume] = {},
+    ) -> None: ...
+    @property
+    def name(self) -> typing.Optional[str]: ...
+    @property
+    def is_interactive(self) -> bool: ...
+    @property
+    def app_id(self) -> typing.Optional[str]: ...
+    @property
+    def description(self) -> typing.Optional[str]: ...
+
+    class __lookup_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            name: str,
+            client: typing.Optional[modal.client.Client] = None,
+            environment_name: typing.Optional[str] = None,
+            create_if_missing: bool = False,
+        ) -> App: ...
+        async def aio(
+            self,
+            name: str,
+            client: typing.Optional[modal.client.Client] = None,
+            environment_name: typing.Optional[str] = None,
+            create_if_missing: bool = False,
+        ) -> App: ...
+
+    lookup: __lookup_spec
+
+    def set_description(self, description: str): ...
+    def _validate_blueprint_value(self, key: str, value: typing.Any): ...
+    def __getitem__(self, tag: str): ...
+    def __setitem__(self, tag: str, obj: modal.object.Object): ...
+    def __getattr__(self, tag: str): ...
+    def __setattr__(self, tag: str, obj: modal.object.Object): ...
+    @property
+    def image(self) -> modal.image.Image: ...
+    @image.setter
+    def image(self, value): ...
+    def _uncreate_all_objects(self): ...
+
+    class ___set_local_app_spec(typing_extensions.Protocol):
+        def __call__(
+            self, client: modal.client.Client, running_app: modal.running_app.RunningApp
+        ) -> synchronicity.combined_types.AsyncAndBlockingContextManager[None]: ...
+        def aio(
+            self, client: modal.client.Client, running_app: modal.running_app.RunningApp
+        ) -> typing.AsyncContextManager[None]: ...
+
+    _set_local_app: ___set_local_app_spec
+
+    class __run_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            client: typing.Optional[modal.client.Client] = None,
+            show_progress: typing.Optional[bool] = None,
+            detach: bool = False,
+            interactive: bool = False,
+        ) -> synchronicity.combined_types.AsyncAndBlockingContextManager[App]: ...
+        def aio(
+            self,
+            client: typing.Optional[modal.client.Client] = None,
+            show_progress: typing.Optional[bool] = None,
+            detach: bool = False,
+            interactive: bool = False,
+        ) -> typing.AsyncContextManager[App]: ...
+
+    run: __run_spec
+
+    def _get_default_image(self): ...
+    def _get_watch_mounts(self): ...
+    def _add_function(self, function: modal.functions.Function, is_web_endpoint: bool): ...
+    def _add_class(self, tag: str, cls: modal.cls.Cls): ...
+    def _init_container(self, client: modal.client.Client, running_app: modal.running_app.RunningApp): ...
+    @property
+    def registered_functions(self) -> dict[str, modal.functions.Function]: ...
+    @property
+    def registered_classes(self) -> dict[str, modal.functions.Function]: ...
+    @property
+    def registered_entrypoints(self) -> dict[str, LocalEntrypoint]: ...
+    @property
+    def indexed_objects(self) -> dict[str, modal.object.Object]: ...
+    @property
+    def registered_web_endpoints(self) -> list[str]: ...
+    def local_entrypoint(
+        self, _warn_parentheses_missing: typing.Any = None, *, name: typing.Optional[str] = None
+    ) -> typing.Callable[[typing.Callable[..., typing.Any]], LocalEntrypoint]: ...
+    def function(
+        self,
+        _warn_parentheses_missing: typing.Any = None,
+        *,
+        image: typing.Optional[modal.image.Image] = None,
+        schedule: typing.Optional[modal.schedule.Schedule] = None,
+        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]]
+        ] = None,
+        serialized: bool = False,
+        mounts: collections.abc.Sequence[modal.mount.Mount] = (),
+        network_file_systems: dict[
+            typing.Union[str, pathlib.PurePosixPath], modal.network_file_system.NetworkFileSystem
+        ] = {},
+        volumes: dict[
+            typing.Union[str, pathlib.PurePosixPath],
+            typing.Union[modal.volume.Volume, modal.cloud_bucket_mount.CloudBucketMount],
+        ] = {},
+        allow_cross_region_volumes: bool = False,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
+        ephemeral_disk: typing.Optional[int] = None,
+        proxy: typing.Optional[modal.proxy.Proxy] = None,
+        retries: typing.Union[int, modal.retries.Retries, None] = None,
+        concurrency_limit: typing.Optional[int] = None,
+        allow_concurrent_inputs: typing.Optional[int] = None,
+        container_idle_timeout: typing.Optional[int] = None,
+        timeout: typing.Optional[int] = None,
+        keep_warm: typing.Optional[int] = None,
+        name: typing.Optional[str] = None,
+        is_generator: typing.Optional[bool] = None,
+        cloud: typing.Optional[str] = None,
+        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        enable_memory_snapshot: bool = False,
+        block_network: bool = False,
+        max_inputs: typing.Optional[int] = None,
+        i6pn: typing.Optional[bool] = None,
+        _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        _experimental_buffer_containers: typing.Optional[int] = None,
+        _experimental_proxy_ip: typing.Optional[str] = None,
+        _experimental_custom_scaling_factor: typing.Optional[float] = None,
+    ) -> _FunctionDecoratorType: ...
+    @typing_extensions.dataclass_transform(
+        field_specifiers=(modal.cls.parameter,),
+        kw_only_default=True,
+    )
+    def cls(
+        self,
+        _warn_parentheses_missing: typing.Optional[bool] = None,
+        *,
+        image: typing.Optional[modal.image.Image] = None,
+        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]]
+        ] = None,
+        serialized: bool = False,
+        mounts: collections.abc.Sequence[modal.mount.Mount] = (),
+        network_file_systems: dict[
+            typing.Union[str, pathlib.PurePosixPath], modal.network_file_system.NetworkFileSystem
+        ] = {},
+        volumes: dict[
+            typing.Union[str, pathlib.PurePosixPath],
+            typing.Union[modal.volume.Volume, modal.cloud_bucket_mount.CloudBucketMount],
+        ] = {},
+        allow_cross_region_volumes: bool = False,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
+        ephemeral_disk: typing.Optional[int] = None,
+        proxy: typing.Optional[modal.proxy.Proxy] = None,
+        retries: typing.Union[int, modal.retries.Retries, None] = None,
+        concurrency_limit: typing.Optional[int] = None,
+        allow_concurrent_inputs: typing.Optional[int] = None,
+        container_idle_timeout: typing.Optional[int] = None,
+        timeout: typing.Optional[int] = None,
+        keep_warm: typing.Optional[int] = None,
+        cloud: typing.Optional[str] = None,
+        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        enable_memory_snapshot: bool = False,
+        block_network: bool = False,
+        max_inputs: typing.Optional[int] = None,
+        _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        _experimental_buffer_containers: typing.Optional[int] = None,
+        _experimental_proxy_ip: typing.Optional[str] = None,
+        _experimental_custom_scaling_factor: typing.Optional[float] = None,
+    ) -> typing.Callable[[CLS_T], CLS_T]: ...
+
+    class __spawn_sandbox_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            *entrypoint_args: str,
+            image: typing.Optional[modal.image.Image] = None,
+            mounts: collections.abc.Sequence[modal.mount.Mount] = (),
+            secrets: collections.abc.Sequence[modal.secret.Secret] = (),
+            network_file_systems: dict[
+                typing.Union[str, pathlib.PurePosixPath], modal.network_file_system.NetworkFileSystem
+            ] = {},
+            timeout: typing.Optional[int] = None,
+            workdir: typing.Optional[str] = None,
+            gpu: typing.Union[None, bool, str, modal.gpu._GPUConfig] = None,
+            cloud: typing.Optional[str] = None,
+            region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+            cpu: typing.Union[float, tuple[float, float], None] = None,
+            memory: typing.Union[int, tuple[int, int], None] = None,
+            block_network: bool = False,
+            volumes: dict[
+                typing.Union[str, pathlib.PurePosixPath],
+                typing.Union[modal.volume.Volume, modal.cloud_bucket_mount.CloudBucketMount],
+            ] = {},
+            pty_info: typing.Optional[modal_proto.api_pb2.PTYInfo] = None,
+            _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        ) -> None: ...
+        async def aio(
+            self,
+            *entrypoint_args: str,
+            image: typing.Optional[modal.image.Image] = None,
+            mounts: collections.abc.Sequence[modal.mount.Mount] = (),
+            secrets: collections.abc.Sequence[modal.secret.Secret] = (),
+            network_file_systems: dict[
+                typing.Union[str, pathlib.PurePosixPath], modal.network_file_system.NetworkFileSystem
+            ] = {},
+            timeout: typing.Optional[int] = None,
+            workdir: typing.Optional[str] = None,
+            gpu: typing.Union[None, bool, str, modal.gpu._GPUConfig] = None,
+            cloud: typing.Optional[str] = None,
+            region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+            cpu: typing.Union[float, tuple[float, float], None] = None,
+            memory: typing.Union[int, tuple[int, int], None] = None,
+            block_network: bool = False,
+            volumes: dict[
+                typing.Union[str, pathlib.PurePosixPath],
+                typing.Union[modal.volume.Volume, modal.cloud_bucket_mount.CloudBucketMount],
+            ] = {},
+            pty_info: typing.Optional[modal_proto.api_pb2.PTYInfo] = None,
+            _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        ) -> None: ...
+
+    spawn_sandbox: __spawn_sandbox_spec
+
+    def include(self, /, other_app: App): ...
+
+    class ___logs_spec(typing_extensions.Protocol):
+        def __call__(
+            self, client: typing.Optional[modal.client.Client] = None
+        ) -> typing.Generator[str, None, None]: ...
+        def aio(
+            self, client: typing.Optional[modal.client.Client] = None
+        ) -> collections.abc.AsyncGenerator[str, None]: ...
+
+    _logs: ___logs_spec
+
+    @classmethod
+    def _get_container_app(cls) -> typing.Optional[App]: ...
+    @classmethod
+    def _reset_container_app(cls): ...
+
+class _Stub(_App):
     @staticmethod
-    def _reset_container():
-        ...
-
-    def stop_fetching_inputs(self):
-        ...
-
-
-_container_app: _ContainerApp
-
-container_app: ContainerApp
-
-async def _interact(client: typing.Union[modal.client._Client, None] = None) -> None:
-    ...
-
-
-class __interact_spec(typing_extensions.Protocol):
-    def __call__(self, client: typing.Union[modal.client.Client, None] = None) -> None:
-        ...
-
-    async def aio(self, *args, **kwargs) -> None:
-        ...
-
-interact: __interact_spec
-
-
-def is_local() -> bool:
-    ...
-
-
-async def _list_apps(env: str, client: typing.Union[modal.client._Client, None] = None) -> typing.List[modal_proto.api_pb2.AppStats]:
-    ...
-
-
-class __list_apps_spec(typing_extensions.Protocol):
-    def __call__(self, env: str, client: typing.Union[modal.client.Client, None] = None) -> typing.List[modal_proto.api_pb2.AppStats]:
-        ...
-
-    async def aio(self, *args, **kwargs) -> typing.List[modal_proto.api_pb2.AppStats]:
-        ...
-
-list_apps: __list_apps_spec
+    def __new__(
+        cls,
+        name: typing.Optional[str] = None,
+        *,
+        image: typing.Optional[modal.image._Image] = None,
+        mounts: collections.abc.Sequence[modal.mount._Mount] = [],
+        secrets: collections.abc.Sequence[modal.secret._Secret] = [],
+        volumes: dict[typing.Union[str, pathlib.PurePosixPath], modal.volume._Volume] = {},
+    ): ...
+
+class Stub(App):
+    def __init__(
+        self,
+        name: typing.Optional[str] = None,
+        *,
+        image: typing.Optional[modal.image.Image] = None,
+        mounts: collections.abc.Sequence[modal.mount.Mount] = [],
+        secrets: collections.abc.Sequence[modal.secret.Secret] = [],
+        volumes: dict[typing.Union[str, pathlib.PurePosixPath], modal.volume.Volume] = {},
+    ) -> None: ...
+
+_default_image: modal.image._Image