fal 1.44.1__tar.gz → 1.45.1__tar.gz

{fal-1.44.1/fal.egg-info → fal-1.45.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.44.1
+Version: 1.45.1
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
@@ -31,6 +31,7 @@ Requires-Dist: python-dateutil<3,>=2.8.0
 Requires-Dist: types-python-dateutil<3,>=2.8.0
 Requires-Dist: dateparser<2,>=1.2.0
 Requires-Dist: types-dateparser<2,>=1.2.0
+Requires-Dist: tuspy==1.1.0
 Requires-Dist: importlib-metadata>=4.4; python_version < "3.10"
 Requires-Dist: msgpack<2,>=1.0.7
 Requires-Dist: websockets>=12.0

{fal-1.44.1 → fal-1.45.1/fal.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.44.1
+Version: 1.45.1
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
@@ -31,6 +31,7 @@ Requires-Dist: python-dateutil<3,>=2.8.0
 Requires-Dist: types-python-dateutil<3,>=2.8.0
 Requires-Dist: dateparser<2,>=1.2.0
 Requires-Dist: types-dateparser<2,>=1.2.0
+Requires-Dist: tuspy==1.1.0
 Requires-Dist: importlib-metadata>=4.4; python_version < "3.10"
 Requires-Dist: msgpack<2,>=1.0.7
 Requires-Dist: websockets>=12.0

{fal-1.44.1 → fal-1.45.1}/fal.egg-info/SOURCES.txt

@@ -86,6 +86,7 @@ src/fal/app.py
 src/fal/apps.py
 src/fal/config.py
 src/fal/container.py
+src/fal/file_sync.py
 src/fal/files.py
 src/fal/flags.py
 src/fal/project.py
@@ -163,6 +164,7 @@ tests/conftest.py
 tests/integration_test.py
 tests/mainify_target.py
 tests/test_apps.py
+tests/test_file_sync.py
 tests/test_files.py
 tests/test_kv.py
 tests/test_stability.py
@@ -182,4 +184,5 @@ tests/toolkit/image_test.py
 tests/toolkit/test_types.py
 tests/toolkit/file/providers/test_fal_retry.py
 tests/toolkit/utils/retry.py
+tests/unit/test_app.py
 tools/demo_script.py

{fal-1.44.1 → fal-1.45.1}/fal.egg-info/requires.txt

@@ -24,6 +24,7 @@ python-dateutil<3,>=2.8.0
 types-python-dateutil<3,>=2.8.0
 dateparser<2,>=1.2.0
 types-dateparser<2,>=1.2.0
+tuspy==1.1.0
 msgpack<2,>=1.0.7
 websockets>=12.0
 pillow<12,>=10.2.0

{fal-1.44.1 → fal-1.45.1}/pyproject.toml

@@ -50,6 +50,7 @@ dependencies = [
     "types-python-dateutil>=2.8.0,<3",
     "dateparser>=1.2.0,<2",
     "types-dateparser>=1.2.0,<2",
+    "tuspy==1.1.0",
     # For 3.9 and earlier, importlib-metadata's newer versions are included in the standard library.
     'importlib-metadata>=4.4; python_version < "3.10"',
     "msgpack>=1.0.7,<2",

{fal-1.44.1 → fal-1.45.1}/src/fal/_fal_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.44.1'
-__version_tuple__ = version_tuple = (1, 44, 1)
+__version__ = version = '1.45.1'
+__version_tuple__ = version_tuple = (1, 45, 1)
 
 __commit_id__ = commit_id = None

{fal-1.44.1 → fal-1.45.1}/src/fal/api.py

@@ -43,6 +43,7 @@ from typing_extensions import Concatenate, ParamSpec
 
 import fal.flags as flags
 from fal._serialization import include_module, include_modules_from, patch_pickle
+from fal.console import console
 from fal.container import ContainerImage
 from fal.exceptions import (
     AppException,
@@ -51,6 +52,7 @@ from fal.exceptions import (
     FieldException,
 )
 from fal.exceptions._cuda import _is_cuda_oom_exception
+from fal.file_sync import FileSync
 from fal.logging.isolate import IsolateLogPrinter
 from fal.sdk import (
     FAL_SERVERLESS_DEFAULT_CONCURRENCY_BUFFER,
@@ -63,6 +65,7 @@ from fal.sdk import (
     DeploymentStrategyLiteral,
     FalServerlessClient,
     FalServerlessConnection,
+    File,
     HostedRunState,
     MachineRequirements,
     get_agent_credentials,
@@ -438,16 +441,25 @@ class FalServerlessHost(Host):
             "_base_image",
             "_scheduler",
             "_scheduler_options",
+            "app_files",
+            "app_files_ignore",
+            "app_files_context_dir",
         }
     )
 
     url: str = FAL_SERVERLESS_DEFAULT_URL
+    local_file_path: str = ""
     credentials: Credentials = field(default_factory=get_default_credentials)
-    _lock: threading.Lock = field(default_factory=threading.Lock)
 
-    _log_printer = IsolateLogPrinter(debug=flags.DEBUG)
+    _lock: threading.Lock = field(default_factory=threading.Lock, init=False)
+
+    _log_printer: IsolateLogPrinter = field(
+        default_factory=lambda: IsolateLogPrinter(debug=flags.DEBUG), init=False
+    )
 
-    _thread_pool: ThreadPoolExecutor = field(default_factory=ThreadPoolExecutor)
+    _thread_pool: ThreadPoolExecutor = field(
+        default_factory=ThreadPoolExecutor, init=False
+    )
 
     def __getstate__(self) -> dict[str, Any]:
         state = self.__dict__.copy()
@@ -465,6 +477,35 @@ class FalServerlessHost(Host):
             client = FalServerlessClient(self.url, self.credentials)
             return client.connect()
 
+    def _app_files_sync(self, options: Options) -> list[File]:
+        import re  # noqa: PLC0415
+
+        app_files: list[str] = options.host.get("app_files", [])
+        app_files_ignore_str = options.host.get("app_files_ignore", [])
+        app_files_ignore = [re.compile(pattern) for pattern in app_files_ignore_str]
+        app_files_context_dir = options.host.get("app_files_context_dir", None)
+        res = []
+        if app_files:
+            sync = FileSync(self.local_file_path)
+            files, errors = sync.sync_files(
+                app_files,
+                files_ignore=app_files_ignore,
+                files_context_dir=app_files_context_dir,
+            )
+            if errors:
+                for error in errors:
+                    console.print(
+                        f"Error uploading file {error.relative_path}: {error.message}"
+                    )
+
+                raise FalServerlessException("Error uploading files")
+
+            res = [
+                File(relative_path=file.relative_path, hash=file.hash) for file in files
+            ]
+
+        return res
+
     @_handle_grpc_error()
     def register(
         self,
@@ -515,6 +556,8 @@ class FalServerlessHost(Host):
             startup_timeout=startup_timeout,
         )
 
+        app_files = self._app_files_sync(options)
+
         partial_func = _prepare_partial_func(func)
 
         if metadata is None:
@@ -537,6 +580,7 @@ class FalServerlessHost(Host):
             scale=scale,
             # By default, logs are public
             private_logs=options.host.get("private_logs", False),
+            files=app_files,
         ):
             for log in partial_result.logs:
                 self._log_printer.print(log)
@@ -594,6 +638,8 @@ class FalServerlessHost(Host):
             startup_timeout=startup_timeout,
         )
 
+        app_files = self._app_files_sync(options)
+
         return_value = _UNSET
         # Allow isolate provided arguments (such as setup function) to take
         # precedence over the ones provided by the user.
@@ -603,6 +649,7 @@ class FalServerlessHost(Host):
             environments,
             machine_requirements=machine_requirements,
             setup_function=setup_function,
+            files=app_files,
         ):
             result_handler(partial_result)
 

{fal-1.44.1 → fal-1.45.1}/src/fal/app.py

@@ -35,6 +35,13 @@ from fal.toolkit.file.providers.fal import LIFECYCLE_PREFERENCE
 
 REALTIME_APP_REQUIREMENTS = ["websockets", "msgpack"]
 REQUEST_ID_KEY = "x-fal-request-id"
+DEFAULT_APP_FILES_IGNORE = [
+    r"\.pyc$",
+    r"__pycache__/",
+    r"\.git/",
+    r"\.DS_Store$",
+]
+
 
 EndpointT = TypeVar("EndpointT", bound=Callable[..., Any])
 logger = get_logger(__name__)
@@ -298,6 +305,14 @@ def _print_python_packages() -> None:
     print("[debug] Python packages installed:", ", ".join(packages))
 
 
+def _include_app_files_path():
+    import sys  # noqa: PLC0415
+
+    # Add local files deployment path to sys.path so imports
+    # work correctly in the isolate agent
+    sys.path.append("/app_files")
+
+
 class App(BaseServable):
     requirements: ClassVar[list[str]] = []
     local_python_modules: ClassVar[list[str]] = []
@@ -313,6 +328,9 @@ class App(BaseServable):
     }
     app_name: ClassVar[Optional[str]] = None
     app_auth: ClassVar[Optional[AuthModeLiteral]] = None
+    app_files: ClassVar[list[str]] = []
+    app_files_ignore: ClassVar[list[str]] = DEFAULT_APP_FILES_IGNORE
+    app_files_context_dir: ClassVar[Optional[str]] = None
     request_timeout: ClassVar[Optional[int]] = None
     startup_timeout: ClassVar[Optional[int]] = None
     min_concurrency: ClassVar[Optional[int]] = None
@@ -334,6 +352,15 @@ class App(BaseServable):
         if cls.startup_timeout is not None:
             cls.host_kwargs["startup_timeout"] = cls.startup_timeout
 
+        if cls.app_files:
+            cls.host_kwargs["app_files"] = cls.app_files
+
+        if cls.app_files_ignore:
+            cls.host_kwargs["app_files_ignore"] = cls.app_files_ignore
+
+        if cls.app_files_context_dir is not None:
+            cls.host_kwargs["app_files_context_dir"] = cls.app_files_context_dir
+
         if cls.min_concurrency is not None:
             cls.host_kwargs["min_concurrency"] = cls.min_concurrency
 
@@ -349,7 +376,7 @@ class App(BaseServable):
         if cls.max_multiplexing is not None:
             cls.host_kwargs["max_multiplexing"] = cls.max_multiplexing
 
-        cls.app_name = getattr(cls, "app_name", app_name)
+        cls.app_name = getattr(cls, "app_name") or app_name
 
         if cls.__init__ is not App.__init__:
             raise ValueError(
@@ -382,6 +409,7 @@ class App(BaseServable):
 
     @asynccontextmanager
     async def lifespan(self, app: fastapi.FastAPI):
+        _include_app_files_path()
         _print_python_packages()
         await _call_any_fn(self.setup)
         try:

{fal-1.44.1 → fal-1.45.1}/src/fal/cli/deploy.py

@@ -92,7 +92,7 @@ def _deploy_from_reference(
         file_path = str(file_path)  # type: ignore
 
     user = _get_user()
-    host = FalServerlessHost(args.host)
+    host = FalServerlessHost(args.host, local_file_path=str(file_path))
     loaded = load_function_from(
         host,
         file_path,  # type: ignore
@@ -180,6 +180,7 @@ def _deploy(args):
         # default comes from the CLI
         app_deployment_strategy = cast(DeploymentStrategyLiteral, args.strategy)
         app_scale_settings = cast(bool, args.app_scale_settings)
+        file_path = str(Path(file_path).absolute())
 
     _deploy_from_reference(
         (file_path, func_name),

{fal-1.44.1 → fal-1.45.1}/src/fal/cli/run.py

@@ -1,3 +1,5 @@
+from pathlib import Path
+
 from ._utils import get_app_data_from_toml, is_app_name
 from .parser import FalClientParser, RefAction
 
@@ -6,14 +8,16 @@ def _run(args):
     from fal.api import FalServerlessHost
     from fal.utils import load_function_from
 
-    host = FalServerlessHost(args.host)
-
     if is_app_name(args.func_ref):
         app_name = args.func_ref[0]
         app_ref, *_ = get_app_data_from_toml(app_name)
         file_path, func_name = RefAction.split_ref(app_ref)
     else:
         file_path, func_name = args.func_ref
+        # Turn relative path into absolute path for files
+        file_path = str(Path(file_path).absolute())
+
+    host = FalServerlessHost(args.host, local_file_path=file_path)
 
     loaded = load_function_from(host, file_path, func_name)
 

{fal-1.44.1 → fal-1.45.1}/src/fal/exceptions/__init__.py

@@ -2,8 +2,10 @@ from __future__ import annotations
 
 from ._base import (
     AppException,  # noqa: F401
+    AppFileUploadException,  # noqa: F401
     FalServerlessException,  # noqa: F401
     FieldException,  # noqa: F401
+    FileTooLargeError,  # noqa: F401
     RequestCancelledException,  # noqa: F401
 )
 from ._cuda import CUDAOutOfMemoryException  # noqa: F401

{fal-1.44.1 → fal-1.45.1}/src/fal/exceptions/_base.py

@@ -56,3 +56,18 @@ class RequestCancelledException(FalServerlessException):
     """Exception raised when the request is cancelled by the client."""
 
     message: str = "Request cancelled by the client."
+
+
+@dataclass
+class FileTooLargeError(FalServerlessException):
+    """Exception raised when the file is too large."""
+
+    message: str = "File is too large."
+
+
+@dataclass
+class AppFileUploadException(FalServerlessException):
+    """Raised when file upload fails"""
+
+    message: str
+    relative_path: str