toga-iOS 0.4.2__tar.gz → 0.5.0__tar.gz

{toga-iOS-0.4.2/src/toga_iOS.egg-info → toga_ios-0.5.0}/PKG-INFO

@@ -1,36 +1,38 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: toga-iOS
-Version: 0.4.2
+Version: 0.5.0
 Summary: An iOS backend for the Toga widget toolkit.
 Author-email: Russell Keith-Magee <russell@keith-magee.com>
 Maintainer-email: BeeWare Team <team@beeware.org>
 License: New BSD
 Project-URL: Homepage, https://beeware.org/project/projects/libraries/toga/
 Project-URL: Funding, https://beeware.org/contributing/membership/
-Project-URL: Documentation, https://toga.readthedocs.io/en/latest/
+Project-URL: Documentation, https://toga.readthedocs.io/
 Project-URL: Tracker, https://github.com/beeware/toga/issues
 Project-URL: Source, https://github.com/beeware/toga
+Project-URL: Changelog, https://toga.readthedocs.io/en/stable/background/project/releases.html
 Keywords: gui,widget,cross-platform,toga,mobile,iOS
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 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: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: User Interfaces
 Classifier: Topic :: Software Development :: Widget Sets
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: fonttools<5.0.0,>=4.42.1
-Requires-Dist: rubicon-objc<0.5.0,>=0.4.7
-Requires-Dist: toga-core==0.4.2
+Requires-Dist: rubicon-objc<0.6.0,>=0.5.0
+Requires-Dist: toga-core==0.5.0
+Dynamic: requires-dist
 
 toga-iOS
 ========
@@ -40,7 +42,7 @@ An iOS backend for the `Toga widget toolkit`_.
 This package isn't much use by itself; it needs to be combined with `the core Toga library`_.
 
 For platform requirements, see the `iOS platform documentation
-<https://toga.readthedocs.io/en/stable/reference/platforms/iOS.html#prerequisites>`__.
+<https://toga.readthedocs.io/en/latest/reference/platforms/iOS.html#prerequisites>`__.
 
 For more details, see the `Toga project on Github`_.
 

{toga-iOS-0.4.2 → toga_ios-0.5.0}/README.rst

@@ -6,7 +6,7 @@ An iOS backend for the `Toga widget toolkit`_.
 This package isn't much use by itself; it needs to be combined with `the core Toga library`_.
 
 For platform requirements, see the `iOS platform documentation
-<https://toga.readthedocs.io/en/stable/reference/platforms/iOS.html#prerequisites>`__.
+<https://toga.readthedocs.io/en/latest/reference/platforms/iOS.html#prerequisites>`__.
 
 For more details, see the `Toga project on Github`_.
 

{toga-iOS-0.4.2 → toga_ios-0.5.0}/pyproject.toml

@@ -1,8 +1,8 @@
 [build-system]
 requires = [
-    "setuptools==69.0.0",
-    "setuptools_scm==8.0.4",
-    "setuptools_dynamic_dependencies @ git+https://github.com/beeware/setuptools_dynamic_dependencies",
+    "setuptools==76.0.0",
+    "setuptools_scm==8.2.0",
+    "setuptools_dynamic_dependencies==1.0.0",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -11,7 +11,7 @@ dynamic = ["version", "dependencies"]
 name = "toga-iOS"
 description = "An iOS backend for the Toga widget toolkit."
 readme = "README.rst"
-requires-python = ">= 3.8"
+requires-python = ">= 3.9"
 license.text = "New BSD"
 authors = [
     {name="Russell Keith-Magee", email="russell@keith-magee.com"},
@@ -33,11 +33,11 @@ classifiers = [
     "License :: OSI Approved :: BSD License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3 :: Only",
     "Topic :: Software Development",
     "Topic :: Software Development :: User Interfaces",
@@ -47,9 +47,10 @@ classifiers = [
 [project.urls]
 Homepage = "https://beeware.org/project/projects/libraries/toga/"
 Funding = "https://beeware.org/contributing/membership/"
-Documentation = "https://toga.readthedocs.io/en/latest/"
+Documentation = "https://toga.readthedocs.io/"
 Tracker = "https://github.com/beeware/toga/issues"
 Source = "https://github.com/beeware/toga"
+Changelog = "https://toga.readthedocs.io/en/stable/background/project/releases.html"
 
 [project.entry-points."toga.backends"]
 iOS = "toga_iOS"
@@ -60,7 +61,7 @@ root = ".."
 [tool.setuptools_dynamic_dependencies]
 dependencies = [
     "fonttools >= 4.42.1, < 5.0.0",
-    "rubicon-objc >= 0.4.7, < 0.5.0",
+    "rubicon-objc >= 0.5.0, < 0.6.0",
     "toga-core == {version}",
 ]
 

toga_ios-0.5.0/src/toga_iOS/__init__.py

@@ -0,0 +1,3 @@
+import travertino
+
+__version__ = travertino._package_version(__file__, __name__)

{toga-iOS-0.4.2 → toga_ios-0.5.0}/src/toga_iOS/app.py

@@ -3,30 +3,32 @@ import asyncio
 from rubicon.objc import objc_method
 from rubicon.objc.eventloop import EventLoopPolicy, iOSLifecycle
 
-from toga_iOS.libs import UIResponder, av_foundation
-from toga_iOS.window import Window
+import toga
+from toga_iOS.libs import UIResponder, UIScreen, av_foundation
 
-
-class MainWindow(Window):
-    _is_main_window = True
+from .screens import Screen as ScreenImpl
 
 
 class PythonAppDelegate(UIResponder):
     @objc_method
     def applicationDidBecomeActive_(self, application) -> None:
         print("App became active.")
+        App.app.interface.current_window.on_gain_focus()
 
     @objc_method
     def applicationWillResignActive_(self, application) -> None:
         print("App about to leave foreground.", flush=True)
+        App.app.interface.current_window.on_lose_focus()
 
     @objc_method
     def applicationDidEnterBackground_(self, application) -> None:
         print("App entered background.")
+        App.app.interface.current_window.on_hide()
 
     @objc_method
     def applicationWillEnterForeground_(self, application) -> None:
         print("App about to enter foreground.")
+        App.app.interface.current_window.on_show()
 
     @objc_method
     def application_didFinishLaunchingWithOptions_(
@@ -35,6 +37,7 @@ class PythonAppDelegate(UIResponder):
         print("App finished launching.")
         App.app.native = application
         App.app.create()
+        App.app.interface.current_window.on_show()
         return True
 
     @objc_method
@@ -51,6 +54,12 @@ class PythonAppDelegate(UIResponder):
 
 
 class App:
+    # iOS apps exit when the last window is closed
+    CLOSE_ON_LAST_WINDOW = True
+    # iOS doesn't have command line handling;
+    # but saying it does shortcuts the default handling
+    HANDLES_COMMAND_LINE = True
+
     def __init__(self, interface):
         self.interface = interface
         self.interface._impl = self
@@ -67,14 +76,25 @@ class App:
         """Calls the startup method on the interface."""
         self.interface._startup()
 
-    def open_document(self, fileURL):  # pragma: no cover
-        """Add a new document to this app."""
+    ######################################################################
+    # Commands and menus
+    ######################################################################
+
+    def create_standard_commands(self):
         pass
 
     def create_menus(self):
         # No menus on an iOS app (for now)
         pass
 
+    ######################################################################
+    # App lifecycle
+    ######################################################################
+
+    def exit(self):  # pragma: no cover
+        # Mobile apps can't be exited, but the entry point needs to exist
+        pass
+
     def main_loop(self):
         # Main loop is non-blocking on iOS. The app loop is integrated with the
         # main iOS event loop, so this call will return; however, it will leave
@@ -82,36 +102,48 @@ class App:
         # iOS event loop.
         self.loop.run_forever_cooperatively(lifecycle=iOSLifecycle())
 
+    def set_icon(self, icon):
+        # iOS apps don't have runtime icons, so this can't be invoked
+        pass  # pragma: no cover
+
     def set_main_window(self, window):
-        pass
+        if window is None or window == toga.App.BACKGROUND:
+            raise ValueError("Apps without main windows are not supported on iOS")
 
-    def get_current_window(self):
-        # iOS only has a main window.
-        return self.interface.main_window._impl
+    ######################################################################
+    # App resources
+    ######################################################################
 
-    def set_current_window(self, window):
-        # iOS only has a main window, so this is a no-op
-        pass
+    def get_screens(self):
+        return [ScreenImpl(UIScreen.mainScreen)]
 
-    def show_about_dialog(self):
-        self.interface.factory.not_implemented("App.show_about_dialog()")
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        self.interface.factory.not_implemented("dark mode state")
+        return None
+
+    ######################################################################
+    # App capabilities
+    ######################################################################
 
     def beep(self):
         # 1013 is a magic constant that is the "SMS RECEIVED 5" sound,
         # sounding like a single strike of a bell.
         av_foundation.AudioServicesPlayAlertSound(1013)
 
-    def exit(self):  # pragma: no cover
-        # Mobile apps can't be exited, but the entry point needs to exist
+    def open_document(self, fileURL):  # pragma: no cover
+        """Add a new document to this app."""
         pass
 
-    def enter_full_screen(self, windows):
-        # No-op; mobile doesn't support full screen
-        pass
+    def show_about_dialog(self):
+        self.interface.factory.not_implemented("App.show_about_dialog()")
 
-    def exit_full_screen(self, windows):
-        # No-op; mobile doesn't support full screen
-        pass
+    ######################################################################
+    # Cursor control
+    ######################################################################
 
     def hide_cursor(self):
         # No-op; mobile doesn't support cursors
@@ -120,3 +152,15 @@ class App:
     def show_cursor(self):
         # No-op; mobile doesn't support cursors
         pass
+
+    ######################################################################
+    # Window control
+    ######################################################################
+
+    def get_current_window(self):
+        # iOS only has a main window.
+        return self.interface.main_window._impl
+
+    def set_current_window(self, window):
+        # iOS only has a main window, so this is a no-op
+        pass

{toga-iOS-0.4.2 → toga_ios-0.5.0}/src/toga_iOS/colors.py

@@ -11,10 +11,9 @@ def native_color(c):
     try:
         color = CACHE[c]
     except KeyError:
-        # Color needs to be retained to be kept in the cache
         color = UIColor.colorWithRed(
             c.rgba.r / 255, green=c.rgba.g / 255, blue=c.rgba.b / 255, alpha=c.rgba.a
-        ).retain()
+        )
         CACHE[c] = color
 
     return color

toga_ios-0.5.0/src/toga_iOS/command.py

@@ -0,0 +1,28 @@
+from toga import Command as StandardCommand
+
+
+class Command:
+    def __init__(self, interface):
+        self.interface = interface
+        self.native = []
+
+    @classmethod
+    def standard(cls, app, id):
+        if id in {
+            StandardCommand.ABOUT,
+            StandardCommand.EXIT,
+            StandardCommand.NEW,
+            StandardCommand.OPEN,
+            StandardCommand.PREFERENCES,
+            StandardCommand.SAVE,
+            StandardCommand.SAVE_AS,
+            StandardCommand.SAVE_ALL,
+            StandardCommand.VISIT_HOMEPAGE,
+        }:
+            # These are valid commands, but they're not defined on iOS.
+            return None
+
+        raise ValueError(f"Unknown standard command {id!r}")
+
+    def set_enabled(self, value):
+        pass

toga_ios-0.5.0/src/toga_iOS/constraints.py

@@ -0,0 +1,116 @@
+from toga_iOS.libs import (
+    NSLayoutAttributeBottom,
+    NSLayoutAttributeLeft,
+    NSLayoutAttributeRight,
+    NSLayoutAttributeTop,
+    NSLayoutConstraint,
+    NSLayoutRelationEqual,
+)
+
+
+class Constraints:
+    def __init__(self, widget):
+        """A wrapper object storing the constraints required to position a widget at a
+        precise location in its container.
+
+        :param widget: The Widget implementation to be constrained.
+        """
+        self.widget = widget
+        self.widget.native.translatesAutoresizingMaskIntoConstraints = False
+
+        self._container = None
+
+        self.width_constraint = None
+        self.height_constraint = None
+
+        self.left_constraint = None
+        self.top_constraint = None
+
+    # Deletion isn't an event we can programmatically invoke; deletion
+    # of constraints can take several iterations before it occurs.
+    def __del__(self):  # pragma: nocover
+        self._remove_constraints()
+
+    def _remove_constraints(self):
+        if self.container:
+            # print(f"Remove constraints for {self.widget} in {self.container}")
+            # Due to the unpredictability of garbage collection, it's possible for
+            # the native object of the window's container to be deleted on the ObjC
+            # side before the constraints for the window have been removed. Protect
+            # against this possibility.
+            if self.container.native:
+                self.container.native.removeConstraint(self.width_constraint)
+                self.container.native.removeConstraint(self.height_constraint)
+                self.container.native.removeConstraint(self.left_constraint)
+                self.container.native.removeConstraint(self.top_constraint)
+
+    @property
+    def container(self):
+        return self._container
+
+    @container.setter
+    def container(self, value):
+        # This will *always* remove and then add constraints. It relies on the base
+        # widget to *not* invoke this setter unless the container is actually changing.
+
+        self._remove_constraints()
+        self._container = value
+        if value is not None:
+            # print(
+            #     f"Add constraints for {self.widget} in {self.container}"
+            #     f"{self.widget.interface.layout}"
+            # )
+            self.left_constraint = NSLayoutConstraint.constraintWithItem(
+                self.widget.native,
+                attribute__1=NSLayoutAttributeLeft,
+                relatedBy=NSLayoutRelationEqual,
+                toItem=self.container.native,
+                attribute__2=NSLayoutAttributeLeft,
+                multiplier=1.0,
+                constant=10,  # Use a dummy, non-zero value for now
+            )
+            self.container.native.addConstraint(self.left_constraint)
+
+            self.top_constraint = NSLayoutConstraint.constraintWithItem(
+                self.widget.native,
+                attribute__1=NSLayoutAttributeTop,
+                relatedBy=NSLayoutRelationEqual,
+                toItem=self.container.native,
+                attribute__2=NSLayoutAttributeTop,
+                multiplier=1.0,
+                constant=5,  # Use a dummy, non-zero value for now
+            )
+            self.container.native.addConstraint(self.top_constraint)
+
+            self.width_constraint = NSLayoutConstraint.constraintWithItem(
+                self.widget.native,
+                attribute__1=NSLayoutAttributeRight,
+                relatedBy=NSLayoutRelationEqual,
+                toItem=self.widget.native,
+                attribute__2=NSLayoutAttributeLeft,
+                multiplier=1.0,
+                constant=50,  # Use a dummy, non-zero value for now
+            )
+            self.container.native.addConstraint(self.width_constraint)
+
+            self.height_constraint = NSLayoutConstraint.constraintWithItem(
+                self.widget.native,
+                attribute__1=NSLayoutAttributeBottom,
+                relatedBy=NSLayoutRelationEqual,
+                toItem=self.widget.native,
+                attribute__2=NSLayoutAttributeTop,
+                multiplier=1.0,
+                constant=30,  # Use a dummy, non-zero value for now
+            )
+            self.container.native.addConstraint(self.height_constraint)
+
+    def update(self, x, y, width, height):
+        # print(
+        #     f"UPDATE CONSTRAINTS {self.widget} in {self.container} "
+        #     f"{width}x{height}@{x},{y}"
+        # )
+        self.left_constraint.constant = x
+        self.top_constraint.constant = y
+
+        self.width_constraint.constant = width
+        self.height_constraint.constant = height

{toga-iOS-0.4.2 → toga_ios-0.5.0}/src/toga_iOS/container.py

@@ -72,13 +72,18 @@ class Container(BaseContainer):
 
         self.layout_native = self.native if layout_native is None else layout_native
 
+    def __del__(self):
+        # Mark the contained native object as explicitly None so that the
+        # constraints know the object has been deleted.
+        self.native = None
+
     @property
     def width(self):
         return self.layout_native.bounds.size.width
 
     @property
     def height(self):
-        return self.layout_native.bounds.size.height
+        return self.layout_native.bounds.size.height - self.top_offset
 
     @property
     def top_offset(self):
@@ -124,7 +129,54 @@ class RootContainer(Container):
         layout_native=None,
         on_refresh=None,
     ):
+        """A bare content container.
+
+        This is a container that *doesn't* include a navigation/title bar at the top.
+
+        :param content: The widget impl that is the container's initial content.
+        :param layout_native: The native widget that should be used to provide
+            size hints to the layout. This will usually be the container widget
+            itself; however, for widgets like ScrollContainer where the layout
+            needs to be computed based on a different size to what will be
+            rendered, the source of the size can be different.
+        :param on_refresh: The callback to be notified when this container's layout is
+            refreshed.
         """
+        super().__init__(
+            content=content,
+            layout_native=layout_native,
+            on_refresh=on_refresh,
+        )
+
+        # Construct a UIViewController to hold the root content
+        self.controller = UIViewController.alloc().init()
+
+        # Set the controller's view to be the root content widget
+        self.controller.view = self.native
+
+    # The testbed app won't instantiate a simple app, so we can't test these properties
+    @property
+    def top_offset(self):  # pragma: no cover
+        return UIApplication.sharedApplication.statusBarFrame.size.height
+
+    @property
+    def title(self):  # pragma: no cover
+        return self._title
+
+    @title.setter
+    def title(self, value):
+        self._title = value
+
+
+class NavigationContainer(Container):
+    def __init__(
+        self,
+        content=None,
+        layout_native=None,
+        on_refresh=None,
+    ):
+        """A top level container that provides a navigation/title bar.
+
         :param content: The widget impl that is the container's initial content.
         :param layout_native: The native widget that should be used to provide
             size hints to the layout. This will usually be the container widget
@@ -151,10 +203,6 @@ class RootContainer(Container):
         # Set the controller's view to be the root content widget
         self.content_controller.view = self.native
 
-    @property
-    def height(self):
-        return self.layout_native.bounds.size.height - self.top_offset
-
     @property
     def top_offset(self):
         return (