pythonnative 0.20.0__tar.gz → 0.22.0__tar.gz

{pythonnative-0.20.0/src/pythonnative.egg-info → pythonnative-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.20.0
+Version: 0.22.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -42,8 +42,11 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.31.0
+Requires-Dist: tomli>=2.0; python_version < "3.11"
 Provides-Extra: ios
 Requires-Dist: rubicon-objc<0.5.0,>=0.4.6; extra == "ios"
+Provides-Extra: build
+Requires-Dist: Pillow>=10.0; extra == "build"
 Provides-Extra: docs
 Requires-Dist: mkdocs>=1.5; extra == "docs"
 Requires-Dist: mkdocs-material[imaging]>=9.5; extra == "docs"
@@ -56,12 +59,14 @@ Requires-Dist: ruff>=0.5; extra == "dev"
 Requires-Dist: mypy>=1.10; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: Pillow>=10.0; extra == "dev"
 Provides-Extra: ci
 Requires-Dist: black>=24.0; extra == "ci"
 Requires-Dist: ruff>=0.5; extra == "ci"
 Requires-Dist: mypy>=1.10; extra == "ci"
 Requires-Dist: pytest>=8.0; extra == "ci"
 Requires-Dist: pytest-asyncio>=0.23; extra == "ci"
+Requires-Dist: Pillow>=10.0; extra == "ci"
 Dynamic: license-file
 
 <p align="center">
@@ -102,7 +107,10 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect`, and navigation with `use_navigation`, all through one consistent pattern.
 - **Typed `style` prop:** Pass all visual and layout properties through a single `style` dict, fully described by the `pn.Style` `TypedDict` and the ergonomic `pn.style(...)` helper for IDE autocomplete and static checking. Compose reusable styles with `StyleSheet`.
 - **Cross-platform flexbox engine:** A pure-Python, Yoga-style layout engine computes frames once and applies them to native views, so `flex`, `padding`, `aspect_ratio`, and `position: "absolute"` produce the same geometry on Android and iOS.
-- **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation. State updates re-render **locally** — only the component whose state changed (and its subtree) re-runs, and unchanged leaves reuse cached intrinsic measurements — so deep UIs stay responsive instead of re-rendering the whole app from the root on every tap.
+- **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation. Each commit lands as **one batched transaction** of mutation ops, and event callbacks are routed through a tag-based registry so re-renders that only change closures cost zero native calls. State updates re-render **locally** — only the component whose state changed (and its subtree) re-runs, and unchanged leaves reuse cached intrinsic measurements — so deep UIs stay responsive instead of re-rendering the whole app from the root on every tap.
+- **Native-driven animations:** The `Animated` API (timing / spring / decay, awaitable or fire-and-forget) hands animations to Core Animation and `ViewPropertyAnimator` whenever possible, so no Python code runs per frame; a pure-Python ticker covers the rest.
+- **Native gesture system:** Attach `Tap`, `LongPress`, `Pan`, `Swipe`, `Pinch`, and `Rotation` recognizers to any view via the `gestures=` prop — backed by `UIGestureRecognizer` on iOS and a unit-testable pure-Python arbiter on Android and desktop.
+- **Virtualized lists:** `FlatList` / `SectionList` window their rows in Python over the platform scroll view — uniform, exact, or measured variable heights, grids, headers/footers, infinite scroll, and an imperative scroll controller, identical on every platform.
 - **Direct native bindings:** Python calls platform APIs directly through Chaquopy and rubicon-objc, with no JavaScript bridge.
 - **Custom-component SDK:** Wrap any platform widget as a first-class element with type-checked props via `pythonnative.sdk` (`Props`, `@native_component`, `element_factory`). Plugins distributed on PyPI auto-register through the `pythonnative.handlers` entry-point group.
 - **CLI scaffolding:** `pn init` creates a ready-to-run project; `pn run android` and `pn run ios` build and launch your app.

{pythonnative-0.20.0 → pythonnative-0.22.0}/README.md

@@ -36,7 +36,10 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **Hooks and function components:** Manage state with `use_state`, side effects with `use_effect`, and navigation with `use_navigation`, all through one consistent pattern.
 - **Typed `style` prop:** Pass all visual and layout properties through a single `style` dict, fully described by the `pn.Style` `TypedDict` and the ergonomic `pn.style(...)` helper for IDE autocomplete and static checking. Compose reusable styles with `StyleSheet`.
 - **Cross-platform flexbox engine:** A pure-Python, Yoga-style layout engine computes frames once and applies them to native views, so `flex`, `padding`, `aspect_ratio`, and `position: "absolute"` produce the same geometry on Android and iOS.
-- **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation. State updates re-render **locally** — only the component whose state changed (and its subtree) re-runs, and unchanged leaves reuse cached intrinsic measurements — so deep UIs stay responsive instead of re-rendering the whole app from the root on every tap.
+- **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation. Each commit lands as **one batched transaction** of mutation ops, and event callbacks are routed through a tag-based registry so re-renders that only change closures cost zero native calls. State updates re-render **locally** — only the component whose state changed (and its subtree) re-runs, and unchanged leaves reuse cached intrinsic measurements — so deep UIs stay responsive instead of re-rendering the whole app from the root on every tap.
+- **Native-driven animations:** The `Animated` API (timing / spring / decay, awaitable or fire-and-forget) hands animations to Core Animation and `ViewPropertyAnimator` whenever possible, so no Python code runs per frame; a pure-Python ticker covers the rest.
+- **Native gesture system:** Attach `Tap`, `LongPress`, `Pan`, `Swipe`, `Pinch`, and `Rotation` recognizers to any view via the `gestures=` prop — backed by `UIGestureRecognizer` on iOS and a unit-testable pure-Python arbiter on Android and desktop.
+- **Virtualized lists:** `FlatList` / `SectionList` window their rows in Python over the platform scroll view — uniform, exact, or measured variable heights, grids, headers/footers, infinite scroll, and an imperative scroll controller, identical on every platform.
 - **Direct native bindings:** Python calls platform APIs directly through Chaquopy and rubicon-objc, with no JavaScript bridge.
 - **Custom-component SDK:** Wrap any platform widget as a first-class element with type-checked props via `pythonnative.sdk` (`Props`, `@native_component`, `element_factory`). Plugins distributed on PyPI auto-register through the `pythonnative.handlers` entry-point group.
 - **CLI scaffolding:** `pn init` creates a ready-to-run project; `pn run android` and `pn run ios` build and launch your app.

{pythonnative-0.20.0 → pythonnative-0.22.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.20.0"
+version = "0.22.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -25,12 +25,16 @@ classifiers = [
 ]
 dependencies = [
   "requests>=2.31.0",
+  "tomli>=2.0; python_version < '3.11'",
 ]
 
 [project.optional-dependencies]
 ios = [
   "rubicon-objc>=0.4.6,<0.5.0",
 ]
+build = [
+  "Pillow>=10.0",
+]
 docs = [
   "mkdocs>=1.5",
   "mkdocs-material[imaging]>=9.5",
@@ -44,6 +48,7 @@ dev = [
   "mypy>=1.10",
   "pytest>=8.0",
   "pytest-asyncio>=0.23",
+  "Pillow>=10.0",
 ]
 ci = [
   "black>=24.0",
@@ -51,6 +56,7 @@ ci = [
   "mypy>=1.10",
   "pytest>=8.0",
   "pytest-asyncio>=0.23",
+  "Pillow>=10.0",
 ]
 
 [project.scripts]
@@ -73,6 +79,8 @@ Documentation = "https://docs.pythonnative.com/"
 
 
 
+
+
 [tool.setuptools.packages.find]
 where = ["src"]
 
@@ -120,6 +128,9 @@ ignore = ["D107", "D105", "D203", "D213"]
 "src/pythonnative/native_views/android.py" = ["D101", "D102"]
 "src/pythonnative/native_views/ios.py" = ["D101", "D102"]
 "src/pythonnative/native_views/desktop.py" = ["D101", "D102"]
+# ios.py embeds a LaunchScreen storyboard as an XML string literal whose
+# lines exceed the limit; the XML must stay on single lines for Xcode.
+"src/pythonnative/project/ios.py" = ["E501"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"

{pythonnative-0.20.0 → pythonnative-0.22.0}/src/pythonnative/__init__.py

@@ -26,7 +26,16 @@ Key building blocks:
   PythonNative ships a fully-typed [`Style`][pythonnative.style.Style]
   TypedDict so editors and ``mypy`` validate every key as you type.
 - **Animations** use the ``Animated`` namespace, modeled on React
-  Native's animation API.
+  Native's animation API. Animations are driven natively (Core
+  Animation / ``ViewPropertyAnimator``) whenever possible.
+- **Gestures** attach to any view via the ``gestures=`` prop using
+  descriptors from ``pythonnative.gestures``
+  ([`Tap`][pythonnative.gestures.Tap],
+  [`LongPress`][pythonnative.gestures.LongPress],
+  [`Pan`][pythonnative.gestures.Pan],
+  [`Swipe`][pythonnative.gestures.Swipe],
+  [`Pinch`][pythonnative.gestures.Pinch],
+  [`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
@@ -51,9 +60,9 @@ Example:
     ```
 """
 
-__version__ = "0.20.0"
+__version__ = "0.22.0"
 
-from . import runtime, sdk
+from . import gestures, runtime, sdk
 from .alerts import Alert
 from .animated import Animated, AnimatedValue, use_animated_value
 from .components import (
@@ -321,6 +330,8 @@ __all__ = [
     "Animated",
     "AnimatedValue",
     "use_animated_value",
+    # Gestures
+    "gestures",
     # Imperative
     "Alert",
     # Native modules