pythonnative 0.12.0__tar.gz → 0.13.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.12.0
+Version: 0.13.1
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -101,7 +101,8 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation.
 - **Direct native bindings:** Python calls platform APIs directly through Chaquopy and rubicon-objc, with no JavaScript bridge.
 - **CLI scaffolding:** `pn init` creates a ready-to-run project; `pn run android` and `pn run ios` build and launch your app.
-- **Navigation:** Push and pop screens with argument passing via the `use_navigation()` hook.
+- **Native-backed navigation:** Declarative `Stack`, `Tab`, and `Drawer` navigators inspired by React Navigation. The root stack drives the platform's native navigation controller (`UINavigationController` on iOS, AndroidX Navigation Component on Android), so transitions, back gestures, and the hardware back button match what users expect.
+- **Fast Refresh hot reload:** `pn run --hot-reload` watches `app/` and patches edits into the running app on save, preserving component state across most changes.
 - **Bundled templates:** Android Gradle and iOS Xcode templates are included, so scaffolding requires no network access.
 
 ## Quick Start
@@ -119,7 +120,7 @@ import pythonnative as pn
 
 
 @pn.component
-def MainPage():
+def App():
     count, set_count = pn.use_state(0)
     return pn.Column(
         pn.Text(f"Count: {count}", style={"font_size": 24}),

{pythonnative-0.12.0 → pythonnative-0.13.1}/README.md

@@ -37,7 +37,8 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **Virtual view tree + reconciler:** Element trees are diffed and patched with minimal native mutations, similar to React's reconciliation.
 - **Direct native bindings:** Python calls platform APIs directly through Chaquopy and rubicon-objc, with no JavaScript bridge.
 - **CLI scaffolding:** `pn init` creates a ready-to-run project; `pn run android` and `pn run ios` build and launch your app.
-- **Navigation:** Push and pop screens with argument passing via the `use_navigation()` hook.
+- **Native-backed navigation:** Declarative `Stack`, `Tab`, and `Drawer` navigators inspired by React Navigation. The root stack drives the platform's native navigation controller (`UINavigationController` on iOS, AndroidX Navigation Component on Android), so transitions, back gestures, and the hardware back button match what users expect.
+- **Fast Refresh hot reload:** `pn run --hot-reload` watches `app/` and patches edits into the running app on save, preserving component state across most changes.
 - **Bundled templates:** Android Gradle and iOS Xcode templates are included, so scaffolding requires no network access.
 
 ## Quick Start
@@ -55,7 +56,7 @@ import pythonnative as pn
 
 
 @pn.component
-def MainPage():
+def App():
     count, set_count = pn.use_state(0)
     return pn.Column(
         pn.Text(f"Count: {count}", style={"font_size": 24}),

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

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

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

@@ -41,7 +41,7 @@ Example:
     ```
 """
 
-__version__ = "0.12.0"
+__version__ = "0.13.1"
 
 from .alerts import Alert
 from .animated import Animated, AnimatedValue
@@ -98,8 +98,8 @@ from .navigation import (
     use_focus_effect,
     use_route,
 )
-from .page import create_page
 from .platform import Platform
+from .screen import create_screen
 from .style import StyleSheet, ThemeContext
 
 __all__ = [
@@ -130,7 +130,7 @@ __all__ = [
     "WebView",
     # Core
     "Element",
-    "create_page",
+    "create_screen",
     # Hooks
     "batch_updates",
     "component",

{pythonnative-0.12.0 → pythonnative-0.13.1}/src/pythonnative/cli/pn.py

@@ -32,9 +32,9 @@ from typing import Any, Dict, List, Optional
 def init_project(args: argparse.Namespace) -> None:
     """Scaffold a new PythonNative project in the current directory.
 
-    Creates `app/main_page.py`, `pythonnative.json`,
-    `requirements.txt`, and `.gitignore`. Refuses to overwrite
-    existing files unless `--force` is passed.
+    Creates `app/main.py`, `pythonnative.json`, `requirements.txt`,
+    and `.gitignore`. Refuses to overwrite existing files unless
+    `--force` is passed.
 
     Args:
         args: The parsed argparse namespace. Recognized attributes:
@@ -68,30 +68,55 @@ def init_project(args: argparse.Namespace) -> None:
 
     os.makedirs(app_dir, exist_ok=True)
 
-    main_page_py = os.path.join(app_dir, "main_page.py")
-    if not os.path.exists(main_page_py) or args.force:
-        with open(main_page_py, "w", encoding="utf-8") as f:
+    main_py = os.path.join(app_dir, "main.py")
+    if not os.path.exists(main_py) or args.force:
+        with open(main_py, "w", encoding="utf-8") as f:
             f.write("""import pythonnative as pn
 
+Stack = pn.create_stack_navigator()
+
 
 @pn.component
-def MainPage():
+def HomeScreen():
     count, set_count = pn.use_state(0)
+    nav = pn.use_navigation()
     return pn.ScrollView(
         pn.Column(
             pn.Text("Hello from PythonNative!", style={"font_size": 24, "bold": True}),
             pn.Text(f"Tapped {count} times"),
             pn.Button("Tap me", on_click=lambda: set_count(count + 1)),
+            pn.Button("Open detail", on_click=lambda: nav.navigate("Detail", {"count": count})),
             style={"spacing": 12, "padding": 16, "align_items": "stretch"},
         )
     )
+
+
+@pn.component
+def DetailScreen():
+    nav = pn.use_navigation()
+    params = pn.use_route()
+    return pn.Column(
+        pn.Text(f"Detail: count was {params.get('count', 0)}", style={"font_size": 20}),
+        pn.Button("Back", on_click=nav.go_back),
+        style={"spacing": 12, "padding": 16},
+    )
+
+
+@pn.component
+def App():
+    return pn.NavigationContainer(
+        Stack.Navigator(
+            Stack.Screen("Home", component=HomeScreen, options={"title": "Home"}),
+            Stack.Screen("Detail", component=DetailScreen, options={"title": "Detail"}),
+        )
+    )
 """)
 
     # Create config
     config = {
         "name": project_name,
         "appId": "com.example." + project_name.replace(" ", "").lower(),
-        "entryPoint": "app/main_page.py",
+        "entryPoint": "app/main.py",
         "pythonVersion": "3.11",
         "ios": {},
         "android": {},
@@ -319,7 +344,7 @@ ANDROID_LOGCAT_FILTERS: list[str] = [
     "python.stdout:V",
     "python.stderr:V",
     "MainActivity:V",
-    "PageFragment:V",
+    "ScreenFragment:V",
     "Navigator:V",
     "PythonNative:V",
     "AndroidRuntime:E",

{pythonnative-0.12.0 → pythonnative-0.13.1}/src/pythonnative/hooks.py

@@ -511,13 +511,13 @@ def use_window_dimensions() -> Dict[str, float]:
     """Return the current viewport size and re-render when it changes.
 
     Equivalent to React Native's ``useWindowDimensions``. The values
-    are pushed by the page host whenever the platform reports a new
+    are pushed by the screen host whenever the platform reports a new
     size (initial layout, rotation, multitasking split-view).
 
     Returns:
         A dict with ``"width"`` and ``"height"`` floats in layout
         units (pt on iOS, dp on Android). Both are ``0.0`` until the
-        page host has run its first layout pass.
+        screen host has run its first layout pass.
 
     Raises:
         RuntimeError: If called outside a `@component` function.
@@ -717,8 +717,13 @@ _NavigationContext: Context = create_context(None)
 class NavigationHandle:
     """Handle returned by [`use_navigation`][pythonnative.use_navigation].
 
-    Wraps the host's push/pop primitives so screens can navigate without
-    knowing the underlying native navigation stack.
+    Wraps the host's push/pop primitives so screens can navigate
+    without knowing the underlying native navigation stack. The
+    typical user-facing surface is the declarative handle returned by
+    a [`Stack`][pythonnative.create_stack_navigator] — this class is
+    the lower-level fallback used when no navigator is rendered (and
+    as the bridge that declarative navigators delegate to when they
+    need to push real native screens).
 
     Example:
         ```python
@@ -729,7 +734,7 @@ class NavigationHandle:
             nav = pn.use_navigation()
             return pn.Button(
                 "Open Detail",
-                on_click=lambda: nav.navigate(DetailScreen, params={"id": 42}),
+                on_click=lambda: nav.navigate("Detail", {"id": 42}),
             )
         ```
     """
@@ -737,16 +742,20 @@ class NavigationHandle:
     def __init__(self, host: Any) -> None:
         self._host = host
 
-    def navigate(self, page: Any, params: Optional[Dict[str, Any]] = None) -> None:
-        """Push `page` onto the navigation stack.
+    def navigate(self, component: Any, params: Optional[Dict[str, Any]] = None) -> None:
+        """Push ``component`` onto the navigation stack.
 
         Args:
-            page: Either a `@component` function or a dotted Python
-                path (e.g., `"app.detail.DetailScreen"`).
+            component: A ``@component`` function or a dotted Python
+                path (e.g. ``"app.detail.DetailScreen"``). When a
+                Stack navigator is the root of the app, prefer the
+                declarative ``nav.navigate("Detail", params)`` form
+                returned by ``use_navigation()`` (it pushes by route
+                name and the host re-uses its own ``App`` component).
             params: Optional dict of arguments serialized into the
                 target screen.
         """
-        self._host._push(page, params)
+        self._host._push(component, params)
 
     def go_back(self) -> None:
         """Pop the current screen and return to the previous one."""
@@ -771,13 +780,13 @@ def use_navigation() -> NavigationHandle:
 
     Raises:
         RuntimeError: If called outside a component rendered via
-            [`create_page`][pythonnative.create_page].
+            [`create_screen`][pythonnative.create_screen].
     """
     handle = use_context(_NavigationContext)
     if handle is None:
         raise RuntimeError(
-            "use_navigation() called outside a PythonNative page. "
-            "Ensure your component is rendered via create_page()."
+            "use_navigation() called outside a PythonNative screen. "
+            "Ensure your component is rendered via create_screen()."
         )
     return handle