pythonnative 0.0.1__tar.gz → 0.2.0__tar.gz

{pythonnative-0.0.1 → pythonnative-0.2.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 PythonNative
+Copyright (c) 2025 PythonNative
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ 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.
+THE SOFTWARE.

pythonnative-0.2.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: pythonnative
+Version: 0.2.0
+Summary: Cross-platform native UI toolkit for Android and iOS
+Author: Owen Carey
+License: MIT License
+        
+        Copyright (c) 2025 PythonNative
+        
+        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
+
+# PythonNative
+
+**PythonNative** is a cross-platform toolkit that allows you to create native Android and iOS apps using Python. Inspired by frameworks like React Native and NativeScript, PythonNative provides a Pythonic interface for building native UI elements, handling lifecycle events, and accessing platform-specific APIs.
+
+## Features
+
+- **Native UI Components**: Create and manage native buttons, labels, lists, and more, all from Python.
+- **Cross-Platform**: Write once, run on both Android and iOS.
+- **Lifecycle Management**: Handle app lifecycle events with ease.
+- **Native API Access**: Access device features like Camera, Geolocation, and Notifications.
+- **Powered by Proven Tools**: PythonNative integrates seamlessly with [Rubicon](https://beeware.org/project/projects/bridges/rubicon/) for iOS and [Chaquopy](https://chaquo.com/chaquopy/) for Android, ensuring robust native performance.
+
+## Quick Start
+
+### Installation
+
+First, install PythonNative via pip:
+
+```bash
+pip install pythonnative
+```
+
+### Create Your First App
+
+Initialize a new PythonNative app:
+
+```bash
+pn init my_app
+```
+
+Your app directory will look like this:
+
+```text
+my_app/
+├── README.md
+├── app
+│   ├── __init__.py
+│   ├── main_page.py
+│   └── resources
+├── pythonnative.json
+├── requirements.txt
+└── tests
+```
+
+### Writing Views
+
+In PythonNative, everything is a view. Here's a simple example of how to create a main page with a list view:
+
+```python
+import pythonnative as pn
+
+class MainPage(pn.Page):
+    def __init__(self, native_instance):
+        super().__init__(native_instance)
+
+    def on_create(self):
+        super().on_create()
+        stack_view = pn.StackView(self.native_instance)
+        list_data = ["item_{}".format(i) for i in range(100)]
+        list_view = pn.ListView(self.native_instance, list_data)
+        stack_view.add_view(list_view)
+        self.set_root_view(stack_view)
+```
+
+### Run the app
+
+```bash
+pn run android
+pn run ios
+```
+
+## Documentation
+
+For detailed guides and API references, visit the [PythonNative documentation](https://docs.pythonnative.com/).

pythonnative-0.2.0/README.md

@@ -0,0 +1,74 @@
+# PythonNative
+
+**PythonNative** is a cross-platform toolkit that allows you to create native Android and iOS apps using Python. Inspired by frameworks like React Native and NativeScript, PythonNative provides a Pythonic interface for building native UI elements, handling lifecycle events, and accessing platform-specific APIs.
+
+## Features
+
+- **Native UI Components**: Create and manage native buttons, labels, lists, and more, all from Python.
+- **Cross-Platform**: Write once, run on both Android and iOS.
+- **Lifecycle Management**: Handle app lifecycle events with ease.
+- **Native API Access**: Access device features like Camera, Geolocation, and Notifications.
+- **Powered by Proven Tools**: PythonNative integrates seamlessly with [Rubicon](https://beeware.org/project/projects/bridges/rubicon/) for iOS and [Chaquopy](https://chaquo.com/chaquopy/) for Android, ensuring robust native performance.
+
+## Quick Start
+
+### Installation
+
+First, install PythonNative via pip:
+
+```bash
+pip install pythonnative
+```
+
+### Create Your First App
+
+Initialize a new PythonNative app:
+
+```bash
+pn init my_app
+```
+
+Your app directory will look like this:
+
+```text
+my_app/
+├── README.md
+├── app
+│   ├── __init__.py
+│   ├── main_page.py
+│   └── resources
+├── pythonnative.json
+├── requirements.txt
+└── tests
+```
+
+### Writing Views
+
+In PythonNative, everything is a view. Here's a simple example of how to create a main page with a list view:
+
+```python
+import pythonnative as pn
+
+class MainPage(pn.Page):
+    def __init__(self, native_instance):
+        super().__init__(native_instance)
+
+    def on_create(self):
+        super().on_create()
+        stack_view = pn.StackView(self.native_instance)
+        list_data = ["item_{}".format(i) for i in range(100)]
+        list_view = pn.ListView(self.native_instance, list_data)
+        stack_view.add_view(list_view)
+        self.set_root_view(stack_view)
+```
+
+### Run the app
+
+```bash
+pn run android
+pn run ios
+```
+
+## Documentation
+
+For detailed guides and API references, visit the [PythonNative documentation](https://docs.pythonnative.com/).

pythonnative-0.2.0/pyproject.toml

@@ -0,0 +1,90 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pythonnative"
+version = "0.2.0"
+description = "Cross-platform native UI toolkit for Android and iOS"
+authors = [
+  { name = "Owen Carey" }
+]
+readme = "README.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: User Interfaces",
+]
+dependencies = [
+  "requests>=2.31.0",
+]
+
+[project.optional-dependencies]
+ios = [
+  "rubicon-objc>=0.4.6,<0.5.0",
+]
+docs = [
+  "mkdocs>=1.5",
+  "mkdocs-material[imaging]>=9.5",
+  "mkdocstrings[python]>=0.24",
+]
+dev = [
+  "black>=24.0",
+  "ruff>=0.5",
+  "mypy>=1.10",
+  "pytest>=8.0",
+]
+ci = [
+  "black>=24.0",
+  "ruff>=0.5",
+  "mypy>=1.10",
+  "pytest>=8.0",
+]
+
+[project.scripts]
+pn = "pythonnative.cli.pn:main"
+
+[project.urls]
+Homepage = "https://github.com/pythonnative/pythonnative"
+Repository = "https://github.com/pythonnative/pythonnative"
+Issues = "https://github.com/pythonnative/pythonnative/issues"
+Documentation = "https://docs.pythonnative.com/"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+license-files = ["LICENSE*"]
+
+# Include template directories inside the package so importlib.resources can find them
+[tool.setuptools.package-data]
+pythonnative = [
+  "templates/**",
+]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 120
+extend-exclude = [
+  "experiments",
+  "apps",
+  "templates",
+  "docs",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+ignore = []
+
+[tool.black]
+line-length = 120
+target-version = ['py39']

pythonnative-0.2.0/src/pythonnative/__init__.py

@@ -0,0 +1,74 @@
+from importlib import import_module
+from typing import Any, Dict
+
+__version__ = "0.2.0"
+
+__all__ = [
+    "ActivityIndicatorView",
+    "Button",
+    "DatePicker",
+    "ImageView",
+    "Label",
+    "ListView",
+    "MaterialActivityIndicatorView",
+    "MaterialButton",
+    "MaterialDatePicker",
+    "MaterialProgressView",
+    "MaterialSearchBar",
+    "MaterialSwitch",
+    "MaterialTimePicker",
+    "MaterialBottomNavigationView",
+    "MaterialToolbar",
+    "Page",
+    "PickerView",
+    "ProgressView",
+    "ScrollView",
+    "SearchBar",
+    "StackView",
+    "Switch",
+    "TextField",
+    "TextView",
+    "TimePicker",
+    "WebView",
+]
+
+_NAME_TO_MODULE: Dict[str, str] = {
+    "ActivityIndicatorView": ".activity_indicator_view",
+    "Button": ".button",
+    "DatePicker": ".date_picker",
+    "ImageView": ".image_view",
+    "Label": ".label",
+    "ListView": ".list_view",
+    "MaterialActivityIndicatorView": ".material_activity_indicator_view",
+    "MaterialButton": ".material_button",
+    "MaterialDatePicker": ".material_date_picker",
+    "MaterialProgressView": ".material_progress_view",
+    "MaterialSearchBar": ".material_search_bar",
+    "MaterialSwitch": ".material_switch",
+    "MaterialTimePicker": ".material_time_picker",
+    "MaterialBottomNavigationView": ".material_bottom_navigation_view",
+    "MaterialToolbar": ".material_toolbar",
+    "Page": ".page",
+    "PickerView": ".picker_view",
+    "ProgressView": ".progress_view",
+    "ScrollView": ".scroll_view",
+    "SearchBar": ".search_bar",
+    "StackView": ".stack_view",
+    "Switch": ".switch",
+    "TextField": ".text_field",
+    "TextView": ".text_view",
+    "TimePicker": ".time_picker",
+    "WebView": ".web_view",
+}
+
+
+def __getattr__(name: str) -> Any:
+    module_path = _NAME_TO_MODULE.get(name)
+    if not module_path:
+        raise AttributeError(f"module 'pythonnative' has no attribute {name!r}")
+    module = import_module(module_path, package=__name__)
+    return getattr(module, name)
+
+
+def __dir__() -> Any:
+    return sorted(list(globals().keys()) + __all__)

pythonnative-0.2.0/src/pythonnative/activity_indicator_view.py

@@ -0,0 +1,71 @@
+from abc import ABC, abstractmethod
+
+from .utils import IS_ANDROID, get_android_context
+from .view import ViewBase
+
+# ========================================
+# Base class
+# ========================================
+
+
+class ActivityIndicatorViewBase(ABC):
+    @abstractmethod
+    def __init__(self) -> None:
+        super().__init__()
+
+    @abstractmethod
+    def start_animating(self) -> None:
+        pass
+
+    @abstractmethod
+    def stop_animating(self) -> None:
+        pass
+
+
+if IS_ANDROID:
+    # ========================================
+    # Android class
+    # https://developer.android.com/reference/android/widget/ProgressBar
+    # ========================================
+
+    from java import jclass
+
+    class ActivityIndicatorView(ActivityIndicatorViewBase, ViewBase):
+        def __init__(self) -> None:
+            super().__init__()
+            self.native_class = jclass("android.widget.ProgressBar")
+            # self.native_instance = self.native_class(context, None, android.R.attr.progressBarStyleLarge)
+            context = get_android_context()
+            self.native_instance = self.native_class(context)
+            self.native_instance.setIndeterminate(True)
+
+        def start_animating(self) -> None:
+            # self.native_instance.setVisibility(android.view.View.VISIBLE)
+            return
+
+        def stop_animating(self) -> None:
+            # self.native_instance.setVisibility(android.view.View.GONE)
+            return
+
+else:
+    # ========================================
+    # iOS class
+    # https://developer.apple.com/documentation/uikit/uiactivityindicatorview
+    # ========================================
+
+    from rubicon.objc import ObjCClass
+
+    class ActivityIndicatorView(ActivityIndicatorViewBase, ViewBase):
+        def __init__(self) -> None:
+            super().__init__()
+            self.native_class = ObjCClass("UIActivityIndicatorView")
+            self.native_instance = self.native_class.alloc().initWithActivityIndicatorStyle_(
+                0
+            )  # 0: UIActivityIndicatorViewStyleLarge
+            self.native_instance.hidesWhenStopped = True
+
+        def start_animating(self) -> None:
+            self.native_instance.startAnimating()
+
+        def stop_animating(self) -> None:
+            self.native_instance.stopAnimating()

pythonnative-0.2.0/src/pythonnative/button.py

@@ -0,0 +1,109 @@
+from abc import ABC, abstractmethod
+from typing import Callable, Optional
+
+from .utils import IS_ANDROID, get_android_context
+from .view import ViewBase
+
+# ========================================
+# Base class
+# ========================================
+
+
+class ButtonBase(ABC):
+    @abstractmethod
+    def __init__(self) -> None:
+        super().__init__()
+
+    @abstractmethod
+    def set_title(self, title: str) -> None:
+        pass
+
+    @abstractmethod
+    def get_title(self) -> str:
+        pass
+
+    @abstractmethod
+    def set_on_click(self, callback: Callable[[], None]) -> None:
+        pass
+
+
+if IS_ANDROID:
+    # ========================================
+    # Android class
+    # https://developer.android.com/reference/android/widget/Button
+    # ========================================
+
+    from java import dynamic_proxy, jclass
+
+    class Button(ButtonBase, ViewBase):
+        def __init__(self, title: str = "") -> None:
+            super().__init__()
+            self.native_class = jclass("android.widget.Button")
+            context = get_android_context()
+            self.native_instance = self.native_class(context)
+            self.set_title(title)
+
+        def set_title(self, title: str) -> None:
+            self.native_instance.setText(title)
+
+        def get_title(self) -> str:
+            return self.native_instance.getText().toString()
+
+        def set_on_click(self, callback: Callable[[], None]) -> None:
+            class OnClickListener(dynamic_proxy(jclass("android.view.View").OnClickListener)):
+                def __init__(self, callback):
+                    super().__init__()
+                    self.callback = callback
+
+                def onClick(self, view):
+                    self.callback()
+
+            listener = OnClickListener(callback)
+            self.native_instance.setOnClickListener(listener)
+
+else:
+    # ========================================
+    # iOS class
+    # https://developer.apple.com/documentation/uikit/uibutton
+    # ========================================
+
+    from rubicon.objc import SEL, ObjCClass, objc_method
+
+    NSObject = ObjCClass("NSObject")
+
+    # Mypy cannot understand Rubicon's dynamic subclassing; ignore the base type here.
+    class _PNButtonHandler(NSObject):  # type: ignore[valid-type]
+        # Set by the Button when wiring up the target/action callback.
+        _callback: Optional[Callable[[], None]] = None
+
+        @objc_method
+        def onTap_(self, sender) -> None:
+            try:
+                callback = self._callback
+                if callback is not None:
+                    callback()
+            except Exception:
+                # Swallow exceptions to avoid crashing the app; logging is handled at higher levels
+                pass
+
+    class Button(ButtonBase, ViewBase):
+        def __init__(self, title: str = "") -> None:
+            super().__init__()
+            self.native_class = ObjCClass("UIButton")
+            self.native_instance = self.native_class.alloc().init()
+            self.set_title(title)
+
+        def set_title(self, title: str) -> None:
+            self.native_instance.setTitle_forState_(title, 0)
+
+        def get_title(self) -> str:
+            return self.native_instance.titleForState_(0)
+
+        def set_on_click(self, callback: Callable[[], None]) -> None:
+            # Create a handler object with an Objective-C method `onTap:` and attach the Python callback
+            handler = _PNButtonHandler.new()
+            # Keep strong references to the handler and callback
+            self._click_handler = handler
+            handler._callback = callback
+            # UIControlEventTouchUpInside = 1 << 6
+            self.native_instance.addTarget_action_forControlEvents_(handler, SEL("onTap:"), 1 << 6)