Test app

.github/workflows/ci.yml

@@ -96,21 +96,13 @@ jobs:
  run: |
  tox -e py-core
  cd core
- python -m coverage xml
  mv .coverage .coverage.${{ matrix.platform }}.${{ matrix.python-version }}
  - name: Store coverage data
  uses: actions/upload-artifact@v3
  with:
  name: core-coverage-data
  path: "core/.coverage.*"
  if-no-files-found: error
- - name: Upload coverage data to CodeCov
- uses: codecov/codecov-action@v3
- with:
- token: ${{ secrets.CODECOV_TOKEN }}
- file: core/coverage.xml
- flags: unittests
- fail_ci_if_error: true
 
  core-coverage:
  name: Combine & check core coverage.
@@ -190,3 +182,58 @@ jobs:
  TOGA_INSTALL_COMMAND: 'bash -c "pip install ../{core,dummy,${{ matrix.backend }}}/dist/*.whl"'
  run: |
  tox -e py-${{ matrix.backend }}
+
+ testbed:
+ needs: core
+ strategy:
+ fail-fast: false
+ matrix:
+ backend: ["macOS", "windows", "linux", "android", "iOS"]
+ include:
+ - pre-command:
+ briefcase-run-prefix:
+ briefcase-run-args:
+
+ - backend: macOS
+ runs-on: macos-12
+
+ - backend: linux
+ runs-on: ubuntu-latest
+ pre-command: "sudo apt-get update -y && sudo apt-get install -y python3-gi python3-gi-cairo gir1.2-gtk-3.0 python3-dev libgirepository1.0-dev libcairo2-dev pkg-config"
+ briefcase-run-prefix: 'xvfb-run -a -s "-screen 0 2048x1536x24"'
+
+ - backend: windows
+ runs-on: windows-latest
+
+ - backend: iOS
+ runs-on: macos-12
+ briefcase-run-args: ' -d "iPhone SE (3rd generation)"'
+
+ - backend: android
+ runs-on: macos-12
+ briefcase-run-args: " -d '{\"avd\":\"beePhone\"}' --Xemulator=-no-window --Xemulator=-no-snapshot --Xemulator=-no-audio --Xemulator=-no-boot-anim --shutdown-on-exit"
+
+ runs-on: ${{ matrix.runs-on }}
+ steps:
+ - uses: actions/checkout@v3.1.0
+ with:
+ fetch-depth: 0
+ - name: Set up Python
+ uses: actions/setup-python@v4.3.0
+ with:
+ python-version: "3.X"
+ - name: Install dependencies
+ run: |
+ ${{ matrix.pre-command }}
+ # Use the development version of Briefcase
+ pip install git+https://github.com/beeware/briefcase.git
+ - name: Test App
+ run: |
+ cd testbed
+ ${{ matrix.briefcase-run-prefix }} briefcase run ${{ matrix.backend }} --test ${{ matrix.briefcase-run-args }}
+ - uses: actions/upload-artifact@v3
+ name: Upload logs
+ if: failure()
+ with:
+ name: testbed-failure-logs-${{ matrix.backend }}
+ path: testbed/logs/*

android/MANIFEST.in

@@ -3,3 +3,4 @@ include LICENSE
 include README.rst
 include tox.ini
 recursive-include tests *.py
+recursive-include tests_backend *.py

android/tests_backend/widgets/base.py

@@ -0,0 +1,43 @@
+from pytest import skip
+
+
+class SimpleProbe:
+ def __init__(self, widget):
+ self.native = widget._impl.native
+ assert isinstance(self.native, self.native_class)
+
+ def assert_container(self, container):
+ container_native = container._impl.native
+ for i in range(container_native.getChildCount()):
+ child = container_native.getChildAt(i)
+ if child is self.native:
+ break
+ else:
+ raise AssertionError(f"cannot find {self.native} in {container_native}")
+
+ @property
+ def enabled(self):
+ return self.native.isEnabled()
+
+ @property
+ def background_color(self):
+ skip("not implemented: background_color")
+
+ @property
+ def color(self):
+ skip("not implemented: color")
+
+ @property
+ def hidden(self):
+ skip("not implemented: hidden")
+
+ @property
+ def width(self):
+ return self.native.getWidth()
+
+ @property
+ def height(self):
+ return self.native.getHeight()
+
+ def press(self):
+ self.native.performClick()

android/tests_backend/widgets/button.py

@@ -0,0 +1,8 @@
+from java import jclass
+
+from .label import LabelProbe
+
+
+# On Android, a Button is just a TextView with a state-dependent background image.
+class ButtonProbe(LabelProbe):
+ native_class = jclass("android.widget.Button")

android/tests_backend/widgets/label.py

@@ -0,0 +1,16 @@
+from java import jclass
+
+from .base import SimpleProbe
+from .properties import toga_color
+
+
+class LabelProbe(SimpleProbe):
+ native_class = jclass("android.widget.TextView")
+
+ @property
+ def color(self):
+ return toga_color(self.native.getCurrentTextColor())
+
+ @property
+ def text(self):
+ return str(self.native.getText())

android/tests_backend/widgets/properties.py

@@ -0,0 +1,15 @@
+from java import jint
+
+from android.graphics import Color
+from toga.colors import rgba
+
+
+def toga_color(color_int):
+ # Select the `int` overloads rather than the `long` ones.
+ color_int = jint(color_int)
+ return rgba(
+ Color.red(color_int),
+ Color.green(color_int),
+ Color.blue(color_int),
+ Color.alpha(color_int) / 255,
+ )

android/tests_backend/widgets/slider.py

@@ -0,0 +1,24 @@
+from java import jclass
+
+from android.os import Build
+
+from .base import SimpleProbe
+
+
+class SliderProbe(SimpleProbe):
+ native_class = jclass("android.widget.SeekBar")
+
+ @property
+ def position(self):
+ return (self.native.getProgress() - self._min) / (self._max - self._min)
+
+ def change(self, position):
+ self.native.setProgress(self._min + round(position * (self._max - self._min)))
+
+ @property
+ def _min(self):
+ return 0 if (Build.VERSION.SDK_INT < 26) else self.native.getMin()
+
+ @property
+ def _max(self):
+ return self.native.getMax()

changes/1687.misc.rst

@@ -0,0 +1 @@
+Added a backend test app.

iOS/src/toga_iOS/app.py

@@ -110,8 +110,10 @@ def open_document(self, fileURL):
  pass
 
  def main_loop(self):
- # Main loop is a no-op on iOS; the app loop is integrated with the
- # main iOS event loop.
+ # 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
+ # the app in a state such that asyncio events will be scheduled on the
+ # iOS event loop.
  self.loop.run_forever_cooperatively(lifecycle=iOSLifecycle())
 
  def set_main_window(self, window):

pyproject.toml

@@ -35,6 +35,7 @@ known_first_party = [
  "toga_dummy",
  "toga_gtk",
  "toga_iOS",
+ "toga_test",
  "toga_web",
  "toga_winforms",
 ]

testbed/.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/

testbed/pyproject.toml

@@ -0,0 +1,90 @@
+# This project was generated using template: https://github.com/beeware/briefcase-template and branch: v0.3.12
+[tool.briefcase]
+project_name = "Toga Testbed"
+bundle = "org.beeware.toga"
+version = "0.0.1"
+url = "https://beeware.org"
+license = "BSD license"
+author = 'Tiberius Yak'
+author_email = "tiberius@beeware.org"
+
+[tool.briefcase.app.testbed]
+formal_name = "Toga Testbed"
+description = "A testbed for Toga visual tests"
+icon = "src/testbed/resources/testbed"
+sources = [
+ 'src/testbed',
+]
+test_sources = [
+ 'tests',
+]
+requires = [
+ '../core',
+]
+test_requires = [
+ 'pytest==7.2.0',
+ 'pytest-asyncio==0.20.2',
+]
+
+
+[tool.briefcase.app.testbed.macOS]
+requires = [
+ '../cocoa',
+ 'std-nslog~=1.0.0'
+]
+
+[tool.briefcase.app.testbed.linux]
+requires = [
+ '../gtk',
+]
+
+[tool.briefcase.app.testbed.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.testbed.linux.flatpak]
+flatpak_runtime = 'org.gnome.Platform'
+flatpak_runtime_version = '42'
+flatpak_sdk = 'org.gnome.Sdk'
+
+[tool.briefcase.app.testbed.windows]
+test_sources = [
+ '../winforms/tests_backend',
+]
+requires = [
+ '../winforms',
+]
+
+# Mobile deployments
+[tool.briefcase.app.testbed.iOS]
+requires = [
+ '../iOS',
+ 'std-nslog~=1.0.0'
+]
+
+[tool.briefcase.app.testbed.android]
+test_sources = [
+ '../android/tests_backend',
+]
+requires = [
+ '../android'
+]
+
+# TODO: replace with extractPackages
+build_gradle_extra_content = "android.defaultConfig.python.pyc.src false"
+
+[tool.briefcase.app.testbed.web]
+requires = [
+ '../web'
+]
+style_framework = "Bootstrap v4.6"

testbed/src/testbed/__main__.py

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