pythonnative 0.11.0__tar.gz → 0.12.0__tar.gz

{pythonnative-0.11.0/src/pythonnative.egg-info → pythonnative-0.12.0}/PKG-INFO

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

{pythonnative-0.11.0 → pythonnative-0.12.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.11.0"
+version = "0.12.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -60,6 +60,7 @@ Repository = "https://github.com/pythonnative/pythonnative"
 Issues = "https://github.com/pythonnative/pythonnative/issues"
 Documentation = "https://docs.pythonnative.com/"
 
+
 [tool.setuptools.packages.find]
 where = ["src"]
 

{pythonnative-0.11.0 → pythonnative-0.12.0}/src/pythonnative/__init__.py

@@ -23,6 +23,8 @@ Key building blocks:
   factories.
 - **Styling** uses a single ``style`` dict per element (or a list of
   dicts), composable via [`StyleSheet`][pythonnative.StyleSheet].
+- **Animations** use the ``Animated`` namespace, modeled on React
+  Native's animation API.
 
 Example:
     ```python
@@ -39,8 +41,10 @@ Example:
     ```
 """
 
-__version__ = "0.11.0"
+__version__ = "0.12.0"
 
+from .alerts import Alert
+from .animated import Animated, AnimatedValue
 from .components import (
     ActivityIndicator,
     Button,
@@ -48,14 +52,19 @@ from .components import (
     ErrorBoundary,
     FlatList,
     Image,
+    KeyboardAvoidingView,
     Modal,
+    Picker,
     Pressable,
     ProgressBar,
+    RefreshControl,
     Row,
     SafeAreaView,
     ScrollView,
+    SectionList,
     Slider,
     Spacer,
+    StatusBar,
     Switch,
     Text,
     TextInput,
@@ -71,12 +80,16 @@ from .hooks import (
     use_callback,
     use_context,
     use_effect,
+    use_keyboard_height,
     use_memo,
     use_navigation,
     use_reducer,
     use_ref,
+    use_safe_area_insets,
     use_state,
+    use_window_dimensions,
 )
+from .native_modules import Camera, FileSystem, Location, Notifications
 from .navigation import (
     NavigationContainer,
     create_drawer_navigator,
@@ -86,6 +99,7 @@ from .navigation import (
     use_route,
 )
 from .page import create_page
+from .platform import Platform
 from .style import StyleSheet, ThemeContext
 
 __all__ = [
@@ -96,14 +110,19 @@ __all__ = [
     "ErrorBoundary",
     "FlatList",
     "Image",
+    "KeyboardAvoidingView",
     "Modal",
+    "Picker",
     "Pressable",
     "ProgressBar",
+    "RefreshControl",
     "Row",
     "SafeAreaView",
     "ScrollView",
+    "SectionList",
     "Slider",
     "Spacer",
+    "StatusBar",
     "Switch",
     "Text",
     "TextInput",
@@ -120,12 +139,15 @@ __all__ = [
     "use_context",
     "use_effect",
     "use_focus_effect",
+    "use_keyboard_height",
     "use_memo",
     "use_navigation",
     "use_reducer",
     "use_ref",
     "use_route",
+    "use_safe_area_insets",
     "use_state",
+    "use_window_dimensions",
     "Provider",
     # Navigation
     "NavigationContainer",
@@ -135,4 +157,16 @@ __all__ = [
     # Styling
     "StyleSheet",
     "ThemeContext",
+    # Animation
+    "Animated",
+    "AnimatedValue",
+    # Imperative
+    "Alert",
+    # Native modules
+    "Camera",
+    "FileSystem",
+    "Location",
+    "Notifications",
+    # Platform
+    "Platform",
 ]

pythonnative-0.12.0/src/pythonnative/alerts.py

@@ -0,0 +1,112 @@
+"""Imperative system alerts.
+
+Modeled on React Native's `Alert.alert()`. Alerts are not part of
+the element tree — they're imperative, fire-and-forget calls that
+trigger a native dialog.
+
+Example:
+    ```python
+    import pythonnative as pn
+
+    def confirm_delete():
+        pn.Alert.show(
+            title="Delete item?",
+            message="This action cannot be undone.",
+            buttons=[
+                {"label": "Cancel", "style": "cancel"},
+                {
+                    "label": "Delete",
+                    "style": "destructive",
+                    "on_press": delete_item,
+                },
+            ],
+        )
+    ```
+"""
+
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, List, Optional
+
+from .platform import Platform
+
+
+class Alert:
+    """Imperative alert / action-sheet helper.
+
+    All methods are static. Use `Alert.show()` for an alert dialog
+    and pass ``style="action_sheet"`` for an iOS-style action sheet.
+    """
+
+    @staticmethod
+    def show(
+        *,
+        title: str,
+        message: Optional[str] = None,
+        buttons: Optional[List[Dict[str, Any]]] = None,
+        style: str = "alert",
+    ) -> None:
+        """Present a native alert dialog or action sheet.
+
+        Args:
+            title: Dialog title (required).
+            message: Optional body text.
+            buttons: Each button is ``{"label": str, "style":
+                "default"|"cancel"|"destructive", "on_press": callable}``.
+                Defaults to a single "OK" button.
+            style: ``"alert"`` (default) or ``"action_sheet"``.
+
+        On iOS this uses ``UIAlertController``; on Android it uses
+        ``AlertDialog.Builder``. On the test backend the call is a
+        no-op so unit tests don't need to mock UIKit/AndroidX.
+        """
+        if Platform.is_ios:
+            try:
+                from .native_views.ios import _present_alert as _ios_present_alert
+
+                _ios_present_alert(title=title, message=message, buttons=buttons or [], style=style)
+            except Exception:
+                pass
+            return
+        if Platform.is_android:
+            try:
+                from .native_views.android import _present_alert as _android_present_alert
+
+                _android_present_alert(title=title, message=message, buttons=buttons or [], style=style)
+            except Exception:
+                pass
+            return
+        # Test environment: record the call so unit tests can assert on it.
+        Alert._test_log.append(
+            {
+                "title": title,
+                "message": message,
+                "buttons": list(buttons or []),
+                "style": style,
+            }
+        )
+
+    @staticmethod
+    def confirm(
+        *,
+        title: str,
+        message: Optional[str] = None,
+        confirm_label: str = "OK",
+        cancel_label: str = "Cancel",
+        on_confirm: Optional[Callable[[], None]] = None,
+        on_cancel: Optional[Callable[[], None]] = None,
+    ) -> None:
+        """Convenience wrapper for two-button confirm/cancel dialogs."""
+        Alert.show(
+            title=title,
+            message=message,
+            buttons=[
+                {"label": cancel_label, "style": "cancel", "on_press": on_cancel},
+                {"label": confirm_label, "style": "default", "on_press": on_confirm},
+            ],
+        )
+
+    #: Records every Alert.show call when running off-device. Tests
+    #: should reset this list between cases via
+    #: ``Alert._test_log.clear()``.
+    _test_log: List[Dict[str, Any]] = []