simulator: test_qa: Add explicit image size tests
Ensure screenshots are standard sized and that their usage in both the README and the class docstrings are scaled appropriately. Signed-off-by: Daniel Thompson <daniel@redfelineninja.org.uk>
This commit is contained in:
parent
ae8d184250
commit
c43d9b1a70
1 changed files with 57 additions and 9 deletions
|
@ -2,22 +2,58 @@ import pytest
|
||||||
import wasp
|
import wasp
|
||||||
import importlib
|
import importlib
|
||||||
import os
|
import os
|
||||||
|
from PIL import Image
|
||||||
|
|
||||||
EXCLUDE = ('Notifications', 'Template', 'Faces', 'ReadMe')
|
EXCLUDE = ('Notifications', 'Template', 'Faces', 'ReadMe')
|
||||||
|
|
||||||
|
def test_screenshot(constructor):
|
||||||
|
if constructor.NAME in EXCLUDE:
|
||||||
|
return
|
||||||
|
fname = f'res/{constructor.NAME}App.png'.replace(' ', '')
|
||||||
|
|
||||||
|
# Every application requires a screenshot be captured for use in the
|
||||||
|
# documentation. The screenshots must conform to standard dimensions
|
||||||
|
# and have a specific name. The apps are shown in a grid at
|
||||||
|
# https://wasp-os.readthedocs.io/en/latest/README.html#screenshots
|
||||||
|
# so your app will look untidy if it does not use the same dimensions
|
||||||
|
# as the others.
|
||||||
|
#
|
||||||
|
# Press 's' in the simulator to capture a screenshot that meets these
|
||||||
|
# requirements.
|
||||||
|
with Image.open(fname) as screenshot:
|
||||||
|
assert screenshot.width == 358
|
||||||
|
assert screenshot.height == 406
|
||||||
|
|
||||||
def test_README(constructor):
|
def test_README(constructor):
|
||||||
if constructor.NAME in EXCLUDE:
|
if constructor.NAME in EXCLUDE:
|
||||||
return
|
return
|
||||||
fname = f'res/{constructor.NAME}App.png'.replace(' ', '')
|
fname = f'res/{constructor.NAME}App.png'.replace(' ', '')
|
||||||
|
|
||||||
# A screenshot must exist for every application (press 's' in the
|
|
||||||
# simulator)
|
|
||||||
assert os.path.exists(fname)
|
|
||||||
|
|
||||||
# Every screenshot must be included in the README image gallery
|
|
||||||
with open('README.rst') as f:
|
with open('README.rst') as f:
|
||||||
readme = f.read()
|
readme = f.readlines()
|
||||||
assert fname in readme
|
|
||||||
|
# Get the offset (or offsets) of that fname within the file
|
||||||
|
offsets = [i for i, ln in enumerate(readme) if fname in ln]
|
||||||
|
|
||||||
|
# Every app must have its screenshot included in the README image
|
||||||
|
# gallery.
|
||||||
|
assert len(offsets) >= 1
|
||||||
|
|
||||||
|
for offset in offsets:
|
||||||
|
# Paranoid self-test of the test code
|
||||||
|
assert fname in readme[offset]
|
||||||
|
|
||||||
|
# There must be alt text attached to every instance of the
|
||||||
|
# screenshot (and it must be on the line following the
|
||||||
|
# screenshot.
|
||||||
|
assert ':alt:' in readme[offset+1]
|
||||||
|
|
||||||
|
# The width must be set to 179 (e.g. half the true size). The
|
||||||
|
# watch is a HiDPI device and HTML pixel width coordinates are
|
||||||
|
# based on a low value DPI. Thus we need to scale them on older
|
||||||
|
# displays for them to look right (a browser on a HiDPI laptop
|
||||||
|
# will do the right thing and not downscale).
|
||||||
|
assert ':width: 179' in readme[offset+2]
|
||||||
|
|
||||||
def test_app_library(constructor):
|
def test_app_library(constructor):
|
||||||
if constructor.NAME in EXCLUDE:
|
if constructor.NAME in EXCLUDE:
|
||||||
|
@ -41,13 +77,25 @@ def test_docstrings(constructor):
|
||||||
class_doc = constructor.__doc__
|
class_doc = constructor.__doc__
|
||||||
module_doc = importlib.import_module(constructor.__module__).__doc__
|
module_doc = importlib.import_module(constructor.__module__).__doc__
|
||||||
|
|
||||||
# Screenshots should *not* appear in the constructor.
|
# Screenshots should *not* be included in the constructor doc
|
||||||
|
# strings.
|
||||||
if constructor.__doc__:
|
if constructor.__doc__:
|
||||||
assert fname not in constructor.__doc__
|
assert fname not in constructor.__doc__
|
||||||
|
|
||||||
# Screenshots should appear in the full module documentation
|
# Screenshots must be included in the full module documentation
|
||||||
assert f'.. figure:: {fname }' in module_doc
|
assert f'.. figure:: {fname }' in module_doc
|
||||||
|
|
||||||
|
# The width must be set to 179 (e.g. half the true size). The
|
||||||
|
# watch is a HiDPI device and HTML pixel width coordinates are
|
||||||
|
# based on a low value DPI. Thus we need to scale them on older
|
||||||
|
# displays for them to look right (a browser on a HiDPI laptop
|
||||||
|
# will do the right thing and not downscale).
|
||||||
|
#
|
||||||
|
# Note that this can be a looser test than the one for the
|
||||||
|
# README because there shouldn't be too many other images in
|
||||||
|
# the class docstrings.
|
||||||
|
assert ':width: 179' in module_doc
|
||||||
|
|
||||||
# The second line of the module documentation should be an
|
# The second line of the module documentation should be an
|
||||||
# underline (e.g. the first line must be a section header)
|
# underline (e.g. the first line must be a section header)
|
||||||
assert(module_doc.split('\n')[1].startswith('~~~~'))
|
assert(module_doc.split('\n')[1].startswith('~~~~'))
|
||||||
|
|
Loading…
Reference in a new issue