pythonnative 0.52.2__tar.gz → 0.53.0__tar.gz

{pythonnative-0.52.2/src/pythonnative.egg-info → pythonnative-0.53.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.52.2
+Version: 0.53.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -86,14 +86,18 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **Native lists and navigation:** UIKit collection views and Android recycler views recycle cells for fixed or variable row sizes, grids, sections, and horizontal lists. Native navigation containers present logical screen roots at every nesting level while providers and component state remain in the shared Python tree; navigators take screen options, groups, tab-bar styles, and a navigation ref usable outside components.
 - **Animation and gestures:** Serialized animation graphs support timing with named or bezier easing, springs, React Native's decay model, arithmetic, interpolation, and native scroll and gesture bindings. Gestures activate with Gesture Handler-style offsets and update supported animation bindings without Python work on every frame.
 - **Assets and graphics:** Drop images, fonts, and SVGs under `app/assets/` and reference them by path. Density variants, bundled fonts, a vector `Icon` set, `Svg` drawing, gradients, and blur render natively on both platforms and in the browser preview.
-- **Device APIs:** Python facades expose camera, location, notifications, storage, permissions, keyboard, dimensions and pixel ratio, device info, localization, accessibility settings, and other native services, with a Python fallback for headless tests. Test permissions and platform behavior on your deployment targets.
-- **Native extension SDK:** Python dataclasses and protocols define contracts; `define_component` returns a typed element factory and `pn codegen` generates props and module adapters for Swift and Kotlin. Plugins package native sources and resources, and builds verify matching contracts at startup.
+- **Device APIs:** Python facades expose storage, permissions, keyboard, dimensions and pixel ratio, device info, localization, accessibility settings, haptics, and other native services in every app, with a Python fallback for headless tests. Test permissions and platform behavior on your deployment targets.
+- **First-party capabilities:** Video, audio, camera, maps, location, notifications, push, pickers, sensors, biometrics, background tasks, and in-app purchases ship in the package and compile into your app only when you list them: `[plugins] use = ["camera", "maps"]` in `pythonnative.toml`, then `from pythonnative.camera import CameraView`. An app that doesn't list one contains none of its code, and calling it raises `plugin_not_enabled`. Simulators can't prove everything here: camera capture on iOS, remote push, and purchases need real hardware or store credentials.
+- **Networking:** `pn.fetch` handles JSON, multipart uploads, streamed responses, and upload progress, and `pn.WebSocket` is a pure-Python RFC 6455 client used as an async context manager and iterator, so it behaves the same on device, in tests, and in the preview.
+- **Native extension SDK:** Python dataclasses and protocols define contracts; `define_component` returns a typed element factory and `pn codegen` generates props and module adapters for Swift and Kotlin. Plugins package native sources and resources, change `Info.plist`, entitlements, the privacy manifest, the Android manifest, and Gradle through a declarative manifest, and observe app lifecycle events. Builds verify matching contracts at startup.
 - **Testing library:** `pythonnative.testing` renders components headlessly with Testing Library-style queries (`get_by_role`, `get_by_placeholder_text`, `within`, `find_by_*`), a virtual clock for timers, and a pytest plugin that resets the runtime between tests.
-- **PythonNative Go:** a prebuilt dev client, published with each release, runs any project without native code, so the project itself is never compiled. `i` / `a` in `pn start` open it on the iOS Simulator (which still needs Xcode installed) or an Android emulator, and a phone with Go installed opens the project by scanning the QR code `pn start` prints. Go isn't in the app stores: Android phones install the APK, and iPhones need Go built and signed with your Apple team. Projects that add native code run in their own debug build, which `pn run` rebuilds only when something native changes.
+- **PythonNative Go:** a prebuilt dev client, published with each release, runs any project without native code, so the project itself is never compiled. `i` / `a` in `pn start` open it on the iOS Simulator (which still needs Xcode installed) or an Android emulator, and a phone with Go installed opens the project by scanning the QR code `pn start` prints. Go isn't in the app stores: Android phones install the APK, and iPhones need Go built and signed with your Apple team. Go carries every first-party capability except push. Projects that use push or add other native code run in their own debug build, which `pn run` rebuilds only when something native changes.
 - **DevTools and debugging:** `pn start` serves DevTools, with a component tree showing props and hooks (and editable state), a console with a REPL inside the running app, problems with component stacks and source excerpts, network requests, and live performance with trace capture. VS Code attaches `debugpy` breakpoints to Python on the preview, a simulator, or a phone. On device, a dev menu (shake or Cmd+D) offers reload, an element inspector, and a performance monitor, and errors show a screen with the component stack and your source.
 - **Development tools:** Fast Refresh preserves compatible component state, `pn lint` checks the rules of hooks, and `pn init` scaffolds tests, type checking, debugger settings, and CI.
 - **Browser preview:** `pn preview` runs your Python application against DOM widgets mounted by the same renderer core, compiled to WebAssembly. It supports iteration on application logic and UI; fonts, platform controls, and device APIs require mobile testing.
 - **App packaging and dependency locks:** `pn run` and `pn build` stage bundled app templates, native libraries, and Python sources. Target-specific wheel locks record dependency versions and hashes for mobile builds. Binary dependencies need compatible mobile wheels; `pn deps` reports target resolution.
+- **Store release:** `pn build` stops a release that a store would reject (no icon, no signing, a missing usage string) and validates the artifacts, `pn run --release` runs the release configuration on a simulator or emulator, `pn submit` uploads to App Store Connect and Google Play with credentials from the environment, and `pn links` prints the files a site hosts for universal links and app links. CI builds and runs release artifacts and tests `pn submit` against fakes, but no real store submission has been verified yet, so treat your first upload as the first true test.
+- **Production failure handling:** `pn.set_error_handler` receives every uncaught error with its phase, which is where a crash reporter attaches. In a release build, a render error no boundary catches shows a fallback screen with a retry button, which `pn.set_error_fallback` replaces, and a failed mount remounts the screen once before falling back.
 
 ## Quick Start
 
@@ -131,6 +135,7 @@ pn init my-app && cd my-app
 pn start            # dev server: scan the QR code, or press i (iOS), a (Android), w (browser), j (DevTools)
 pn run ios          # the project's own debug build, for projects that add native code
 pn build ios        # standalone release artifacts
+pn submit ios       # upload the latest release build
 ```
 
 ## Documentation

{pythonnative-0.52.2 → pythonnative-0.53.0}/README.md

@@ -39,14 +39,18 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **Native lists and navigation:** UIKit collection views and Android recycler views recycle cells for fixed or variable row sizes, grids, sections, and horizontal lists. Native navigation containers present logical screen roots at every nesting level while providers and component state remain in the shared Python tree; navigators take screen options, groups, tab-bar styles, and a navigation ref usable outside components.
 - **Animation and gestures:** Serialized animation graphs support timing with named or bezier easing, springs, React Native's decay model, arithmetic, interpolation, and native scroll and gesture bindings. Gestures activate with Gesture Handler-style offsets and update supported animation bindings without Python work on every frame.
 - **Assets and graphics:** Drop images, fonts, and SVGs under `app/assets/` and reference them by path. Density variants, bundled fonts, a vector `Icon` set, `Svg` drawing, gradients, and blur render natively on both platforms and in the browser preview.
-- **Device APIs:** Python facades expose camera, location, notifications, storage, permissions, keyboard, dimensions and pixel ratio, device info, localization, accessibility settings, and other native services, with a Python fallback for headless tests. Test permissions and platform behavior on your deployment targets.
-- **Native extension SDK:** Python dataclasses and protocols define contracts; `define_component` returns a typed element factory and `pn codegen` generates props and module adapters for Swift and Kotlin. Plugins package native sources and resources, and builds verify matching contracts at startup.
+- **Device APIs:** Python facades expose storage, permissions, keyboard, dimensions and pixel ratio, device info, localization, accessibility settings, haptics, and other native services in every app, with a Python fallback for headless tests. Test permissions and platform behavior on your deployment targets.
+- **First-party capabilities:** Video, audio, camera, maps, location, notifications, push, pickers, sensors, biometrics, background tasks, and in-app purchases ship in the package and compile into your app only when you list them: `[plugins] use = ["camera", "maps"]` in `pythonnative.toml`, then `from pythonnative.camera import CameraView`. An app that doesn't list one contains none of its code, and calling it raises `plugin_not_enabled`. Simulators can't prove everything here: camera capture on iOS, remote push, and purchases need real hardware or store credentials.
+- **Networking:** `pn.fetch` handles JSON, multipart uploads, streamed responses, and upload progress, and `pn.WebSocket` is a pure-Python RFC 6455 client used as an async context manager and iterator, so it behaves the same on device, in tests, and in the preview.
+- **Native extension SDK:** Python dataclasses and protocols define contracts; `define_component` returns a typed element factory and `pn codegen` generates props and module adapters for Swift and Kotlin. Plugins package native sources and resources, change `Info.plist`, entitlements, the privacy manifest, the Android manifest, and Gradle through a declarative manifest, and observe app lifecycle events. Builds verify matching contracts at startup.
 - **Testing library:** `pythonnative.testing` renders components headlessly with Testing Library-style queries (`get_by_role`, `get_by_placeholder_text`, `within`, `find_by_*`), a virtual clock for timers, and a pytest plugin that resets the runtime between tests.
-- **PythonNative Go:** a prebuilt dev client, published with each release, runs any project without native code, so the project itself is never compiled. `i` / `a` in `pn start` open it on the iOS Simulator (which still needs Xcode installed) or an Android emulator, and a phone with Go installed opens the project by scanning the QR code `pn start` prints. Go isn't in the app stores: Android phones install the APK, and iPhones need Go built and signed with your Apple team. Projects that add native code run in their own debug build, which `pn run` rebuilds only when something native changes.
+- **PythonNative Go:** a prebuilt dev client, published with each release, runs any project without native code, so the project itself is never compiled. `i` / `a` in `pn start` open it on the iOS Simulator (which still needs Xcode installed) or an Android emulator, and a phone with Go installed opens the project by scanning the QR code `pn start` prints. Go isn't in the app stores: Android phones install the APK, and iPhones need Go built and signed with your Apple team. Go carries every first-party capability except push. Projects that use push or add other native code run in their own debug build, which `pn run` rebuilds only when something native changes.
 - **DevTools and debugging:** `pn start` serves DevTools, with a component tree showing props and hooks (and editable state), a console with a REPL inside the running app, problems with component stacks and source excerpts, network requests, and live performance with trace capture. VS Code attaches `debugpy` breakpoints to Python on the preview, a simulator, or a phone. On device, a dev menu (shake or Cmd+D) offers reload, an element inspector, and a performance monitor, and errors show a screen with the component stack and your source.
 - **Development tools:** Fast Refresh preserves compatible component state, `pn lint` checks the rules of hooks, and `pn init` scaffolds tests, type checking, debugger settings, and CI.
 - **Browser preview:** `pn preview` runs your Python application against DOM widgets mounted by the same renderer core, compiled to WebAssembly. It supports iteration on application logic and UI; fonts, platform controls, and device APIs require mobile testing.
 - **App packaging and dependency locks:** `pn run` and `pn build` stage bundled app templates, native libraries, and Python sources. Target-specific wheel locks record dependency versions and hashes for mobile builds. Binary dependencies need compatible mobile wheels; `pn deps` reports target resolution.
+- **Store release:** `pn build` stops a release that a store would reject (no icon, no signing, a missing usage string) and validates the artifacts, `pn run --release` runs the release configuration on a simulator or emulator, `pn submit` uploads to App Store Connect and Google Play with credentials from the environment, and `pn links` prints the files a site hosts for universal links and app links. CI builds and runs release artifacts and tests `pn submit` against fakes, but no real store submission has been verified yet, so treat your first upload as the first true test.
+- **Production failure handling:** `pn.set_error_handler` receives every uncaught error with its phase, which is where a crash reporter attaches. In a release build, a render error no boundary catches shows a fallback screen with a retry button, which `pn.set_error_fallback` replaces, and a failed mount remounts the screen once before falling back.
 
 ## Quick Start
 
@@ -84,6 +88,7 @@ pn init my-app && cd my-app
 pn start            # dev server: scan the QR code, or press i (iOS), a (Android), w (browser), j (DevTools)
 pn run ios          # the project's own debug build, for projects that add native code
 pn build ios        # standalone release artifacts
+pn submit ios       # upload the latest release build
 ```
 
 ## Documentation

{pythonnative-0.52.2 → pythonnative-0.53.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.52.2"
+version = "0.53.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -101,6 +101,7 @@ license-files = ["LICENSE*"]
 pythonnative = [
   "py.typed",
   "templates/**", "native/**", "sdk/templates/**",
+  "*/native/**",
   "devserver/static/**",
   "icons/_lucide.json", "icons/LICENSE-lucide.txt",
   "sdk/_builtin_contracts.json",

{pythonnative-0.52.2 → pythonnative-0.53.0}/scripts/check-distributions.py

@@ -24,6 +24,9 @@ PACKAGE_FILES = {
     "pythonnative/native/core/yoga/Yoga.h",
     "pythonnative/native/core/yoga/YGNode.cpp",
     "pythonnative/native/ios/Package.swift",
+    "pythonnative/location/native/pn_plugin.json",
+    "pythonnative/location/native/schema.json",
+    "pythonnative/location/native/ios/LocationPlugin.swift",
     "pythonnative/templates/android_template/gradlew",
     "pythonnative/devserver/static/core/mount.js",
     "pythonnative/devserver/static/core/pn_core.js",

{pythonnative-0.52.2 → pythonnative-0.53.0}/src/pythonnative/__init__.py

@@ -4,10 +4,13 @@ PythonNative is a cross-platform toolkit that turns Python ``@component``
 functions into real, native Android and iOS views. The component model
 is React-like (function components plus hooks). Python owns the logical
 component tree and reconciliation on a dedicated asyncio application thread.
-Versioned commits cross into Swift ``PythonNativeKit`` on iOS and the Kotlin
-``pythonnative`` module on Android. Those renderers own widgets, Yoga layout,
-measurement, gestures, and animation frames on the platform UI thread.
-The browser preview uses DOM widgets and Yoga WebAssembly.
+Versioned commits go to a shared C++ renderer core, which every target links.
+The core validates each commit against the native contracts, lays it out with
+Yoga off the UI thread, flattens layout-only views, and runs animation graphs.
+Swift ``PythonNativeKit`` on iOS and the Kotlin ``pythonnative`` module on
+Android mount the result: they own widgets, text drawing, input, and the frame
+clock on the platform UI thread. The browser preview runs the same core as
+WebAssembly and mounts DOM widgets.
 
 Key building blocks:
 
@@ -50,6 +53,18 @@ Key building blocks:
   with [`define_component`][pythonnative.sdk.define_component], which
   returns its element factory (or expose it from a PyPI package via the
   ``pythonnative.handlers`` entry-point group).
+- **Capabilities** are opt-in device features, one subpackage each:
+  ``pythonnative.audio``, ``background``, ``biometrics``, ``camera``,
+  ``location``, ``maps``, ``notifications``, ``pickers``, ``purchases``,
+  ``push``, ``sensors``, and ``video``. They aren't re-exported here. List
+  one in ``[plugins].use`` in ``pythonnative.toml`` to compile it into the
+  app, then import it by name: ``from pythonnative.camera import CameraView``.
+  Calling one that isn't in the build raises ``NativeModuleError`` with the
+  code ``plugin_not_enabled``.
+- **Failures** in a release build reach
+  [`set_error_handler`][pythonnative.set_error_handler], and a render error
+  no boundary catches shows the screen set with
+  [`set_error_fallback`][pythonnative.set_error_fallback].
 
 Example:
     ```python
@@ -66,12 +81,12 @@ Example:
     ```
 """
 
-__version__ = "0.52.2"
+__version__ = "0.53.0"
 
 import importlib
 from typing import TYPE_CHECKING, Any
 
-from . import appearance, diagnostics, runtime, sdk, svg
+from . import appearance, sdk, svg
 from .alerts import Alert
 from .assets import Asset, asset
 from .component import Component, component, memo
@@ -118,13 +133,13 @@ from .components import (
     Switch,
     Text,
     TextInput,
-    TouchableOpacity,
     View,
     WebNavigationEvent,
     WebView,
+    set_error_fallback,
 )
 from .components.props import AccessibilityProps, ViewProps
-from .diagnostics import HookOrderError
+from .diagnostics import HookOrderError, set_error_handler
 from .element import Element, Node
 from .handles import ScrollOffset, ScrollViewHandle, TextInputHandle, ViewHandle, WebViewHandle
 from .hooks import (
@@ -157,15 +172,11 @@ from .hooks import (
     use_transition,
     use_window_dimensions,
 )
-from .hosts import create_screen
-from .mutations import UNSET, UnsetType
 from .native_modules import (
     AccessibilityEvent,
     AccessibilityInfo,
     AppState,
     Battery,
-    Biometrics,
-    Camera,
     Clipboard,
     Device,
     DeviceInfo,
@@ -180,25 +191,22 @@ from .native_modules import (
     Linking,
     Locale,
     Localization,
-    Location,
     NetInfo,
-    Notifications,
     Permissions,
     PixelRatio,
     SecureStore,
     Share,
-    Vibration,
     use_app_state,
     use_locales,
     use_net_info,
     use_reduce_motion,
     use_screen_reader_enabled,
 )
-from .platform import Platform, get_platform
+from .platform import Platform
 from .platform_metrics import WindowDimensions
 from .runtime import run_async, run_blocking
 from .scheduler import batch_updates
-from .sdk import Props, define_component, element_factory
+from .sdk import Props, define_component
 from .storage import AsyncStorage, use_persisted_state
 from .store import Store, use_store
 from .style import (
@@ -206,36 +214,13 @@ from .style import (
     AccessibilityAction,
     AccessibilityState,
     AccessibilityValue,
-    AlignContent,
-    AlignItems,
-    AlignSelf,
-    AutoCapitalize,
-    BorderStyle,
     Color,
-    Dimension,
-    Display,
     DynamicColor,
     EdgeInsets,
-    FlexDirection,
-    FlexWrap,
-    FontWeight,
-    JustifyContent,
-    KeyboardType,
-    LayoutDirection,
-    Overflow,
-    PointerEvents,
-    Position,
-    ReturnKeyType,
-    ScaleType,
     ShadowOffset,
     Style,
     StyleProp,
     StyleSheet,
-    TextAlign,
-    TextDecoration,
-    TextTransform,
-    TransformSpec,
-    resolve_style,
     style,
 )
 from .suspense import Resource, lazy, start_resource
@@ -253,8 +238,13 @@ from .theme import (
 )
 
 __all__ = [
-    "UNSET",
-    "UnsetType",
+    # Errors
+    "set_error_fallback",
+    "set_error_handler",
+    # Networking
+    "WebSocket",
+    "WebSocketClosed",
+    "WebSocketError",
     # Components
     "ActivityIndicator",
     "BlurView",
@@ -299,7 +289,6 @@ __all__ = [
     "Switch",
     "Text",
     "TextInput",
-    "TouchableOpacity",
     "View",
     "WebView",
     # Shared props
@@ -327,7 +316,6 @@ __all__ = [
     "Element",
     "Node",
     "component",
-    "create_screen",
     "memo",
     # Hooks
     "ColorScheme",
@@ -387,34 +375,13 @@ __all__ = [
     "AccessibilityAction",
     "AccessibilityState",
     "AccessibilityValue",
-    "AlignContent",
-    "AlignItems",
-    "AlignSelf",
-    "AutoCapitalize",
-    "BorderStyle",
     "Color",
-    "Dimension",
-    "Display",
     "DynamicColor",
     "EdgeInsets",
-    "FlexDirection",
-    "FlexWrap",
-    "FontWeight",
-    "JustifyContent",
-    "KeyboardType",
-    "LayoutDirection",
-    "Overflow",
-    "PointerEvents",
-    "Position",
-    "ReturnKeyType",
-    "ScaleType",
     "ShadowOffset",
     "Style",
     "StyleProp",
     "StyleSheet",
-    "TextAlign",
-    "TextDecoration",
-    "TextTransform",
     "Theme",
     "ThemeProvider",
     "Colors",
@@ -425,14 +392,11 @@ __all__ = [
     "DARK_THEME",
     "ABSOLUTE_FILL",
     "use_styles",
-    "TransformSpec",
-    "resolve_style",
     "style",
     "use_theme",
     # Appearance
     "appearance",
     # Animation
-    "ANIMATABLE_PROPS",
     "Animated",
     "AnimatedValue",
     "AnimationResult",
@@ -463,21 +427,16 @@ __all__ = [
     "use_screen_reader_enabled",
     "AppState",
     "Battery",
-    "Biometrics",
-    "Camera",
     "Clipboard",
     "FileSystem",
     "Haptics",
     "ImageSize",
     "Images",
     "Linking",
-    "Location",
     "NetInfo",
-    "Notifications",
     "Permissions",
     "SecureStore",
     "Share",
-    "Vibration",
     "use_app_state",
     "use_net_info",
     # Stores
@@ -491,17 +450,13 @@ __all__ = [
     # Runtime
     "run_async",
     "run_blocking",
-    "runtime",
     # Diagnostics
     "HookOrderError",
-    "diagnostics",
     # Platform
     "Platform",
-    "get_platform",
     # Custom-component SDK
     "Props",
     "define_component",
-    "element_factory",
     "sdk",
 ]
 
@@ -512,7 +467,6 @@ from .list_data import ListData, Section, ViewableItem
 # documentation are unchanged, and type checkers see ordinary imports.
 _LAZY_GROUPS: dict[str, tuple[str, ...]] = {
     "animated": (
-        "ANIMATABLE_PROPS",
         "Animated",
         "AnimatedValue",
         "AnimationResult",
@@ -543,6 +497,7 @@ _LAZY_GROUPS: dict[str, tuple[str, ...]] = {
         "use_screen_options",
     ),
     "net": ("HTTPError", "Response", "fetch"),
+    "websocket": ("WebSocket", "WebSocketClosed", "WebSocketError"),
 }
 _LAZY = {name: module for module, names in _LAZY_GROUPS.items() for name in names}
 _LAZY_MODULES = frozenset({"gestures", "icons"})
@@ -550,7 +505,6 @@ _LAZY_MODULES = frozenset({"gestures", "icons"})
 if TYPE_CHECKING:
     from . import gestures, icons
     from .animated import (
-        ANIMATABLE_PROPS,
         Animated,
         AnimatedValue,
         AnimationResult,
@@ -581,6 +535,7 @@ if TYPE_CHECKING:
         use_screen_options,
     )
     from .net import HTTPError, Response, fetch
+    from .websocket import WebSocket, WebSocketClosed, WebSocketError
 
 
 def __getattr__(name: str) -> Any: