pythonnative 0.45.0__tar.gz → 0.46.0__tar.gz

{pythonnative-0.45.0/src/pythonnative.egg-info → pythonnative-0.46.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.45.0
+Version: 0.46.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -40,7 +40,6 @@ Classifier: Topic :: Software Development :: User Interfaces
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests>=2.31.0
 Provides-Extra: build
 Requires-Dist: Pillow>=10.0; extra == "build"
 Dynamic: license-file
@@ -77,15 +76,17 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 
 ## Features
 
-- **Declarative components and hooks:** Describe native UI with Python functions, immutable elements, and typed styles. State, effects, context, and suspense boundaries follow one logical application tree across screens, overlays, and mounted list rows.
+- **Declarative components and hooks:** Describe native UI with Python functions, immutable elements, and typed styles. State, effects, context, and suspense boundaries follow one logical application tree across screens, overlays, and mounted list rows. State updates batch automatically, effect errors reach the nearest error boundary, and event callbacks receive typed records instead of dicts.
+- **React Native's core surface:** `Pressable`, `ScrollView`, `Text`, `TextInput`, `Image`, `Modal`, `FlatList`, and `SectionList` carry the props a React Native developer expects (disabled state and ripples, content insets and snapping, ellipsize modes and pressable spans, controlled selection and key events, sticky headers and inverted lists), plus typed imperative handles on `ref.current` and the full accessibility prop set.
 - **Native widgets and layout:** Swift and Kotlin component managers own UIKit and Android widgets. The shared Yoga C++ engine computes layout beside the controls, using platform measurements for text and intrinsic sizes.
 - **Standard asyncio:** Components, effects, event handlers, and tasks run on a dedicated Python application thread. Native UI threads handle widgets, scrolling, and animation frames. Component-owned tasks are canceled on unmount.
 - **Incremental reconciliation:** State changes update affected component subtrees. Versioned bridge commits validate operations and acknowledge revisions; events and controlled text inputs carry identities that prevent stale updates.
-- **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 while providers and component state remain in the shared Python tree.
-- **Animation and gestures:** Serialized animation graphs support timing, springs, decay, arithmetic, interpolation, and native scroll and gesture bindings. Swift and Kotlin recognize mobile gestures and update supported animation bindings without Python work on every frame.
+- **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, themes, 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. Swift and Kotlin recognize mobile gestures with Gesture Handler-style activation 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, and other native services. Test permissions and platform behavior on your deployment targets.
-- **Native extension SDK:** Python dataclasses and protocols define contracts; `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 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.
+- **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.
 - **Development tools:** `pn start` serves the browser preview and connected mobile dev clients. Fast Refresh preserves compatible component state, while diagnostics report errors and invalid hook usage. Changes to native inputs trigger a rebuild.
 - **Browser preview:** `pn preview` runs your Python application against a browser renderer with DOM widgets, Yoga WebAssembly layout, and JavaScript animation graphs. 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.

{pythonnative-0.45.0 → pythonnative-0.46.0}/README.md

@@ -30,15 +30,17 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 
 ## Features
 
-- **Declarative components and hooks:** Describe native UI with Python functions, immutable elements, and typed styles. State, effects, context, and suspense boundaries follow one logical application tree across screens, overlays, and mounted list rows.
+- **Declarative components and hooks:** Describe native UI with Python functions, immutable elements, and typed styles. State, effects, context, and suspense boundaries follow one logical application tree across screens, overlays, and mounted list rows. State updates batch automatically, effect errors reach the nearest error boundary, and event callbacks receive typed records instead of dicts.
+- **React Native's core surface:** `Pressable`, `ScrollView`, `Text`, `TextInput`, `Image`, `Modal`, `FlatList`, and `SectionList` carry the props a React Native developer expects (disabled state and ripples, content insets and snapping, ellipsize modes and pressable spans, controlled selection and key events, sticky headers and inverted lists), plus typed imperative handles on `ref.current` and the full accessibility prop set.
 - **Native widgets and layout:** Swift and Kotlin component managers own UIKit and Android widgets. The shared Yoga C++ engine computes layout beside the controls, using platform measurements for text and intrinsic sizes.
 - **Standard asyncio:** Components, effects, event handlers, and tasks run on a dedicated Python application thread. Native UI threads handle widgets, scrolling, and animation frames. Component-owned tasks are canceled on unmount.
 - **Incremental reconciliation:** State changes update affected component subtrees. Versioned bridge commits validate operations and acknowledge revisions; events and controlled text inputs carry identities that prevent stale updates.
-- **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 while providers and component state remain in the shared Python tree.
-- **Animation and gestures:** Serialized animation graphs support timing, springs, decay, arithmetic, interpolation, and native scroll and gesture bindings. Swift and Kotlin recognize mobile gestures and update supported animation bindings without Python work on every frame.
+- **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, themes, 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. Swift and Kotlin recognize mobile gestures with Gesture Handler-style activation 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, and other native services. Test permissions and platform behavior on your deployment targets.
-- **Native extension SDK:** Python dataclasses and protocols define contracts; `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 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.
+- **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.
 - **Development tools:** `pn start` serves the browser preview and connected mobile dev clients. Fast Refresh preserves compatible component state, while diagnostics report errors and invalid hook usage. Changes to native inputs trigger a rebuild.
 - **Browser preview:** `pn preview` runs your Python application against a browser renderer with DOM widgets, Yoga WebAssembly layout, and JavaScript animation graphs. 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.

{pythonnative-0.45.0 → pythonnative-0.46.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.45.0"
+version = "0.46.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -26,9 +26,7 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: User Interfaces",
 ]
-dependencies = [
-  "requests>=2.31.0",
-]
+dependencies = []
 
 [project.optional-dependencies]
 build = [
@@ -64,6 +62,9 @@ docs = [
 [project.scripts]
 pn = "pythonnative.cli.pn:main"
 
+[project.entry-points.pytest11]
+pythonnative = "pythonnative.testing.pytest_plugin"
+
 [project.urls]
 Homepage = "https://github.com/pythonnative/pythonnative"
 Repository = "https://github.com/pythonnative/pythonnative"

{pythonnative-0.45.0 → pythonnative-0.46.0}/src/pythonnative/__init__.py

@@ -42,12 +42,10 @@ Key building blocks:
   [`Rotation`][pythonnative.gestures.Rotation]).
 - **Custom native components** can be authored with the
   ``pythonnative.sdk`` package: define a typed
-  [`Props`][pythonnative.sdk.Props] dataclass, implement a
-  [`ViewHandler`][pythonnative.native_views.base.ViewHandler] for each
-  platform, and register it via
-  [`@native_component`][pythonnative.sdk.native_component] (or expose
-  it from a PyPI package via the ``pythonnative.handlers`` entry-point
-  group).
+  [`Props`][pythonnative.sdk.Props] dataclass and declare the component
+  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).
 
 Example:
     ```python
@@ -64,11 +62,11 @@ Example:
     ```
 """
 
-__version__ = "0.45.0"
+__version__ = "0.46.0"
 
 from . import appearance, diagnostics, gestures, icons, runtime, sdk, svg
 from .alerts import Alert
-from .animated import Animated, AnimatedValue, use_animated_value
+from .animated import ANIMATABLE_PROPS, Animated, AnimatedValue, AnimationResult, Easing, EasingSpec, use_animated_value
 from .assets import Asset, asset
 from .component import Component, component, memo
 from .components import (
@@ -77,6 +75,7 @@ from .components import (
     Button,
     Checkbox,
     Column,
+    ContentSizeEvent,
     DatePicker,
     ErrorBoundary,
     FlatList,
@@ -86,19 +85,25 @@ from .components import (
     ImageLoadEvent,
     ImageSource,
     KeyboardAvoidingView,
+    KeyPressEvent,
+    LayoutEvent,
     LinearGradient,
     ListController,
     Modal,
     Picker,
     Portal,
     Pressable,
+    PressState,
     ProgressBar,
     RefreshControl,
+    Ripple,
     Row,
     SafeAreaView,
+    ScrollEvent,
     ScrollView,
     SectionList,
     SegmentedControl,
+    SelectionEvent,
     Slider,
     Spacer,
     StatusBar,
@@ -114,8 +119,12 @@ from .components import (
 )
 from .diagnostics import HookOrderError
 from .element import Element
+from .gestures import GestureSpec, SwipeDirection
+from .handles import ScrollOffset, ScrollViewHandle, TextInputHandle, ViewHandle, WebViewHandle
 from .hooks import (
+    ColorScheme,
     Context,
+    Deps,
     MutationCall,
     MutationState,
     QueryResult,
@@ -146,64 +155,86 @@ from .hosts import create_screen
 from .icons import Icon, IconName
 from .mutations import UNSET, UnsetType
 from .native_modules import (
+    AccessibilityEvent,
+    AccessibilityInfo,
     AppState,
     Battery,
     Biometrics,
     Camera,
     Clipboard,
+    Device,
+    DeviceInfo,
+    Dimensions,
+    DimensionsEvent,
     FileSystem,
     Haptics,
     Images,
     ImageSize,
+    Keyboard,
+    KeyboardEvent,
     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 .navigation import (
+    DARK_NAVIGATION_THEME,
+    DEFAULT_NAVIGATION_THEME,
     LinkingConfig,
     Navigation,
+    NavigationColors,
     NavigationContainer,
+    NavigationRef,
     NavigationState,
+    NavigationTheme,
     Route,
+    ScreenGroup,
     ScreenOptions,
+    TabBarStyle,
     create_drawer_navigator,
+    create_navigation_ref,
     create_stack_navigator,
     create_tab_navigator,
     use_focus_effect,
     use_is_focused,
     use_navigation,
+    use_navigation_theme,
     use_route,
 )
 from .net import HTTPError, Response, fetch
 from .platform import Platform, get_platform
+from .platform_metrics import WindowDimensions
 from .runtime import run_async, run_blocking
 from .scheduler import batch_updates
-from .sdk import (
-    Props,
-    ViewHandler,
-    element_factory,
-    native_component,
-    register_component,
-)
+from .sdk import Props, define_component, element_factory
 from .storage import AsyncStorage, use_persisted_state
 from .style import (
     DEFAULT_DARK_THEME,
     DEFAULT_LIGHT_THEME,
+    AccessibilityAction,
     AccessibilityState,
+    AccessibilityValue,
     AlignContent,
     AlignItems,
     AlignSelf,
     AutoCapitalize,
+    BorderStyle,
     Color,
     Dimension,
     Display,
+    DynamicColor,
     EdgeInsets,
     FlexDirection,
     FlexWrap,
@@ -260,8 +291,10 @@ __all__ = [
     "Picker",
     "Portal",
     "Pressable",
+    "PressState",
     "ProgressBar",
     "RefreshControl",
+    "Ripple",
     "Row",
     "SafeAreaView",
     "ScrollView",
@@ -278,6 +311,18 @@ __all__ = [
     "TouchableOpacity",
     "View",
     "WebView",
+    # Typed events
+    "ContentSizeEvent",
+    "KeyPressEvent",
+    "LayoutEvent",
+    "ScrollEvent",
+    "SelectionEvent",
+    # Imperative handles
+    "ScrollOffset",
+    "ScrollViewHandle",
+    "TextInputHandle",
+    "ViewHandle",
+    "WebViewHandle",
     # Assets and graphics
     "Asset",
     "asset",
@@ -290,6 +335,8 @@ __all__ = [
     "create_screen",
     "memo",
     # Hooks
+    "ColorScheme",
+    "Deps",
     "Context",
     "MutationCall",
     "MutationState",
@@ -323,12 +370,21 @@ __all__ = [
     "lazy",
     "start_resource",
     # Navigation
+    "DARK_NAVIGATION_THEME",
+    "DEFAULT_NAVIGATION_THEME",
     "LinkingConfig",
     "Navigation",
+    "NavigationColors",
     "NavigationContainer",
+    "NavigationRef",
     "NavigationState",
+    "NavigationTheme",
     "Route",
+    "ScreenGroup",
     "ScreenOptions",
+    "TabBarStyle",
+    "create_navigation_ref",
+    "use_navigation_theme",
     "create_drawer_navigator",
     "create_stack_navigator",
     "create_tab_navigator",
@@ -337,16 +393,20 @@ __all__ = [
     "use_navigation",
     "use_route",
     # Styling - typed primitives
+    "AccessibilityAction",
     "AccessibilityState",
+    "AccessibilityValue",
     "AlignContent",
     "AlignItems",
     "AlignSelf",
     "AutoCapitalize",
+    "BorderStyle",
     "Color",
     "DEFAULT_DARK_THEME",
     "DEFAULT_LIGHT_THEME",
     "Dimension",
     "Display",
+    "DynamicColor",
     "EdgeInsets",
     "FlexDirection",
     "FlexWrap",
@@ -376,14 +436,35 @@ __all__ = [
     # Appearance
     "appearance",
     # Animation
+    "ANIMATABLE_PROPS",
     "Animated",
     "AnimatedValue",
+    "AnimationResult",
+    "Easing",
+    "EasingSpec",
     "use_animated_value",
     # Gestures
+    "GestureSpec",
+    "SwipeDirection",
     "gestures",
     # Imperative
     "Alert",
     # Native modules
+    "AccessibilityEvent",
+    "AccessibilityInfo",
+    "Device",
+    "DeviceInfo",
+    "Dimensions",
+    "DimensionsEvent",
+    "Keyboard",
+    "KeyboardEvent",
+    "Locale",
+    "Localization",
+    "PixelRatio",
+    "WindowDimensions",
+    "use_locales",
+    "use_reduce_motion",
+    "use_screen_reader_enabled",
     "AppState",
     "Battery",
     "Biometrics",
@@ -420,9 +501,7 @@ __all__ = [
     "get_platform",
     # Custom-component SDK
     "Props",
-    "ViewHandler",
+    "define_component",
     "element_factory",
-    "native_component",
-    "register_component",
     "sdk",
 ]