pythonnative 0.37.0__py3-none-any.whl → 0.39.0__py3-none-any.whl

pythonnative/__init__.py

@@ -62,7 +62,7 @@ Example:
     ```
 """
 
-__version__ = "0.37.0"
+__version__ = "0.39.0"
 
 from . import appearance, diagnostics, gestures, images, runtime, sdk
 from .alerts import Alert
@@ -190,6 +190,7 @@ from .style import (
     AutoCapitalize,
     Color,
     Dimension,
+    Display,
     EdgeInsets,
     FlexDirection,
     FlexWrap,
@@ -198,6 +199,7 @@ from .style import (
     KeyboardType,
     LayoutDirection,
     Overflow,
+    PointerEvents,
     Position,
     ReturnKeyType,
     ScaleType,
@@ -207,6 +209,8 @@ from .style import (
     StyleSheet,
     TextAlign,
     TextDecoration,
+    TextTransform,
+    Theme,
     ThemeContext,
     TransformSpec,
     default_theme,
@@ -314,6 +318,7 @@ __all__ = [
     "DEFAULT_DARK_THEME",
     "DEFAULT_LIGHT_THEME",
     "Dimension",
+    "Display",
     "EdgeInsets",
     "FlexDirection",
     "FlexWrap",
@@ -322,6 +327,7 @@ __all__ = [
     "KeyboardType",
     "LayoutDirection",
     "Overflow",
+    "PointerEvents",
     "Position",
     "ReturnKeyType",
     "ScaleType",
@@ -331,6 +337,8 @@ __all__ = [
     "StyleSheet",
     "TextAlign",
     "TextDecoration",
+    "TextTransform",
+    "Theme",
     "ThemeContext",
     "TransformSpec",
     "default_theme",

pythonnative/alerts.py

@@ -52,16 +52,13 @@ async def _present(
     "default"|"cancel"|"destructive"}`` dicts. The module resolves with
     the index the user picked, or ``-1`` if the dialog was dismissed
     without a selection. Off device the
-    [`DesktopAlert`][pythonnative.native_modules.desktop.DesktopAlert]
+    [`FallbackAlert`][pythonnative.native_modules.fallback.FallbackAlert]
     implementation records the call and answers from the queue set by
     [`Alert.set_test_response`][pythonnative.alerts.Alert.set_test_response].
     """
-    try:
-        result = await native_module("Alert").call_async(
-            "present", title=title, message=message, buttons=buttons, style=style
-        )
-    except Exception:
-        return -1
+    result = await native_module("Alert").call_async(
+        "present", title=title, message=message, buttons=buttons, style=style
+    )
     try:
         return int(result)
     except (TypeError, ValueError):
@@ -135,14 +132,9 @@ class Alert:
         [`choose`][pythonnative.alerts.Alert.choose] and ``await``
         the result.
         """
-        try:
-            native_module("Alert").call(
-                "show", title=title, message=message, buttons=[{"label": button, "style": "default"}], style="alert"
-            )
-        except Exception:
-            from . import diagnostics
-
-            diagnostics.swallowed("alerts.Alert.show")
+        native_module("Alert").call(
+            "show", title=title, message=message, buttons=[{"label": button, "style": "default"}], style="alert"
+        )
 
     @staticmethod
     async def confirm(

pythonnative/animated.py

@@ -40,7 +40,7 @@ native view the value is attached to
   callback when the animation settles, updates the
   [`AnimatedValue`][pythonnative.animated.AnimatedValue], and resolves
   any awaiting tasks.
-- **Declined** (desktop preview, unattached values, callable easings,
+- **Declined** (unattached values, callable easings,
   values feeding Python-side listeners or derived nodes): a single
   background thread ticks the animation at ~60 Hz from Python, pushing
   each frame through ``set_animated_property``. Semantics are

pythonnative/bootstrap.py

@@ -8,9 +8,10 @@ import pythonnative.bootstrap; pythonnative.bootstrap.start()
 
 [`start`][pythonnative.bootstrap.start] connects the two halves of the
 bridge (installing the native -> Python callback on iOS), verifies the
-protocol version, routes ``print()`` to the console on iOS, and warms
-the asyncio runtime. From then on the native runtime drives everything
-through ``callback("host", ...)``; see ``docs/concepts/bridge.md``.
+protocol version, routes ``print()`` to the console on iOS, warms the
+asyncio runtime, and, in debug builds, starts the dev client that syncs
+sources from ``pn start``. From then on the native runtime drives
+everything through ``callback("host", ...)``; see ``docs/concepts/bridge.md``.
 """
 
 from __future__ import annotations
@@ -29,8 +30,8 @@ def start(dev: bool = False, strict: bool = False) -> Dict[str, Any]:
     """Connect the bridge and prepare the runtime.
 
     Args:
-        dev: Enable dev mode (RedBox, validation warnings). Debug
-            templates pass ``True``; hot reload turns it on as well.
+        dev: Enable dev mode (RedBox, validation warnings, the dev
+            client). Debug templates pass ``True``.
         strict: Re-raise the failure after recording it. The templates
             pass ``True`` so a broken bridge surfaces as a bootstrap
             error screen with the full traceback.
@@ -59,7 +60,8 @@ def start(dev: bool = False, strict: bool = False) -> Dict[str, Any]:
         from . import bridge
 
         status_["protocol"] = bridge.handshake()
-        if dev or os.environ.get("PN_DEV") in ("1", "true"):
+        dev_mode = bool(dev or os.environ.get("PN_DEV") in ("1", "true"))
+        if dev_mode:
             from . import diagnostics
 
             diagnostics.set_dev_mode(True)
@@ -73,6 +75,13 @@ def start(dev: bool = False, strict: bool = False) -> Dict[str, Any]:
         from .native_views import get_registry
 
         get_registry()
+        if dev_mode:
+            # Debug builds are dev clients: connect to `pn start` when
+            # the build (or a remembered connection) names a server.
+            from . import devclient
+
+            client = devclient.start_if_configured()
+            status_["dev_server"] = client.url if client is not None else None
     except Exception as exc:
         status_["error"] = f"{type(exc).__name__}: {exc}"
         print(f"[pn.bootstrap] start failed: {exc!r}", file=sys.stderr)

pythonnative/bridge/__init__.py

@@ -7,11 +7,13 @@ Everything that crosses into native code goes through a
 [`native_callback`][pythonnative.bridge.native_callback]. The protocol
 is documented in ``docs/concepts/bridge.md``.
 
-Off-device (tests, ``pn preview``) there is no transport; the desktop
-registry renders with Tkinter and native modules fall back to their
-Python implementations. Tests that want to exercise the bridge itself
-install a [`FakeTransport`][pythonnative.bridge.fake.FakeTransport]
-with [`set_transport`][pythonnative.bridge.set_transport].
+Under ``pn preview`` the native side is a browser page, reached through
+[`WebTransport`][pythonnative.bridge.web.WebTransport]; the preview
+installs it with [`set_transport`][pythonnative.bridge.set_transport]
+before any screen mounts. In headless tests there is no transport at
+all: native modules fall back to their Python implementations, and
+tests that want to exercise the bridge itself install a
+[`FakeTransport`][pythonnative.bridge.fake.FakeTransport].
 """
 
 from __future__ import annotations
@@ -74,7 +76,7 @@ _explicit = False
 
 
 def _create_platform_transport() -> Optional[Transport]:
-    from ..utils import IS_ANDROID, IS_IOS
+    from ..utils import IS_ANDROID, IS_IOS, IS_WEB
 
     if IS_IOS:
         from .ios import IOSTransport
@@ -86,6 +88,11 @@ def _create_platform_transport() -> Optional[Transport]:
         from .android import AndroidTransport
 
         return AndroidTransport()
+    if IS_WEB:
+        raise RuntimeError(
+            "PN_PLATFORM=web is set but no browser preview transport is installed. "
+            "Start the app with `pn preview` (or `pn start`), which installs the WebTransport."
+        )
     return None
 
 
@@ -104,7 +111,7 @@ def get_transport() -> Transport:
             if created is None:
                 raise RuntimeError(
                     "No native bridge is available on this platform (running off-device). "
-                    "Use `pn preview` for the desktop renderer or install a FakeTransport in tests."
+                    "Use `pn preview` for the browser renderer or install a FakeTransport in tests."
                 )
             _transport = created
     return _transport
@@ -116,9 +123,9 @@ def has_transport() -> bool:
         return True
     if _explicit:
         return False
-    from ..utils import IS_ANDROID, IS_IOS
+    from ..utils import IS_ANDROID, IS_IOS, IS_WEB
 
-    return bool(IS_IOS or IS_ANDROID)
+    return bool(IS_IOS or IS_ANDROID or IS_WEB)
 
 
 def set_transport(transport: Optional[Transport]) -> None:

pythonnative/bridge/codec.py

@@ -104,7 +104,7 @@ def encode_transaction(
 
     Args:
         ops: Ordered mutations from the reconciler.
-        prop_filter: Unused hook kept for symmetry with the desktop
+        prop_filter: Unused hook kept for symmetry with the test
             registry; reserved for per-type prop rewriting.
 
     Returns: