pythonnative 0.7.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

pythonnative/native_views/base.py

@@ -0,0 +1,150 @@
+"""Shared base classes and utilities for native view handlers.
+
+Provides the :class:`ViewHandler` abstract base class and common helper
+functions used by both Android and iOS platform implementations.
+"""
+
+from typing import Any, Dict, Union
+
+
+class ViewHandler:
+    """Protocol for creating, updating, and managing children of a native view type."""
+
+    def create(self, props: Dict[str, Any]) -> Any:
+        raise NotImplementedError
+
+    def update(self, native_view: Any, changed_props: Dict[str, Any]) -> None:
+        raise NotImplementedError
+
+    def add_child(self, parent: Any, child: Any) -> None:
+        pass
+
+    def remove_child(self, parent: Any, child: Any) -> None:
+        pass
+
+    def insert_child(self, parent: Any, child: Any, index: int) -> None:
+        self.add_child(parent, child)
+
+
+# ======================================================================
+# Color parsing
+# ======================================================================
+
+
+def parse_color_int(color: Union[str, int]) -> int:
+    """Parse ``#RRGGBB`` / ``#AARRGGBB`` hex string or raw int to a *signed* ARGB int.
+
+    Java's ``setBackgroundColor`` et al. expect a signed 32-bit int, so values
+    with a high alpha byte (e.g. 0xFF…) must be converted to negative ints.
+    """
+    if isinstance(color, int):
+        val = color
+    else:
+        c = color.strip().lstrip("#")
+        if len(c) == 6:
+            c = "FF" + c
+        val = int(c, 16)
+    if val > 0x7FFFFFFF:
+        val -= 0x100000000
+    return val
+
+
+# ======================================================================
+# Padding / margin helpers
+# ======================================================================
+
+
+def resolve_padding(padding: Any) -> tuple:
+    """Normalise various padding representations to ``(left, top, right, bottom)``."""
+    if padding is None:
+        return (0, 0, 0, 0)
+    if isinstance(padding, (int, float)):
+        v = int(padding)
+        return (v, v, v, v)
+    if isinstance(padding, dict):
+        h = int(padding.get("horizontal", 0))
+        v = int(padding.get("vertical", 0))
+        left = int(padding.get("left", h))
+        right = int(padding.get("right", h))
+        top = int(padding.get("top", v))
+        bottom = int(padding.get("bottom", v))
+        a = int(padding.get("all", 0))
+        if a:
+            left = left or a
+            right = right or a
+            top = top or a
+            bottom = bottom or a
+        return (left, top, right, bottom)
+    return (0, 0, 0, 0)
+
+
+# ======================================================================
+# Flex layout constants
+# ======================================================================
+
+FLEX_DIRECTION_COLUMN = "column"
+FLEX_DIRECTION_ROW = "row"
+FLEX_DIRECTION_COLUMN_REVERSE = "column_reverse"
+FLEX_DIRECTION_ROW_REVERSE = "row_reverse"
+
+JUSTIFY_FLEX_START = "flex_start"
+JUSTIFY_CENTER = "center"
+JUSTIFY_FLEX_END = "flex_end"
+JUSTIFY_SPACE_BETWEEN = "space_between"
+JUSTIFY_SPACE_AROUND = "space_around"
+JUSTIFY_SPACE_EVENLY = "space_evenly"
+
+ALIGN_STRETCH = "stretch"
+ALIGN_FLEX_START = "flex_start"
+ALIGN_CENTER = "center"
+ALIGN_FLEX_END = "flex_end"
+
+POSITION_RELATIVE = "relative"
+POSITION_ABSOLUTE = "absolute"
+
+OVERFLOW_VISIBLE = "visible"
+OVERFLOW_HIDDEN = "hidden"
+OVERFLOW_SCROLL = "scroll"
+
+
+def is_vertical(direction: str) -> bool:
+    """Return ``True`` if *direction* represents a vertical (column) axis."""
+    return direction in (FLEX_DIRECTION_COLUMN, FLEX_DIRECTION_COLUMN_REVERSE)
+
+
+# ======================================================================
+# Layout property keys
+# ======================================================================
+
+LAYOUT_KEYS = frozenset(
+    {
+        "width",
+        "height",
+        "flex",
+        "flex_grow",
+        "flex_shrink",
+        "margin",
+        "min_width",
+        "max_width",
+        "min_height",
+        "max_height",
+        "align_self",
+        "position",
+        "top",
+        "right",
+        "bottom",
+        "left",
+    }
+)
+
+CONTAINER_KEYS = frozenset(
+    {
+        "flex_direction",
+        "justify_content",
+        "align_items",
+        "overflow",
+        "spacing",
+        "padding",
+        "background_color",
+    }
+)