fal 0.15.0__tar.gz → 1.0.0__tar.gz

fal-1.0.0/.gitignore

@@ -0,0 +1 @@
+/src/fal/_fal_version.py

{fal-0.15.0 → fal-1.0.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 0.15.0
+Version: 1.0.0
 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
@@ -19,7 +19,7 @@ Requires-Dist: grpc-interceptor<1,>=0.15.0
 Requires-Dist: colorama<1,>=0.4.6
 Requires-Dist: portalocker<3,>=2.7.0
 Requires-Dist: rich<14,>=13.3.2
-Requires-Dist: rich_click
+Requires-Dist: rich_argparse
 Requires-Dist: packaging<22,>=21.3
 Requires-Dist: pathspec<1,>=0.11.1
 Requires-Dist: pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<3
@@ -36,9 +36,10 @@ Requires-Dist: pillow<11,>=10.2.0
 Requires-Dist: pyjwt[crypto]<3,>=2.8.0
 Requires-Dist: uvicorn<1,>=0.29.0
 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"
 Provides-Extra: dev
 Requires-Dist: fal[test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
@@ -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 → fal-1.0.0}/README.md

@@ -44,3 +44,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 → fal-1.0.0}/fal.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 0.15.0
+Version: 1.0.0
 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
@@ -19,7 +19,7 @@ Requires-Dist: grpc-interceptor<1,>=0.15.0
 Requires-Dist: colorama<1,>=0.4.6
 Requires-Dist: portalocker<3,>=2.7.0
 Requires-Dist: rich<14,>=13.3.2
-Requires-Dist: rich_click
+Requires-Dist: rich_argparse
 Requires-Dist: packaging<22,>=21.3
 Requires-Dist: pathspec<1,>=0.11.1
 Requires-Dist: pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<3
@@ -36,9 +36,10 @@ Requires-Dist: pillow<11,>=10.2.0
 Requires-Dist: pyjwt[crypto]<3,>=2.8.0
 Requires-Dist: uvicorn<1,>=0.29.0
 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"
 Provides-Extra: dev
 Requires-Dist: fal[test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
@@ -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 → fal-1.0.0}/fal.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+.gitignore
 README.md
 openapi_rest.config.yaml
 pyproject.toml
@@ -53,27 +54,38 @@ openapi-fal-rest/openapi_fal_rest/models/workflow_schema_input.py
 openapi-fal-rest/openapi_fal_rest/models/workflow_schema_output.py
 src/fal/__init__.py
 src/fal/__main__.py
+src/fal/_fal_version.py
 src/fal/_serialization.py
+src/fal/_version.py
 src/fal/api.py
 src/fal/app.py
 src/fal/apps.py
-src/fal/cli.py
 src/fal/flags.py
 src/fal/py.typed
 src/fal/rest_client.py
 src/fal/sdk.py
 src/fal/sync.py
+src/fal/utils.py
 src/fal/workflows.py
 src/fal/auth/__init__.py
 src/fal/auth/auth0.py
 src/fal/auth/local.py
+src/fal/cli/__init__.py
+src/fal/cli/apps.py
+src/fal/cli/auth.py
+src/fal/cli/debug.py
+src/fal/cli/deploy.py
+src/fal/cli/keys.py
+src/fal/cli/main.py
+src/fal/cli/parser.py
+src/fal/cli/run.py
+src/fal/cli/secrets.py
 src/fal/console/__init__.py
 src/fal/console/icons.py
 src/fal/console/ux.py
 src/fal/exceptions/__init__.py
 src/fal/exceptions/_base.py
 src/fal/exceptions/auth.py
-src/fal/exceptions/handlers.py
 src/fal/logging/__init__.py
 src/fal/logging/isolate.py
 src/fal/logging/style.py
@@ -98,6 +110,13 @@ tests/integration_test.py
 tests/mainify_target.py
 tests/test_apps.py
 tests/test_stability.py
+tests/cli/__init__.py
+tests/cli/test_apps.py
+tests/cli/test_auth.py
+tests/cli/test_deploy.py
+tests/cli/test_keys.py
+tests/cli/test_run.py
+tests/cli/test_secrets.py
 tests/mainify_package/__init__.py
 tests/mainify_package/impl.py
 tests/mainify_package/utils.py

fal-1.0.0/fal.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fal = fal.cli:main

{fal-0.15.0 → fal-1.0.0}/fal.egg-info/requires.txt

@@ -1,5 +1,5 @@
 isolate[build]<1.0,>=0.12.3
-isolate-proto==0.3.4
+isolate-proto==0.4.0
 grpcio<2,>=1.50.0
 dill==0.3.7
 cloudpickle==3.0.0
@@ -12,7 +12,7 @@ grpc-interceptor<1,>=0.15.0
 colorama<1,>=0.4.6
 portalocker<3,>=2.7.0
 rich<14,>=13.3.2
-rich_click
+rich_argparse
 packaging<22,>=21.3
 pathspec<1,>=0.11.1
 pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<3
@@ -36,6 +36,7 @@ fal[test]
 openapi-python-client<1,>=0.14.1
 
 [test]
-pytest
-pytest-xdist
+pytest<8
 pytest-asyncio
+pytest-xdist
+flaky

{fal-0.15.0 → fal-1.0.0}/pyproject.toml

@@ -7,6 +7,7 @@ root = "../../"
 git_describe_command= 'git describe --tags --abbrev=0 --dirty --match "fal_v*"'
 tag_regex = "^fal_v(?P<version>.*)$"
 fallback_version = "0.0.0"
+version_file = "src/fal/_fal_version.py"
 
 [tool.setuptools.packages.find]
 where = ["src", "openapi-fal-rest"]
@@ -22,7 +23,7 @@ readme = "README.md"
 requires-python = ">=3.8"
 dependencies = [
     "isolate[build]>=0.12.3,<1.0",
-    "isolate-proto==0.3.4",
+    "isolate-proto==0.4.0",
     "grpcio>=1.50.0,<2",
     "dill==0.3.7",
     "cloudpickle==3.0.0",
@@ -35,7 +36,7 @@ dependencies = [
     "colorama>=0.4.6,<1",
     "portalocker>=2.7.0,<3",
     "rich>=13.3.2,<14",
-    "rich_click",
+    "rich_argparse",
     "packaging>=21.3,<22",
     "pathspec>=0.11.1,<1",
     "pydantic!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,<3",
@@ -58,9 +59,10 @@ dependencies = [
 
 [project.optional-dependencies]
 test = [
-    "pytest",
-    "pytest-xdist",
+    "pytest<8",
     "pytest-asyncio",
+    "pytest-xdist",
+    "flaky",
 ]
 dev = [
     "fal[test]",
@@ -68,4 +70,13 @@ dev = [
 ]
 
 [project.scripts]
-fal = "fal.cli:cli"
+fal = "fal.cli:main"
+
+[tool.ruff]
+target-version = "py38"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "PLC", "PLE", "PLW", "I", "UP"]
+
+[tool.ruff.lint.pyupgrade]
+keep-runtime-typing = true

fal-1.0.0/src/fal/__init__.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from fal import apps  # noqa: F401
+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
+from fal.sync import sync_dir
+
+from ._version import __version__, version_tuple  # noqa: F401
+
+local = LocalHost()
+serverless = FalServerlessHost()
+
+# DEPRECATED - use serverless instead
+cloud = FalServerlessHost()
+
+__all__ = [
+    "function",
+    "cached",
+    "App",
+    "endpoint",
+    "realtime",
+    # "wrap_app",
+    "FalServerlessKeyCredentials",
+    "sync_dir",
+    "__version__",
+    "version_tuple",
+]

fal-1.0.0/src/fal/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

fal-1.0.0/src/fal/_fal_version.py

@@ -0,0 +1,16 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)

{fal-0.15.0 → fal-1.0.0}/src/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-1.0.0/src/fal/_version.py

@@ -0,0 +1,6 @@
+try:
+    from ._fal_version import version as __version__  # type: ignore[import]
+    from ._fal_version import version_tuple  # type: ignore[import]
+except ImportError:
+    __version__ = "UNKNOWN"
+    version_tuple = (0, 0, __version__)  # type: ignore[assignment]

{fal-0.15.0 → fal-1.0.0}/src/fal/api.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import inspect
+import os
 import sys
 import threading
 from collections import defaultdict
@@ -40,8 +41,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 +58,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 +114,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 +546,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 +787,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):
@@ -830,6 +833,9 @@ class BaseServable:
         """
         pass
 
+    def _add_extra_routes(self, app: FastAPI):
+        pass
+
     @asynccontextmanager
     async def lifespan(self, app: FastAPI):
         yield
@@ -840,7 +846,10 @@ class BaseServable:
         from fastapi.responses import JSONResponse
         from starlette_exporter import PrometheusMiddleware
 
-        _app = FalFastAPI(lifespan=self.lifespan)
+        _app = FalFastAPI(
+            lifespan=self.lifespan,
+            root_path=os.getenv("FAL_APP_ROOT_PATH") or "",
+        )
 
         _app.add_middleware(
             CORSMiddleware,
@@ -891,6 +900,8 @@ class BaseServable:
                     methods=["POST"],
                 )
 
+        self._add_extra_routes(_app)
+
         return _app
 
     def openapi(self) -> dict[str, Any]:
@@ -918,7 +929,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 +1020,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 +1080,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 +1114,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: