Test app

pyproject.toml

@@ -29,12 +29,14 @@ profile = "black"
 split_on_trailing_comma = true
 combine_as_imports = true
 known_first_party = [
+    "tests",
     "toga",
     "toga_android",
     "toga_cocoa",
     "toga_dummy",
     "toga_gtk",
     "toga_iOS",
+    "toga_test",
     "toga_web",
     "toga_winforms",
 ]

test/.gitignore

@@ -0,0 +1,69 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# OSX useful to ignore
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# IntelliJ Idea family of suites
+.idea
+*.iml
+## File-based project format:
+*.ipr
+*.iws
+## mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# Briefcase build directories
+iOS/
+macOS/
+windows/
+android/
+linux/
+django/
+
+# Briefcase log files
+logs/

test/pyproject.toml

@@ -0,0 +1,84 @@
+# This project was generated using template: https://github.com/beeware/briefcase-template and branch: v0.3.12
+[tool.briefcase]
+project_name = "Toga test"
+bundle = "org.beeware"
+version = "0.0.1"
+url = "https://beeware.org"
+license = "BSD license"
+author = 'Tiberius Yak'
+author_email = "[email protected]"
+
+[tool.briefcase.app.toga-test]
+formal_name = "Toga test"
+description = "Toga test"
+icon = "src/toga_test/resources/toga_test"
+sources = [
+    'src/toga_test',
+    'src/tests',
+]
+requires = [
+    '../core',
+    '../dummy',
+    'pytest==7.2.0',
+    'pytest-asyncio==0.20.2',
+]
+
+
+[tool.briefcase.app.toga-test.macOS]
+requires = [
+    '../cocoa',
+    'std-nslog~=1.0.0'
+]
+
+[tool.briefcase.app.toga-test.linux]
+requires = [
+    '../gtk',
+]
+
+[tool.briefcase.app.toga-test.linux.appimage]
+system_requires = [
+    'gir1.2-webkit-3.0',
+    'libcairo2-dev',
+    'libgirepository1.0-dev',
+    'libgtk-3-dev',
+    'libpango1.0-dev',
+    'librsvg2-dev',
+    'libwebkitgtk-3.0-0',
+]
+linuxdeploy_plugins = [
+    'DEPLOY_GTK_VERSION=3 gtk',
+]
+
+[tool.briefcase.app.toga-test.linux.flatpak]
+flatpak_runtime = 'org.gnome.Platform'
+flatpak_runtime_version = '42'
+flatpak_sdk = 'org.gnome.Sdk'
+
+[tool.briefcase.app.toga-test.windows]
+sources = [
+    '../winforms/test_probes',
+]
+requires = [
+    '../winforms',
+]
+
+# Mobile deployments
+[tool.briefcase.app.toga-test.iOS]
+requires = [
+    '../iOS',
+    'std-nslog~=1.0.0'
+]
+
+[tool.briefcase.app.toga-test.android]
+requires = [
+    '../android'
+]
+
+# TODO: replace with extractPackages
+build_gradle_extra_content = "android.defaultConfig.python.pyc.src false"
+
+[tool.briefcase.app.toga-test.web]
+requires = [
+    '../web'
+]
+style_framework = "Bootstrap v4.6"

test/src/tests/conftest.py

@@ -0,0 +1,57 @@
+import asyncio
+import inspect
+from dataclasses import dataclass
+
+from pytest import fixture
+
+import toga_test.app
+
+
+@fixture(scope="session")
+def app():
+    return toga_test.app.app
+
+
+@fixture(scope="session")
+def main_box(app):
+    return app.main_box
+
+
+# Controls the event loop used by pytest-asyncio.
+@fixture(scope="session")
+def event_loop(app):
+    return ProxyEventLoop(app._impl.loop)
+
+
+# Proxy which forwards all tasks to another event loop in a thread-safe manner. It
+# implements only the methods used by pytest-asyncio.
+@dataclass
+class ProxyEventLoop(asyncio.AbstractEventLoop):
+    loop: object
+
+    # Used by ensure_future.
+    def create_task(self, coro):
+        return ProxyTask(coro)
+
+    def run_until_complete(self, future):
+        if inspect.iscoroutine(future):
+            coro = future
+        elif isinstance(future, ProxyTask):
+            coro = future.coro
+        else:
+            raise TypeError(f"Future type {type(future)} is not currently supported")
+        return asyncio.run_coroutine_threadsafe(coro, self.loop).result()
+
+    def close(self):
+        pass
+
+
+@dataclass
+class ProxyTask:
+    coro: object
+
+    # Used by ensure_future.
+    _source_traceback = None
+
+    def done(self):
+        return False

test/src/tests/test_data.py

@@ -0,0 +1,16 @@
+from toga.colors import rgba
+
+# TODO: add non-ASCII strings.
+TEXTS = ["", " ", "a", "ab", "abc", "hello world", "hello\nworld"]
+
+
+# TODO: include None
+components = [0, 1, 2, 128, 253, 254, 255]
+alphas = [0.0, 0.01, 0.1, 0.5, 0.9, 0.99, 1.0]
+COLORS = [
+    rgba(r, g, b, a)
+    for r in components
+    for g in components
+    for b in components
+    for a in alphas
+]

test/src/tests/test_utils.py

@@ -0,0 +1,9 @@
+# TODO: rename to utils.py once optimizations are disabled in the stub app. Until then,
+# assertions in files not named test_*.py will raise "PytestConfigWarning: assertions not
+# in test modules or plugins will be ignored".
+
+
+def set_get(obj, name, value):
+    """Calls a setter, then verifies that the same value is returned by the getter."""
+    setattr(obj, name, value)
+    assert getattr(obj, name) == value

test/src/tests/widgets/conftest.py

@@ -0,0 +1,17 @@
+from importlib import import_module
+
+from pytest import fixture
+
+
+@fixture
+async def widget(main_box, new_widget):
+    main_box.add(new_widget)
+    yield new_widget
+    main_box.remove(new_widget)
+
+
+@fixture
+async def probe(main_box, widget):
+    name = type(widget).__name__
+    module = import_module(f"test_probes.widgets.probe_{name.lower()}")
+    return getattr(module, f"{name}Probe")(main_box, widget)

test/src/tests/widgets/test_button.py

@@ -0,0 +1,19 @@
+from unittest.mock import Mock
+
+from pytest import fixture
+
+import toga
+
+
+@fixture
+async def new_widget():
+    return toga.Button("")
+
+
+async def test_press(widget, probe):
+    handler = Mock()
+    # TODO: can't use set_get, because getattr returns the wrapped handler, which is an
+    # implementation detail that we shouldn't expose.
+    setattr(widget, "on_press", handler)
+    probe.press()
+    handler.assert_called_once_with(widget)

test/src/tests/widgets/test_label.py

@@ -0,0 +1,44 @@
+from pytest import approx, fixture
+
+import toga
+
+from ..test_data import COLORS, TEXTS
+from ..test_utils import set_get
+
+
+@fixture
+async def new_widget():
+    return toga.Label("")
+
+
+async def test_text(widget, probe):
+    for text in TEXTS:
+        set_get(widget, "text", text)
+        assert probe.text == text
+
+
+async def test_color(widget, probe):
+    for color in COLORS:
+        widget.style.color = color
+        for component in ["r", "g", "b"]:
+            assert getattr(probe.color, component) == getattr(color, component)
+        assert probe.color.a == approx(color.a, abs=(1 / 256))
+
+
+async def test_multiline(widget, probe):
+    def make_lines(n):
+        return "\n".join(f"line{i}" for i in range(n))
+
+    widget.text = make_lines(1)
+    line_height = probe.height
+
+    widget.text = make_lines(2)
+    assert probe.height == approx(line_height * 2, rel=0.1)
+    line_spacing = probe.height - (line_height * 2)
+
+    for n in range(3, 10):
+        widget.text = make_lines(n)
+        assert probe.height == approx(
+            (line_height * n) + (line_spacing * (n - 1)),
+            rel=0.1,
+        )

test/src/toga_test/__main__.py

@@ -0,0 +1,4 @@
+from toga_test.app import main
+
+if __name__ == "__main__":
+    main().main_loop()