modal 0.73.81__tar.gz → 0.73.83__tar.gz

{modal-0.73.81 → modal-0.73.83}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: modal
-Version: 0.73.81
+Version: 0.73.83
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License: Apache-2.0

{modal-0.73.81 → modal-0.73.83}/modal/__init__.py

@@ -23,7 +23,18 @@ try:
     from .mount import Mount
     from .network_file_system import NetworkFileSystem
     from .output import enable_output
-    from .partial_function import asgi_app, batched, build, enter, exit, method, web_endpoint, web_server, wsgi_app
+    from .partial_function import (
+        asgi_app,
+        batched,
+        build,
+        enter,
+        exit,
+        fastapi_endpoint,
+        method,
+        web_endpoint,
+        web_server,
+        wsgi_app,
+    )
     from .proxy import Proxy
     from .queue import Queue
     from .retries import Retries
@@ -76,6 +87,7 @@ __all__ = [
     "enable_output",
     "enter",
     "exit",
+    "fastapi_endpoint",
     "forward",
     "is_local",
     "interact",

{modal-0.73.81 → modal-0.73.83}/modal/_partial_function.py

@@ -256,6 +256,64 @@ def _parse_custom_domains(custom_domains: Optional[Iterable[str]] = None) -> lis
     return _custom_domains
 
 
+def _fastapi_endpoint(
+    _warn_parentheses_missing=None,
+    *,
+    method: str = "GET",  # REST method for the created endpoint.
+    label: Optional[str] = None,  # Label for created endpoint. Final subdomain will be <workspace>--<label>.modal.run.
+    custom_domains: Optional[Iterable[str]] = None,  # Custom fully-qualified domain name (FQDN) for the endpoint.
+    docs: bool = False,  # Whether to enable interactive documentation for this endpoint at /docs.
+    requires_proxy_auth: bool = False,  # Require Modal-Key and Modal-Secret HTTP Headers on requests.
+) -> Callable[[Callable[P, ReturnType]], _PartialFunction[P, ReturnType, ReturnType]]:
+    """Register a basic web endpoint with this application.
+
+    This is the simple way to create a web endpoint on Modal. The function
+    behaves as a [FastAPI](https://fastapi.tiangolo.com/) handler and should
+    return a response object to the caller.
+
+    Endpoints created with `@app.fastapi_endpoint` are meant to be simple, single
+    request handlers and automatically have
+    [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) enabled.
+    For more flexibility, use `@app.asgi_app`.
+
+    To learn how to use Modal with popular web frameworks, see the
+    [guide on web endpoints](https://modal.com/docs/guide/webhooks).
+
+    This function replaces the deprecated `@web_endpoint` decorator.
+    """
+    if isinstance(_warn_parentheses_missing, str):
+        # Probably passing the method string as a positional argument.
+        raise InvalidError('Positional arguments are not allowed. Suggestion: `@fastapi_endpoint(method="GET")`.')
+    elif _warn_parentheses_missing is not None:
+        raise InvalidError(
+            "Positional arguments are not allowed. Did you forget parentheses? Suggestion: `@fastapi_endpoint()`."
+        )
+
+    def wrapper(raw_f: Callable[..., Any]) -> _PartialFunction:
+        if isinstance(raw_f, _Function):
+            raw_f = raw_f.get_raw_f()
+            raise InvalidError(
+                f"Applying decorators for {raw_f} in the wrong order!\nUsage:\n\n"
+                "@app.function()\n@app.fastapi_endpoint()\ndef my_webhook():\n    ..."
+            )
+
+        return _PartialFunction(
+            raw_f,
+            _PartialFunctionFlags.FUNCTION,
+            api_pb2.WebhookConfig(
+                type=api_pb2.WEBHOOK_TYPE_FUNCTION,
+                method=method,
+                web_endpoint_docs=docs,
+                requested_suffix=label or "",
+                async_mode=api_pb2.WEBHOOK_ASYNC_MODE_AUTO,
+                custom_domains=_parse_custom_domains(custom_domains),
+                requires_proxy_auth=requires_proxy_auth,
+            ),
+        )
+
+    return wrapper
+
+
 def _web_endpoint(
     _warn_parentheses_missing=None,
     *,

{modal-0.73.81 → modal-0.73.83}/modal/app.py

@@ -658,13 +658,13 @@ class _App:
                 if is_method_fn(f.raw_f.__qualname__):
                     raise InvalidError(
                         "The `@app.function` decorator cannot be used on class methods. "
-                        "Swap with `@modal.method` or `@modal.web_endpoint`, or drop the `@app.function` decorator. "
+                        "Swap with `@modal.method` or one of the web endpoint decorators. "
                         "Example: "
                         "\n\n"
                         "```python\n"
                         "@app.cls()\n"
                         "class MyClass:\n"
-                        "    @modal.web_endpoint()\n"
+                        "    @modal.method()\n"
                         "    def f(self, x):\n"
                         "        ...\n"
                         "```\n"

{modal-0.73.81 → modal-0.73.83}/modal/client.pyi

@@ -27,7 +27,7 @@ class _Client:
     _snapshotted: bool
 
     def __init__(
-        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.73.81"
+        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.73.83"
     ): ...
     def is_closed(self) -> bool: ...
     @property
@@ -85,7 +85,7 @@ class Client:
     _snapshotted: bool
 
     def __init__(
-        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.73.81"
+        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.73.83"
     ): ...
     def is_closed(self) -> bool: ...
     @property

{modal-0.73.81 → modal-0.73.83}/modal/partial_function.py

@@ -7,6 +7,7 @@ from ._partial_function import (
     _build,
     _enter,
     _exit,
+    _fastapi_endpoint,
     _method,
     _PartialFunction,
     _web_endpoint,
@@ -19,6 +20,7 @@ from ._partial_function import (
 PartialFunction = synchronize_api(_PartialFunction, target_module=__name__)
 method = synchronize_api(_method, target_module=__name__)
 web_endpoint = synchronize_api(_web_endpoint, target_module=__name__)
+fastapi_endpoint = synchronize_api(_fastapi_endpoint, target_module=__name__)
 asgi_app = synchronize_api(_asgi_app, target_module=__name__)
 wsgi_app = synchronize_api(_wsgi_app, target_module=__name__)
 web_server = synchronize_api(_web_server, target_module=__name__)

{modal-0.73.81 → modal-0.73.83}/modal/partial_function.pyi

@@ -61,6 +61,18 @@ def web_endpoint(
     [collections.abc.Callable[modal._partial_function.P, modal._partial_function.ReturnType]],
     PartialFunction[modal._partial_function.P, modal._partial_function.ReturnType, modal._partial_function.ReturnType],
 ]: ...
+def fastapi_endpoint(
+    _warn_parentheses_missing=None,
+    *,
+    method: str = "GET",
+    label: typing.Optional[str] = None,
+    custom_domains: typing.Optional[collections.abc.Iterable[str]] = None,
+    docs: bool = False,
+    requires_proxy_auth: bool = False,
+) -> collections.abc.Callable[
+    [collections.abc.Callable[modal._partial_function.P, modal._partial_function.ReturnType]],
+    PartialFunction[modal._partial_function.P, modal._partial_function.ReturnType, modal._partial_function.ReturnType],
+]: ...
 def asgi_app(
     _warn_parentheses_missing=None,
     *,

{modal-0.73.81 → modal-0.73.83}/modal.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: modal
-Version: 0.73.81
+Version: 0.73.83
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License: Apache-2.0

{modal-0.73.81 → modal-0.73.83}/modal_version/_version_generated.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2025
 
 # Note: Reset this value to -1 whenever you make a minor `0.X` release of the client.
-build_number = 81  # git: fa53b89
+build_number = 83  # git: a4a605c