fal 0.15.0__py3-none-any.whl → 0.15.2__py3-none-any.whl

fal/__init__.py

@@ -1,8 +1,7 @@
 from __future__ import annotations
 
 from fal import apps  # noqa: F401
-from fal.api import FalServerlessHost, LocalHost, cached
-from fal.api import function
+from fal.api import FalServerlessHost, LocalHost, cached, function
 from fal.api import function as isolated  # noqa: F401
 from fal.app import App, endpoint, realtime, wrap_app  # noqa: F401
 from fal.sdk import FalServerlessKeyCredentials
@@ -24,14 +23,3 @@ __all__ = [
     "FalServerlessKeyCredentials",
     "sync_dir",
 ]
-
-
-# NOTE: This makes `import fal.dbt` import the `dbt-fal` module and `import fal` import the `fal` module
-# NOTE: taken from dbt-core: https://github.com/dbt-labs/dbt-core/blob/ac539fd5cf325cfb5315339077d03399d575f570/core/dbt/adapters/__init__.py#L1-L7
-# N.B.
-# This will add to the package’s __path__ all subdirectories of directories on sys.path named after the package which effectively combines both modules into a single namespace (dbt.adapters)
-# The matching statement is in plugins/postgres/dbt/adapters/__init__.py
-
-from pkgutil import extend_path  # noqa: E402
-
-__path__ = extend_path(__path__, __name__)

fal/_serialization.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
+import pickle
 from typing import Any, Callable
 
-import pickle
 import cloudpickle
 
 
@@ -98,11 +98,12 @@ def _patch_pydantic_field_serialization() -> None:
 
 
 def _patch_pydantic_model_serialization() -> None:
-    # If user has created new pydantic models in his namespace, we will try to pickle those
-    # by value, which means recreating class skeleton, which will stumble upon
-    # __pydantic_parent_namespace__ in its __dict__ and it may contain modules that happened
-    # to be imported in the namespace but are not actually used, resulting in pickling errors.
-    # Unfortunately this also means that `model_rebuid()` might not work.
+    # If user has created new pydantic models in his namespace, we will try to pickle
+    # those by value, which means recreating class skeleton, which will stumble upon
+    # __pydantic_parent_namespace__ in its __dict__ and it may contain modules that
+    # happened to be imported in the namespace but are not actually used, resulting
+    # in pickling errors. Unfortunately this also means that `model_rebuid()` might
+    # not work.
     try:
         import pydantic
     except ImportError:
@@ -133,7 +134,8 @@ def _patch_lru_cache() -> None:
     # https://github.com/cloudpipe/cloudpickle/issues/178
     # https://github.com/uqfoundation/dill/blob/70f569b0dd268d2b1e85c0f300951b11f53c5d53/dill/_dill.py#L1429
 
-    from functools import lru_cache, _lru_cache_wrapper as LRUCacheType
+    from functools import _lru_cache_wrapper as LRUCacheType
+    from functools import lru_cache
 
     def create_lru_cache(func: Callable, kwargs: dict) -> LRUCacheType:
         return lru_cache(**kwargs)(func)
@@ -155,8 +157,8 @@ def _patch_lru_cache() -> None:
 
 def _patch_lock() -> None:
     # https://github.com/uqfoundation/dill/blob/70f569b0dd268d2b1e85c0f300951b11f53c5d53/dill/_dill.py#L1310
-    from threading import Lock
     from _thread import LockType
+    from threading import Lock
 
     def create_lock(locked: bool) -> Lock:
         lock = Lock()
@@ -199,7 +201,11 @@ def _patch_console_thread_locals() -> None:
         return ConsoleThreadLocals(**kwargs)
 
     def pickle_locals(obj: ConsoleThreadLocals) -> tuple[Callable, tuple]:
-        kwargs = {"theme_stack": obj.theme_stack, "buffer": obj.buffer, "buffer_index": obj.buffer_index}
+        kwargs = {
+            "theme_stack": obj.theme_stack,
+            "buffer": obj.buffer,
+            "buffer_index": obj.buffer_index,
+        }
         return create_locals, (kwargs, )
 
     _register(ConsoleThreadLocals, pickle_locals)

fal/api.py

@@ -40,8 +40,8 @@ from pydantic import __version__ as pydantic_version
 from typing_extensions import Concatenate, ParamSpec
 
 import fal.flags as flags
-from fal.exceptions import FalServerlessException
 from fal._serialization import include_modules_from, patch_pickle
+from fal.exceptions import FalServerlessException
 from fal.logging.isolate import IsolateLogPrinter
 from fal.sdk import (
     FAL_SERVERLESS_DEFAULT_KEEP_ALIVE,
@@ -57,7 +57,7 @@ from fal.sdk import (
 )
 
 ArgsT = ParamSpec("ArgsT")
-ReturnT = TypeVar("ReturnT", covariant=True)
+ReturnT = TypeVar("ReturnT", covariant=True)  # noqa: PLC0105
 
 BasicConfig = Dict[str, Any]
 _UNSET = object()
@@ -113,8 +113,8 @@ class Host(Generic[ArgsT, ReturnT]):
         environment options."""
 
         options = Options()
-        for key, value in config.items():
-            key, value = cls.parse_key(key, value)
+        for item in config.items():
+            key, value = cls.parse_key(*item)
             if key in cls._SUPPORTED_KEYS:
                 options.host[key] = value
             elif key in cls._GATEWAY_KEYS:
@@ -545,7 +545,8 @@ _DEFAULT_HOST = FalServerlessHost()
 _SERVE_PORT = 8080
 
 # Overload @function to help users identify the correct signature.
-# NOTE: This is both in sync with host options and with environment configs from `isolate` package.
+# NOTE: This is both in sync with host options and with environment configs from
+# `isolate` package.
 
 
 ## virtualenv
@@ -785,7 +786,8 @@ class FalFastAPI(FastAPI):
         """
         Add x-fal-order-* keys to the OpenAPI specification to help the rendering of UI.
 
-        NOTE: We rely on the fact that fastapi and Python dicts keep the order of properties.
+        NOTE: We rely on the fact that fastapi and Python dicts keep the order of
+        properties.
         """
 
         def mark_order(obj: dict[str, Any], key: str):
@@ -918,7 +920,9 @@ class BaseServable:
                 asyncio.create_task(metrics_server.serve()): metrics_server,
             }
 
-            _, pending = await asyncio.wait(tasks.keys(), return_when=asyncio.FIRST_COMPLETED)
+            _, pending = await asyncio.wait(
+                tasks.keys(), return_when=asyncio.FIRST_COMPLETED,
+            )
             if not pending:
                 return
 
@@ -1007,13 +1011,15 @@ class IsolatedFunction(Generic[ArgsT, ReturnT]):
                 lines = []
                 for used_modules, references in pairs:
                     lines.append(
-                        f"\t- {used_modules!r} (accessed through {', '.join(map(repr, references))})"
+                        f"\t- {used_modules!r} "
+                        f"(accessed through {', '.join(map(repr, references))})"
                     )
 
                 function_name = self.func.__name__
                 raise FalServerlessError(
-                    f"Couldn't deserialize your function on the remote server. \n\n[Hint] {function_name!r} "
-                    f"function uses the following modules which weren't present in the environment definition:\n"
+                    f"Couldn't deserialize your function on the remote server. \n\n"
+                    f"[Hint] {function_name!r} function uses the following modules "
+                    "which weren't present in the environment definition:\n"
                     + "\n".join(lines)
                 ) from None
         except Exception as exc:
@@ -1065,7 +1071,8 @@ class IsolatedFunction(Generic[ArgsT, ReturnT]):
     def func(self) -> Callable[ArgsT, ReturnT]:
         serve_mode = self.options.gateway.get("serve")
         if serve_mode:
-            # This type can be safely ignored because this case only happens when it is a ServedIsolatedFunction
+            # This type can be safely ignored because this case only happens when it
+            # is a ServedIsolatedFunction
             serve_func: Callable[[], None] = ServeWrapper(self.raw_func)
             return serve_func  # type: ignore
         else:
@@ -1098,8 +1105,10 @@ class ServedIsolatedFunction(
 
 class Server(uvicorn.Server):
     """Server is a uvicorn.Server that actually plays nicely with signals.
-    By default, uvicorn's Server class overwrites the signal handler for SIGINT, swallowing the signal and preventing other tasks from cancelling.
-    This class allows the task to be gracefully cancelled using asyncio's built-in task cancellation or with an event, like aiohttp.
+    By default, uvicorn's Server class overwrites the signal handler for SIGINT,
+    swallowing the signal and preventing other tasks from cancelling.
+    This class allows the task to be gracefully cancelled using asyncio's built-in task
+    cancellation or with an event, like aiohttp.
     """
 
     def install_signal_handlers(self) -> None:

fal/app.py

@@ -10,9 +10,11 @@ from typing import Any, Callable, ClassVar, TypeVar
 from fastapi import FastAPI
 
 import fal.api
+from fal._serialization import include_modules_from
 from fal.api import RouteSignature
 from fal.logging import get_logger
-from fal._serialization import include_modules_from
+from fal.toolkit.file.providers import fal as fal_provider_module
+
 REALTIME_APP_REQUIREMENTS = ["websockets", "msgpack"]
 
 EndpointT = TypeVar("EndpointT", bound=Callable[..., Any])
@@ -123,6 +125,22 @@ class App(fal.api.BaseServable):
                 )
             return response
 
+        @app.middleware("http")
+        async def set_global_object_preference(request, call_next):
+            response = await call_next(request)
+            try:
+                fal_provider_module.GLOBAL_LIFECYCLE_PREFERENCE = request.headers.get(
+                    "X-Fal-Object-Lifecycle-Preference"
+                )
+            except Exception:
+                from fastapi.logger import logger
+
+                logger.exception(
+                    "Failed set a global lifecycle preference %s",
+                    self.__class__.__name__,
+                )
+            return response
+
     def provide_hints(self) -> list[str]:
         """Provide hints for routing the application."""
         raise NotImplementedError
@@ -237,14 +255,16 @@ def _fal_websocket_template(
                     output = output.dict()
                 else:
                     raise TypeError(
-                        f"Expected a dict or pydantic model as output, got {type(output)}"
+                        "Expected a dict or pydantic model as output, got "
+                        f"{type(output)}"
                     )
 
             messages = [
                 msgpack.packb(output, use_bin_type=True),
             ]
             if route_signature.emit_timings:
-                # We emit x-fal messages in JSON, no matter what the input/output format is.
+                # We emit x-fal messages in JSON, no matter what the
+                # input/output format is.
                 timings = {
                     "type": "x-fal-message",
                     "action": "timings",
@@ -354,7 +374,8 @@ def realtime(
 
         if hasattr(original_func, "route_signature"):
             raise ValueError(
-                f"Can't set multiple routes for the same function: {original_func.__name__}"
+                "Can't set multiple routes for the same function: "
+                f"{original_func.__name__}"
             )
 
         if input_modal is _SENTINEL:

fal/auth/__init__.py

@@ -51,7 +51,8 @@ def _fetch_access_token() -> str:
     Load the refresh token, request a new access_token (refreshing the refresh token)
     and return the access_token.
     """
-    # We need to lock both read and write access because we could be reading a soon invalid refresh_token
+    # We need to lock both read and write access because we could be reading a soon
+    # invalid refresh_token
     with local.lock_token():
         refresh_token, access_token = local.load_token()
 

fal/auth/auth0.py

@@ -30,7 +30,8 @@ def _open_browser(url: str, code: str | None) -> None:
     maybe_open_browser_tab(url)
 
     console.print(
-        "If browser didn't open automatically, on your computer or mobile device navigate to"
+        "If browser didn't open automatically, "
+        "on your computer or mobile device navigate to"
     )
     console.print(url)
 
@@ -155,7 +156,8 @@ def build_jwk_client():
 
 def validate_id_token(token: str):
     """
-    id_token is intended for the client (this sdk) only. Never send one to another service.
+    id_token is intended for the client (this sdk) only.
+    Never send one to another service.
     """
     from jwt import decode
 

fal/auth/local.py

@@ -62,7 +62,8 @@ def delete_token() -> None:
 @contextmanager
 def lock_token():
     """
-    Lock the access to the token file to avoid race conditions when running multiple scripts at the same time.
+    Lock the access to the token file to avoid race conditions when running multiple
+    scripts at the same time.
     """
     lock_file = _check_dir_exist() / _LOCK_FILE
     with portalocker.utils.TemporaryFileLock(

fal/cli.py

@@ -89,12 +89,13 @@ class MainGroup(RichGroup):
             except Exception as exception:
                 logger.error(exception)
                 if state.debug:
-                    # Here we supress detailed errors on click lines because
-                    # they're mostly decorator calls, irrelevant to the dev's error tracing
+                    # Here we supress detailed errors on click lines because they're
+                    # mostly decorator calls, irrelevant to the dev's error tracing
                     console.print_exception(suppress=[click])
                     console.print()
                     console.print(
-                        f"The [markdown.code]invocation_id[/] for this operation is: [white]{state.invocation_id}[/]"
+                        "The [markdown.code]invocation_id[/] for this operation is: "
+                        f"[white]{state.invocation_id}[/]"
                     )
                 else:
                     self._exception_handler.handle(exception)
@@ -207,7 +208,8 @@ def key_generate(client: sdk.FalServerlessClient, scope: str, alias: str | None)
         print(
             f"Generated key id and key secret, with the scope `{scope}`.\n"
             "This is the only time the secret will be visible.\n"
-            "You will need to generate a new key pair if you lose access to this secret."
+            "You will need to generate a new key pair if you lose access to this "
+            "secret."
         )
         print(f"FAL_KEY='{result[1]}:{result[0]}'")
 
@@ -306,7 +308,8 @@ def register_application(
     gateway_options = isolated_function.options.gateway
     if "serve" not in gateway_options and "exposed_port" not in gateway_options:
         raise api.FalServerlessError(
-            "One of `serve` or `exposed_port` options needs to be specified in the isolated annotation to register a function"
+            "One of `serve` or `exposed_port` options needs to be specified "
+            "in the isolated annotation to register a function"
         )
     elif (
         "exposed_port" in gateway_options

fal/exceptions/__init__.py

@@ -13,7 +13,8 @@ class ApplicationExceptionHandler:
 
     This exception handler is capable of handling, i.e. customize the output
     and add behavior, of any type of exception. Click handles all `ClickException`
-    types by default, but prints the stack for other exception not wrapped in ClickException.
+    types by default, but prints the stack for other exception not wrapped in
+    ClickException.
 
     The handler also allows for central metrics and logging collection.
     """

fal/flags.py

@@ -18,8 +18,6 @@ GRPC_HOST = os.getenv("FAL_HOST", "api.alpha.fal.ai")
 if not TEST_MODE:
     assert GRPC_HOST.startswith("api"), "FAL_HOST must start with 'api'"
 
-GATEWAY_HOST = GRPC_HOST.replace("api", "gateway", 1)
-
 REST_HOST = GRPC_HOST.replace("api", "rest", 1)
 REST_SCHEME = "http" if TEST_MODE or AUTH_DISABLED else "https"
 REST_URL = f"{REST_SCHEME}://{REST_HOST}"

fal/logging/isolate.py

@@ -34,10 +34,10 @@ class IsolateLogPrinter:
             timestamp = log.timestamp
         else:
             # Default value for timestamp if user has old `isolate` version.
-            # Even if the controller version is controller by us, which means that the timestamp
-            # is being sent in the gRPC message.
-            # The `isolate` version users interpret that message with is out of our control.
-            # So we need to handle this case.
+            # Even if the controller version is controller by us, which means that
+            # the timestamp is being sent in the gRPC message.
+            # The `isolate` version users interpret that message with is out of our
+            # control. So we need to handle this case.
             timestamp = datetime.now(timezone.utc)
 
         event: EventDict = {

fal/sdk.py

@@ -8,17 +8,17 @@ from enum import Enum
 from typing import Any, Callable, Generic, Iterator, Literal, TypeVar
 
 import grpc
+import isolate_proto
 from isolate.connections.common import is_agent
 from isolate.logs import Log
 from isolate.server.interface import from_grpc, to_serialized_object, to_struct
+from isolate_proto.configuration import GRPC_OPTIONS
 
-import isolate_proto
 from fal import flags
 from fal._serialization import patch_pickle
 from fal.auth import USER, key_credentials
 from fal.logging import get_logger
 from fal.logging.trace import TraceContextInterceptor
-from isolate_proto.configuration import GRPC_OPTIONS
 
 ResultT = TypeVar("ResultT")
 InputT = TypeVar("InputT")
@@ -187,6 +187,16 @@ class HostedRunStatus:
     state: HostedRunState
 
 
+@dataclass
+class ApplicationInfo:
+    application_id: str
+    keep_alive: int
+    max_concurrency: int
+    max_multiplexing: int
+    active_runners: int
+    min_concurrency: int
+
+
 @dataclass
 class AliasInfo:
     alias: str
@@ -263,6 +273,20 @@ class KeyScope(enum.Enum):
             raise ValueError(f"Unknown KeyScope: {proto}")
 
 
+@from_grpc.register(isolate_proto.ApplicationInfo)
+def _from_grpc_application_info(
+    message: isolate_proto.ApplicationInfo
+) -> ApplicationInfo:
+    return ApplicationInfo(
+        application_id=message.application_id,
+        keep_alive=message.keep_alive,
+        max_concurrency=message.max_concurrency,
+        max_multiplexing=message.max_multiplexing,
+        active_runners=message.active_runners,
+        min_concurrency=message.min_concurrency,
+    )
+
+
 @from_grpc.register(isolate_proto.AliasInfo)
 def _from_grpc_alias_info(message: isolate_proto.AliasInfo) -> AliasInfo:
     if message.auth_mode is isolate_proto.ApplicationAuthMode.PUBLIC:
@@ -496,6 +520,18 @@ class FalServerlessConnection:
         )
         return from_grpc(res.alias_info)
 
+    def list_applications(self) -> list[ApplicationInfo]:
+        request = isolate_proto.ListApplicationsRequest()
+        res: isolate_proto.ListApplicationsResult = self.stub.ListApplications(request)
+        return [from_grpc(app) for app in res.applications]
+
+    def delete_application(
+        self,
+        application_id: str,
+    ) -> None:
+        request = isolate_proto.DeleteApplicationRequest(application_id=application_id)
+        self.stub.DeleteApplication(request)
+
     def run(
         self,
         function: Callable[..., ResultT],

fal/sync.py

@@ -31,7 +31,8 @@ def _upload_file(source_path: str, target_path: str, unzip: bool = False):
         body = upload_file_model.BodyUploadLocalFile(
             rest_types.File(
                 payload=file_to_upload,
-                # We need to set a file_name, otherwise the server errors processing the file
+                # We need to set a file_name, otherwise the server errors
+                # processing the file
                 file_name=os.path.basename(source_path),
             )
         )
@@ -45,7 +46,9 @@ def _upload_file(source_path: str, target_path: str, unzip: bool = False):
 
     if response.status_code != 200:
         raise Exception(
-            f"Failed to upload file. Server returned status code {response.status_code} and message {response.parsed}"
+            "Failed to upload file. "
+            "Server returned status code "
+            f"{response.status_code} and message {response.parsed}"
         )
 
 
@@ -94,7 +97,8 @@ def sync_dir(local_dir: str | Path, remote_dir: str, force_upload=False) -> str:
     local_dir_abs = os.path.expanduser(local_dir)
     if not os.path.isabs(remote_dir) or not remote_dir.startswith("/data"):
         raise ValueError(
-            "'remote_dir' must be an absolute path starting with `/data`, e.g. '/data/sync/my_dir'"
+            "'remote_dir' must be an absolute path starting with `/data`, "
+            "e.g. '/data/sync/my_dir'"
         )
 
     remote_dir = remote_dir.replace("/data/", "", 1)

fal/toolkit/file/file.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import shutil
 from pathlib import Path
 from tempfile import NamedTemporaryFile, mkdtemp
-from typing import Callable, Optional, Any
+from typing import Any, Callable, Optional
 from urllib.parse import urlparse
 from zipfile import ZipFile
 
@@ -13,8 +13,8 @@ import pydantic
 if not hasattr(pydantic, "__version__") or pydantic.__version__.startswith("1."):
     IS_PYDANTIC_V2 = False
 else:
-    from pydantic_core import core_schema, CoreSchema
     from pydantic import GetCoreSchemaHandler
+    from pydantic_core import CoreSchema, core_schema
     IS_PYDANTIC_V2 = True
 
 from pydantic import BaseModel, Field
@@ -57,22 +57,28 @@ class File(BaseModel):
         description="The URL where the file can be downloaded from.",
     )
     content_type: Optional[str] = Field(
-        None, description="The mime type of the file.",
+        None,
+        description="The mime type of the file.",
         examples=["image/png"],
     )
     file_name: Optional[str] = Field(
-        None, description="The name of the file. It will be auto-generated if not provided.",
+        None,
+        description="The name of the file. It will be auto-generated if not provided.",
         examples=["z9RV14K95DvU.png"],
     )
     file_size: Optional[int] = Field(
         None, description="The size of the file in bytes.", examples=[4404019]
     )
     file_data: Optional[bytes] = Field(
-        None, description="File data", exclude=True, repr=False,
+        None,
+        description="File data",
+        exclude=True,
+        repr=False,
     )
 
     # Pydantic custom validator for input type conversion
     if IS_PYDANTIC_V2:
+
         @classmethod
         def __get_pydantic_core_schema__(
             cls, source_type: Any, handler: GetCoreSchemaHandler
@@ -81,10 +87,12 @@ class File(BaseModel):
                 cls.__convert_from_str,
                 handler(source_type),
             )
+
     else:
+
         @classmethod
         def __get_validators__(cls):
-            yield cls.__convert_from_str  
+            yield cls.__convert_from_str
 
     @classmethod
     def __convert_from_str(cls, value: Any):

fal/toolkit/file/providers/fal.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import dataclasses
 import json
 import os
 from base64 import b64encode
@@ -14,6 +15,14 @@ from fal.toolkit.file.types import FileData, FileRepository
 _FAL_CDN = "https://fal.media"
 
 
+@dataclass
+class ObjectLifecyclePreference:
+    expriation_duration_seconds: int
+
+
+GLOBAL_LIFECYCLE_PREFERENCE = ObjectLifecyclePreference(expriation_duration_seconds=2)
+
+
 @dataclass
 class FalFileRepository(FileRepository):
     def save(self, file: FileData) -> str:
@@ -70,19 +79,27 @@ class FalFileRepository(FileRepository):
 
 @dataclass
 class InMemoryRepository(FileRepository):
-    def save(self, file: FileData) -> str:
+    def save(
+        self,
+        file: FileData,
+    ) -> str:
         return f'data:{file.content_type};base64,{b64encode(file.data).decode("utf-8")}'
 
 
 @dataclass
 class FalCDNFileRepository(FileRepository):
-    def save(self, file: FileData) -> str:
+    def save(
+        self,
+        file: FileData,
+    ) -> str:
         headers = {
             **self.auth_headers,
             "Accept": "application/json",
             "Content-Type": file.content_type,
+            "X-Fal-Object-Lifecycle-Preference": json.dumps(
+                dataclasses.asdict(GLOBAL_LIFECYCLE_PREFERENCE)
+            ),
         }
-
         url = os.getenv("FAL_CDN_HOST", _FAL_CDN) + "/files/upload"
         request = Request(url, headers=headers, method="POST", data=file.data)
         try:

fal/toolkit/image/image.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import io
 from tempfile import NamedTemporaryFile
-from typing import TYPE_CHECKING, Literal, Union, Optional
+from typing import TYPE_CHECKING, Literal, Optional, Union
 
 from pydantic import BaseModel, Field
 

fal/toolkit/optimize.py

@@ -4,7 +4,6 @@ import os
 import traceback
 from typing import TYPE_CHECKING, Any
 
-
 if TYPE_CHECKING:
     import torch
 

fal/toolkit/utils/download_utils.py

@@ -17,7 +17,10 @@ FAL_MODEL_WEIGHTS_DIR = FAL_PERSISTENT_DIR / ".fal" / "model_weights"
 
 # TODO: how can we randomize the user agent to avoid being blocked?
 TEMP_HEADERS = {
-    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:21.0) Gecko/20100101 Firefox/21.0"
+    "User-Agent": (
+        "Mozilla/5.0 (Macintosh; "
+        "Intel Mac OS X 10.8; rv:21.0) Gecko/20100101 Firefox/21.0"
+    ),
 }
 
 
@@ -94,8 +97,8 @@ def _file_content_length_matches(url: str, file_path: Path) -> bool:
         file_path: The local path to the file being compared.
 
     Returns:
-        bool:`True` if the local file's content length matches the remote file's content length,
-              `False` otherwise.
+        bool: `True` if the local file's content length matches the remote file's
+            content length, `False` otherwise.
     """
     local_file_content_length = file_path.stat().st_size
     remote_file_content_length = _get_remote_file_properties(url)[1]

fal/workflows.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import graphlib
 import json
 import webbrowser
 from argparse import ArgumentParser
@@ -8,6 +7,7 @@ from collections import Counter
 from dataclasses import dataclass, field
 from typing import Any, Iterator, Union, cast
 
+import graphlib
 import rich
 from openapi_fal_rest.api.workflows import (
     create_or_update_workflow_workflows_post as publish_workflow,
@@ -450,7 +450,12 @@ def main() -> None:
                 for event in handle.iter_events(logs=True):
                     if isinstance(event, fal.apps.Queued):
                         status.update(
-                            status=f"Queued for {node_id!r} (position={event.position}) ({n}/{len(workflow.nodes)})",
+                            status=(
+                                "Queued for "
+                                f"{node_id!r} "
+                                f"(position={event.position}) "
+                                f"({n}/{len(workflow.nodes)})",
+                            ),
                             spinner="dots",
                         )
                     elif isinstance(event, fal.apps.InProgress):

{fal-0.15.0.dist-info → fal-0.15.2.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 0.15.0
+Version: 0.15.2
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <hello@fal.ai>
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: isolate[build] <1.0,>=0.12.3
-Requires-Dist: isolate-proto ==0.3.4
+Requires-Dist: isolate-proto ==0.4.0
 Requires-Dist: grpcio <2,>=1.50.0
 Requires-Dist: dill ==0.3.7
 Requires-Dist: cloudpickle ==3.0.0
@@ -39,9 +39,10 @@ Provides-Extra: dev
 Requires-Dist: fal[test] ; extra == 'dev'
 Requires-Dist: openapi-python-client <1,>=0.14.1 ; extra == 'dev'
 Provides-Extra: test
-Requires-Dist: pytest ; extra == 'test'
-Requires-Dist: pytest-xdist ; extra == 'test'
+Requires-Dist: pytest <8 ; extra == 'test'
 Requires-Dist: pytest-asyncio ; extra == 'test'
+Requires-Dist: pytest-xdist ; extra == 'test'
+Requires-Dist: flaky ; extra == 'test'
 
 [![PyPI](https://img.shields.io/pypi/v/fal.svg?logo=PyPI)](https://pypi.org/project/fal)
 [![Tests](https://img.shields.io/github/actions/workflow/status/fal-ai/fal/integration_tests.yaml?label=Tests)](https://github.com/fal-ai/fal/actions)
@@ -89,3 +90,30 @@ A new virtual environment will be created by fal in the cloud and the set of req
 ## Next steps
 
 If you would like to find out more about the capabilities of fal, check out to the [docs](https://fal.ai/docs). You can learn more about persistent storage, function caches and deploying your functions as API endpoints.
+
+## Contributing
+
+### Installing in editable mode with dev dependencies
+
+```py
+pip install -e 'projects/fal[dev]'
+pip install -e 'projects/fal_client[dev]'
+pip install -e 'projects/isolate_proto[dev]'
+```
+
+### Running tests
+
+```py
+pytest
+```
+
+### Pre-commit
+
+```
+cd projects/fal
+pre-commit install
+```
+
+### Commit format
+
+Please follow [conventional commits specification](https://www.conventionalcommits.org/) for descriptions/messages.

{fal-0.15.0.dist-info → fal-0.15.2.dist-info}/RECORD

@@ -1,44 +1,44 @@
-fal/__init__.py,sha256=XOobhu3D94O9K9ka_AJh6sw3K7lV-s_NuSto_fx9TXg,1255
+fal/__init__.py,sha256=unz75H_W1OpXsdkjHqjJs_GrA_BzwHaXImRH-pekaL0,617
 fal/__main__.py,sha256=8hDtWlaFZK24KhfNq_ZKgtXqYHsDQDetukOCMlsbW0Q,59
-fal/_serialization.py,sha256=d7cyacqQwwmSJJOh7WMGdv4jBzpLQJRsXxJc-GfhWN4,7517
-fal/api.py,sha256=7LChw4fl1ClJa7qDcL2V7wwb_Eiw8c3QwPZhtt9PBqg,35975
-fal/app.py,sha256=GCHes5uFQIH4cpK3YiiRSrsWSSkzWxlYh2T-nKra7Z8,12398
+fal/_serialization.py,sha256=Tx_c_mpJ8dYAVmPwdLkwgozSqfdvdFyWRYx3lH3-koQ,7595
+fal/api.py,sha256=Nqs8qhYHRpCit1DiXqfFCacSnpUnI3__bssqcx5eVPc,36095
+fal/app.py,sha256=bo8NbJTCjbIoeMVyW5YBxGljzDAKAqOjOJwP5erT2GM,13129
 fal/apps.py,sha256=UhR6mq8jBiTAp-QvUnvbnMNcuJ5wHIKSqdlfyx8aBQ8,6829
-fal/cli.py,sha256=STeefdtKG9RSeVXOKWtWtxNZTgvZX7Z3s80br8HZyK8,18374
-fal/flags.py,sha256=AATQO65M4C87dGp0j7o6cSQWcr62xE-8DnJYsUjFFbw,942
+fal/cli.py,sha256=2sPCP4G_y3aUX0SKVSOTkTaLdYJpcm9B6FYDqIVhx-8,18431
+fal/flags.py,sha256=aWzOn3Ynl1s-eACerj1ZnRwlj3CvaGu0wIFcp7YXqX4,887
 fal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fal/rest_client.py,sha256=kGBGmuyHfX1lR910EoKCYPjsyU8MdXawT_cW2q8Sajc,568
-fal/sdk.py,sha256=TNmxxte-oca8WnaiXwc7MIMrUKn_OeYaXtg1xC8t7eM,18793
-fal/sync.py,sha256=Ljet584PVFz4r888-0bwV1Kio-tTneF_85TnHvBPvJw,4277
-fal/workflows.py,sha256=oBOdCCnZ0qMtmuO5JVpXD4FyUWoQgLXAJRe8RtrsGDw,14510
-fal/auth/__init__.py,sha256=VTZfex_kV9WNozmpBDa7joNntOlz-btuu-wHqaGM9Bk,3555
-fal/auth/auth0.py,sha256=5y4-9udOSX2-N_zvinLCpFwl10MdaPydZX2v9GQMZEE,5406
-fal/auth/local.py,sha256=lZqp4j32l2xFpY8zYvLoIHHyJrNAJDcm5MxgsLpY_pw,1786
+fal/sdk.py,sha256=4aQikS2xH90xZpphKljml6cG38aahK2gcVSLTBQQCBY,19925
+fal/sync.py,sha256=ZuIJA2-hTPNANG9B_NNJZUsO68EIdTH0dc9MzeVE2VU,4340
+fal/workflows.py,sha256=4rjqL4xB6GHLJsqTplJmAvpd6uHZJ28sc8su33BFXEo,14682
+fal/auth/__init__.py,sha256=r8iA2-5ih7-Fik3gEC4HEWNFbGoxpYnXpZu1icPIoS0,3561
+fal/auth/auth0.py,sha256=rSG1mgH-QGyKfzd7XyAaj1AYsWt-ho8Y_LZ-FUVWzh4,5421
+fal/auth/local.py,sha256=sndkM6vKpeVny6NHTacVlTbiIFqaksOmw0Viqs_RN1U,1790
 fal/console/__init__.py,sha256=ernZ4bzvvliQh5SmrEqQ7lA5eVcbw6Ra2jalKtA7dxg,132
 fal/console/icons.py,sha256=De9MfFaSkO2Lqfne13n3PrYfTXJVIzYZVqYn5BWsdrA,108
 fal/console/ux.py,sha256=KMQs3UHQvVHDxDQQqlot-WskVKoMQXOE3jiVkkfmIMY,356
-fal/exceptions/__init__.py,sha256=MM9N4uG3_6UkAGw4SLDo-Cp35YawNc1kAIGMl1BFTeI,992
+fal/exceptions/__init__.py,sha256=yAPFUv-RZCFi8joRVOE1hV79bb8WFHnj1zslF_zhYxw,996
 fal/exceptions/_base.py,sha256=U3n_4OtUx5MvfT2eol_a-N0dV9_eYFMvdbrhP-b_NXg,160
 fal/exceptions/auth.py,sha256=gxRago5coI__vSIcdcsqhhq1lRPkvCnwPAueIaXTAdw,329
 fal/exceptions/handlers.py,sha256=nZCmmWU47k4P9NBISNqn0b6-L53KMoNuuGBW4G9Bweo,1674
 fal/logging/__init__.py,sha256=snqprf7-sKw6oAATS_Yxklf-a3XhLg0vIHICPwLp6TM,1583
-fal/logging/isolate.py,sha256=rQbM-wwsCO3ddIFyEo34GBWxDWkDzw3x0iSK79D0yKk,1742
+fal/logging/isolate.py,sha256=Gj_xylXc0ulGIyozLwTWisIclP7-du4tvhJWyPilrgo,1742
 fal/logging/style.py,sha256=ckIgHzvF4DShM5kQh8F133X53z_vF46snuDHVmo_h9g,386
 fal/logging/trace.py,sha256=OhzB6d4rQZimBc18WFLqH_9BGfqFFumKKTAGSsmWRMg,1904
 fal/logging/user.py,sha256=0Xvb8n6tSb9l_V51VDzv6SOdYEFNouV_6nF_W9e7uNQ,642
 fal/toolkit/__init__.py,sha256=sV95wiUzKoiDqF9vDgq4q-BLa2sD6IpuKSqp5kdTQNE,658
 fal/toolkit/exceptions.py,sha256=elHZ7dHCJG5zlHGSBbz-ilkZe9QUvQMomJFi8Pt91LA,198
-fal/toolkit/optimize.py,sha256=I-scpgmRODkzBCLkcsBwxkVm9L4bGVkSSZKiKMFYU0M,1340
+fal/toolkit/optimize.py,sha256=p75sovF0SmRP6zxzpIaaOmqlxvXB_xEz3XPNf59EF7w,1339
 fal/toolkit/file/__init__.py,sha256=FbNl6wD-P0aSSTUwzHt4HujBXrbC3ABmaigPQA4hRfg,70
-fal/toolkit/file/file.py,sha256=_Kt-jqFoUdJ_UxSC7Ll6oeVWtkvjYZBJWONp31UvK7w,6025
+fal/toolkit/file/file.py,sha256=r8PzNCgv8Gkj6s1zM0yW-pcMKIouyaiEH06iBue8MwM,6066
 fal/toolkit/file/types.py,sha256=9CqDh8SmNJNzfsrvtj468uo2SprJH9rOk8KMhhfU73c,1050
-fal/toolkit/file/providers/fal.py,sha256=7oqzkmeNoXjRZKsSIInC1ZdX8-lmYamIZmgWtNrYpJo,3314
+fal/toolkit/file/providers/fal.py,sha256=AfNwdnvt_IIFrzvNZPFjGwfVOQ2OzPfG1ySz6-2tnvc,3690
 fal/toolkit/file/providers/gcp.py,sha256=7Lg7BXoHKkFu0jkGv3_vKh2Ks6eRfDMbw31N3mvDUtk,1913
 fal/toolkit/file/providers/r2.py,sha256=YW5aJBOX41MQxfx1rA_f-IiJhAPMZ5md0cxBcg3y08I,2537
 fal/toolkit/image/__init__.py,sha256=qNLyXsBWysionUjbeWbohLqWlw3G_UpzunamkZd_JLQ,71
-fal/toolkit/image/image.py,sha256=7Hy0Mxb_QAJI1o-5ycYGES4ReB3iLSmxVkCIX2Y6MEs,4252
+fal/toolkit/image/image.py,sha256=2q1ZCBSSdmDx9q1S4ahoCOniNaRcfSFnCS31f3b8ZZ0,4252
 fal/toolkit/utils/__init__.py,sha256=CrmM9DyCz5-SmcTzRSm5RaLgxy3kf0ZsSEN9uhnX2Xo,97
-fal/toolkit/utils/download_utils.py,sha256=9rYLDOztOoib7TqCXuGj05nPmcgd3Soj0AT16O_sczA,15460
+fal/toolkit/utils/download_utils.py,sha256=M-xUAV8kX6o1zcojozSTaArGIC_LgQriagCC8AoG0mM,15487
 openapi_fal_rest/__init__.py,sha256=ziculmF_i6trw63LzZGFX-6W3Lwq9mCR8_UpkpvpaHI,152
 openapi_fal_rest/client.py,sha256=G6BpJg9j7-JsrAUGddYwkzeWRYickBjPdcVgXoPzxuE,2817
 openapi_fal_rest/errors.py,sha256=8mXSxdfSGzxT82srdhYbR0fHfgenxJXaUtMkaGgb6iU,470
@@ -81,8 +81,8 @@ openapi_fal_rest/models/workflow_node_type.py,sha256=-FzyeY2bxcNmizKbJI8joG7byRi
 openapi_fal_rest/models/workflow_schema.py,sha256=4K5gsv9u9pxx2ItkffoyHeNjBBYf6ur5bN4m_zePZNY,2019
 openapi_fal_rest/models/workflow_schema_input.py,sha256=2OkOXWHTNsCXHWS6EGDFzcJKkW5FIap-2gfO233EvZQ,1191
 openapi_fal_rest/models/workflow_schema_output.py,sha256=EblwSPAGfWfYVWw_WSSaBzQVju296is9o28rMBAd0mc,1196
-fal-0.15.0.dist-info/METADATA,sha256=GyZiaXubOMkUTFuwCBujAq0mHZPBnExycm_DTNqndzA,3258
-fal-0.15.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-fal-0.15.0.dist-info/entry_points.txt,sha256=1GadEh1IgXO5Bb42Xo9lwNsJnm9Xjfo3qIdqwbfdV8Q,36
-fal-0.15.0.dist-info/top_level.txt,sha256=r257X1L57oJL8_lM0tRrfGuXFwm66i1huwQygbpLmHw,21
-fal-0.15.0.dist-info/RECORD,,
+fal-0.15.2.dist-info/METADATA,sha256=SfYdtZgpSWTSE3GKU-rqZc5fAi7XGwSM1AB1ZJdqoHM,3738
+fal-0.15.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+fal-0.15.2.dist-info/entry_points.txt,sha256=1GadEh1IgXO5Bb42Xo9lwNsJnm9Xjfo3qIdqwbfdV8Q,36
+fal-0.15.2.dist-info/top_level.txt,sha256=r257X1L57oJL8_lM0tRrfGuXFwm66i1huwQygbpLmHw,21
+fal-0.15.2.dist-info/RECORD,,