fal 1.14.0__py3-none-any.whl → 1.15.0__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.14.0'
-__version_tuple__ = version_tuple = (1, 14, 0)
+__version__ = version = '1.15.0'
+__version_tuple__ = version_tuple = (1, 15, 0)

fal/cli/files.py

@@ -0,0 +1,70 @@
+from .parser import FalClientParser
+
+
+def _list(args):
+    import posixpath
+
+    from fal.files import FalFileSystem
+
+    fs = FalFileSystem()
+
+    for entry in fs.ls(args.path, detail=True):
+        name = posixpath.basename(entry["name"])
+        color = "blue" if entry["type"] == "directory" else "default"
+        args.console.print(f"[{color}]{name}[/{color}]")
+
+
+def _download(args):
+    from fal.files import FalFileSystem
+
+    fs = FalFileSystem()
+    fs.get(args.remote_path, args.local_path)
+
+
+def _upload(args):
+    from fal.files import FalFileSystem
+
+    fs = FalFileSystem()
+    fs.put(args.local_path, args.remote_path)
+
+
+def add_parser(main_subparsers, parents):
+    files_help = "Manage fal files."
+    parser = main_subparsers.add_parser(
+        "files",
+        aliases=["file"],
+        description=files_help,
+        help=files_help,
+        parents=parents,
+    )
+
+    subparsers = parser.add_subparsers(
+        title="Commands",
+        metavar="command",
+        required=True,
+        parser_class=FalClientParser,
+    )
+
+    list_parser = subparsers.add_parser("list", aliases=["ls"], parents=parents)
+    list_parser.add_argument(
+        "path",
+        nargs="?",
+        type=str,
+        help="The path to list",
+        default="/",
+    )
+    list_parser.set_defaults(func=_list)
+
+    download_parser = subparsers.add_parser("download", parents=parents)
+    download_parser.add_argument(
+        "remote_path", type=str, help="Remote path to download"
+    )
+    download_parser.add_argument(
+        "local_path", type=str, help="Local path to download to"
+    )
+    download_parser.set_defaults(func=_download)
+
+    upload_parser = subparsers.add_parser("upload", 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)

fal/cli/main.py

@@ -13,6 +13,7 @@ from . import (
     create,
     deploy,
     doctor,
+    files,
     keys,
     profile,
     run,
@@ -57,6 +58,7 @@ def _get_main_parser() -> argparse.ArgumentParser:
         create,
         runners,
         teams,
+        files,
     ]:
         cmd.add_parser(subparsers, parents)
 

fal/files.py

@@ -1,81 +1,74 @@
-from functools import lru_cache
-from pathlib import Path
-from typing import Any, Dict, Optional, Sequence, Tuple, Union
-
-import tomli
-
-
-@lru_cache
-def _load_toml(path: Union[Path, str]) -> Dict[str, Any]:
-    with open(path, "rb") as f:
-        return tomli.load(f)
-
-
-@lru_cache
-def _cached_resolve(path: Path) -> Path:
-    return path.resolve()
-
-
-@lru_cache
-def find_project_root(srcs: Optional[Sequence[str]]) -> Tuple[Path, str]:
-    """Return a directory containing .git, or pyproject.toml.
-
-    That directory will be a common parent of all files and directories
-    passed in `srcs`.
-
-    If no directory in the tree contains a marker that would specify it's the
-    project root, the root of the file system is returned.
-
-    Returns a two-tuple with the first element as the project root path and
-    the second element as a string describing the method by which the
-    project root was discovered.
-    """
-    if not srcs:
-        srcs = [str(_cached_resolve(Path.cwd()))]
-
-    path_srcs = [_cached_resolve(Path(Path.cwd(), src)) for src in srcs]
-
-    # A list of lists of parents for each 'src'. 'src' is included as a
-    # "parent" of itself if it is a directory
-    src_parents = [
-        list(path.parents) + ([path] if path.is_dir() else []) for path in path_srcs
-    ]
-
-    common_base = max(
-        set.intersection(*(set(parents) for parents in src_parents)),
-        key=lambda path: path.parts,
-    )
-
-    for directory in (common_base, *common_base.parents):
-        if (directory / ".git").exists():
-            return directory, ".git directory"
-
-        if (directory / "pyproject.toml").is_file():
-            pyproject_toml = _load_toml(directory / "pyproject.toml")
-            if "fal" in pyproject_toml.get("tool", {}):
-                return directory, "pyproject.toml"
-
-    return directory, "file system root"
-
-
-def find_pyproject_toml(
-    path_search_start: Optional[Tuple[str, ...]] = None,
-) -> Optional[str]:
-    """Find the absolute filepath to a pyproject.toml if it exists"""
-    path_project_root, _ = find_project_root(path_search_start)
-    path_pyproject_toml = path_project_root / "pyproject.toml"
-
-    if path_pyproject_toml.is_file():
-        return str(path_pyproject_toml)
-
-
-def parse_pyproject_toml(path_config: str) -> Dict[str, Any]:
-    """Parse a pyproject toml file, pulling out relevant parts for fal.
-
-    If parsing fails, will raise a tomli.TOMLDecodeError.
-    """
-    pyproject_toml = _load_toml(path_config)
-    config: Dict[str, Any] = pyproject_toml.get("tool", {}).get("fal", {})
-    config = {k.replace("--", "").replace("-", "_"): v for k, v in config.items()}
-
-    return config
+import posixpath
+from functools import cached_property
+from typing import TYPE_CHECKING
+
+from fsspec import AbstractFileSystem
+
+if TYPE_CHECKING:
+    import httpx
+
+USER_AGENT = "fal-sdk/1.14.0 (python)"
+
+
+class FalFileSystem(AbstractFileSystem):
+    @cached_property
+    def _client(self) -> "httpx.Client":
+        from httpx import Client
+
+        from fal.flags import REST_URL
+        from fal.sdk import get_default_credentials
+
+        creds = get_default_credentials()
+        return Client(
+            base_url=REST_URL,
+            headers={
+                **creds.to_headers(),
+                "User-Agent": USER_AGENT,
+            },
+        )
+
+    def ls(self, path, detail=True, **kwargs):
+        response = self._client.get(f"/files/list/{path.lstrip('/')}")
+        response.raise_for_status()
+        files = response.json()
+        if detail:
+            return sorted(
+                (
+                    {
+                        "name": entry["path"],
+                        "size": entry["size"],
+                        "type": "file" if entry["is_file"] else "directory",
+                        "mtime": entry["updated_time"],
+                    }
+                    for entry in files
+                ),
+                key=lambda x: x["name"],
+            )
+        else:
+            return sorted(entry["path"] for entry in files)
+
+    def info(self, path, **kwargs):
+        parent = posixpath.dirname(path)
+        entries = self.ls(parent, detail=True)
+        for entry in entries:
+            if entry["name"] == path:
+                return entry
+        raise FileNotFoundError(f"File not found: {path}")
+
+    def get_file(self, rpath, lpath, **kwargs):
+        with open(lpath, "wb") as fobj:
+            response = self._client.get(f"/files/file/{rpath.lstrip('/')}")
+            response.raise_for_status()
+            fobj.write(response.content)
+
+    def put_file(self, lpath, rpath, mode="overwrite", **kwargs):
+        with open(lpath, "rb") as fobj:
+            response = self._client.post(
+                f"/files/file/local/{rpath.lstrip('/')}",
+                files={"file_upload": (posixpath.basename(lpath), fobj, "text/plain")},
+            )
+            response.raise_for_status()
+
+    def rm(self, path, **kwargs):
+        response = self._client.delete(f"/files/file/{path.lstrip('/')}")
+        response.raise_for_status()

fal/toolkit/file/providers/fal.py

@@ -5,13 +5,15 @@ import math
 import os
 import threading
 from base64 import b64encode
+from contextlib import contextmanager
 from dataclasses import dataclass
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import Generic, TypeVar
+from typing import Generator, Generic, TypeVar
 from urllib.error import HTTPError
 from urllib.parse import urlparse, urlunparse
 from urllib.request import Request, urlopen
+from urllib.response import addinfourl
 
 from fal.auth import key_credentials
 from fal.toolkit.exceptions import FileUploadException
@@ -21,6 +23,17 @@ from fal.toolkit.utils.retry import retry
 _FAL_CDN = "https://fal.media"
 _FAL_CDN_V3 = "https://v3.fal.media"
 
+DEFAULT_REQUEST_TIMEOUT = 10
+PUT_REQUEST_TIMEOUT = 5 * 60
+
+
+@contextmanager
+def _urlopen(
+    request: Request, timeout: int = DEFAULT_REQUEST_TIMEOUT
+) -> Generator[addinfourl, None, None]:
+    with urlopen(request, timeout=timeout) as response:
+        yield response
+
 
 @dataclass
 class FalV2Token:
@@ -79,7 +92,7 @@ class FalV2TokenManager:
             data=b"{}",
             method="POST",
         )
-        with urlopen(req) as response:
+        with _urlopen(req) as response:
             result = json.load(response)
 
         parsed_base_url = urlparse(result["base_url"])
@@ -158,7 +171,7 @@ class FalFileRepositoryBase(FileRepository):
                 headers=headers,
                 method="POST",
             )
-            with urlopen(req) as response:
+            with _urlopen(req) as response:
                 result = json.load(response)
 
             upload_url = result["upload_url"]
@@ -175,7 +188,7 @@ class FalFileRepositoryBase(FileRepository):
                 headers={"Content-Type": file.content_type},
             )
 
-            with urlopen(req):
+            with _urlopen(req, timeout=PUT_REQUEST_TIMEOUT):
                 pass
 
             return result["file_url"]
@@ -252,7 +265,7 @@ class MultipartUploadGCS:
                 ).encode(),
             )
 
-            with urlopen(req) as response:
+            with _urlopen(req) as response:
                 result = json.load(response)
                 self._access_url = result["file_url"]
                 self._upload_url = result["upload_url"]
@@ -272,7 +285,7 @@ class MultipartUploadGCS:
         )
 
         try:
-            with urlopen(req) as response:
+            with _urlopen(req) as response:
                 result = json.load(response)
                 upload_url = result["upload_url"]
         except HTTPError as exc:
@@ -288,7 +301,7 @@ class MultipartUploadGCS:
         )
 
         try:
-            with urlopen(req) as resp:
+            with _urlopen(req, timeout=PUT_REQUEST_TIMEOUT) as resp:
                 self._parts.append(
                     {
                         "part_number": part_number,
@@ -318,7 +331,7 @@ class MultipartUploadGCS:
                     }
                 ).encode(),
             )
-            with urlopen(req):
+            with _urlopen(req):
                 pass
         except HTTPError as e:
             raise FileUploadException(
@@ -523,7 +536,7 @@ class MultipartUpload:
                     }
                 ).encode(),
             )
-            with urlopen(req) as response:
+            with _urlopen(req) as response:
                 result = json.load(response)
                 self._upload_url = result["upload_url"]
                 self._file_url = result["file_url"]
@@ -543,7 +556,7 @@ class MultipartUpload:
         )
 
         try:
-            with urlopen(req) as resp:
+            with _urlopen(req, timeout=PUT_REQUEST_TIMEOUT) as resp:
                 self._parts.append(
                     {
                         "part_number": part_number,
@@ -568,7 +581,7 @@ class MultipartUpload:
                 },
                 data=json.dumps({"parts": self._parts}).encode(),
             )
-            with urlopen(req):
+            with _urlopen(req):
                 pass
         except HTTPError as e:
             raise FileUploadException(
@@ -721,7 +734,7 @@ class MultipartUploadV3:
                 ).encode(),
             )
 
-            with urlopen(req) as response:
+            with _urlopen(req) as response:
                 result = json.load(response)
                 self._access_url = result["file_url"]
                 self._upload_url = result["upload_url"]
@@ -747,7 +760,7 @@ class MultipartUploadV3:
         )
 
         try:
-            with urlopen(req) as resp:
+            with _urlopen(req, timeout=PUT_REQUEST_TIMEOUT) as resp:
                 self._parts.append(
                     {
                         "partNumber": part_number,
@@ -775,7 +788,7 @@ class MultipartUploadV3:
                 },
                 data=json.dumps({"parts": self._parts}).encode(),
             )
-            with urlopen(req):
+            with _urlopen(req):
                 pass
         except HTTPError as e:
             raise FileUploadException(
@@ -915,7 +928,7 @@ class InternalMultipartUploadV3:
                     "X-Fal-File-Name": self.file_name,
                 },
             )
-            with urlopen(req) as response:
+            with _urlopen(req) as response:
                 result = json.load(response)
                 self._access_url = result["access_url"]
                 self._upload_id = result["uploadId"]
@@ -940,7 +953,7 @@ class InternalMultipartUploadV3:
         )
 
         try:
-            with urlopen(req) as resp:
+            with _urlopen(req, timeout=PUT_REQUEST_TIMEOUT) as resp:
                 self._parts.append(
                     {
                         "partNumber": part_number,
@@ -966,7 +979,7 @@ class InternalMultipartUploadV3:
                 },
                 data=json.dumps({"parts": self._parts}).encode(),
             )
-            with urlopen(req):
+            with _urlopen(req):
                 pass
         except HTTPError as e:
             raise FileUploadException(
@@ -1092,7 +1105,7 @@ class FalFileRepositoryV2(FalFileRepositoryBase):
                 headers=headers,
                 method="PUT",
             )
-            with urlopen(req) as response:
+            with _urlopen(req, timeout=PUT_REQUEST_TIMEOUT) as response:
                 result = json.load(response)
 
             return result["file_url"]
@@ -1186,7 +1199,7 @@ class FalCDNFileRepository(FileRepository):
         url = os.getenv("FAL_CDN_HOST", _FAL_CDN) + "/files/upload"
         request = Request(url, headers=headers, method="POST", data=file.data)
         try:
-            with urlopen(request) as response:
+            with _urlopen(request) as response:
                 result = json.load(response)
         except HTTPError as e:
             raise FileUploadException(
@@ -1266,7 +1279,7 @@ class FalFileRepositoryV3(FileRepository):
             ).encode(),
         )
         try:
-            with urlopen(request) as response:
+            with _urlopen(request) as response:
                 result = json.load(response)
                 file_url = result["file_url"]
                 upload_url = result["upload_url"]
@@ -1282,7 +1295,7 @@ class FalFileRepositoryV3(FileRepository):
             data=file.data,
         )
         try:
-            with urlopen(request):
+            with _urlopen(request, timeout=PUT_REQUEST_TIMEOUT):
                 pass
         except HTTPError as e:
             raise FileUploadException(
@@ -1380,7 +1393,7 @@ class InternalFalFileRepositoryV3(FileRepository):
         url = os.getenv("FAL_CDN_V3_HOST", _FAL_CDN_V3) + "/files/upload"
         request = Request(url, headers=headers, method="POST", data=file.data)
         try:
-            with urlopen(request) as response:
+            with _urlopen(request) as response:
                 result = json.load(response)
         except HTTPError as e:
             raise FileUploadException(

{fal-1.14.0.dist-info → fal-1.15.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fal
-Version: 1.14.0
+Version: 1.15.0
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
@@ -38,6 +38,7 @@ Requires-Dist: uvicorn<1,>=0.29.0
 Requires-Dist: cookiecutter
 Requires-Dist: tomli<3,>2
 Requires-Dist: tomli-w<2,>=1
+Requires-Dist: fsspec
 Provides-Extra: docs
 Requires-Dist: sphinx<8.2.0; extra == "docs"
 Requires-Dist: sphinx-rtd-theme; extra == "docs"

{fal-1.14.0.dist-info → fal-1.15.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 fal/__init__.py,sha256=wXs1G0gSc7ZK60-bHe-B2m0l_sA6TrFk4BxY0tMoLe8,784
 fal/__main__.py,sha256=4JMK66Wj4uLZTKbF-sT3LAxOsr6buig77PmOkJCRRxw,83
-fal/_fal_version.py,sha256=zEosD-3Sqrti57GKf-4yC-NurX2Smyv5d6IDkQisUBo,513
+fal/_fal_version.py,sha256=bw-GHVwYsU9TasIoWctP5ethaWthhk1oAuWz-86NHtc,513
 fal/_serialization.py,sha256=rD2YiSa8iuzCaZohZwN_MPEB-PpSKbWRDeaIDpTEjyY,7653
 fal/_version.py,sha256=EBGqrknaf1WygENX-H4fBefLvHryvJBBGtVJetaB0NY,266
 fal/api.py,sha256=gVZKtdMRNKacBCNVmdZZRGMyF3hrR2bqGiAzUBstkDM,45661
@@ -8,7 +8,7 @@ fal/app.py,sha256=aRb8t-5QCrIPeKHY39yJ3231T5uHGZLhSurkRBtzyu8,24216
 fal/apps.py,sha256=pzCd2mrKl5J_4oVc40_pggvPtFahXBCdrZXWpnaEJVs,12130
 fal/config.py,sha256=19Q7fymEkfxCd9AIy8SxhaQaRvb_vKvYAG3AeZAI6uk,3116
 fal/container.py,sha256=OvR-Zq-NPbYFHTnw0SBUUFxr890Fgbe68J2kSJEpLOk,1905
-fal/files.py,sha256=QgfYfMKmNobMPufrAP_ga1FKcIAlSbw18Iar1-0qepo,2650
+fal/files.py,sha256=HgXD8q9-RKQGIaN7lXtht2BOFFsdMozJcLr3DwLx4x8,2387
 fal/flags.py,sha256=oWN_eidSUOcE9wdPK_77si3A1fpgOC0UEERPsvNLIMc,842
 fal/project.py,sha256=QgfYfMKmNobMPufrAP_ga1FKcIAlSbw18Iar1-0qepo,2650
 fal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -30,8 +30,9 @@ 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=SN0pr6bvdss8_EjmaB2kai5VYVacLRF_oH6it4Ni8-M,1936
 fal/cli/keys.py,sha256=7Sf4DT4le89G42eAOt0ltRjbZAtE70AVQ62hmjZhUy0,3059
-fal/cli/main.py,sha256=4TnIno7fvFJbMPlpb8mnT7meKAR-UAOerxuo5qqPZRQ,2234
+fal/cli/main.py,sha256=CNh-i1xL0G2pbYMsk0VUC6qsxBT9rrQuLCIeDSiRuQs,2260
 fal/cli/parser.py,sha256=jYsGQ0BLQuKI7KtN1jnLVYKMbLtez7hPjwTNfG3UPSk,2964
 fal/cli/profile.py,sha256=9i0pY0Jhm_ziEDdSXgFMGuXUh3Xx3f5S1xBkuuUbH2I,3448
 fal/cli/run.py,sha256=nAC12Qss4Fg1XmV0qOS9RdGNLYcdoHeRgQMvbTN4P9I,1202
@@ -57,7 +58,7 @@ fal/toolkit/types.py,sha256=kkbOsDKj1qPGb1UARTBp7yuJ5JUuyy7XQurYUBCdti8,4064
 fal/toolkit/file/__init__.py,sha256=FbNl6wD-P0aSSTUwzHt4HujBXrbC3ABmaigPQA4hRfg,70
 fal/toolkit/file/file.py,sha256=Kb-mdR66OiSNTS2EGLLJYUqnAw-KN7diqhxvjS7EAZ0,9353
 fal/toolkit/file/types.py,sha256=MMAH_AyLOhowQPesOv1V25wB4qgbJ3vYNlnTPbdSv1M,2304
-fal/toolkit/file/providers/fal.py,sha256=NI9TX5gdFkyc6hHl-5FKNuYvGYhYFHD5FvXRf3d-oRU,46409
+fal/toolkit/file/providers/fal.py,sha256=cbND8tjEJvKklrmYgrjr6RtAcVLJIQ9VwhBhNCqgKc8,46992
 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
@@ -135,8 +136,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.14.0.dist-info/METADATA,sha256=igztZ6l08d35Z3tyPVxQ2JtbHHGSXN5T4A2YWSxFJw8,4062
-fal-1.14.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-fal-1.14.0.dist-info/entry_points.txt,sha256=32zwTUC1U1E7nSTIGCoANQOQ3I7-qHG5wI6gsVz5pNU,37
-fal-1.14.0.dist-info/top_level.txt,sha256=r257X1L57oJL8_lM0tRrfGuXFwm66i1huwQygbpLmHw,21
-fal-1.14.0.dist-info/RECORD,,
+fal-1.15.0.dist-info/METADATA,sha256=_ngkJv-caqQuXH8IS_jwmliPyjEOs0I7sIcQ2QPtPN0,4084
+fal-1.15.0.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+fal-1.15.0.dist-info/entry_points.txt,sha256=32zwTUC1U1E7nSTIGCoANQOQ3I7-qHG5wI6gsVz5pNU,37
+fal-1.15.0.dist-info/top_level.txt,sha256=r257X1L57oJL8_lM0tRrfGuXFwm66i1huwQygbpLmHw,21
+fal-1.15.0.dist-info/RECORD,,

{fal-1.14.0.dist-info → fal-1.15.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
+Generator: setuptools (80.4.0)
 Root-Is-Purelib: true
 Tag: py3-none-any