pythonnative 0.25.0__py3-none-any.whl → 0.27.0__py3-none-any.whl

pythonnative/cli/pn.py

@@ -6,10 +6,14 @@ The console script `pn` (declared in `pyproject.toml`) dispatches to:
 - `pn doctor [platform]`: diagnose the local toolchain and config.
 - `pn preview [component]`: render the app in a desktop (Tkinter) window
   with Fast Refresh, the fast inner dev loop, no device required.
-- `pn run android|ios`: stage + build + install + launch on a device or
-  simulator, with optional on-device hot reload.
+- `pn devices [platform]`: list connected devices, emulators, and
+  simulators.
+- `pn run android|ios [--device D]`: stage + build + install + launch on
+  a device, emulator, or simulator, with optional on-device hot reload.
+- `pn logs android|ios`: stream logs from the running app without
+  rebuilding.
 - `pn build android|ios`: produce standalone artifacts (signed APK/AAB,
-  or an iOS archive/IPA).
+  or an iOS archive/IPA, optionally uploaded to App Store Connect).
 - `pn app-id android|ios`: print the resolved application/bundle id
   (handy for scripts and CI).
 - `pn clean`: remove the local `build/` directory.
@@ -34,6 +38,7 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional
 
 from ..project import builder as builder_mod
+from ..project import devices as devices_mod
 from ..project import doctor as doctor_mod
 from ..project.android import collect_logcat_filters
 from ..project.config import CONFIG_FILENAME, AppConfig, ConfigError, render_default_toml
@@ -241,6 +246,41 @@ def _preview_entry(project_dir: Path) -> str:
         return "app.main"
 
 
+# ======================================================================
+# devices
+# ======================================================================
+
+
+def devices_command(args: argparse.Namespace) -> None:
+    """List connected devices, emulators, and simulators.
+
+    Args:
+        args: Parsed namespace with optional ``platform``.
+    """
+    platform: Optional[str] = getattr(args, "platform", None)
+    devices = devices_mod.list_devices(platform)
+    if not devices:
+        print("No devices found.")
+        print("Android: start an emulator or connect a device with USB debugging enabled.")
+        print("iOS: open Xcode once to install Simulators, or plug in a device.")
+        sys.exit(1)
+    print(f"  {'IDENTIFIER':<40} {'KIND':<10} {'STATE':<10} NAME")
+    for device in devices:
+        print(device.format())
+    print("\nTarget one with: pn run <platform> --device <identifier or name>")
+
+
+def _resolve_device(platform: str, query: Optional[str]) -> Optional[devices_mod.Device]:
+    """Resolve ``--device`` to a concrete target, exiting on a bad query."""
+    if not query:
+        return None
+    device = devices_mod.find_device(devices_mod.list_devices(platform), query)
+    if device is None:
+        print(f"Error: no {platform} device matches {query!r}. Run 'pn devices {platform}' to list targets.")
+        sys.exit(1)
+    return device
+
+
 # ======================================================================
 # run
 # ======================================================================
@@ -250,13 +290,14 @@ def run_project(args: argparse.Namespace) -> None:
     """Stage, build, install, and launch the app on a device/simulator.
 
     Args:
-        args: Parsed namespace (``platform``, ``prepare_only``,
-            ``hot_reload``, ``no_logs``).
+        args: Parsed namespace (``platform``, ``device``,
+            ``prepare_only``, ``hot_reload``, ``no_logs``).
     """
     platform: str = args.platform
     prepare_only: bool = getattr(args, "prepare_only", False)
     hot_reload: bool = getattr(args, "hot_reload", False)
     show_logs: bool = not getattr(args, "no_logs", False)
+    device = _resolve_device(platform, getattr(args, "device", None))
 
     config = _load_config_or_exit()
     builder = builder_mod.Builder(config, log=print)
@@ -273,9 +314,14 @@ def run_project(args: argparse.Namespace) -> None:
 
     try:
         if platform == "android":
-            _run_android(builder, prepared, hot_reload=hot_reload, show_logs=show_logs)
+            _run_android(builder, prepared, device=device, hot_reload=hot_reload, show_logs=show_logs)
+        elif device is not None and device.kind == "device":
+            _run_ios_device(builder, prepared, device=device)
+            if hot_reload:
+                print("Note: hot reload targets the iOS Simulator; skipping it for a physical device.")
+            return
         else:
-            _run_ios(builder, prepared, hot_reload=hot_reload, show_logs=show_logs)
+            _run_ios(builder, prepared, device=device, hot_reload=hot_reload, show_logs=show_logs)
     except builder_mod.BuildError as exc:
         print(f"Error: {exc}")
         sys.exit(1)
@@ -295,9 +341,14 @@ def _run_android(
     builder: builder_mod.Builder,
     prepared: builder_mod.PreparedProject,
     *,
+    device: Optional[devices_mod.Device],
     hot_reload: bool,
     show_logs: bool,
 ) -> None:
+    if device is not None:
+        # Both Gradle's install task and every adb call below honor
+        # ANDROID_SERIAL, so exporting it targets the whole run.
+        os.environ["ANDROID_SERIAL"] = device.identifier
     builder.install_android_debug(prepared)
     _clear_android_hot_reload_overlay(prepared.app_id)
     subprocess.run(
@@ -319,11 +370,12 @@ def _run_ios(
     builder: builder_mod.Builder,
     prepared: builder_mod.PreparedProject,
     *,
+    device: Optional[devices_mod.Device],
     hot_reload: bool,
     show_logs: bool,
 ) -> None:
     app_path = builder.build_ios_simulator(prepared)
-    udid = _select_ios_simulator()
+    udid = device.identifier if device is not None else _select_ios_simulator()
     if udid is None:
         print("No available iOS Simulators found; open the project in Xcode to run.")
         return
@@ -352,6 +404,45 @@ def _run_ios(
         print("Launched iOS app on Simulator.")
 
 
+def _run_ios_device(
+    builder: builder_mod.Builder,
+    prepared: builder_mod.PreparedProject,
+    *,
+    device: devices_mod.Device,
+) -> None:
+    """Build, install, and launch on a physical iOS device via devicectl."""
+    app_path = builder.build_ios_device(prepared)
+    print(f"Installing on {device.name}...")
+    install = subprocess.run(
+        ["xcrun", "devicectl", "device", "install", "app", "--device", device.identifier, str(app_path)],
+        check=False,
+    )
+    if install.returncode != 0:
+        print(
+            "Error: install failed. Make sure the device is unlocked, paired with this Mac, "
+            "and has Developer Mode enabled (Settings > Privacy & Security > Developer Mode)."
+        )
+        sys.exit(1)
+    launch = subprocess.run(
+        [
+            "xcrun",
+            "devicectl",
+            "device",
+            "process",
+            "launch",
+            "--terminate-existing",
+            "--device",
+            device.identifier,
+            prepared.app_id,
+        ],
+        check=False,
+    )
+    if launch.returncode != 0:
+        print("Error: launch failed. Launch the app from the home screen to see details.")
+        sys.exit(1)
+    print(f"Launched on {device.name}. Use Console.app (or Xcode > Devices) for device logs.")
+
+
 # ======================================================================
 # build
 # ======================================================================
@@ -361,16 +452,24 @@ def build_project(args: argparse.Namespace) -> None:
     """Build standalone, distributable artifacts for ``platform``.
 
     Args:
-        args: Parsed namespace (``platform``, ``debug``).
+        args: Parsed namespace (``platform``, ``debug``, ``upload``).
     """
     platform: str = args.platform
     debug: bool = getattr(args, "debug", False)
+    upload: bool = getattr(args, "upload", False)
 
     config = _load_config_or_exit()
     builder = builder_mod.Builder(config, log=print)
 
+    if upload and (platform != "ios" or debug):
+        print("Error: --upload applies to 'pn build ios' release builds only.")
+        sys.exit(1)
+    if upload and config.ios.signing.export_method != "app-store":
+        print('Error: --upload requires [ios.signing] export_method = "app-store" in pythonnative.toml.')
+        sys.exit(1)
+
     try:
-        prepared = builder.prepare(platform)
+        prepared = builder.prepare(platform, release=not debug)
         if platform == "android":
             artifacts = builder.build_android(prepared, debug=debug)
         else:
@@ -378,19 +477,61 @@ def build_project(args: argparse.Namespace) -> None:
                 app_path = builder.build_ios_simulator(prepared)
                 artifacts = builder_mod.BuildArtifacts(paths=[app_path])
             else:
-                artifacts = builder.build_ios_archive(prepared)
+                artifacts = builder.build_ios_archive(prepared, upload=upload)
     except builder_mod.BuildError as exc:
         print(f"Error: {exc}")
         sys.exit(1)
 
+    if upload:
+        print("\nUploaded to App Store Connect. Check the build's status at appstoreconnect.apple.com.")
     if not artifacts.paths:
-        print("Build completed, but no artifacts were found. Check the build output above.")
+        if not upload:
+            print("Build completed, but no artifacts were found. Check the build output above.")
         return
     print("\nBuilt artifacts:")
     for path in artifacts.paths:
         print(f"  {path}")
 
 
+# ======================================================================
+# logs
+# ======================================================================
+
+
+def logs_command(args: argparse.Namespace) -> None:
+    """Stream logs from the running app without rebuilding.
+
+    Args:
+        args: Parsed namespace (``platform``).
+    """
+    platform: str = args.platform
+    if platform == "android":
+        proc = _start_android_log_stream()
+        if proc is None:
+            sys.exit(1)
+        try:
+            proc.wait()
+        except KeyboardInterrupt:
+            print()
+            _terminate_subprocess(proc)
+            print("Stopped log streaming.")
+        return
+
+    # iOS: relaunch the app on the booted simulator with a console PTY so
+    # Python's stdout/stderr stream to this terminal.
+    config = _load_config_or_exit()
+    proc = _start_ios_log_stream(config.bundle_id)
+    if proc is None:
+        print("For a physical device, use Console.app or Xcode > Devices and Simulators.")
+        sys.exit(1)
+    try:
+        proc.wait()
+    except KeyboardInterrupt:
+        print()
+        _terminate_subprocess(proc)
+        print("Stopped log streaming.")
+
+
 # ======================================================================
 # clean
 # ======================================================================
@@ -747,16 +888,35 @@ def _build_parser() -> argparse.ArgumentParser:
     parser_preview.add_argument("--no-hot-reload", action="store_true", help="Disable file watching / Fast Refresh")
     parser_preview.set_defaults(func=preview_project)
 
+    parser_devices = subparsers.add_parser("devices", help="List devices, emulators, and simulators")
+    parser_devices.add_argument("platform", nargs="?", choices=["android", "ios"], help="Restrict to a platform")
+    parser_devices.set_defaults(func=devices_command)
+
     parser_run = subparsers.add_parser("run", help="Build, install, and launch on a device/simulator")
     parser_run.add_argument("platform", choices=["android", "ios"])
+    parser_run.add_argument(
+        "--device",
+        "-d",
+        help="Target device: an identifier or name from 'pn devices' "
+        "(physical iOS devices need [ios].development_team)",
+    )
     parser_run.add_argument("--prepare-only", action="store_true", help="Stage + configure without building")
     parser_run.add_argument("--hot-reload", action="store_true", help="Watch app/ and push updates to the running app")
     parser_run.add_argument("--no-logs", action="store_true", help="Don't stream device logs after launch")
     parser_run.set_defaults(func=run_project)
 
+    parser_logs = subparsers.add_parser("logs", help="Stream logs from the running app")
+    parser_logs.add_argument("platform", choices=["android", "ios"])
+    parser_logs.set_defaults(func=logs_command)
+
     parser_build = subparsers.add_parser("build", help="Build distributable artifacts")
     parser_build.add_argument("platform", choices=["android", "ios"])
     parser_build.add_argument("--debug", action="store_true", help="Build the debug variant instead of release")
+    parser_build.add_argument(
+        "--upload",
+        action="store_true",
+        help='Upload the iOS release build to App Store Connect (needs export_method = "app-store")',
+    )
     parser_build.set_defaults(func=build_project)
 
     parser_app_id = subparsers.add_parser("app-id", help="Print the resolved application/bundle id")

pythonnative/components.py

@@ -755,6 +755,8 @@ def View(
     *children: Element,
     style: StyleProp = None,
     gestures: Optional[List[Any]] = None,
+    hit_slop: Optional[Union[float, Dict[str, float]]] = None,
+    on_layout: Optional[Callable[[Dict[str, float]], None]] = None,
     accessibility_label: Optional[str] = None,
     accessibility_hint: Optional[str] = None,
     accessibility_role: Optional[str] = None,
@@ -797,6 +799,13 @@ def View(
         gestures: Optional list of gesture descriptors from
             `pythonnative.gestures` (e.g. ``[gestures.Pan(on_change=…)]``)
             recognized natively on this view.
+        hit_slop: Extend the touch target beyond the view's bounds
+            without changing layout: a uniform number of points, or a
+            dict with any of ``top`` / ``left`` / ``bottom`` /
+            ``right``.
+        on_layout: Callback invoked with
+            ``{"x", "y", "width", "height"}`` after this view is laid
+            out, and again whenever its frame changes.
         accessibility_label: Spoken description for screen readers.
         accessibility_hint: Spoken extra detail (iOS only).
         accessibility_role: Semantic role for assistive tech.
@@ -824,6 +833,8 @@ def View(
         ref=ref,
         key=key,
         gestures=gestures,
+        hit_slop=hit_slop,
+        on_layout=on_layout,
         accessibility_label=accessibility_label,
         accessibility_hint=accessibility_hint,
         accessibility_role=accessibility_role,
@@ -838,6 +849,7 @@ def View(
 def Column(
     *children: Element,
     style: StyleProp = None,
+    on_layout: Optional[Callable[[Dict[str, float]], None]] = None,
     ref: Optional[Ref] = None,
     key: Optional[str] = None,
 ) -> Element:
@@ -850,6 +862,9 @@ def Column(
     Args:
         *children: Child elements stacked top to bottom.
         style: Style dict (or list of dicts).
+        on_layout: Callback invoked with
+            ``{"x", "y", "width", "height"}`` after layout and on
+            frame changes.
         ref: Optional [`Ref`][pythonnative.Ref] for native-view access.
         key: Stable identity for keyed reconciliation.
 
@@ -860,6 +875,7 @@ def Column(
         "Column",
         *children,
         style=style,
+        on_layout=on_layout,
         ref=ref,
         key=key,
         _forced={"flex_direction": "column"},
@@ -869,6 +885,7 @@ def Column(
 def Row(
     *children: Element,
     style: StyleProp = None,
+    on_layout: Optional[Callable[[Dict[str, float]], None]] = None,
     ref: Optional[Ref] = None,
     key: Optional[str] = None,
 ) -> Element:
@@ -881,6 +898,9 @@ def Row(
     Args:
         *children: Child elements arranged left to right.
         style: Style dict (or list of dicts).
+        on_layout: Callback invoked with
+            ``{"x", "y", "width", "height"}`` after layout and on
+            frame changes.
         ref: Optional [`Ref`][pythonnative.Ref] for native-view access.
         key: Stable identity for keyed reconciliation.
 
@@ -891,6 +911,7 @@ def Row(
         "Row",
         *children,
         style=style,
+        on_layout=on_layout,
         ref=ref,
         key=key,
         _forced={"flex_direction": "row"},
@@ -1144,6 +1165,8 @@ def Pressable(
     on_press_out: Optional[Callable[[], None]] = None,
     pressed_opacity: float = 0.6,
     gestures: Optional[List[Any]] = None,
+    hit_slop: Optional[Union[float, Dict[str, float]]] = None,
+    on_layout: Optional[Callable[[Dict[str, float]], None]] = None,
     style: Union[StyleProp, Callable[[Dict[str, bool]], StyleProp]] = None,
     accessibility_label: Optional[str] = None,
     accessibility_hint: Optional[str] = None,
@@ -1174,6 +1197,14 @@ def Pressable(
         gestures: Optional list of gesture descriptors from
             `pythonnative.gestures` recognized natively on this view
             (pan / swipe / pinch / rotation / multi-tap).
+        hit_slop: Extend the touch target beyond the view's bounds
+            without changing layout: a uniform number of points, or a
+            dict with any of ``top`` / ``left`` / ``bottom`` /
+            ``right``. Essential for small touch targets (icons,
+            chips) that should honor the 44-point guideline.
+        on_layout: Callback invoked with
+            ``{"x", "y", "width", "height"}`` after layout and on
+            frame changes.
         style: Style dict applied to the wrapper, or a callable
             receiving the interaction state (``{"pressed": bool}``)
             and returning a style, re-evaluated on every press
@@ -1220,6 +1251,8 @@ def Pressable(
             on_press_out=on_press_out,
             pressed_opacity=pressed_opacity,
             gestures=gestures,
+            hit_slop=hit_slop,
+            on_layout=on_layout,
             accessibility_label=accessibility_label,
             accessibility_hint=accessibility_hint,
             accessibility_role=accessibility_role,
@@ -1240,6 +1273,8 @@ def Pressable(
         on_press_out=on_press_out,
         pressed_opacity=pressed_opacity,
         gestures=gestures,
+        hit_slop=hit_slop,
+        on_layout=on_layout,
         accessibility_label=accessibility_label,
         accessibility_hint=accessibility_hint,
         accessibility_role=accessibility_role,
@@ -2620,13 +2655,30 @@ def _KeyboardAvoidingContainer(**p: Any) -> Element:
       inside a full-height container).
     - ``"position"``: translates the whole container upward without
       resizing it (useful for pinned footers/toolbars).
+    - ``"height"``: shrinks the container's own height by the shift.
+      The resting height is captured via ``on_layout`` while the
+      keyboard is hidden, so flex-sized containers work too.
     """
-    height = use_keyboard_height()
+    keyboard = use_keyboard_height()
+    base_height, set_base_height = use_state(0.0)
     behavior = p.get("behavior") or "padding"
     offset = float(p.get("keyboard_vertical_offset") or 0.0)
-    shift = max(0.0, height - offset) if height > 0 else 0.0
+    shift = max(0.0, keyboard - offset) if keyboard > 0 else 0.0
     style: Dict[str, Any] = dict(p.get("style") or {})
-    if shift > 0:
+    props: Dict[str, Any] = style
+    if behavior == "height":
+
+        def _record_layout(frame: Dict[str, float]) -> None:
+            if keyboard <= 0:
+                measured = float(frame.get("height", 0.0))
+                if measured > 0 and abs(measured - base_height) > 0.5:
+                    set_base_height(measured)
+
+        props = dict(style)
+        props["on_layout"] = _record_layout
+        if shift > 0 and base_height > 0:
+            props["height"] = max(0.0, base_height - shift)
+    elif shift > 0:
         if behavior == "position":
             transform = list(style.get("transform") or [])
             transform.append({"translate_y": -shift})
@@ -2634,12 +2686,12 @@ def _KeyboardAvoidingContainer(**p: Any) -> Element:
         else:
             style["padding_bottom"] = _numeric_edge_padding(style, "bottom") + shift
     children = p.get("children") or []
-    return Element("KeyboardAvoidingView", style, list(children))
+    return Element("KeyboardAvoidingView", props, list(children))
 
 
 def KeyboardAvoidingView(
     *children: Element,
-    behavior: Literal["padding", "position"] = "padding",
+    behavior: Literal["padding", "position", "height"] = "padding",
     keyboard_vertical_offset: float = 0.0,
     style: StyleProp = None,
     key: Optional[str] = None,
@@ -2656,8 +2708,10 @@ def KeyboardAvoidingView(
     Args:
         *children: Children rendered inside the avoiding container.
         behavior: ``"padding"`` (adds bottom padding, resizing the
-            content) or ``"position"`` (translates the container
-            upward without resizing).
+            content), ``"position"`` (translates the container upward
+            without resizing), or ``"height"`` (shrinks the
+            container's height by the keyboard overlap, matching
+            React Native's ``"height"`` behavior).
         keyboard_vertical_offset: Distance in layout units already
             covered by other UI (e.g. a nav bar); subtracted from the
             keyboard height before applying the shift.

pythonnative/diagnostics.py

@@ -37,6 +37,7 @@ __all__ = [
     "is_dev",
     "warn",
     "warn_once",
+    "swallowed",
     "get_warnings",
     "clear_warnings",
     "set_error_reporter",
@@ -143,6 +144,32 @@ def warn_once(message: str, key: Optional[str] = None) -> None:
     warn(message)
 
 
+def swallowed(context: str) -> None:
+    """Surface a suppressed native-backend exception (dev mode only).
+
+    The native view/module backends intentionally degrade gracefully in
+    production: a failed style application or a missing OS API must not
+    crash the app. Call this from the ``except`` block instead of
+    ``pass`` so that, in dev mode, each suppression is reported once per
+    call site instead of disappearing.
+
+    Args:
+        context: Where the suppression happened, e.g.
+            ``"ios.TextHandler._apply"``.
+    """
+    if not is_dev():
+        return
+    exc = sys.exc_info()[1]
+    if exc is None:
+        return
+    frame = sys._getframe(1)
+    location = f"{os.path.basename(frame.f_code.co_filename)}:{frame.f_lineno}"
+    warn_once(
+        f"{context} suppressed {type(exc).__name__}: {exc} ({location})",
+        key=f"swallowed:{context}:{location}",
+    )
+
+
 def get_warnings() -> List[str]:
     """Return a snapshot of the recorded warnings (oldest first)."""
     with _warn_lock: