toga-qt 0.5.3__tar.gz

toga_qt-0.5.3/CONTRIBUTING.md

@@ -0,0 +1,11 @@
+# Contributing
+
+BeeWare <3's contributions!
+
+Please be aware that BeeWare operates under a [Code of
+Conduct](https://beeware.org/community/behavior/code-of-conduct/).
+
+If you'd like to contribute to Toga development, our [contribution
+guide](https://toga.beeware.org/en/latest/how-to/contribute/index.html) details how
+to set up a development environment, and other requirements we have as part of our
+contribution process.

toga_qt-0.5.3/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2025 Russell Keith-Magee.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of Toga nor the names of its contributors may
+       be used to endorse or promote products derived from this software without
+       specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

toga_qt-0.5.3/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: toga-qt
+Version: 0.5.3
+Summary: An Qt (KDE) backend for the Toga widget toolkit.
+Author-email: Russell Keith-Magee <russell@keith-magee.com>
+Maintainer-email: BeeWare Team <team@beeware.org>
+License-Expression: BSD-3-Clause
+Keywords: gui,widget,cross-platform,toga,desktop,qt
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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.14
+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.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qasync==0.28.0
+Requires-Dist: toga-core==0.5.3
+Provides-Extra: pyside6
+Requires-Dist: PySide6-Essentials==6.10.1; extra == "pyside6"
+Dynamic: license-file
+Dynamic: requires-dist
+
+# toga-qt
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/toga-qt.svg)](https://pypi.python.org/pypi/toga-qt)
+[![BSD-3-Clause License](https://img.shields.io/pypi/l/toga-qt.svg)](https://github.com/beeware/toga-qt/blob/main/LICENSE)
+[![Project status](https://img.shields.io/pypi/status/toga-qt.svg)](https://pypi.python.org/pypi/toga-qt)
+
+A Qt backend for the [Toga widget toolkit](https://beeware.org/toga).
+
+This package isn't much use by itself; it needs to be combined with [the core Toga library](https://pypi.python.org/pypi/toga-core).
+
+For platform requirements, see the [Qt platform documentation](https://toga.beeware.org/en/latest/reference/platforms/linux/qt#prerequisites).
+
+For more details, see the [Toga project on GitHub](https://github.com/beeware/toga).
+
+## Community
+
+Toga is part of the [BeeWare suite](https://beeware.org). You can talk to the community through:
+
+-   [@beeware@fosstodon.org on Mastodon](https://fosstodon.org/@beeware)
+-   [Discord](https://beeware.org/bee/chat/)
+-   The Toga [GitHub Discussions forum](https://github.com/beeware/toga/discussions)
+
+We foster a welcoming and respectful community as described in our [BeeWare Community Code of Conduct](https://beeware.org/community/behavior/).
+
+## Contributing
+
+If you experience problems with Toga, [log them on GitHub](https://github.com/beeware/toga/issues).
+
+If you'd like to contribute to Toga development, our [contribution guide](https://toga.beeware.org/en/latest/how-to/contribute) details how to set up a development environment, and other requirements we have as part of our contribution process.

toga_qt-0.5.3/README.md

@@ -0,0 +1,29 @@
+# toga-qt
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/toga-qt.svg)](https://pypi.python.org/pypi/toga-qt)
+[![BSD-3-Clause License](https://img.shields.io/pypi/l/toga-qt.svg)](https://github.com/beeware/toga-qt/blob/main/LICENSE)
+[![Project status](https://img.shields.io/pypi/status/toga-qt.svg)](https://pypi.python.org/pypi/toga-qt)
+
+A Qt backend for the [Toga widget toolkit](https://beeware.org/toga).
+
+This package isn't much use by itself; it needs to be combined with [the core Toga library](https://pypi.python.org/pypi/toga-core).
+
+For platform requirements, see the [Qt platform documentation](https://toga.beeware.org/en/latest/reference/platforms/linux/qt#prerequisites).
+
+For more details, see the [Toga project on GitHub](https://github.com/beeware/toga).
+
+## Community
+
+Toga is part of the [BeeWare suite](https://beeware.org). You can talk to the community through:
+
+-   [@beeware@fosstodon.org on Mastodon](https://fosstodon.org/@beeware)
+-   [Discord](https://beeware.org/bee/chat/)
+-   The Toga [GitHub Discussions forum](https://github.com/beeware/toga/discussions)
+
+We foster a welcoming and respectful community as described in our [BeeWare Community Code of Conduct](https://beeware.org/community/behavior/).
+
+## Contributing
+
+If you experience problems with Toga, [log them on GitHub](https://github.com/beeware/toga/issues).
+
+If you'd like to contribute to Toga development, our [contribution guide](https://toga.beeware.org/en/latest/how-to/contribute) details how to set up a development environment, and other requirements we have as part of our contribution process.

toga_qt-0.5.3/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = [
+    "setuptools==80.9.0",
+    "setuptools_scm==9.2.2",
+    "setuptools_dynamic_dependencies==1.0.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+dynamic = ["version", "dependencies"]
+name = "toga-qt"
+description = "An Qt (KDE) backend for the Toga widget toolkit."
+readme = "README.md"
+requires-python = ">= 3.10"
+license = "BSD-3-Clause"
+license-files = [
+    "LICENSE"
+]
+authors = [
+    {name="Russell Keith-Magee", email="russell@keith-magee.com"},
+]
+maintainers = [
+    {name="BeeWare Team", email="team@beeware.org"},
+]
+keywords = [
+    "gui",
+    "widget",
+    "cross-platform",
+    "toga",
+    "desktop",
+    "qt",
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Software Development :: Widget Sets",
+]
+
+
+[project.entry-points."toga.backends"]
+linux = "toga_qt"
+
+[tool.setuptools_scm]
+root = ".."
+
+[tool.setuptools_dynamic_dependencies]
+dependencies = [
+    "qasync == 0.28.0",
+    "toga-core == {version}",
+]
+
+[project.optional-dependencies]
+pyside6 = [
+    "PySide6-Essentials == 6.10.1",
+]
+
+[tool.coverage.run]
+parallel = true
+branch = true
+relative_files = true
+
+# See notes in the root pyproject.toml file.
+source = ["src"]
+source_pkgs = ["toga_qt"]
+
+[tool.coverage.paths]
+source = [
+    "src/toga_qt",
+    "**/toga_qt",
+]

toga_qt-0.5.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

toga_qt-0.5.3/src/toga_qt/__init__.py

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

toga_qt-0.5.3/src/toga_qt/app.py

@@ -0,0 +1,216 @@
+import asyncio
+
+from PySide6.QtCore import QSize, Qt
+from PySide6.QtGui import QCursor, QGuiApplication
+from PySide6.QtWidgets import QApplication, QMessageBox
+from qasync import QEventLoop
+
+import toga
+from toga.command import Command, Group
+
+from .command import EditOperation
+from .libs import create_qapplication
+from .screens import Screen as ScreenImpl
+
+
+def _create_about_dialog(app):
+    """
+    Qt has an API, namely QMessageBox.about etc, to produce these
+    dialogs.  However, these static APIs are blocking and modal, which
+    is unlike native apps on KDE where the About dialogs are non-modal.
+    """
+
+    message = (
+        f'<h2 style="font-weight: normal; margin-bottom: 0px">'
+        f"{app.interface.formal_name}</h2>"
+    )
+    versionauthor = []
+    if app.interface.version:
+        versionauthor.append(f"Version {app.interface.version}")
+    if app.interface.author:
+        versionauthor.append(f"Copyright \u00a9 {app.interface.author}")
+    if versionauthor != []:
+        message += f"<p>{'<br>'.join(versionauthor)}</p>"
+    if app.interface.home_page:
+        message += (
+            f"<p><a href={app.interface.home_page}>{app.interface.home_page}</a></p>"
+        )
+    dialog = QMessageBox(
+        QMessageBox.Information,
+        app.interface.formal_name,
+        message,
+        QMessageBox.NoButton,
+        app.get_current_window(),
+    )
+    icon = dialog.windowIcon()
+    dialog.setIconPixmap(icon.pixmap(icon.actualSize(QSize(64, 64))))
+    dialog.setModal(False)
+    return dialog
+
+
+class App:
+    # Qt apps exit when the last window is closed
+    CLOSE_ON_LAST_WINDOW = True
+    # Qt apps use default command line handling
+    HANDLES_COMMAND_LINE = False
+
+    def __init__(self, interface):
+        self.interface = interface
+        self.interface._impl = self
+
+        self.native = create_qapplication()
+        self.loop = QEventLoop(self.native)
+        asyncio.set_event_loop(self.loop)
+        self.app_close_event = asyncio.Event()
+        # Connect the native signal to an asyncio Event in order
+        # for the main event loop to finish running upon app exit
+        self.native.aboutToQuit.connect(self.app_close_event.set)
+        # Qt does not have a native "applicaction started" signal;
+        # however, tasks scheduled on the event loop will only start
+        # as soon as the application is running.
+        self.loop.call_soon_threadsafe(self.interface._startup)
+
+        self.cursorhidden = False
+
+    ######################################################################
+    # Commands and menus
+    ######################################################################
+
+    def create_standard_commands(self):
+        # On KDE, default bundled apps have the following extra commands,
+        # and they automatically enable / disable based on if the associated
+        # functionality is available for the current focused widget.
+        # There's not a satisfying way to implement that in Qt though...
+        # I've referenced https://stackoverflow.com/questions/2047456, so
+        # we omit the enabled detection for now.
+        # Those KDE bundled apps only have one textfield in the application,
+        # so it's trivial for them to implement it.
+        self.interface.commands.add(
+            Command(
+                EditOperation("undo"),
+                "Undo",
+                shortcut=toga.Key.MOD_1 + "z",
+                group=Group.EDIT,
+                order=10,
+            ),
+            Command(
+                EditOperation("redo"),
+                "Redo",
+                shortcut=toga.Key.SHIFT + toga.Key.MOD_1 + "z",
+                group=Group.EDIT,
+                order=20,
+            ),
+            Command(
+                EditOperation("cut", True),
+                "Cut",
+                shortcut=toga.Key.MOD_1 + "x",
+                group=Group.EDIT,
+                section=10,
+                order=10,
+            ),
+            Command(
+                EditOperation("copy"),
+                "Copy",
+                shortcut=toga.Key.MOD_1 + "c",
+                group=Group.EDIT,
+                section=10,
+                order=20,
+            ),
+            Command(
+                EditOperation("paste", True),
+                "Paste",
+                shortcut=toga.Key.MOD_1 + "v",
+                group=Group.EDIT,
+                section=10,
+                order=30,
+            ),
+        )
+
+    def create_menus(self):
+        for window in self.interface.windows:
+            if hasattr(window._impl, "create_menus"):  # pragma: no branch
+                window._impl.create_menus()
+
+    ######################################################################
+    # App lifecycle
+    ######################################################################
+
+    # We can't call this under test conditions, because it would kill the test harness
+    def exit(self):  # pragma: no cover
+        self.native.quit()
+
+    def main_loop(self):
+        self.loop.run_until_complete(self.app_close_event.wait())
+
+    def set_icon(self, icon):
+        for window in QApplication.topLevelWidgets():
+            window.setWindowIcon(icon._impl.native)
+        self.interface.commands[Command.ABOUT].icon = icon
+        self.interface.commands[Command.PREFERENCES].icon = icon
+
+    def set_main_window(self, window):
+        pass
+
+    ######################################################################
+    # App resources
+    ######################################################################
+
+    def get_screens(self):
+        screens = QGuiApplication.screens()
+        primary = QGuiApplication.primaryScreen()
+        screens = [primary] + [
+            s for s in screens if s != primary
+        ]  # Ensure first is primary
+
+        return [ScreenImpl(native=monitor) for monitor in screens]
+
+    ######################################################################
+    # App state
+    ######################################################################
+
+    def get_dark_mode_state(self):
+        return QGuiApplication.styleHints().colorScheme() == Qt.ColorScheme.Dark
+
+    ######################################################################
+    # App capabilities
+    ######################################################################
+
+    async def _beep(self):
+        process = await asyncio.create_subprocess_exec(
+            "canberra-gtk-play", "-i", "bell"
+        )
+        await process.wait()
+
+    def beep(self):
+        asyncio.create_task(self._beep())
+
+    def show_about_dialog(self):
+        # A reference to the about dialog is stored for facilitate testing.
+        # A new instance is created each time to ensure correct window
+        # membership.
+        self._about_dialog = _create_about_dialog(self)
+        self._about_dialog.show()
+
+    ######################################################################
+    # Cursor control
+    ######################################################################
+
+    def hide_cursor(self):
+        if not self.cursorhidden:
+            self.cursorhidden = True
+            self.native.setOverrideCursor(QCursor(Qt.BlankCursor))
+
+    def show_cursor(self):
+        if self.cursorhidden:
+            self.cursorhidden = False
+            self.native.restoreOverrideCursor()
+
+    ######################################################################
+    # Window control
+    ######################################################################
+
+    def get_current_window(self):
+        return self.native.activeWindow()
+
+    def set_current_window(self, window):
+        window._impl.native.activateWindow()

toga_qt-0.5.3/src/toga_qt/colors.py

@@ -0,0 +1,14 @@
+from PySide6.QtGui import QColor
+from travertino.colors import rgb
+
+
+def native_color(c):
+    if c == "transparent":
+        return QColor(0, 0, 0, 0)
+    return QColor(c.rgba.r, c.rgba.g, c.rgba.b, c.rgba.a * 255)
+
+
+def toga_color(c):
+    if c.alpha() == 0 and c.red() == 0 and c.green() == 0 and c.blue() == 0:
+        return "transparent"
+    return rgb(c.red(), c.green(), c.blue(), c.alpha() / 255)

toga_qt-0.5.3/src/toga_qt/command.py

@@ -0,0 +1,142 @@
+import sys
+
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QApplication
+
+from toga import Command as StandardCommand, Group, Key
+
+from .keys import toga_to_qt_key
+
+
+class EditOperation:
+    """
+    Perform a menu item property onto the focused widget, similar to
+    SEL in Objective-C.  This is used to implement the Edit, Copy, etc.
+    actions.
+
+    :param: needwrite:  Whether write access is required for the focus
+        widget.
+    """
+
+    def __init__(self, method_name, needwrite=False):
+        self.method_name = method_name
+        self.needwrite = needwrite
+
+    def __call__(self, interface):
+        fw = QApplication.focusWidget()
+        if not fw:
+            return
+        if self.needwrite:
+            fnwrite = getattr(fw, "isReadOnly", None)
+            if fnwrite():
+                return
+        fn = getattr(fw, self.method_name, None)
+        fn()
+
+
+class Command:
+    """
+    Command `native` property is a list of native widgets associated with the command.
+
+    Native widgets is of type QAction
+    """
+
+    def __init__(self, interface):
+        self.interface = interface
+        self.native = []
+
+    @classmethod
+    def standard(self, app, id):
+        # ---- File menu ----------
+        if id == StandardCommand.PREFERENCES:
+            return {
+                "text": "Configure " + app.formal_name,
+                "shortcut": Key.MOD_1 + Key.SHIFT + ",",
+                "group": Group.SETTINGS,
+                "section": sys.maxsize - 1,
+                "icon": app.icon,
+            }
+        elif id == StandardCommand.EXIT:
+            return {
+                "text": "Quit",
+                "shortcut": Key.MOD_1 + "q",
+                "group": Group.FILE,
+                "section": sys.maxsize,
+            }
+
+        # ---- File menu -----------------------------------
+        elif id == StandardCommand.NEW:
+            return {
+                "text": "New",
+                "shortcut": Key.MOD_1 + "n",
+                "group": Group.FILE,
+                "section": 0,
+                "order": 0,
+            }
+        elif id == StandardCommand.OPEN:
+            return {
+                "text": "Open...",
+                "shortcut": Key.MOD_1 + "o",
+                "group": Group.FILE,
+                "section": 10,
+                "order": 0,
+            }
+
+        elif id == StandardCommand.SAVE:
+            return {
+                "text": "Save",
+                "shortcut": Key.MOD_1 + "s",
+                "group": Group.FILE,
+                "section": 20,
+                "order": 0,
+            }
+        elif id == StandardCommand.SAVE_AS:
+            return {
+                "text": "Save As...",
+                "shortcut": Key.MOD_1 + "S",
+                "group": Group.FILE,
+                "section": 20,
+                "order": 10,
+            }
+        elif id == StandardCommand.SAVE_ALL:
+            return {
+                "text": "Save All",
+                "shortcut": Key.MOD_1 + "l",
+                "group": Group.FILE,
+                "section": 20,
+                "order": 20,
+            }
+        # ---- Help menu -----------------------------------
+        elif id == StandardCommand.VISIT_HOMEPAGE:
+            return None  # KDE apps have homepage link in about dialog
+        elif id == StandardCommand.ABOUT:
+            return {
+                "text": f"About {app.formal_name}",
+                "group": Group.HELP,
+                "section": sys.maxsize,
+                "icon": app.icon,
+            }
+
+        raise ValueError(f"Unknown standard command {id!r}")
+
+    def set_enabled(self, value):
+        enabled = self.interface.enabled
+        for widget in self.native:
+            widget.setEnabled(enabled)
+
+    def create_menu_item(self):
+        item = QAction(self.interface.text)
+
+        if self.interface.icon:
+            item.setIcon(self.interface.icon._impl.native)
+
+        item.triggered.connect(self.interface.action)
+
+        if self.interface.shortcut is not None:
+            item.setShortcut(toga_to_qt_key(self.interface.shortcut))
+
+        item.setEnabled(self.interface.enabled)
+
+        self.native.append(item)
+
+        return item

toga_qt-0.5.3/src/toga_qt/container.py

@@ -0,0 +1,39 @@
+from PySide6.QtWidgets import QWidget
+
+
+class Container:
+    def __init__(self, content=None, layout_native=None, on_refresh=None):
+        self.native = QWidget()
+        self.native.hide()
+        self.layout_native = self.native if layout_native is None else layout_native
+        self._content = None
+        self.on_refresh = on_refresh
+
+        self.content = content  # Set initial content
+
+    @property
+    def width(self):
+        return self.layout_native.width()
+
+    @property
+    def height(self):
+        return self.layout_native.height()
+
+    @property
+    def content(self):
+        return self._content
+
+    @content.setter
+    def content(self, widget):
+        if self.content:
+            self._content.container = None
+            self._content.native.setParent(None)
+
+        self._content = widget
+
+        if widget:
+            widget.container = self
+            widget.native.setParent(self.native)
+
+    def refreshed(self):
+        self.on_refresh(self)