fal 1.5.2__tar.gz → 1.5.3__tar.gz

{fal-1.5.2 → fal-1.5.3}/.gitignore

@@ -1 +1,2 @@
 /src/fal/_fal_version.py
+/docs/*

fal-1.5.3/Makefile

@@ -0,0 +1,24 @@
+MAKEFILE_DIR := $(patsubst %/,%,$(dir $(abspath $(lastword $(MAKEFILE_LIST)))))
+
+SPHINXOPTS    = --fresh-env
+SPHINXBUILD   = sphinx-build
+SPHINXAPIDOC  = sphinx-apidoc
+SOURCEDIR     = $(MAKEFILE_DIR)/docs
+BUILDDIR      = $(MAKEFILE_DIR)/docs/_build
+PROJECTDIR    = $(MAKEFILE_DIR)/src/fal
+
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile clean apidoc html docs
+
+clean:
+	rm -rf $(BUILDDIR)/*
+
+apidoc:
+	$(SPHINXAPIDOC) -f -o "$(SOURCEDIR)" "$(PROJECTDIR)"
+
+html:
+	@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+docs: apidoc html

{fal-1.5.2 → fal-1.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 1.5.2
+Version: 1.5.3
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
@@ -37,6 +37,10 @@ Requires-Dist: pyjwt[crypto]<3,>=2.8.0
 Requires-Dist: uvicorn<1,>=0.29.0
 Requires-Dist: cookiecutter
 Requires-Dist: tomli
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
 Provides-Extra: test
 Requires-Dist: pytest<8; extra == "test"
 Requires-Dist: pytest-asyncio; extra == "test"
@@ -44,7 +48,7 @@ Requires-Dist: pytest-xdist; extra == "test"
 Requires-Dist: flaky; extra == "test"
 Requires-Dist: boto3; extra == "test"
 Provides-Extra: dev
-Requires-Dist: fal[test]; extra == "dev"
+Requires-Dist: fal[docs,test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
 
 [![PyPI](https://img.shields.io/pypi/v/fal.svg?logo=PyPI)](https://pypi.org/project/fal)

fal-1.5.3/docs/conf.py

@@ -0,0 +1,31 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = 'fal_sdk'
+copyright = '2024, FAL Team'
+author = 'FAL Team'
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',
+    'sphinx_autodoc_typehints'
+]
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = 'alabaster'
+html_static_path = ['_static']

fal-1.5.3/docs/index.rst

@@ -0,0 +1,18 @@
+.. fal_sdk documentation master file, created by
+   sphinx-quickstart on Wed Oct  2 05:09:49 2024.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+fal_sdk documentation
+=====================
+
+Add your content using ``reStructuredText`` syntax. See the
+`reStructuredText <https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>`_
+documentation for details.
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   modules

{fal-1.5.2 → fal-1.5.3}/fal.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fal
-Version: 1.5.2
+Version: 1.5.3
 Summary: fal is an easy-to-use Serverless Python Framework
 Author: Features & Labels <support@fal.ai>
 Requires-Python: >=3.8
@@ -37,6 +37,10 @@ Requires-Dist: pyjwt[crypto]<3,>=2.8.0
 Requires-Dist: uvicorn<1,>=0.29.0
 Requires-Dist: cookiecutter
 Requires-Dist: tomli
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
 Provides-Extra: test
 Requires-Dist: pytest<8; extra == "test"
 Requires-Dist: pytest-asyncio; extra == "test"
@@ -44,7 +48,7 @@ Requires-Dist: pytest-xdist; extra == "test"
 Requires-Dist: flaky; extra == "test"
 Requires-Dist: boto3; extra == "test"
 Provides-Extra: dev
-Requires-Dist: fal[test]; extra == "dev"
+Requires-Dist: fal[docs,test]; extra == "dev"
 Requires-Dist: openapi-python-client<1,>=0.14.1; extra == "dev"
 
 [![PyPI](https://img.shields.io/pypi/v/fal.svg?logo=PyPI)](https://pypi.org/project/fal)

{fal-1.5.2 → fal-1.5.3}/fal.egg-info/SOURCES.txt

@@ -1,7 +1,10 @@
 .gitignore
+Makefile
 README.md
 openapi_rest.config.yaml
 pyproject.toml
+docs/conf.py
+docs/index.rst
 fal.egg-info/PKG-INFO
 fal.egg-info/SOURCES.txt
 fal.egg-info/dependency_links.txt

{fal-1.5.2 → fal-1.5.3}/fal.egg-info/requires.txt

@@ -34,9 +34,14 @@ tomli
 importlib-metadata>=4.4
 
 [dev]
-fal[test]
+fal[docs,test]
 openapi-python-client<1,>=0.14.1
 
+[docs]
+sphinx
+sphinx-rtd-theme
+sphinx-autodoc-typehints
+
 [test]
 pytest<8
 pytest-asyncio

{fal-1.5.2 → fal-1.5.3}/pyproject.toml

@@ -60,6 +60,11 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+docs = [
+    "sphinx",
+    "sphinx-rtd-theme",
+    "sphinx-autodoc-typehints",
+]
 test = [
     "pytest<8",
     "pytest-asyncio",
@@ -68,7 +73,7 @@ test = [
     "boto3",
 ]
 dev = [
-    "fal[test]",
+    "fal[docs,test]",
     "openapi-python-client>=0.14.1,<1",
 ]
 

{fal-1.5.2 → fal-1.5.3}/src/fal/_fal_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '1.5.2'
-__version_tuple__ = version_tuple = (1, 5, 2)
+__version__ = version = '1.5.3'
+__version_tuple__ = version_tuple = (1, 5, 3)

{fal-1.5.2 → fal-1.5.3}/src/fal/app.py

@@ -19,7 +19,8 @@ from fal._serialization import include_modules_from
 from fal.api import RouteSignature
 from fal.exceptions import RequestCancelledException
 from fal.logging import get_logger
-from fal.toolkit.file.providers import fal as fal_provider_module
+from fal.toolkit.file import get_lifecycle_preference
+from fal.toolkit.file.providers.fal import GLOBAL_LIFECYCLE_PREFERENCE
 
 REALTIME_APP_REQUIREMENTS = ["websockets", "msgpack"]
 
@@ -266,11 +267,14 @@ class App(fal.api.BaseServable):
 
         @app.middleware("http")
         async def set_global_object_preference(request, call_next):
-            response = await call_next(request)
             try:
-                fal_provider_module.GLOBAL_LIFECYCLE_PREFERENCE = request.headers.get(
-                    "X-Fal-Object-Lifecycle-Preference"
-                )
+                preference_dict = get_lifecycle_preference(request) or {}
+                expiration_duration = preference_dict.get("expiration_duration_seconds")
+                if expiration_duration is not None:
+                    GLOBAL_LIFECYCLE_PREFERENCE.expiration_duration_seconds = int(
+                        expiration_duration
+                    )
+
             except Exception:
                 from fastapi.logger import logger
 
@@ -278,7 +282,7 @@ class App(fal.api.BaseServable):
                     "Failed set a global lifecycle preference %s",
                     self.__class__.__name__,
                 )
-            return response
+            return await call_next(request)
 
         @app.exception_handler(RequestCancelledException)
         async def value_error_exception_handler(

{fal-1.5.2 → fal-1.5.3}/src/fal/toolkit/file/file.py

@@ -144,7 +144,7 @@ class File(BaseModel):
 
         fdata = FileData(data, content_type, file_name)
 
-        object_lifecycle_preference = _get_lifecycle_preference(request)
+        object_lifecycle_preference = get_lifecycle_preference(request)
 
         try:
             url = repo.save(fdata, object_lifecycle_preference)
@@ -191,7 +191,7 @@ class File(BaseModel):
         )
 
         content_type = content_type or "application/octet-stream"
-        object_lifecycle_preference = _get_lifecycle_preference(request)
+        object_lifecycle_preference = get_lifecycle_preference(request)
 
         try:
             url, data = repo.save_file(
@@ -274,7 +274,7 @@ class CompressedFile(File):
             shutil.rmtree(self.extract_dir)
 
 
-def _get_lifecycle_preference(request: Request) -> dict[str, str] | None:
+def get_lifecycle_preference(request: Request) -> dict[str, str] | None:
     import json
 
     preference_str = (