pythonnative 0.17.1__tar.gz → 0.19.0__tar.gz

{pythonnative-0.17.1/src/pythonnative.egg-info → pythonnative-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonnative
-Version: 0.17.1
+Version: 0.19.0
 Summary: Cross-platform native UI toolkit for Android and iOS
 Author: Owen Carey
 License: MIT License
@@ -97,6 +97,8 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 ## Features
 
 - **Declarative UI:** Describe *what* your UI should look like with element functions (`Text`, `Button`, `Column`, `Row`, etc.). PythonNative creates and updates native views automatically.
+- **Rich component library:** 25+ built-in components backed by real native widgets — `TextInput`, `Image` / `ImageBackground`, `ScrollView`, `FlatList` / `SectionList`, `Modal`, `Pressable` / `TouchableOpacity`, `Switch` / `Checkbox`, `Slider`, `SegmentedControl`, `Picker`, `DatePicker`, `ProgressBar` / `ActivityIndicator`, `WebView`, and more.
+- **Device APIs:** Cross-platform modules for `Camera`, `Location`, `FileSystem`, `Notifications`, `Clipboard`, `Share`, `Linking`, `Permissions`, `AppState`, `NetInfo`, `SecureStore`, `Battery`, `Haptics` / `Vibration`, and `Biometrics` — plus reactive `use_app_state` and `use_net_info` hooks.
 - **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.
@@ -104,6 +106,7 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **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.
+- **Instant desktop preview:** `pn preview` renders your app in a native desktop window via Tkinter with Fast Refresh on every save — iterate on layout, state, and navigation in milliseconds without booting a simulator or device. The reconciler, hooks, layout engine, and navigation are the same code that ships to the phone.
 - **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.

{pythonnative-0.17.1 → pythonnative-0.19.0}/README.md

@@ -31,6 +31,8 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 ## Features
 
 - **Declarative UI:** Describe *what* your UI should look like with element functions (`Text`, `Button`, `Column`, `Row`, etc.). PythonNative creates and updates native views automatically.
+- **Rich component library:** 25+ built-in components backed by real native widgets — `TextInput`, `Image` / `ImageBackground`, `ScrollView`, `FlatList` / `SectionList`, `Modal`, `Pressable` / `TouchableOpacity`, `Switch` / `Checkbox`, `Slider`, `SegmentedControl`, `Picker`, `DatePicker`, `ProgressBar` / `ActivityIndicator`, `WebView`, and more.
+- **Device APIs:** Cross-platform modules for `Camera`, `Location`, `FileSystem`, `Notifications`, `Clipboard`, `Share`, `Linking`, `Permissions`, `AppState`, `NetInfo`, `SecureStore`, `Battery`, `Haptics` / `Vibration`, and `Biometrics` — plus reactive `use_app_state` and `use_net_info` hooks.
 - **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.
@@ -38,6 +40,7 @@ PythonNative is a cross-platform toolkit for building native Android and iOS app
 - **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.
+- **Instant desktop preview:** `pn preview` renders your app in a native desktop window via Tkinter with Fast Refresh on every save — iterate on layout, state, and navigation in milliseconds without booting a simulator or device. The reconciler, hooks, layout engine, and navigation are the same code that ships to the phone.
 - **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.

{pythonnative-0.17.1 → pythonnative-0.19.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.17.1"
+version = "0.19.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -70,6 +70,8 @@ Documentation = "https://docs.pythonnative.com/"
 
 
 
+
+
 [tool.setuptools.packages.find]
 where = ["src"]
 
@@ -116,6 +118,7 @@ ignore = ["D107", "D105", "D203", "D213"]
 # docstrings would only add boilerplate that repeats the ABC.
 "src/pythonnative/native_views/android.py" = ["D101", "D102"]
 "src/pythonnative/native_views/ios.py" = ["D101", "D102"]
+"src/pythonnative/native_views/desktop.py" = ["D101", "D102"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"

{pythonnative-0.17.1 → pythonnative-0.19.0}/src/pythonnative/__init__.py

@@ -51,7 +51,7 @@ Example:
     ```
 """
 
-__version__ = "0.17.1"
+__version__ = "0.19.0"
 
 from . import runtime, sdk
 from .alerts import Alert
@@ -61,11 +61,17 @@ from .components import (
     ActivityIndicatorProps,
     Button,
     ButtonProps,
+    Checkbox,
+    CheckboxProps,
     Column,
+    DatePicker,
+    DatePickerProps,
     ErrorBoundary,
     FlatList,
     Fragment,
     Image,
+    ImageBackground,
+    ImageBackgroundProps,
     ImageProps,
     KeyboardAvoidingView,
     KeyboardAvoidingViewProps,
@@ -84,6 +90,8 @@ from .components import (
     ScrollView,
     ScrollViewProps,
     SectionList,
+    SegmentedControl,
+    SegmentedControlProps,
     Slider,
     SliderProps,
     Spacer,
@@ -96,6 +104,8 @@ from .components import (
     TextInput,
     TextInputProps,
     TextProps,
+    TouchableOpacity,
+    TouchableOpacityProps,
     View,
     ViewProps,
     WebView,
@@ -126,7 +136,25 @@ from .hooks import (
     use_state,
     use_window_dimensions,
 )
-from .native_modules import Camera, FileSystem, Location, Notifications
+from .native_modules import (
+    AppState,
+    Battery,
+    Biometrics,
+    Camera,
+    Clipboard,
+    FileSystem,
+    Haptics,
+    Linking,
+    Location,
+    NetInfo,
+    Notifications,
+    Permissions,
+    SecureStore,
+    Share,
+    Vibration,
+    use_app_state,
+    use_net_info,
+)
 from .navigation import (
     NavigationContainer,
     create_drawer_navigator,
@@ -178,11 +206,14 @@ __all__ = [
     # Components
     "ActivityIndicator",
     "Button",
+    "Checkbox",
     "Column",
+    "DatePicker",
     "ErrorBoundary",
     "FlatList",
     "Fragment",
     "Image",
+    "ImageBackground",
     "KeyboardAvoidingView",
     "Modal",
     "Picker",
@@ -193,17 +224,22 @@ __all__ = [
     "SafeAreaView",
     "ScrollView",
     "SectionList",
+    "SegmentedControl",
     "Slider",
     "Spacer",
     "StatusBar",
     "Switch",
     "Text",
     "TextInput",
+    "TouchableOpacity",
     "View",
     "WebView",
     # Built-in Props dataclasses
     "ActivityIndicatorProps",
     "ButtonProps",
+    "CheckboxProps",
+    "DatePickerProps",
+    "ImageBackgroundProps",
     "ImageProps",
     "KeyboardAvoidingViewProps",
     "ModalProps",
@@ -212,12 +248,14 @@ __all__ = [
     "ProgressBarProps",
     "SafeAreaViewProps",
     "ScrollViewProps",
+    "SegmentedControlProps",
     "SliderProps",
     "SpacerProps",
     "StatusBarProps",
     "SwitchProps",
     "TextInputProps",
     "TextProps",
+    "TouchableOpacityProps",
     "ViewProps",
     "WebViewProps",
     # Core
@@ -286,10 +324,23 @@ __all__ = [
     # Imperative
     "Alert",
     # Native modules
+    "AppState",
+    "Battery",
+    "Biometrics",
     "Camera",
+    "Clipboard",
     "FileSystem",
+    "Haptics",
+    "Linking",
     "Location",
+    "NetInfo",
     "Notifications",
+    "Permissions",
+    "SecureStore",
+    "Share",
+    "Vibration",
+    "use_app_state",
+    "use_net_info",
     # Networking + persistence
     "AsyncStorage",
     "fetch",

{pythonnative-0.17.1 → pythonnative-0.19.0}/src/pythonnative/cli/pn.py

@@ -1,9 +1,12 @@
 """`pn` CLI: scaffold, run, and clean PythonNative projects.
 
 The console script `pn` (declared in `pyproject.toml` under
-`[project.scripts]`) dispatches to one of three subcommands:
+`[project.scripts]`) dispatches to one of four subcommands:
 
 - `pn init [name]`: scaffold a new project in the current directory.
+- `pn preview [component]`: render the app in a desktop (Tkinter)
+  window with instant Fast Refresh — the fast inner dev loop, no
+  device or simulator required.
 - `pn run android|ios`: stage code into a native template, build it,
   install it, and stream logs back to the terminal.
 - `pn clean`: remove the local `build/` directory.
@@ -1119,6 +1122,90 @@ def _run_hot_reload(platform: str, project_dir: str, build_dir: str, show_logs:
         print("\n[hot-reload] Stopped.")
 
 
+def _entrypoint_to_module(entry_point: str) -> str:
+    """Convert a config ``entryPoint`` path into an importable module path.
+
+    ``"app/main.py"`` → ``"app.main"``. Returns ``"app.main"`` for
+    empty / unusable input so ``pn preview`` always has a sane default.
+    """
+    normalized = entry_point.strip().replace("\\", "/")
+    if normalized.endswith(".py"):
+        normalized = normalized[:-3]
+    normalized = normalized.strip("/").replace("/", ".")
+    return normalized or "app.main"
+
+
+def preview_project(args: argparse.Namespace) -> None:
+    """Render the project in a desktop preview window (Tkinter).
+
+    Sets ``PN_PLATFORM=desktop`` (so PythonNative selects the Tkinter
+    backend) and hands off to ``pythonnative.preview.run_preview``,
+    which opens a window, mounts the app, and Fast Refreshes on every
+    file save until the window is closed.
+
+    Args:
+        args: Parsed argparse namespace. Recognized attributes:
+
+            - `component` (`str`, optional): Module path like
+              ``"app.main"`` (its ``App`` is used) or a dotted
+              ``module.Component`` path. Defaults to the project's
+              configured ``entryPoint``.
+            - `width` / `height` (`int`): Initial window size in points.
+            - `title` (`str`): Window title.
+            - `no_hot_reload` (`bool`): Disable file watching.
+    """
+    # The desktop backend is selected at *import time* from the
+    # ``PN_PLATFORM`` environment variable (see ``pythonnative.utils`` and
+    # the host selection in ``pythonnative.screen``). Because the ``pn``
+    # console entry point lives inside the ``pythonnative`` package,
+    # importing it already loaded the package under the default,
+    # non-desktop platform before this handler ever runs. Re-exec a fresh
+    # interpreter with the variable set so every module binds to the
+    # Tkinter backend; the re-execed child sees ``PN_PLATFORM=desktop`` and
+    # skips this branch, so there is no exec loop.
+    if os.environ.get("PN_PLATFORM") != "desktop":
+        try:
+            completed = subprocess.run(
+                [sys.executable, "-m", "pythonnative.cli.pn", *sys.argv[1:]],
+                env={**os.environ, "PN_PLATFORM": "desktop"},
+            )
+        except KeyboardInterrupt:
+            sys.exit(130)
+        sys.exit(completed.returncode)
+
+    project_dir = os.getcwd()
+    component: Optional[str] = getattr(args, "component", None)
+    if not component:
+        config = _read_project_config()
+        component = _entrypoint_to_module(config.get("entryPoint", "app/main.py"))
+
+    try:
+        from pythonnative.preview import run_preview
+    except Exception as exc:  # pragma: no cover - environment dependent
+        print(f"Error: could not start the desktop preview: {exc}")
+        print(
+            "The desktop preview needs Tkinter (Python's standard GUI toolkit).\n"
+            "On macOS:        brew install python-tk\n"
+            "On Debian/Ubuntu: sudo apt-get install python3-tk\n"
+            "On Windows:      reinstall Python with the 'tcl/tk' option checked."
+        )
+        sys.exit(1)
+
+    print(f"Starting PythonNative preview for {component} (Ctrl+C or close the window to stop).")
+    try:
+        run_preview(
+            component,
+            project_root=project_dir,
+            width=getattr(args, "width", 390),
+            height=getattr(args, "height", 844),
+            title=getattr(args, "title", "PythonNative Preview"),
+            hot_reload=not getattr(args, "no_hot_reload", False),
+        )
+    except RuntimeError as exc:
+        print(f"Error: {exc}")
+        sys.exit(1)
+
+
 def clean_project(args: argparse.Namespace) -> None:
     """Remove the local `build/` directory.
 
@@ -1152,6 +1239,25 @@ def main() -> None:
     parser_init.add_argument("--force", action="store_true", help="Overwrite existing files if present")
     parser_init.set_defaults(func=init_project)
 
+    # Create a new command 'preview' that calls preview_project
+    parser_preview = subparsers.add_parser("preview")
+    parser_preview.add_argument(
+        "component",
+        nargs="?",
+        help="Module path (e.g. app.main) or dotted component path; defaults to the project entry point",
+    )
+    parser_preview.add_argument("--width", type=int, default=390, help="Initial window width in points (default: 390)")
+    parser_preview.add_argument(
+        "--height", type=int, default=844, help="Initial window height in points (default: 844)"
+    )
+    parser_preview.add_argument("--title", default="PythonNative Preview", help="Preview window title")
+    parser_preview.add_argument(
+        "--no-hot-reload",
+        action="store_true",
+        help="Disable file watching / Fast Refresh",
+    )
+    parser_preview.set_defaults(func=preview_project)
+
     # Create a new command 'run' that calls run_project
     parser_run = subparsers.add_parser("run")
     parser_run.add_argument("platform", choices=["android", "ios"])