pythonnative 0.25.0__tar.gz → 0.26.0__tar.gz

{pythonnative-0.25.0/src/pythonnative.egg-info → pythonnative-0.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.25.0
+Version: 0.26.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License

{pythonnative-0.25.0 → pythonnative-0.26.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.25.0"
+version = "0.26.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/__init__.py

@@ -60,7 +60,7 @@ Example:
     ```
 """
 
-__version__ = "0.25.0"
+__version__ = "0.26.0"
 
 from . import appearance, diagnostics, gestures, images, runtime, sdk
 from .alerts import Alert

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/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-0.25.0 → pythonnative-0.26.0}/src/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:

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/app_state.py

@@ -25,6 +25,7 @@ from __future__ import annotations
 
 from typing import Callable, List
 
+from .. import diagnostics
 from ..hooks import use_effect, use_state
 
 AppStateStatus = str  # "active" | "inactive" | "background"
@@ -74,7 +75,7 @@ def dispatch_app_state(state: AppStateStatus) -> None:
         try:
             listener(state)
         except Exception:
-            pass
+            diagnostics.swallowed("app_state.dispatch_app_state")
 
 
 def use_app_state() -> AppStateStatus:

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/battery.py

@@ -10,6 +10,7 @@ from __future__ import annotations
 
 from typing import Callable, Dict, List
 
+from .. import diagnostics
 from ..utils import IS_ANDROID, IS_IOS
 
 BatteryState = str  # "unknown" | "unplugged" | "charging" | "full"
@@ -62,7 +63,7 @@ def dispatch_battery(level: float, state: BatteryState) -> None:
         try:
             listener(dict(payload))
         except Exception:
-            pass
+            diagnostics.swallowed("battery.dispatch_battery")
 
 
 # ======================================================================
@@ -77,7 +78,7 @@ def _ios_device() -> object:
     try:
         device.setBatteryMonitoringEnabled_(True)
     except Exception:
-        pass
+        diagnostics.swallowed("battery._ios_device")
     return device
 
 

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/biometrics.py

@@ -23,6 +23,7 @@ from __future__ import annotations
 import asyncio
 from typing import Any, Callable, Dict
 
+from .. import diagnostics
 from ..runtime import resolve_future
 from ..utils import IS_ANDROID, IS_IOS
 
@@ -93,7 +94,7 @@ def _ios_authenticate(reason: str, on_done: Callable[[bool], None]) -> None:
             try:
                 on_done(bool(success))
             except Exception:
-                pass
+                diagnostics.swallowed("biometrics._ios_authenticate._reply")
 
         context.evaluatePolicy_localizedReason_reply_(1, reason, Block(_reply, None, bool, ObjCClass("NSError")))
     except Exception:

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/camera.py

@@ -25,6 +25,7 @@ from __future__ import annotations
 import asyncio
 from typing import Any, Callable, Dict, Optional
 
+from .. import diagnostics
 from ..runtime import resolve_future
 from ..utils import IS_ANDROID, IS_IOS
 
@@ -109,7 +110,9 @@ def _ios_launch_picker(on_result: Callable[[Optional[str]], None], source: str)
                 try:
                     picker.dismissViewControllerAnimated_completion_(True, None)
                 except Exception:
-                    pass
+                    diagnostics.swallowed(
+                        "camera._ios_launch_picker._PNImagePickerDelegate.imagePickerController_didFinishPickingMediaWithInfo_"
+                    )
                 cb = self._callback
                 self._callback = None
                 _pending_delegates.pop(id(self), None)
@@ -117,14 +120,18 @@ def _ios_launch_picker(on_result: Callable[[Optional[str]], None], source: str)
                     try:
                         cb(path)
                     except Exception:
-                        pass
+                        diagnostics.swallowed(
+                            "camera._ios_launch_picker._PNImagePickerDelegate.imagePickerController_didFinishPickingMediaWithInfo_"
+                        )
 
             @objc_method
             def imagePickerControllerDidCancel_(self, picker: Any) -> None:
                 try:
                     picker.dismissViewControllerAnimated_completion_(True, None)
                 except Exception:
-                    pass
+                    diagnostics.swallowed(
+                        "camera._ios_launch_picker._PNImagePickerDelegate.imagePickerControllerDidCancel_"
+                    )
                 cb = self._callback
                 self._callback = None
                 _pending_delegates.pop(id(self), None)
@@ -132,7 +139,9 @@ def _ios_launch_picker(on_result: Callable[[Optional[str]], None], source: str)
                     try:
                         cb(None)
                     except Exception:
-                        pass
+                        diagnostics.swallowed(
+                            "camera._ios_launch_picker._PNImagePickerDelegate.imagePickerControllerDidCancel_"
+                        )
 
         delegate = _PNImagePickerDelegate.new()
         delegate._callback = on_result
@@ -170,7 +179,7 @@ def _ios_extract_path(info: Any) -> Optional[str]:
                 try:
                     return str(url.path)
                 except Exception:
-                    pass
+                    diagnostics.swallowed("camera._ios_extract_path")
         image = info.objectForKey_("UIImagePickerControllerOriginalImage")
         if image is not None:
             return _ios_write_image_to_tmp(image)
@@ -293,13 +302,13 @@ def deliver_android_activity_result(request_code: int, result_code: int, data: A
                         if thumb is not None:
                             path = _android_write_bitmap_to_cache(thumb)
                 except Exception:
-                    pass
+                    diagnostics.swallowed("camera.deliver_android_activity_result")
     except Exception:
         path = None
     try:
         cb(path)
     except Exception:
-        pass
+        diagnostics.swallowed("camera.deliver_android_activity_result")
     return True
 
 

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/clipboard.py

@@ -22,6 +22,7 @@ from __future__ import annotations
 
 from typing import Optional
 
+from .. import diagnostics
 from ..utils import IS_ANDROID, IS_IOS
 
 # Desktop fallback buffer so the API is usable off-device.
@@ -79,7 +80,7 @@ def _ios_set(text: str) -> None:
     try:
         pb.string = text
     except Exception:
-        pass
+        diagnostics.swallowed("clipboard._ios_set")
 
 
 def _ios_get() -> str:
@@ -122,7 +123,7 @@ def _android_set(text: str) -> None:
         clip = ClipData.newPlainText("pythonnative", text)
         manager.setPrimaryClip(clip)
     except Exception:
-        pass
+        diagnostics.swallowed("clipboard._android_set")
 
 
 def _android_get() -> str:

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/file_system.py

@@ -17,6 +17,7 @@ Example:
 import os
 from typing import Any, Optional
 
+from .. import diagnostics
 from ..utils import IS_ANDROID
 
 
@@ -49,7 +50,7 @@ class FileSystem:
 
                 return str(get_android_context().getFilesDir().getAbsolutePath())
             except Exception:
-                pass
+                diagnostics.swallowed("file_system.FileSystem.app_dir")
         else:
             try:
                 from rubicon.objc import ObjCClass
@@ -61,7 +62,7 @@ class FileSystem:
                 if docs and docs.count > 0:
                     return str(docs.objectAtIndex_(0).path)
             except Exception:
-                pass
+                diagnostics.swallowed("file_system.FileSystem.app_dir")
         return os.path.join(os.path.expanduser("~"), ".pythonnative_data")
 
     @staticmethod

{pythonnative-0.25.0 → pythonnative-0.26.0}/src/pythonnative/native_modules/haptics.py

@@ -19,6 +19,7 @@ from __future__ import annotations
 
 from typing import Any, Optional
 
+from .. import diagnostics
 from ..utils import IS_ANDROID, IS_IOS
 
 ImpactStyle = str  # "light" | "medium" | "heavy" | "soft" | "rigid"
@@ -86,7 +87,7 @@ class Vibration:
                 try:
                     vibrator.cancel()
                 except Exception:
-                    pass
+                    diagnostics.swallowed("haptics.Vibration.cancel")
 
 
 # ======================================================================
@@ -102,7 +103,7 @@ def _ios_impact(style: str) -> None:
         generator.prepare()
         generator.impactOccurred()
     except Exception:
-        pass
+        diagnostics.swallowed("haptics._ios_impact")
 
 
 def _ios_notification(type_: str) -> None:
@@ -113,7 +114,7 @@ def _ios_notification(type_: str) -> None:
         generator.prepare()
         generator.notificationOccurred_(_IOS_NOTIFICATION_TYPE.get(type_, 0))
     except Exception:
-        pass
+        diagnostics.swallowed("haptics._ios_notification")
 
 
 def _ios_selection() -> None:
@@ -124,7 +125,7 @@ def _ios_selection() -> None:
         generator.prepare()
         generator.selectionChanged()
     except Exception:
-        pass
+        diagnostics.swallowed("haptics._ios_selection")
 
 
 def _ios_legacy_vibrate() -> None:
@@ -134,7 +135,7 @@ def _ios_legacy_vibrate() -> None:
         audio = CDLL(util.find_library("AudioToolbox"))
         audio.AudioServicesPlaySystemSound(4095)  # kSystemSoundID_Vibrate
     except Exception:
-        pass
+        diagnostics.swallowed("haptics._ios_legacy_vibrate")
 
 
 # ======================================================================
@@ -177,4 +178,4 @@ def _android_buzz(duration_ms: int) -> None:
         else:
             vibrator.vibrate(int(duration_ms))
     except Exception:
-        pass
+        diagnostics.swallowed("haptics._android_buzz")