fal 1.20.0__py3-none-any.whl → 1.20.2__py3-none-any.whl

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/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/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/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/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/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/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/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"}}}

{fal-1.20.0.dist-info → fal-1.20.2.dist-info}/METADATA

@@ -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.dist-info → fal-1.20.2.dist-info}/RECORD

@@ -1,9 +1,9 @@
 fal/__init__.py,sha256=wXs1G0gSc7ZK60-bHe-B2m0l_sA6TrFk4BxY0tMoLe8,784
 fal/__main__.py,sha256=4JMK66Wj4uLZTKbF-sT3LAxOsr6buig77PmOkJCRRxw,83
-fal/_fal_version.py,sha256=G6fKlZikLkePqO7zqUxyBFH-RrB5SeRe9ur6-Tubskw,513
+fal/_fal_version.py,sha256=oOzN_eFDSujB4KWlmhVE07aE_rxlU2LHUbGm5yjyaoc,513
 fal/_serialization.py,sha256=npXNsFJ5G7jzBeBIyVMH01Ww34mGY4XWhHpRbSrTtnQ,7598
 fal/_version.py,sha256=1BbTFnucNC_6ldKJ_ZoC722_UkW4S9aDBSW9L0fkKAw,2315
-fal/api.py,sha256=moDNT8wt20uzsI-NTEsbVTpjFXFkSuuRXJx7Apux3SI,46329
+fal/api.py,sha256=_TaUcdTUNz5GnjGd3On1FeDSJ0zVJwZQZqAMn3_Yddw,46451
 fal/app.py,sha256=S5VHxDaj5J9YVC8ECenHCZJlTHalapHyOyHbCBNsDfs,24153
 fal/apps.py,sha256=pzCd2mrKl5J_4oVc40_pggvPtFahXBCdrZXWpnaEJVs,12130
 fal/config.py,sha256=BEMH10B2bfWJ9yNawnLG6v3kBLnLmkhMe201EAODzs4,3124
@@ -30,7 +30,7 @@ fal/cli/create.py,sha256=a8WDq-nJLFTeoIXqpb5cr7GR7YR9ZZrQCawNm34KXXE,627
 fal/cli/debug.py,sha256=u_urnyFzSlNnrq93zz_GXE9FX4VyVxDoamJJyrZpFI0,1312
 fal/cli/deploy.py,sha256=CWf0Y56w-hNCrht-qrfgiOi9nuvve1Kl5NFZJpt_oRA,7770
 fal/cli/doctor.py,sha256=U4ne9LX5gQwNblsYQ27XdO8AYDgbYjTO39EtxhwexRM,983
-fal/cli/files.py,sha256=DnCVWUFmdxVU-ADIAOjG8mFcnc7xjOTuliFJHNYJZzo,2424
+fal/cli/files.py,sha256=pSgAnTm2eHdP-IPkMIVfnK_Ii7mkSSOVgvbsiFUVBC0,2936
 fal/cli/keys.py,sha256=7Sf4DT4le89G42eAOt0ltRjbZAtE70AVQ62hmjZhUy0,3059
 fal/cli/main.py,sha256=ao8EEV_Fkd7AdN5En6k_dZWp158Et5DrqNRutl98MHY,3273
 fal/cli/parser.py,sha256=jYsGQ0BLQuKI7KtN1jnLVYKMbLtez7hPjwTNfG3UPSk,2964
@@ -51,21 +51,21 @@ fal/logging/isolate.py,sha256=jIryi46ZVlJ1mfan4HLNQQ3jwMi8z-WwfqqLlttQVkc,2449
 fal/logging/style.py,sha256=ckIgHzvF4DShM5kQh8F133X53z_vF46snuDHVmo_h9g,386
 fal/logging/trace.py,sha256=OhzB6d4rQZimBc18WFLqH_9BGfqFFumKKTAGSsmWRMg,1904
 fal/logging/user.py,sha256=H7Pg-nqhpzsUb5f6uXyZUeLWAsr3oImQEaYSCIIAlqo,818
-fal/toolkit/__init__.py,sha256=DoTg1gPpN8fMkBbrtXbW8OF3Se7ShucLntBUu2wOwEI,768
+fal/toolkit/__init__.py,sha256=GR5KxAsNODlhs-DTarJcb5raujActubn0afR7FPueWs,886
 fal/toolkit/exceptions.py,sha256=elHZ7dHCJG5zlHGSBbz-ilkZe9QUvQMomJFi8Pt91LA,198
 fal/toolkit/optimize.py,sha256=p75sovF0SmRP6zxzpIaaOmqlxvXB_xEz3XPNf59EF7w,1339
 fal/toolkit/types.py,sha256=kkbOsDKj1qPGb1UARTBp7yuJ5JUuyy7XQurYUBCdti8,4064
 fal/toolkit/audio/__init__.py,sha256=sqNVfrKbppWlIGLoFTaaNTxLpVXsFHxOSHLA5VG547A,35
-fal/toolkit/audio/audio.py,sha256=_o5zCqBOppmX6_N_vtDkiW6e35XklOMvW71ELo6gfEE,344
+fal/toolkit/audio/audio.py,sha256=gt458h989iQ-EhQSH-mCuJuPBY4RneLJE05f_QWU1E0,572
 fal/toolkit/file/__init__.py,sha256=FbNl6wD-P0aSSTUwzHt4HujBXrbC3ABmaigPQA4hRfg,70
-fal/toolkit/file/file.py,sha256=QITEtOyevDVOjv9iwUEWId7edQ6EBx6Uz6CgqWWJJ-U,9568
+fal/toolkit/file/file.py,sha256=7JWAwDqT3xnfCtPl75x1TpRmtJmWRRVvsGFMNUta3bY,9765
 fal/toolkit/file/types.py,sha256=MMAH_AyLOhowQPesOv1V25wB4qgbJ3vYNlnTPbdSv1M,2304
 fal/toolkit/file/providers/fal.py,sha256=vt4Mznbfca6blfk0psF1ix-zB6309kpIA0_5Qh7bmFw,47217
 fal/toolkit/file/providers/gcp.py,sha256=DKeZpm1MjwbvEsYvkdXUtuLIJDr_UNbqXj_Mfv3NTeo,2437
 fal/toolkit/file/providers/r2.py,sha256=YqnYkkAo_ZKIa-xoSuDnnidUFwJWHdziAR34PE6irdI,3061
 fal/toolkit/file/providers/s3.py,sha256=EI45T54Mox7lHZKROss_O8o0DIn3CHP9k1iaNYVrxvg,2714
 fal/toolkit/image/__init__.py,sha256=m3OatPbBhcEOYyaTu_dgToxunUKoJu4bJVCWUoN7HX4,1838
-fal/toolkit/image/image.py,sha256=b0dpPwMuOnMdcIdoM_dZfavrFdji5SplKDmg0ERFfNg,5339
+fal/toolkit/image/image.py,sha256=GwTKEsbpoHLbaIQJuPjq4vKXuSttn2plCLoI_aLuYfI,5538
 fal/toolkit/image/safety_checker.py,sha256=S7ow-HuoVxC6ixHWWcBrAUm2dIlgq3sTAIull6xIbAg,3105
 fal/toolkit/image/nsfw_filter/__init__.py,sha256=0d9D51EhcnJg8cZLYJjgvQJDZT74CfQu6mpvinRYRpA,216
 fal/toolkit/image/nsfw_filter/env.py,sha256=iAP2Q3vzIl--DD8nr8o3o0goAwhExN2v0feYE0nIQjs,212
@@ -77,7 +77,7 @@ fal/toolkit/utils/download_utils.py,sha256=IIb8eLsoFg4Gy-2N0M4trnxFUF75f1pWtjOX_
 fal/toolkit/utils/endpoint.py,sha256=5EXoshA2PD_brjEfhNWAWasjqLOCRrjBnfhj6QGuMt8,782
 fal/toolkit/utils/retry.py,sha256=0pnKqs1Y2dADMAk2944FZr68ZL3wQC_5hqApfgyMf_8,1531
 fal/toolkit/video/__init__.py,sha256=YV0jWpuvoA_CDFQXhd3zOvilFLKH7DYARrbzR7hWhpE,35
-fal/toolkit/video/video.py,sha256=U2hIIaIKCB_ZStYgQjpMTNrVONklq6fcqj-IT9jA7nE,344
+fal/toolkit/video/video.py,sha256=dHNMdV_zJHiJMzlfIiyDv7tqJBsD32aoc3Ao0t1nKNk,572
 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
@@ -141,8 +141,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-1.20.0.dist-info/METADATA,sha256=RHUb3t5f1i_0lUu1RlLCW8RybmD0zbYXDXkFPzX3YCg,4085
-fal-1.20.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fal-1.20.0.dist-info/entry_points.txt,sha256=32zwTUC1U1E7nSTIGCoANQOQ3I7-qHG5wI6gsVz5pNU,37
-fal-1.20.0.dist-info/top_level.txt,sha256=r257X1L57oJL8_lM0tRrfGuXFwm66i1huwQygbpLmHw,21
-fal-1.20.0.dist-info/RECORD,,
+fal-1.20.2.dist-info/METADATA,sha256=R0uG3AsFj6ZgzcOe-Q7O99Cuhks3e1uU6n31FUz1mCo,4085
+fal-1.20.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fal-1.20.2.dist-info/entry_points.txt,sha256=32zwTUC1U1E7nSTIGCoANQOQ3I7-qHG5wI6gsVz5pNU,37
+fal-1.20.2.dist-info/top_level.txt,sha256=r257X1L57oJL8_lM0tRrfGuXFwm66i1huwQygbpLmHw,21
+fal-1.20.2.dist-info/RECORD,,