flet 1.0.0.dev2__tar.gz → 1.0.2__tar.gz

{flet-1.0.0.dev2 → flet-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 1.0.0.dev2
+Version: 1.0.2
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://flet.dev/docs/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==1.0.0.dev2; extra == "cli"
-Requires-Dist: flet-web==1.0.0.dev2; extra == "web"
+Requires-Dist: flet-cli==1.0.2; extra == "cli"
+Requires-Dist: flet-web==1.0.2; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Emscripten"
 Requires-Dist: httpx>=0.28.1; platform_system != "Emscripten"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==1.0.0.dev2; extra == "all"
-Requires-Dist: flet-web==1.0.0.dev2; extra == "all"
-Requires-Dist: flet-desktop==1.0.0.dev2; extra == "all"
+Requires-Dist: flet-cli==1.0.2; extra == "all"
+Requires-Dist: flet-web==1.0.2; extra == "all"
+Requires-Dist: flet-desktop==1.0.2; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==1.0.0.dev2; extra == "cli"
+Requires-Dist: flet-cli==1.0.2; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==1.0.0.dev2; extra == "desktop"
+Requires-Dist: flet-desktop==1.0.2; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==1.0.0.dev2; extra == "web"
+Requires-Dist: flet-web==1.0.2; extra == "web"
 Provides-Extra: test
 Requires-Dist: pytest>=7.2.0; extra == "test"
 Requires-Dist: pytest-asyncio>=1.1.0; extra == "test"
@@ -41,7 +41,7 @@ Requires-Dist: scikit-image>=0.25.2; extra == "test"
 </p>
 
 <p align="center">
-    <em>Build multi-platform apps in Python. No frontend experience required.</em>
+    <em>Build cross-platform apps in Python. No frontend experience required.</em>
 </p>
 
 <p align="center">
@@ -59,10 +59,11 @@ Requires-Dist: scikit-image>=0.25.2; extra == "test"
         <img src="https://flet.dev/docs/assets/badges/docs-coverage/flet.svg" alt="Docstring coverage" /></a>
 </p>
 
----
+Flet is a Python framework for building web, desktop, and mobile apps without prior experience in frontend development.
 
-Flet is a framework that allows building mobile, desktop and web applications
-in Python only without prior experience in frontend development.
+> **[Try Flet online in Flet Studio](https://studio.flet.dev)**
+>
+> Create, run, and share Python apps in your browser. Start from an example, write your own code, or get help from the AI agent. No installation required.
 
 ### <img src="https://flet.dev/img/pages/home/single-code-base.svg" width="25" align="top" />&nbsp;&nbsp;&nbsp;Single code base for any device
 

{flet-1.0.0.dev2 → flet-1.0.2}/README.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-    <em>Build multi-platform apps in Python. No frontend experience required.</em>
+    <em>Build cross-platform apps in Python. No frontend experience required.</em>
 </p>
 
 <p align="center">
@@ -24,10 +24,11 @@
         <img src="https://flet.dev/docs/assets/badges/docs-coverage/flet.svg" alt="Docstring coverage" /></a>
 </p>
 
----
+Flet is a Python framework for building web, desktop, and mobile apps without prior experience in frontend development.
 
-Flet is a framework that allows building mobile, desktop and web applications
-in Python only without prior experience in frontend development.
+> **[Try Flet online in Flet Studio](https://studio.flet.dev)**
+>
+> Create, run, and share Python apps in your browser. Start from an example, write your own code, or get help from the AI agent. No installation required.
 
 ### <img src="https://flet.dev/img/pages/home/single-code-base.svg" width="25" align="top" />&nbsp;&nbsp;&nbsp;Single code base for any device
 

{flet-1.0.0.dev2 → flet-1.0.2}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "1.0.0.dev2"
+version = "1.0.2"
 description = "Flet for Python - easily build interactive multi-platform apps in Python"
 authors = [{name = "Appveyor Systems Inc.", email = "hello@flet.dev"}]
 license = "Apache-2.0"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "flet-cli==1.0.0.dev2; extra == 'cli'",
-    "flet-web==1.0.0.dev2; extra == 'web'",
+    "flet-cli==1.0.2; extra == 'cli'",
+    "flet-web==1.0.2; extra == 'web'",
     "oauthlib >=3.2.2; platform_system != 'Emscripten'",
     "httpx >=0.28.1; platform_system != 'Emscripten'",
     "repath >=0.9.0",
@@ -23,15 +23,15 @@ Documentation = "https://flet.dev/docs/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==1.0.0.dev2",
-    "flet-web==1.0.0.dev2",
-    "flet-desktop==1.0.0.dev2",
+    "flet-cli==1.0.2",
+    "flet-web==1.0.2",
+    "flet-desktop==1.0.2",
 ]
-cli = ["flet-cli==1.0.0.dev2"]
+cli = ["flet-cli==1.0.2"]
 desktop = [
-    "flet-desktop==1.0.0.dev2",
+    "flet-desktop==1.0.2",
 ]
-web = ["flet-web==1.0.0.dev2"]
+web = ["flet-web==1.0.2"]
 # Dependencies needed to run integration tests written with `flet.testing`
 # (the `flet test` command / the pytest plugin). Pillow/numpy/scikit-image
 # back screenshot and GIF comparison.

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/app.py

@@ -45,6 +45,26 @@ Used for both `main` and `before_main` handlers.
 """
 
 
+def __configure_logging_from_env() -> None:
+    """
+    Applies the log level named by the `FLET_LOG_LEVEL` environment variable.
+
+    `flet run -v` sets this so the framework's own logging reaches the console
+    without the app having to configure it. `basicConfig` does nothing once the
+    root logger has a handler, so an app that configures logging itself keeps
+    the setup it chose.
+    """
+    level = os.getenv("FLET_LOG_LEVEL")
+    if not level:
+        return
+
+    resolved = logging.getLevelName(level.strip().upper())
+    if isinstance(resolved, int):
+        logging.basicConfig(level=resolved)
+    else:
+        logger.warning("Unknown FLET_LOG_LEVEL: %s", level)
+
+
 def run(
     main: AppCallable,
     before_main: Optional[AppCallable] = None,
@@ -83,6 +103,8 @@ def run(
         A FastAPI ASGI app when `export_asgi_app=True`.
             Otherwise, runs the app and returns `None`.
     """
+    __configure_logging_from_env()
+
     if is_pyodide():
         __run_pyodide(main=main, before_main=before_main)
         return
@@ -156,6 +178,8 @@ async def run_async(
         no_cdn: Whether to avoid loading CanvasKit, Pyodide, and fonts from CDN.
     """
 
+    __configure_logging_from_env()
+
     if is_pyodide():
         __run_pyodide(main=main, before_main=before_main)
         return

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/auth/authorization_service.py

@@ -1,4 +1,3 @@
-import json
 import secrets
 import time
 from collections.abc import Mapping
@@ -116,6 +115,7 @@ class AuthorizationService(Authorization):
         Raises:
             httpx.HTTPStatusError: If token endpoint returns a non-success status.
         """
+
         import httpx
         from oauthlib.oauth2 import WebApplicationClient
 
@@ -129,11 +129,11 @@ class AuthorizationService(Authorization):
         )
         headers = self.__get_default_headers()
         headers["content-type"] = "application/x-www-form-urlencoded"
-        req = httpx.Request(
-            "POST", self.provider.token_endpoint, content=data, headers=headers
-        )
+
         async with httpx.AsyncClient(follow_redirects=True) as client:
-            resp = await client.send(req)
+            resp = await client.post(
+                self.provider.token_endpoint, content=data, headers=headers
+            )
             resp.raise_for_status()
             client = WebApplicationClient(self.provider.client_id)
             t = client.parse_request_body_response(resp.text)
@@ -217,19 +217,21 @@ class AuthorizationService(Authorization):
         )
         headers = self.__get_default_headers()
         headers["content-type"] = "application/x-www-form-urlencoded"
-        refresh_req = httpx.Request(
-            "POST", url=self.provider.token_endpoint, content=data, headers=headers
-        )
-        if refresh_req:
-            async with httpx.AsyncClient(follow_redirects=True) as client:
-                refresh_resp = await client.send(refresh_req)
-                refresh_resp.raise_for_status()
-                assert self.__token is not None
-                client = WebApplicationClient(self.provider.client_id)
-                t = client.parse_request_body_response(refresh_resp.text)
-                if t.get("refresh_token") is None:
-                    t["refresh_token"] = self.__token.refresh_token
-                self.__token = self.__convert_token(t)
+
+        async with httpx.AsyncClient(follow_redirects=True) as client:
+            refresh_resp = await client.post(
+                self.provider.token_endpoint, content=data, headers=headers
+            )
+            refresh_resp.raise_for_status()
+            assert self.__token is not None
+
+            client = WebApplicationClient(self.provider.client_id)
+            t = client.parse_request_body_response(refresh_resp.text)
+
+            if t.get("refresh_token") is None:
+                t["refresh_token"] = self.__token.refresh_token
+
+            self.__token = self.__convert_token(t)
 
     async def __get_user(self) -> User:
         """
@@ -242,18 +244,20 @@ class AuthorizationService(Authorization):
         Raises:
             httpx.HTTPStatusError: If user endpoint request fails.
         """
+
         import httpx
 
         assert self.__token is not None
         assert self.provider.user_endpoint is not None
+
         headers = self.__get_default_headers()
         headers["Authorization"] = f"Bearer {self.__token.access_token}"
-        user_req = httpx.Request("GET", self.provider.user_endpoint, headers=headers)
+
         async with httpx.AsyncClient(follow_redirects=True) as client:
-            user_resp = await client.send(user_req)
+            user_resp = await client.get(self.provider.user_endpoint, headers=headers)
             user_resp.raise_for_status()
             assert self.provider.user_id_fn is not None
-            uj = json.loads(user_resp.text)
+            uj = user_resp.json()
             return User(uj, str(self.provider.user_id_fn(uj)))
 
     def __get_default_headers(self) -> dict[str, str]:

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/auth/providers/github_oauth_provider.py

@@ -1,4 +1,3 @@
-import json
 from typing import Optional
 
 from flet.auth.group import Group
@@ -8,6 +7,8 @@ from flet.version import flet_version
 
 __all__ = ["GitHubOAuthProvider"]
 
+GITHUB_API_BASE_URL = "https://api.github.com"
+
 
 class GitHubOAuthProvider(OAuthProvider):
     """
@@ -38,20 +39,20 @@ class GitHubOAuthProvider(OAuthProvider):
         Returns:
             A list of :class:`~flet.auth.Group` mapped from `/user/teams`.
         """
+
         import httpx
 
-        async with httpx.AsyncClient(follow_redirects=True) as client:
-            teams_resp = await client.send(
-                httpx.Request(
-                    "GET",
-                    "https://api.github.com/user/teams",
-                    headers=self.__get_client_headers(access_token),
-                )
+        async with httpx.AsyncClient(
+            base_url=GITHUB_API_BASE_URL, follow_redirects=True
+        ) as client:
+
+            teams_resp = await client.get(
+                "/user/teams", headers=self.__get_client_headers(access_token)
             )
             teams_resp.raise_for_status()
             groups = []
-            tj = json.loads(teams_resp.text)
-            for t in tj:
+
+            for t in teams_resp.json():
                 groups.append(
                     Group(
                         t,
@@ -71,28 +72,25 @@ class GitHubOAuthProvider(OAuthProvider):
             A :class:`~flet.auth.User` built from `/user`; its `email` is populated
                 from the primary address in `/user/emails` when available.
         """
+
         import httpx
 
-        async with httpx.AsyncClient(follow_redirects=True) as client:
-            user_resp = await client.send(
-                httpx.Request(
-                    "GET",
-                    "https://api.github.com/user",
-                    headers=self.__get_client_headers(access_token),
-                )
+        async with httpx.AsyncClient(
+            base_url=GITHUB_API_BASE_URL, follow_redirects=True
+        ) as client:
+
+            user_resp = await client.get(
+                "/user", headers=self.__get_client_headers(access_token)
             )
             user_resp.raise_for_status()
-            uj = json.loads(user_resp.text)
+            uj = user_resp.json()
 
-            emails_resp = await client.send(
-                httpx.Request(
-                    "GET",
-                    "https://api.github.com/user/emails",
-                    headers=self.__get_client_headers(access_token),
-                )
+            emails_resp = await client.get(
+                "/user/emails", headers=self.__get_client_headers(access_token)
             )
             emails_resp.raise_for_status()
-            ej = json.loads(emails_resp.text)
+            ej = emails_resp.json()
+
             for e in ej:
                 if e["primary"]:
                     uj["email"] = e["email"]

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/components/hooks/use_callback.py

@@ -18,11 +18,14 @@ def use_callback(
 
     Args:
         fn: A function to memoize.
-        dependencies: If present, fn is only re-memoized when one of the dependencies
-            has changed. If absent, fn is only memoized on initial render.
+        dependencies: Values the function depends on. If absent, the `fn` passed on
+            each render is returned as is. If empty, the `fn` from the first render
+            is kept. Otherwise, it is replaced only when one of the dependencies has
+            changed.
 
     Returns:
-        A memoized version of the function whose identity is stable between renders.
+        The memoized function. The same function object is returned on every render
+            until it is replaced.
     """
     # Just memoize the function object itself
     return use_memo(lambda: fn, dependencies)

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/components/hooks/use_effect.py

@@ -50,8 +50,10 @@ def use_effect(
     Args:
         setup: A function that performs the side effect. It may optionally return
             a cleanup function.
-        dependencies: If present, the effect is only re-run when one of the dependencies
-            has changed. If absent, the effect is only run on initial render.
+        dependencies: Values the effect depends on. The effect always runs after the
+            component mounts. If absent, it also re-runs after every render. If
+            empty, it runs only on mount. Otherwise, it re-runs only when one of the
+            dependencies has changed.
         cleanup: An optional function that cleans up after the effect. It is run
             before the effect is re-run, and when the component unmounts.
     """

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/components/hooks/use_memo.py

@@ -30,12 +30,14 @@ def use_memo(
 
     Args:
         calculate_value: A function that computes the value to be memoized.
-        dependencies: If present, the value is only recomputed when one of
-            the dependencies has changed. If absent, the value is only computed
-            on the initial render.
+        dependencies: Values the computation depends on. If absent, the value is
+            recomputed on every render. If empty, it is computed only on the first
+            render. Otherwise, it is recomputed only when one of the dependencies
+            has changed.
 
     Returns:
-        A memoized value whose identity is stable between renders.
+        The memoized value. The same object is returned on every render until the
+            value is recomputed.
     """
     component = current_component()
 

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/base_control.py

@@ -328,6 +328,9 @@ class BaseControl:
 
         Override this hook to perform lightweight setup that depends on initialized
         fields. Do not call `update()` here.
+
+        See :class:`~flet.Service` for service registration timing and page access
+        during this hook.
         """
         pass
 
@@ -395,22 +398,34 @@ class BaseControl:
 
     def get_data_channel(self, channel_id: int):
         """
-        Resolve the [DataChannel] allocated on the Dart side for this
-        widget. Pattern:
+        Resolve the :class:`~flet.DataChannel` allocated on the Dart side for this
+        control or service.
+
+        Example:
+            A custom service whose Dart implementation opens a data channel and
+            raises `data_channel_open` can capture it during initialization:
+
+            ```python
+            import flet as ft
 
-            on_data_channel_open: Optional[ft.EventHandler[DataChannelOpenEvent]] = None
 
-            def init(self):
-                self.on_data_channel_open = self._on_open
+            @ft.control("MyService")
+            class MyService(ft.Service):
+                on_data_channel_open: ft.EventHandler[ft.DataChannelOpenEvent] | None = None
 
-            def _on_open(self, e):
-                self._channel = self.get_data_channel(e.channel_id)
+                def init(self):
+                    super().init()
+                    self.on_data_channel_open = self._on_open
+
+                def _on_open(self, e: ft.DataChannelOpenEvent):
+                    self._channel = self.get_data_channel(e.channel_id)
+            ```
 
         Idempotent — the underlying Connection caches DataChannels by id,
         so repeated calls return the same instance. No error path: the id
         always comes from a framework-fired event, so by the time this
         runs the channel exists on both sides.
-        """
+        """  # noqa: E501
         return self.page.session.connection.data_channel_for(channel_id)
 
     # public methods

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/core/icon.py

@@ -27,8 +27,11 @@ class Icon(LayoutControl):
     """
     The icon to display, selected from a predefined icon set.
 
-    You can explore available icons using the
-    [Flet Icons Browser](https://studio.flet.dev/gallery/run/apps/icons_browser/).
+    Browse every available icon on the
+    [Icons](https://flet.dev/docs/types/icons) and
+    [CupertinoIcons](https://flet.dev/docs/types/cupertinoicons) pages, or run the
+    [icons browser](https://studio.flet.dev/gallery/run/apps/icons_browser/) as a
+    live Flet app.
     """
 
     color: Optional[ColorValue] = None

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/core/interactive_viewer.py

@@ -135,7 +135,19 @@ class InteractiveViewer(LayoutControl):
 
     alignment: Optional[Alignment] = None
     """
-    The alignment of the :attr:`content` within this viewer.
+    The origin of the transformation applied to the :attr:`content` when it is
+    zoomed or panned, relative to the content's size.
+
+    :meth:`zoom` scales the content around this point. It does not change where the
+    content is placed in this viewer; to position the content, wrap it in a control
+    that aligns its child, such as a :class:`~flet.Container` with
+    :attr:`~flet.Container.alignment` set.
+
+    Note:
+        Gestures and the limits of :meth:`pan` treat the top-left corner as the
+        origin. With any other value, the content drifts away from the pointer while
+        zooming with a gesture, and once zoomed in, panning stops short of one edge
+        of the content and goes past the opposite one, leaving empty space.
     """
 
     boundary_margin: MarginValue = field(default_factory=lambda: Margin.all(0))

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/core/raw_image.py

@@ -154,7 +154,13 @@ class RawImage(LayoutControl):
     def _capture_channel(self, e: DataChannelOpenEvent) -> None:
         # Single-channel widget; no need to dispatch on e.channel_name.
         self._channel = self.get_data_channel(e.channel_id)
-        self._channel.on_bytes(self._on_dart_message)
+        loop = asyncio.get_running_loop()
+        # Embedded DataChannel callbacks arrive on a native bridge thread.
+        # Resolve acknowledgements on the event loop so Future callbacks wake
+        # the renderer immediately and the pending-ack queue stays on one thread.
+        self._channel.on_bytes(
+            lambda payload: loop.call_soon_threadsafe(self._on_dart_message, payload)
+        )
         # Acks pending on a previous channel will never arrive; resolve
         # them so old `render` awaits return instead of hanging.
         while self._pending_acks:

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/core/semantics.py

@@ -30,6 +30,19 @@ class Semantics(Control):
     A textual description of the :attr:`content`.
     """
 
+    identifier: Optional[str] = None
+    """
+    A stable identifier for this node in the native accessibility hierarchy.
+
+    Unlike :attr:`label`, this value is not announced to users. Native testing
+    tools use it as Android ``resource-id``, iOS ``accessibilityIdentifier``,
+    and the web ``flt-semantics-identifier`` DOM attribute. Widget tests can
+    match it with :meth:`flet.testing.Tester.find_by_semantics_identifier`.
+
+    Setting this property forces a dedicated semantics node, equivalent to
+    setting :attr:`container` to ``True``.
+    """
+
     expanded: Optional[bool] = None
     """
     Whether this subtree represents something that can be in an "expanded" or \

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/material/container.py

@@ -139,7 +139,7 @@ class Container(LayoutControl, AdaptiveControl, ActionControl):
             controls=[
                 ft.Container(
                     content=ft.Text("Hello"),
-                    image_src="https://picsum.photos/100/100",
+                    image=ft.DecorationImage(src="https://picsum.photos/100/100"),
                     width=100,
                     height=100,
                 ),

{flet-1.0.0.dev2 → flet-1.0.2}/src/flet/controls/object_patch.py

@@ -1015,12 +1015,8 @@ class DiffBuilder:
                         new_item, "fn", None
                     )
 
-                if (not frozen_local and old_item is new_item) or (
-                    frozen_local
-                    and old_item is not new_item
-                    and same_type
-                    and same_component_fn
-                    and _keys_match()
+                if old_item is new_item or (
+                    frozen_local and same_type and same_component_fn and _keys_match()
                 ):
                     self._compare_dataclasses(
                         parent, _path_join(path, idx), old_item, new_item, frozen_local
@@ -1138,6 +1134,14 @@ class DiffBuilder:
         """
         logger.debug("\n_compare_dataclasses: %s\n\n%s\n%s\n", path, src, dst)
 
+        if frozen and src is dst:
+            # Retained immutable children have no new description to reconcile.
+            # In particular, a Component must not migrate state to itself or
+            # render over its old body before that body can be diffed.
+            if parent is not None and parent is not dst:
+                dst._parent = weakref.ref(parent)
+            return
+
         if (
             self.control_cls
             and isinstance(parent, self.control_cls)