pythonnative 0.3.0__tar.gz → 0.5.0__tar.gz

{pythonnative-0.3.0 → pythonnative-0.5.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 PythonNative
+Copyright (c) 2026 Owen Carey
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

pythonnative-0.5.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: pythonnative
+Version: 0.5.0
+Summary: Cross-platform native UI toolkit for Android and iOS
+Author: Owen Carey
+License: MIT License
+        
+        Copyright (c) 2026 Owen Carey
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in
+        all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+        THE SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/pythonnative/pythonnative
+Project-URL: Repository, https://github.com/pythonnative/pythonnative
+Project-URL: Issues, https://github.com/pythonnative/pythonnative/issues
+Project-URL: Documentation, https://docs.pythonnative.com/
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Provides-Extra: ios
+Requires-Dist: rubicon-objc<0.5.0,>=0.4.6; extra == "ios"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocs-material[imaging]>=9.5; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Provides-Extra: ci
+Requires-Dist: black>=24.0; extra == "ci"
+Requires-Dist: ruff>=0.5; extra == "ci"
+Requires-Dist: mypy>=1.10; extra == "ci"
+Requires-Dist: pytest>=8.0; extra == "ci"
+Dynamic: license-file
+
+<p align="center">
+  <img src="docs/assets/banner.jpg" alt="PythonNative" width="800" />
+</p>
+
+<p align="center">
+  <em>Build native Android and iOS apps in Python.</em>
+</p>
+
+<p align="center">
+  <a href="https://github.com/pythonnative/pythonnative/actions/workflows/ci.yml"><img src="https://github.com/pythonnative/pythonnative/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/pythonnative/pythonnative/actions/workflows/release.yml"><img src="https://github.com/pythonnative/pythonnative/actions/workflows/release.yml/badge.svg" alt="Release" /></a>
+  <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/v/pythonnative" alt="PyPI Version" /></a>
+  <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/pyversions/pythonnative" alt="Python Versions" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/pypi/l/pythonnative" alt="License: MIT" /></a>
+  <a href="https://docs.pythonnative.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fdocs.pythonnative.com&label=docs" alt="Docs" /></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.pythonnative.com/">Documentation</a> ·
+  <a href="https://docs.pythonnative.com/getting-started/">Getting Started</a> ·
+  <a href="https://docs.pythonnative.com/examples/">Examples</a> ·
+  <a href="CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+## Overview
+
+PythonNative is a cross-platform toolkit for building native Android and iOS apps in Python. It provides a **declarative, React-like component model** with automatic reconciliation, powered by Chaquopy on Android and rubicon-objc on iOS. Describe your UI as a tree of elements, manage state with `set_state()`, and let PythonNative handle creating and updating native views.
+
+## 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.
+- **Reactive state:** Call `self.set_state(key=value)` and the framework re-renders only what changed — no manual view mutation.
+- **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 for multi-page apps.
+- **Bundled templates:** Android Gradle and iOS Xcode templates are included — scaffolding requires no network access.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install pythonnative
+```
+
+### Usage
+
+```python
+import pythonnative as pn
+
+
+class MainPage(pn.Page):
+    def __init__(self, native_instance):
+        super().__init__(native_instance)
+        self.state = {"count": 0}
+
+    def render(self):
+        return pn.Column(
+            pn.Text(f"Count: {self.state['count']}", font_size=24),
+            pn.Button(
+                "Tap me",
+                on_click=lambda: self.set_state(count=self.state["count"] + 1),
+            ),
+            spacing=12,
+            padding=16,
+        )
+```
+
+### Available Components
+
+| Component | Description |
+|---|---|
+| `Text` | Display text |
+| `Button` | Tappable button with `on_click` callback |
+| `Column` / `Row` | Vertical / horizontal layout containers |
+| `ScrollView` | Scrollable wrapper |
+| `TextInput` | Text entry field with `on_change` callback |
+| `Image` | Display images |
+| `Switch` | Toggle with `on_change` callback |
+| `ProgressBar` | Determinate progress (0.0–1.0) |
+| `ActivityIndicator` | Indeterminate loading spinner |
+| `WebView` | Embedded web content |
+| `Spacer` | Empty space |
+
+## Documentation
+
+Visit [docs.pythonnative.com](https://docs.pythonnative.com/) for the full documentation, including getting started guides, platform-specific instructions for Android and iOS, API reference, and working examples.
+
+## Contributing
+
+Contributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, coding standards, and guidelines for submitting pull requests.
+
+## License
+
+[MIT](LICENSE)

pythonnative-0.5.0/README.md

@@ -0,0 +1,98 @@
+<p align="center">
+  <img src="docs/assets/banner.jpg" alt="PythonNative" width="800" />
+</p>
+
+<p align="center">
+  <em>Build native Android and iOS apps in Python.</em>
+</p>
+
+<p align="center">
+  <a href="https://github.com/pythonnative/pythonnative/actions/workflows/ci.yml"><img src="https://github.com/pythonnative/pythonnative/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/pythonnative/pythonnative/actions/workflows/release.yml"><img src="https://github.com/pythonnative/pythonnative/actions/workflows/release.yml/badge.svg" alt="Release" /></a>
+  <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/v/pythonnative" alt="PyPI Version" /></a>
+  <a href="https://pypi.org/project/pythonnative/"><img src="https://img.shields.io/pypi/pyversions/pythonnative" alt="Python Versions" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/pypi/l/pythonnative" alt="License: MIT" /></a>
+  <a href="https://docs.pythonnative.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fdocs.pythonnative.com&label=docs" alt="Docs" /></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.pythonnative.com/">Documentation</a> ·
+  <a href="https://docs.pythonnative.com/getting-started/">Getting Started</a> ·
+  <a href="https://docs.pythonnative.com/examples/">Examples</a> ·
+  <a href="CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+## Overview
+
+PythonNative is a cross-platform toolkit for building native Android and iOS apps in Python. It provides a **declarative, React-like component model** with automatic reconciliation, powered by Chaquopy on Android and rubicon-objc on iOS. Describe your UI as a tree of elements, manage state with `set_state()`, and let PythonNative handle creating and updating native views.
+
+## 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.
+- **Reactive state:** Call `self.set_state(key=value)` and the framework re-renders only what changed — no manual view mutation.
+- **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 for multi-page apps.
+- **Bundled templates:** Android Gradle and iOS Xcode templates are included — scaffolding requires no network access.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install pythonnative
+```
+
+### Usage
+
+```python
+import pythonnative as pn
+
+
+class MainPage(pn.Page):
+    def __init__(self, native_instance):
+        super().__init__(native_instance)
+        self.state = {"count": 0}
+
+    def render(self):
+        return pn.Column(
+            pn.Text(f"Count: {self.state['count']}", font_size=24),
+            pn.Button(
+                "Tap me",
+                on_click=lambda: self.set_state(count=self.state["count"] + 1),
+            ),
+            spacing=12,
+            padding=16,
+        )
+```
+
+### Available Components
+
+| Component | Description |
+|---|---|
+| `Text` | Display text |
+| `Button` | Tappable button with `on_click` callback |
+| `Column` / `Row` | Vertical / horizontal layout containers |
+| `ScrollView` | Scrollable wrapper |
+| `TextInput` | Text entry field with `on_change` callback |
+| `Image` | Display images |
+| `Switch` | Toggle with `on_change` callback |
+| `ProgressBar` | Determinate progress (0.0–1.0) |
+| `ActivityIndicator` | Indeterminate loading spinner |
+| `WebView` | Embedded web content |
+| `Spacer` | Empty space |
+
+## Documentation
+
+Visit [docs.pythonnative.com](https://docs.pythonnative.com/) for the full documentation, including getting started guides, platform-specific instructions for Android and iOS, API reference, and working examples.
+
+## Contributing
+
+Contributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, coding standards, and guidelines for submitting pull requests.
+
+## License
+
+[MIT](LICENSE)

{pythonnative-0.3.0 → pythonnative-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythonnative"
-version = "0.3.0"
+version = "0.5.0"
 description = "Cross-platform native UI toolkit for Android and iOS"
 authors = [
   { name = "Owen Carey" }
@@ -88,3 +88,30 @@ ignore = []
 [tool.black]
 line-length = 120
 target-version = ['py39']
+
+# ── Semantic Release ────────────────────────────────────────────────
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+version_variables = ["src/pythonnative/__init__.py:__version__"]
+commit_message = "chore(release): v{version}"
+tag_format = "v{version}"
+major_on_zero = false
+
+[tool.semantic_release.branches.main]
+match = "main"
+prerelease = false
+
+[tool.semantic_release.changelog]
+changelog_file = "CHANGELOG.md"
+exclude_commit_patterns = [
+    "^chore\\(release\\):",
+]
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = [
+    "build", "chore", "ci", "docs", "feat", "fix",
+    "perf", "refactor", "revert", "style", "test",
+]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf"]

pythonnative-0.5.0/src/pythonnative/__init__.py

@@ -0,0 +1,54 @@
+"""PythonNative — declarative native UI for Android and iOS.
+
+Public API::
+
+    import pythonnative as pn
+
+    class MainPage(pn.Page):
+        def __init__(self, native_instance):
+            super().__init__(native_instance)
+            self.state = {"count": 0}
+
+        def render(self):
+            return pn.Column(
+                pn.Text(f"Count: {self.state['count']}", font_size=24),
+                pn.Button("Increment", on_click=lambda: self.set_state(count=self.state["count"] + 1)),
+                spacing=12,
+            )
+"""
+
+__version__ = "0.5.0"
+
+from .components import (
+    ActivityIndicator,
+    Button,
+    Column,
+    Image,
+    ProgressBar,
+    Row,
+    ScrollView,
+    Spacer,
+    Switch,
+    Text,
+    TextInput,
+    WebView,
+)
+from .element import Element
+from .page import Page
+
+__all__ = [
+    "ActivityIndicator",
+    "Button",
+    "Column",
+    "Element",
+    "Image",
+    "Page",
+    "ProgressBar",
+    "Row",
+    "ScrollView",
+    "Spacer",
+    "Switch",
+    "Text",
+    "TextInput",
+    "WebView",
+]

{pythonnative-0.3.0 → pythonnative-0.5.0}/src/pythonnative/cli/pn.py

@@ -41,7 +41,6 @@ def init_project(args: argparse.Namespace) -> None:
 
     os.makedirs(app_dir, exist_ok=True)
 
-    # Minimal hello world app scaffold (no bootstrap function; host instantiates Page directly)
     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:
@@ -52,15 +51,22 @@ def init_project(args: argparse.Namespace) -> None:
 class MainPage(pn.Page):
     def __init__(self, native_instance):
         super().__init__(native_instance)
-
-    def on_create(self):
-        super().on_create()
-        stack = pn.StackView()
-        stack.add_view(pn.Label("Hello from PythonNative!"))
-        button = pn.Button("Tap me")
-        button.set_on_click(lambda: print("Button clicked"))
-        stack.add_view(button)
-        self.set_root_view(stack)
+        self.state = {"count": 0}
+
+    def increment(self):
+        self.set_state(count=self.state["count"] + 1)
+
+    def render(self):
+        return pn.ScrollView(
+            pn.Column(
+                pn.Text("Hello from PythonNative!", font_size=24, bold=True),
+                pn.Text(f"Tapped {self.state['count']} times"),
+                pn.Button("Tap me", on_click=self.increment),
+                spacing=12,
+                padding=16,
+                alignment="fill",
+            )
+        )
 """
             )
 

pythonnative-0.5.0/src/pythonnative/components.py

@@ -0,0 +1,241 @@
+"""Built-in element-creating functions for declarative UI composition.
+
+Each function returns an :class:`Element` describing a native UI widget.
+These are pure data — no native views are created until the reconciler
+mounts the element tree.
+
+Naming follows React Native conventions:
+
+- ``Text`` (was *Label*)
+- ``Button``
+- ``Column`` / ``Row`` (was *StackView* vertical/horizontal)
+- ``ScrollView``
+- ``TextInput`` (was *TextField*)
+- ``Image`` (was *ImageView*)
+- ``Switch``
+- ``ProgressBar`` (was *ProgressView*)
+- ``ActivityIndicator`` (was *ActivityIndicatorView*)
+- ``WebView``
+- ``Spacer`` (new)
+"""
+
+from typing import Any, Callable, Dict, Optional, Union
+
+from .element import Element
+
+
+def _filter_none(**kwargs: Any) -> Dict[str, Any]:
+    """Return *kwargs* with ``None``-valued entries removed."""
+    return {k: v for k, v in kwargs.items() if v is not None}
+
+
+# ---------------------------------------------------------------------------
+# Leaf components
+# ---------------------------------------------------------------------------
+
+
+def Text(
+    text: str = "",
+    *,
+    font_size: Optional[float] = None,
+    color: Optional[str] = None,
+    bold: bool = False,
+    text_align: Optional[str] = None,
+    background_color: Optional[str] = None,
+    max_lines: Optional[int] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Display text."""
+    props = _filter_none(
+        text=text,
+        font_size=font_size,
+        color=color,
+        bold=bold or None,
+        text_align=text_align,
+        background_color=background_color,
+        max_lines=max_lines,
+    )
+    return Element("Text", props, [], key=key)
+
+
+def Button(
+    title: str = "",
+    *,
+    on_click: Optional[Callable[[], None]] = None,
+    color: Optional[str] = None,
+    background_color: Optional[str] = None,
+    font_size: Optional[float] = None,
+    enabled: bool = True,
+    key: Optional[str] = None,
+) -> Element:
+    """Create a tappable button."""
+    props: Dict[str, Any] = {"title": title}
+    if on_click is not None:
+        props["on_click"] = on_click
+    if color is not None:
+        props["color"] = color
+    if background_color is not None:
+        props["background_color"] = background_color
+    if font_size is not None:
+        props["font_size"] = font_size
+    if not enabled:
+        props["enabled"] = False
+    return Element("Button", props, [], key=key)
+
+
+def TextInput(
+    *,
+    value: str = "",
+    placeholder: str = "",
+    on_change: Optional[Callable[[str], None]] = None,
+    secure: bool = False,
+    font_size: Optional[float] = None,
+    color: Optional[str] = None,
+    background_color: Optional[str] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Create a single-line text entry field."""
+    props: Dict[str, Any] = {"value": value}
+    if placeholder:
+        props["placeholder"] = placeholder
+    if on_change is not None:
+        props["on_change"] = on_change
+    if secure:
+        props["secure"] = True
+    if font_size is not None:
+        props["font_size"] = font_size
+    if color is not None:
+        props["color"] = color
+    if background_color is not None:
+        props["background_color"] = background_color
+    return Element("TextInput", props, [], key=key)
+
+
+def Image(
+    source: str = "",
+    *,
+    width: Optional[float] = None,
+    height: Optional[float] = None,
+    scale_type: Optional[str] = None,
+    background_color: Optional[str] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Display an image from a resource path or URL."""
+    props = _filter_none(
+        source=source or None,
+        width=width,
+        height=height,
+        scale_type=scale_type,
+        background_color=background_color,
+    )
+    return Element("Image", props, [], key=key)
+
+
+def Switch(
+    *,
+    value: bool = False,
+    on_change: Optional[Callable[[bool], None]] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Create a toggle switch."""
+    props: Dict[str, Any] = {"value": value}
+    if on_change is not None:
+        props["on_change"] = on_change
+    return Element("Switch", props, [], key=key)
+
+
+def ProgressBar(
+    *,
+    value: float = 0.0,
+    background_color: Optional[str] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Show determinate progress (0.0 – 1.0)."""
+    props = _filter_none(value=value, background_color=background_color)
+    return Element("ProgressBar", props, [], key=key)
+
+
+def ActivityIndicator(
+    *,
+    animating: bool = True,
+    key: Optional[str] = None,
+) -> Element:
+    """Show an indeterminate loading spinner."""
+    return Element("ActivityIndicator", {"animating": animating}, [], key=key)
+
+
+def WebView(
+    *,
+    url: str = "",
+    key: Optional[str] = None,
+) -> Element:
+    """Embed web content."""
+    props: Dict[str, Any] = {}
+    if url:
+        props["url"] = url
+    return Element("WebView", props, [], key=key)
+
+
+def Spacer(
+    *,
+    size: Optional[float] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Insert empty space with an optional fixed size."""
+    props = _filter_none(size=size)
+    return Element("Spacer", props, [], key=key)
+
+
+# ---------------------------------------------------------------------------
+# Container components
+# ---------------------------------------------------------------------------
+
+PaddingValue = Union[int, float, Dict[str, Union[int, float]]]
+
+
+def Column(
+    *children: Element,
+    spacing: float = 0,
+    padding: Optional[PaddingValue] = None,
+    alignment: Optional[str] = None,
+    background_color: Optional[str] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Arrange children vertically."""
+    props = _filter_none(
+        spacing=spacing or None,
+        padding=padding,
+        alignment=alignment,
+        background_color=background_color,
+    )
+    return Element("Column", props, list(children), key=key)
+
+
+def Row(
+    *children: Element,
+    spacing: float = 0,
+    padding: Optional[PaddingValue] = None,
+    alignment: Optional[str] = None,
+    background_color: Optional[str] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Arrange children horizontally."""
+    props = _filter_none(
+        spacing=spacing or None,
+        padding=padding,
+        alignment=alignment,
+        background_color=background_color,
+    )
+    return Element("Row", props, list(children), key=key)
+
+
+def ScrollView(
+    child: Optional[Element] = None,
+    *,
+    background_color: Optional[str] = None,
+    key: Optional[str] = None,
+) -> Element:
+    """Wrap a single child in a scrollable container."""
+    children = [child] if child is not None else []
+    props = _filter_none(background_color=background_color)
+    return Element("ScrollView", props, children, key=key)

pythonnative-0.5.0/src/pythonnative/element.py

@@ -0,0 +1,47 @@
+"""Lightweight element descriptors for the virtual view tree.
+
+An Element is an immutable description of a UI node — analogous to a React
+element.  It captures a type name, a props dictionary, and an ordered list
+of children without creating any native platform objects.  The reconciler
+consumes these trees to determine what native views must be created,
+updated, or removed.
+"""
+
+from typing import Any, Dict, List, Optional
+
+
+class Element:
+    """Immutable description of a single UI node."""
+
+    __slots__ = ("type", "props", "children", "key")
+
+    def __init__(
+        self,
+        type_name: str,
+        props: Dict[str, Any],
+        children: List["Element"],
+        key: Optional[str] = None,
+    ) -> None:
+        self.type = type_name
+        self.props = props
+        self.children = children
+        self.key = key
+
+    def __repr__(self) -> str:
+        return f"Element({self.type!r}, props={set(self.props)}, children={len(self.children)})"
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, Element):
+            return NotImplemented
+        return (
+            self.type == other.type
+            and self.props == other.props
+            and self.children == other.children
+            and self.key == other.key
+        )
+
+    def __ne__(self, other: object) -> bool:
+        result = self.__eq__(other)
+        if result is NotImplemented:
+            return result
+        return not result