fal 1.20.0__tar.gz → 1.20.2__tar.gz

{fal-1.20.0/fal.egg-info → fal-1.20.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.20.0
+Version: 1.20.2
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8

{fal-1.20.0 → fal-1.20.2/fal.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.20.0
+Version: 1.20.2
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8

{fal-1.20.0 → fal-1.20.2}/src/fal/_fal_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '1.20.0'
-__version_tuple__ = version_tuple = (1, 20, 0)
+__version__ = version = '1.20.2'
+__version_tuple__ = version_tuple = (1, 20, 2)

{fal-1.20.0 → fal-1.20.2}/src/fal/api.py

@@ -1183,6 +1183,9 @@ class BaseServable:
         app_info.labels(version=self.version).set(1)
 
         app = self._build_app()
+
+        # We use the default workers=1 config because setup function can be heavy
+        # and it runs once per worker.
         server = Server(
             config=Config(app, host="0.0.0.0", port=8080, timeout_keep_alive=300)
         )

{fal-1.20.0 → fal-1.20.2}/src/fal/cli/files.py

@@ -48,11 +48,19 @@ def add_parser(main_subparsers, parents):
     subparsers = parser.add_subparsers(
         title="Commands",
         metavar="command",
+        dest="cmd",
         required=True,
         parser_class=FalClientParser,
     )
 
-    list_parser = subparsers.add_parser("list", aliases=["ls"], parents=parents)
+    list_help = "List files."
+    list_parser = subparsers.add_parser(
+        "list",
+        aliases=["ls"],
+        description=list_help,
+        help=list_help,
+        parents=parents,
+    )
     list_parser.add_argument(
         "path",
         nargs="?",
@@ -62,7 +70,13 @@ def add_parser(main_subparsers, parents):
     )
     list_parser.set_defaults(func=_list)
 
-    download_parser = subparsers.add_parser("download", parents=parents)
+    download_help = "Download files."
+    download_parser = subparsers.add_parser(
+        "download",
+        description=download_help,
+        help=download_help,
+        parents=parents,
+    )
     download_parser.add_argument(
         "remote_path", type=str, help="Remote path to download"
     )
@@ -71,12 +85,24 @@ def add_parser(main_subparsers, parents):
     )
     download_parser.set_defaults(func=_download)
 
-    upload_parser = subparsers.add_parser("upload", parents=parents)
+    upload_help = "Upload files."
+    upload_parser = subparsers.add_parser(
+        "upload",
+        description=upload_help,
+        help=upload_help,
+        parents=parents,
+    )
     upload_parser.add_argument("local_path", type=str, help="Local path to upload")
     upload_parser.add_argument("remote_path", type=str, help="Remote path to upload to")
     upload_parser.set_defaults(func=_upload)
 
-    upload_url_parser = subparsers.add_parser("upload-url", parents=parents)
+    upload_url_help = "Upload file from URL."
+    upload_url_parser = subparsers.add_parser(
+        "upload-url",
+        description=upload_url_help,
+        help=upload_url_help,
+        parents=parents,
+    )
     upload_url_parser.add_argument("url", type=str, help="URL to upload")
     upload_url_parser.add_argument(
         "remote_path", type=str, help="Remote path to upload to"

{fal-1.20.0 → fal-1.20.2}/src/fal/toolkit/__init__.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
-from fal.toolkit.audio.audio import Audio
-from fal.toolkit.file import CompressedFile, File
-from fal.toolkit.image.image import Image, ImageSizeInput, get_image_size
+from fal.toolkit.audio.audio import Audio, AudioField
+from fal.toolkit.file import CompressedFile, File, FileField
+from fal.toolkit.image.image import Image, ImageField, ImageSizeInput, get_image_size
 from fal.toolkit.optimize import optimize
 from fal.toolkit.utils import (
     FAL_MODEL_WEIGHTS_DIR,
@@ -12,17 +12,21 @@ from fal.toolkit.utils import (
     download_file,
     download_model_weights,
 )
-from fal.toolkit.video.video import Video
+from fal.toolkit.video.video import Video, VideoField
 
 __all__ = [
+    "Audio",
+    "AudioField",
     "CompressedFile",
     "File",
+    "FileField",
     "Image",
+    "ImageField",
     "ImageSizeInput",
     "get_image_size",
-    "Audio",
-    "Video",
     "optimize",
+    "Video",
+    "VideoField",
     "FAL_MODEL_WEIGHTS_DIR",
     "FAL_PERSISTENT_DIR",
     "FAL_REPOSITORY_DIR",

{fal-1.20.0 → fal-1.20.2}/src/fal/toolkit/audio/audio.py

@@ -1,6 +1,18 @@
+from functools import wraps
+
+from pydantic import Field
+
 from fal.toolkit.file.file import IS_PYDANTIC_V2, File
 
 
+@wraps(Field)
+def AudioField(*args, **kwargs):
+    ui = kwargs.get("ui", {})
+    ui.setdefault("field", "audio")
+    kwargs["ui"] = ui
+    return Field(*args, **kwargs)
+
+
 class Audio(File):
     if IS_PYDANTIC_V2:
         model_config = {"json_schema_extra": {"ui": {"field": "audio"}}}

{fal-1.20.0 → fal-1.20.2}/src/fal/toolkit/file/file.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import shutil
+from functools import wraps
 from pathlib import Path
 from tempfile import NamedTemporaryFile, mkdtemp
 from typing import Any, Callable, Optional
@@ -63,6 +64,14 @@ FALLBACK_REPOSITORY: FileRepository | RepositoryId = "fal"
 OBJECT_LIFECYCLE_PREFERENCE_KEY = "x-fal-object-lifecycle-preference"
 
 
+@wraps(Field)
+def FileField(*args, **kwargs):
+    ui = kwargs.get("ui", {})
+    ui.setdefault("field", "file")
+    kwargs["ui"] = ui
+    return Field(*args, **kwargs)
+
+
 class File(BaseModel):
     # public properties
     url: str = Field(

{fal-1.20.0 → fal-1.20.2}/src/fal/toolkit/image/image.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import io
+from functools import wraps
 from tempfile import NamedTemporaryFile
 from typing import TYPE_CHECKING, Literal, Optional, Union
 
@@ -63,6 +64,14 @@ def get_image_size(source: ImageSizeInput) -> ImageSize:
 ImageFormat = Literal["png", "jpeg", "jpg", "webp", "gif"]
 
 
+@wraps(Field)
+def ImageField(*args, **kwargs):
+    ui = kwargs.get("ui", {})
+    ui.setdefault("field", "image")
+    kwargs["ui"] = ui
+    return Field(*args, **kwargs)
+
+
 class Image(File):
     """
     Represents an image file.

{fal-1.20.0 → fal-1.20.2}/src/fal/toolkit/video/video.py

@@ -1,6 +1,18 @@
+from functools import wraps
+
+from pydantic import Field
+
 from fal.toolkit.file.file import IS_PYDANTIC_V2, File
 
 
+@wraps(Field)
+def VideoField(*args, **kwargs):
+    ui = kwargs.get("ui", {})
+    ui.setdefault("field", "video")
+    kwargs["ui"] = ui
+    return Field(*args, **kwargs)
+
+
 class Video(File):
     if IS_PYDANTIC_V2:
         model_config = {"json_schema_extra": {"ui": {"field": "video"}}}