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

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/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/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/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/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/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/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")

pythonnative/native_modules/linking.py

@@ -4,27 +4,38 @@
 ``Intent(ACTION_VIEW)`` so a Python app can hand a URL (``https:``,
 ``mailto:``, ``tel:``, a custom scheme, …) to the OS.
 
-All methods are synchronous and return a ``bool`` describing whether
-the platform accepted the request. On desktop they return ``False``.
+Outbound methods are synchronous and return a ``bool`` describing
+whether the platform accepted the request. On desktop they return
+``False``.
+
+Inbound deep links flow the other way: declare your schemes in
+``pythonnative.toml`` (``app.url_schemes``) and the native host calls
+[`dispatch_url`][pythonnative.native_modules.linking.dispatch_url] for
+every URL that opens the app. The URL that cold-started the app is kept
+and returned by ``get_initial_url``; later URLs reach subscribers added
+with ``add_listener``.
 
 Example:
     ```python
     import pythonnative as pn
 
-    if pn.Linking.can_open_url("tel:+15551234567"):
-        pn.Linking.open_url("tel:+15551234567")
+    if url := pn.Linking.get_initial_url():
+        navigate_to(url)
+
+    unsubscribe = pn.Linking.add_listener(navigate_to)
     ```
 """
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any, Callable, List, Optional
 
 from ..utils import IS_ANDROID, IS_IOS
 
 # Populated by the native host when the app is launched from a deep
-# link; ``get_initial_url`` returns it once.
+# link; ``get_initial_url`` returns it.
 _initial_url: Optional[str] = None
+_url_listeners: List[Callable[[str], None]] = []
 
 
 class Linking:
@@ -62,6 +73,28 @@ class Linking:
         """Return the URL that launched the app, if any."""
         return _initial_url
 
+    @staticmethod
+    def add_listener(callback: Callable[[str], None]) -> Callable[[], None]:
+        """Subscribe to deep links that arrive while the app is running.
+
+        Args:
+            callback: Called with the full URL string for every inbound
+                deep link (including the initial one, which is
+                dispatched right after startup).
+
+        Returns:
+            A zero-arg function that unsubscribes when called.
+        """
+        _url_listeners.append(callback)
+
+        def _unsubscribe() -> None:
+            try:
+                _url_listeners.remove(callback)
+            except ValueError:
+                pass
+
+        return _unsubscribe
+
 
 def set_initial_url(url: Optional[str]) -> None:
     """Record the launch URL (called by the native host on cold start)."""
@@ -69,6 +102,29 @@ def set_initial_url(url: Optional[str]) -> None:
     _initial_url = url
 
 
+def dispatch_url(url: str) -> None:
+    """Deliver an inbound deep link from the native host.
+
+    The first URL ever dispatched is also recorded as the initial URL
+    (a cold start from a deep link reaches Python only after the
+    interpreter boots, so the host can't call ``set_initial_url``
+    earlier than this).
+
+    Args:
+        url: The full URL string that opened the app.
+    """
+    global _initial_url
+    if _initial_url is None:
+        _initial_url = url
+    for listener in list(_url_listeners):
+        try:
+            listener(url)
+        except Exception as exc:
+            from .. import diagnostics
+
+            diagnostics.warn(f"Linking listener raised while handling {url!r}: {exc!r}")
+
+
 # ======================================================================
 # iOS
 # ======================================================================

pythonnative/native_modules/location.py

@@ -27,6 +27,7 @@ from __future__ import annotations
 import asyncio
 from typing import Any, Callable, Dict, Optional, Tuple
 
+from .. import diagnostics
 from ..runtime import resolve_future
 from ..utils import IS_ANDROID, IS_IOS
 
@@ -94,7 +95,7 @@ def _ios_get(on_result: Callable[[Optional[Coords]], None]) -> None:
                     if self._manager is not None:
                         self._manager.stopUpdatingLocation()
                 except Exception:
-                    pass
+                    diagnostics.swallowed("location._ios_get._PNLocationDelegate._finish")
                 cb = self._callback
                 self._callback = None
                 _pending_delegates.pop(id(self), None)
@@ -102,7 +103,7 @@ def _ios_get(on_result: Callable[[Optional[Coords]], None]) -> None:
                     try:
                         cb(coords)
                     except Exception:
-                        pass
+                        diagnostics.swallowed("location._ios_get._PNLocationDelegate._finish")
 
             @objc_method
             def locationManager_didUpdateLocations_(self, manager: Any, locations: Any) -> None:
@@ -131,7 +132,9 @@ def _ios_get(on_result: Callable[[Optional[Coords]], None]) -> None:
                     try:
                         manager.startUpdatingLocation()
                     except Exception:
-                        pass
+                        diagnostics.swallowed(
+                            "location._ios_get._PNLocationDelegate.locationManagerDidChangeAuthorization_"
+                        )
 
         delegate = _PNLocationDelegate.new()
         delegate._callback = on_result
@@ -143,11 +146,11 @@ def _ios_get(on_result: Callable[[Optional[Coords]], None]) -> None:
         try:
             manager.requestWhenInUseAuthorization()
         except Exception:
-            pass
+            diagnostics.swallowed("location._ios_get")
         try:
             manager.startUpdatingLocation()
         except Exception:
-            pass
+            diagnostics.swallowed("location._ios_get")
     except Exception:
         on_result(None)
 
@@ -176,7 +179,7 @@ def _android_get(on_result: Callable[[Optional[Coords]], None]) -> None:
                     on_result((float(loc.getLatitude()), float(loc.getLongitude())))
                     return
         except Exception:
-            pass
+            diagnostics.swallowed("location._android_get")
 
         LocationListener = jclass("android.location.LocationListener")
         delivered = [False]
@@ -188,12 +191,12 @@ def _android_get(on_result: Callable[[Optional[Coords]], None]) -> None:
             try:
                 lm.removeUpdates(listener)
             except Exception:
-                pass
+                diagnostics.swallowed("location._android_get._finish")
             _pending_delegates.pop(id(listener), None)
             try:
                 on_result(coords)
             except Exception:
-                pass
+                diagnostics.swallowed("location._android_get._finish")
 
         class _PNLocationListener(dynamic_proxy(LocationListener)):  # type: ignore[misc]
             def onLocationChanged(self, loc: Any) -> None:

pythonnative/native_modules/net_info.py

@@ -3,8 +3,10 @@
 [`NetInfo`][pythonnative.NetInfo] reports whether the device is online
 and over what kind of connection. ``fetch`` returns a snapshot dict;
 ``add_listener`` (and the [`use_net_info`][pythonnative.use_net_info]
-hook) deliver live updates as the native host forwards connectivity
-changes through
+hook) deliver live updates: while at least one listener is subscribed,
+a lightweight background watcher polls the platform's connectivity
+state and dispatches a fresh snapshot whenever it changes. Native
+hosts may also push changes directly through
 [`dispatch_net_info`][pythonnative.native_modules.net_info.dispatch_net_info].
 
 A snapshot looks like::
@@ -17,8 +19,10 @@ A snapshot looks like::
 
 from __future__ import annotations
 
-from typing import Callable, Dict, List
+import threading
+from typing import Callable, Dict, List, Optional
 
+from .. import diagnostics
 from ..hooks import use_effect, use_state
 from ..utils import IS_ANDROID, IS_IOS
 
@@ -31,6 +35,11 @@ _last_state: NetInfoState = {
     "is_internet_reachable": True,
 }
 
+# Background watcher driving live updates while listeners exist.
+_WATCH_INTERVAL_S = 2.0
+_watcher_lock = threading.Lock()
+_watcher_stop: Optional[threading.Event] = None
+
 
 class NetInfo:
     """Network connectivity interface."""
@@ -47,18 +56,60 @@ class NetInfo:
 
     @staticmethod
     def add_listener(callback: Callable[[NetInfoState], None]) -> Callable[[], None]:
-        """Subscribe to connectivity changes; returns an unsubscribe fn."""
+        """Subscribe to connectivity changes; returns an unsubscribe fn.
+
+        The first subscription starts a background watcher that polls
+        the platform connectivity state every couple of seconds and
+        dispatches a snapshot on change; the watcher stops when the
+        last listener unsubscribes.
+        """
         _listeners.append(callback)
+        _ensure_watcher()
 
         def _unsubscribe() -> None:
             try:
                 _listeners.remove(callback)
             except ValueError:
                 pass
+            if not _listeners:
+                _stop_watcher()
 
         return _unsubscribe
 
 
+def _ensure_watcher() -> None:
+    """Start the connectivity watcher if a platform backend exists."""
+    global _watcher_stop
+    if not (IS_ANDROID or IS_IOS):
+        return
+    with _watcher_lock:
+        if _watcher_stop is not None:
+            return
+        stop = threading.Event()
+        _watcher_stop = stop
+
+    def _watch() -> None:
+        previous = dict(_last_state)
+        while not stop.wait(_WATCH_INTERVAL_S):
+            try:
+                current = _android_state() if IS_ANDROID else _ios_state()
+            except Exception:
+                continue
+            if current != previous:
+                previous = dict(current)
+                dispatch_net_info(current)
+
+    threading.Thread(target=_watch, daemon=True, name="pn-netinfo").start()
+
+
+def _stop_watcher() -> None:
+    global _watcher_stop
+    with _watcher_lock:
+        if _watcher_stop is not None:
+            _watcher_stop.set()
+            _watcher_stop = None
+
+
 def dispatch_net_info(state: NetInfoState) -> None:
     """Push a new connectivity snapshot and notify listeners."""
     global _last_state
@@ -67,7 +118,26 @@ def dispatch_net_info(state: NetInfoState) -> None:
         try:
             listener(dict(state))
         except Exception:
-            pass
+            diagnostics.swallowed("net_info.dispatch_net_info")
+
+
+def dispatch_android_change() -> None:
+    """Re-read Android connectivity and notify listeners on change.
+
+    Called by the template's ``MainActivity`` from the
+    ``ConnectivityManager.NetworkCallback`` it registers via
+    ``registerDefaultNetworkCallback`` whenever the default network
+    appears, drops, or changes capabilities. The callback lives in
+    Kotlin because Chaquopy's ``dynamic_proxy`` implements interfaces
+    only and ``NetworkCallback`` is a class. Re-reading the snapshot
+    here keeps the transport-type mapping in one place, and identical
+    consecutive snapshots are dropped so paired ``onAvailable`` /
+    ``onCapabilitiesChanged`` callbacks don't double-notify.
+    """
+    state = _android_state()
+    if state == _last_state:
+        return
+    dispatch_net_info(state)
 
 
 def use_net_info() -> NetInfoState: