pythonnative 0.40.0__cp314-cp314-win_amd64.whl

pythonnative/__init__.py

@@ -0,0 +1,411 @@
+"""PythonNative: declarative native UI for Android and iOS.
+
+PythonNative is a cross-platform toolkit that turns Python ``@component``
+functions into real, native Android and iOS views. The component model
+is React-like (function components plus hooks). Python owns the
+component tree, reconciliation, and layout; each commit crosses once
+into a native rendering core (Swift ``PythonNativeKit`` on iOS, the
+Kotlin ``pythonnative`` module on Android) that owns every platform
+view, gesture, animation, and device API. There is no JavaScript.
+
+Key building blocks:
+
+- **Element factories** ([`Text`][pythonnative.Text],
+  [`Button`][pythonnative.Button], [`Column`][pythonnative.Column], etc.)
+  return immutable [`Element`][pythonnative.Element] descriptors.
+- **Hooks** ([`use_state`][pythonnative.use_state],
+  [`use_effect`][pythonnative.use_effect],
+  [`use_reducer`][pythonnative.use_reducer], etc.) manage state, side
+  effects, and context inside `@component` functions.
+- **Navigation** is built from
+  [`NavigationContainer`][pythonnative.NavigationContainer] plus one of
+  the [`create_stack_navigator`][pythonnative.create_stack_navigator],
+  [`create_tab_navigator`][pythonnative.create_tab_navigator], or
+  [`create_drawer_navigator`][pythonnative.create_drawer_navigator]
+  factories.
+- **Styling** uses a single ``style`` dict per element (or a list of
+  dicts), composable via [`StyleSheet`][pythonnative.StyleSheet].
+  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. 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
+  [`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).
+
+Example:
+    ```python
+    import pythonnative as pn
+
+    @pn.component
+    def App():
+        count, set_count = pn.use_state(0)
+        return pn.Column(
+            pn.Text(f"Count: {count}", style=pn.style(font_size=24)),
+            pn.Button("+", on_press=lambda: set_count(count + 1)),
+            style=pn.style(spacing=12),
+        )
+    ```
+"""
+
+
+# start delvewheel patch
+def _delvewheel_patch_1_13_1():
+    import os
+    if os.path.isdir(libs_dir := os.path.abspath(os.path.join(os.path.dirname(__file__), os.pardir, 'pythonnative.libs'))):
+        os.add_dll_directory(libs_dir)
+
+
+_delvewheel_patch_1_13_1()
+del _delvewheel_patch_1_13_1
+# end delvewheel patch
+
+__version__ = "0.40.0"
+
+from . import appearance, diagnostics, gestures, runtime, sdk
+from .alerts import Alert
+from .animated import Animated, AnimatedValue, use_animated_value
+from .component import Component, component, memo
+from .components import (
+    ActivityIndicator,
+    Button,
+    Checkbox,
+    Column,
+    DatePicker,
+    ErrorBoundary,
+    FlatList,
+    Fragment,
+    Image,
+    ImageBackground,
+    KeyboardAvoidingView,
+    ListController,
+    Modal,
+    Picker,
+    Portal,
+    Pressable,
+    ProgressBar,
+    RefreshControl,
+    Row,
+    SafeAreaView,
+    ScrollView,
+    SectionList,
+    SegmentedControl,
+    Slider,
+    Spacer,
+    StatusBar,
+    Suspense,
+    Switch,
+    Text,
+    TextInput,
+    TouchableOpacity,
+    View,
+    WebView,
+)
+from .diagnostics import HookOrderError
+from .element import Element
+from .hooks import (
+    Context,
+    MutationCall,
+    MutationState,
+    QueryResult,
+    Ref,
+    create_context,
+    use_back_handler,
+    use_callback,
+    use_color_scheme,
+    use_context,
+    use_deferred_value,
+    use_effect,
+    use_imperative_handle,
+    use_keyboard_height,
+    use_layout_effect,
+    use_memo,
+    use_mutation,
+    use_query,
+    use_reducer,
+    use_ref,
+    use_resource,
+    use_safe_area_insets,
+    use_state,
+    use_subscription,
+    use_transition,
+    use_window_dimensions,
+)
+from .hosts import create_screen
+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 (
+    LinkingConfig,
+    Navigation,
+    NavigationContainer,
+    NavigationState,
+    Route,
+    ScreenOptions,
+    create_drawer_navigator,
+    create_stack_navigator,
+    create_tab_navigator,
+    use_focus_effect,
+    use_is_focused,
+    use_navigation,
+    use_route,
+)
+from .net import HTTPError, Response, fetch
+from .platform import Platform, get_platform
+from .runtime import run_async, run_blocking
+from .scheduler import batch_updates
+from .sdk import (
+    Props,
+    ViewHandler,
+    element_factory,
+    native_component,
+    register_component,
+)
+from .storage import AsyncStorage, use_persisted_state
+from .style import (
+    DEFAULT_DARK_THEME,
+    DEFAULT_LIGHT_THEME,
+    AccessibilityState,
+    AlignContent,
+    AlignItems,
+    AlignSelf,
+    AutoCapitalize,
+    Color,
+    Dimension,
+    Display,
+    EdgeInsets,
+    FlexDirection,
+    FlexWrap,
+    FontWeight,
+    JustifyContent,
+    KeyboardType,
+    LayoutDirection,
+    Overflow,
+    PointerEvents,
+    Position,
+    ReturnKeyType,
+    ScaleType,
+    ShadowOffset,
+    Style,
+    StyleProp,
+    StyleSheet,
+    TextAlign,
+    TextDecoration,
+    TextTransform,
+    Theme,
+    ThemeContext,
+    TransformSpec,
+    default_theme,
+    resolve_style,
+    style,
+    use_theme,
+)
+from .suspense import Resource, lazy, start_resource
+
+__all__ = [
+    # Components
+    "ActivityIndicator",
+    "Button",
+    "Checkbox",
+    "Column",
+    "DatePicker",
+    "ErrorBoundary",
+    "FlatList",
+    "Fragment",
+    "Image",
+    "ImageBackground",
+    "KeyboardAvoidingView",
+    "ListController",
+    "Modal",
+    "Picker",
+    "Portal",
+    "Pressable",
+    "ProgressBar",
+    "RefreshControl",
+    "Row",
+    "SafeAreaView",
+    "ScrollView",
+    "SectionList",
+    "SegmentedControl",
+    "Slider",
+    "Spacer",
+    "StatusBar",
+    "Suspense",
+    "Switch",
+    "Text",
+    "TextInput",
+    "TouchableOpacity",
+    "View",
+    "WebView",
+    # Core
+    "Component",
+    "Element",
+    "component",
+    "create_screen",
+    "memo",
+    # Hooks
+    "Context",
+    "MutationCall",
+    "MutationState",
+    "QueryResult",
+    "Ref",
+    "batch_updates",
+    "create_context",
+    "use_back_handler",
+    "use_callback",
+    "use_color_scheme",
+    "use_context",
+    "use_deferred_value",
+    "use_effect",
+    "use_imperative_handle",
+    "use_keyboard_height",
+    "use_layout_effect",
+    "use_memo",
+    "use_mutation",
+    "use_persisted_state",
+    "use_query",
+    "use_reducer",
+    "use_ref",
+    "use_resource",
+    "use_safe_area_insets",
+    "use_state",
+    "use_subscription",
+    "use_transition",
+    "use_window_dimensions",
+    # Suspense and async rendering
+    "Resource",
+    "lazy",
+    "start_resource",
+    # Navigation
+    "LinkingConfig",
+    "Navigation",
+    "NavigationContainer",
+    "NavigationState",
+    "Route",
+    "ScreenOptions",
+    "create_drawer_navigator",
+    "create_stack_navigator",
+    "create_tab_navigator",
+    "use_focus_effect",
+    "use_is_focused",
+    "use_navigation",
+    "use_route",
+    # Styling - typed primitives
+    "AccessibilityState",
+    "AlignContent",
+    "AlignItems",
+    "AlignSelf",
+    "AutoCapitalize",
+    "Color",
+    "DEFAULT_DARK_THEME",
+    "DEFAULT_LIGHT_THEME",
+    "Dimension",
+    "Display",
+    "EdgeInsets",
+    "FlexDirection",
+    "FlexWrap",
+    "FontWeight",
+    "JustifyContent",
+    "KeyboardType",
+    "LayoutDirection",
+    "Overflow",
+    "PointerEvents",
+    "Position",
+    "ReturnKeyType",
+    "ScaleType",
+    "ShadowOffset",
+    "Style",
+    "StyleProp",
+    "StyleSheet",
+    "TextAlign",
+    "TextDecoration",
+    "TextTransform",
+    "Theme",
+    "ThemeContext",
+    "TransformSpec",
+    "default_theme",
+    "resolve_style",
+    "style",
+    "use_theme",
+    # Appearance
+    "appearance",
+    # Image pipeline
+    # Animation
+    "Animated",
+    "AnimatedValue",
+    "use_animated_value",
+    # Gestures
+    "gestures",
+    # 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",
+    "HTTPError",
+    "Response",
+    # Runtime
+    "run_async",
+    "run_blocking",
+    "runtime",
+    # Diagnostics
+    "HookOrderError",
+    "diagnostics",
+    # Platform
+    "Platform",
+    "get_platform",
+    # Custom-component SDK
+    "Props",
+    "ViewHandler",
+    "element_factory",
+    "native_component",
+    "register_component",
+    "sdk",
+]

pythonnative/_ios_log.py

@@ -0,0 +1,92 @@
+"""Route Python `sys.stdout`/`sys.stderr` through fd 2 on iOS.
+
+When an app is launched via `xcrun simctl launch --console-pty`
+(what `pn run ios` does), the simulator attaches the caller's
+terminal to the app's stderr, which is the same channel `NSLog` and
+`os_log` write to. Python `print()` calls, however, go to
+`sys.stdout` (fd 1), and for reasons specific to how CPython's
+embedded framework is started on the iOS Simulator that descriptor
+does not reach the attached console. As a result, users see
+Swift-side `NSLog` output but never their own `print()` output.
+
+Redirecting `sys.stdout` and `sys.stderr` at a Python level to write
+straight to fd 2 is a small, reliable fix: fd 2 *is* visible to
+`simctl` (that is exactly how `NSLog` reaches the terminal), so
+Python output lands next to the Swift logs with correct ordering.
+
+This module is intentionally self-contained (no bridge or
+platform-specific C bindings required), so it is safe to import
+early during `pythonnative` package initialization.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import Iterable
+
+_STDERR_FD = 2
+
+
+class _StderrStream:
+    """Minimal text-mode file-like that writes UTF-8 bytes to fd 2.
+
+    Write-through (no buffering), so a `print()` call appears in the
+    terminal immediately. That matches user expectations for an
+    interactive "run on simulator" log stream.
+    """
+
+    encoding = "utf-8"
+    errors = "replace"
+    mode = "w"
+    name = "<stderr>"
+
+    def write(self, s: str) -> int:
+        if not s:
+            return 0
+        data = s.encode(self.encoding, self.errors)
+        try:
+            return os.write(_STDERR_FD, data)
+        except OSError:
+            return 0
+
+    def writelines(self, lines: Iterable[str]) -> None:
+        for line in lines:
+            self.write(line)
+
+    def flush(self) -> None:
+        # os.write is unbuffered; nothing to flush.
+        return None
+
+    def isatty(self) -> bool:
+        try:
+            return os.isatty(_STDERR_FD)
+        except OSError:
+            return False
+
+    def fileno(self) -> int:
+        return _STDERR_FD
+
+    def close(self) -> None:
+        # Don't actually close fd 2.
+        return None
+
+    @property
+    def closed(self) -> bool:
+        return False
+
+
+_installed = False
+
+
+def install() -> None:
+    """Swap `sys.stdout` and `sys.stderr` for fd-2 writers.
+
+    Idempotent: only the first call has effect.
+    """
+    global _installed
+    if _installed:
+        return
+    sys.stdout = _StderrStream()
+    sys.stderr = _StderrStream()
+    _installed = True