# Released under the MIT License. See LICENSE for details.
#
"""Provides UI for test settings."""
from __future__ import annotations # Docs-generation hack.
import copy
from typing import TYPE_CHECKING, override
import bauiv1 as bui
from bauiv1 import _commonassets, _classicassets
from bauiv1lib.utils import get_screen_margins, scroll_fade_top
if TYPE_CHECKING:
from typing import Any, Callable
[docs]
class TestingWindow(bui.MainWindow):
"""Window for conveniently testing various settings."""
def __init__(
self,
title: bui.Lstr | bui.LangStr,
entries: list[dict[str, Any]],
transition: str | None = 'in_right',
origin_widget: bui.Widget | None = None,
):
assert bui.app.classic is not None
uiscale = bui.app.ui_v1.uiscale
self._width = 1200 if uiscale is bui.UIScale.SMALL else 600
self._height = 800 if uiscale is bui.UIScale.SMALL else 400
self._entries_orig = copy.deepcopy(entries)
self._entries = copy.deepcopy(entries)
# Do some fancy math to fill all available screen area up to the
# size of our backing container. This lets us fit to the exact
# screen shape at small ui scale.
screensize = bui.get_virtual_screen_size()
scale = (
2.27
if uiscale is bui.UIScale.SMALL
else 1.2 if uiscale is bui.UIScale.MEDIUM else 1.0
)
# Calc screen size in our local container space and clamp to a
# bit smaller than our container size.
target_width = min(self._width - 60, screensize[0] / scale)
target_height = min(self._height - 70, screensize[1] / scale)
# To get top/left coords, go to the center of our window and
# offset by half the width/height of our target area.
yoffs = 0.5 * self._height + 0.5 * target_height + 30.0
self._scroll_width = target_width
self._scroll_height = target_height - 47
self._scroll_bottom = yoffs - 78 - self._scroll_height
# In small ui we extend our scrollable area out into the screen
# margins (space between the virtual bounds and the actual
# screen edges) while keeping content laid out within the
# virtual bounds.
margin_left, margin_right, margin_bottom, margin_top = (
get_screen_margins(scale)
if uiscale is bui.UIScale.SMALL
else (0.0, 0.0, 0.0, 0.0)
)
# In small ui we also extend the scroll's top edge all the way
# up to the top of the screen; soft blobs then keep our title
# and info text legible over any content scrolled up there.
# Content gets padded to stay exactly where it would be with
# the top edge in its standard spot below the title.
top_extend = (
(0.5 * self._height + 0.5 * (screensize[1] / scale))
- (self._scroll_bottom + self._scroll_height)
+ margin_top
if uiscale is bui.UIScale.SMALL
else 0.0
)
# A bit of extra padding above our content so the soft blobs
# fading things out under the title don't eat into our top
# row when scrolled to the top.
top_pad = 15.0
super().__init__(
root_widget=bui.containerwidget(
size=(self._width, self._height),
scale=scale,
toolbar_visibility=(
'menu_minimal'
if uiscale is bui.UIScale.SMALL
else 'menu_full'
),
),
transition=transition,
origin_widget=origin_widget,
# We're affected by screen size only at small ui-scale.
refresh_on_screen_size_changes=uiscale is bui.UIScale.SMALL,
)
if uiscale is bui.UIScale.SMALL:
self._back_button = bui.get_special_widget('back_button')
bui.containerwidget(
edit=self._root_widget, on_cancel_call=self.main_window_back
)
else:
self._back_button = btn = bui.buttonwidget(
parent=self._root_widget,
autoselect=True,
position=(35, yoffs - 59),
size=(60, 60),
scale=0.8,
text_scale=1.2,
label=bui.charstr(bui.SpecialChar.BACK),
button_type='backSmall',
on_activate_call=self.main_window_back,
)
bui.containerwidget(edit=self._root_widget, cancel_button=btn)
self.title = title
self._scrollwidget = bui.scrollwidget(
parent=self._root_widget,
size=(
self._scroll_width + margin_left + margin_right,
self._scroll_height + margin_bottom + top_extend,
),
position=(
self._width * 0.5 - self._scroll_width * 0.5 - margin_left,
self._scroll_bottom - margin_bottom,
),
highlight=False,
border_opacity=0.4,
center_small_content_horizontally=True,
)
bui.containerwidget(edit=self._scrollwidget, claims_left_right=True)
# Our scroll area extends up past our title; these soft blobs
# (plus the title and info text being drawn after the scroll
# area) keep those legible over content scrolled up there.
# Note that we intentionally use the original
# un-margin-extended scroll geometry here so the blobs
# coincide with the title, which doesn't move when we extend
# out into screen margins.
if uiscale is bui.UIScale.SMALL:
scroll_fade_top(
self._root_widget,
self._width * 0.5 - self._scroll_width * 0.5,
self._scroll_bottom,
self._scroll_width,
self._scroll_height,
# Nudge the blobs up so their most-opaque core covers
# our title and info-text area.
yoffs_extra=30.0,
)
bui.textwidget(
parent=self._root_widget,
position=(
self._width * 0.5,
yoffs - (43 if uiscale is bui.UIScale.SMALL else 35),
),
size=(0, 0),
scale=0.7 if uiscale is bui.UIScale.SMALL else 1.0,
color=bui.app.ui_v1.title_color,
h_align='center',
v_align='center',
maxwidth=245,
text=self.title,
)
bui.textwidget(
parent=self._root_widget,
position=(
self._width * 0.5,
yoffs - 65,
),
size=(0, 0),
scale=0.5,
color=bui.app.ui_v1.infotextcolor,
h_align='center',
v_align='center',
maxwidth=self._scroll_width * 0.75,
text=_classicassets.strings.settings.testing.for_testing_note,
)
self._spacing = 50
self._sub_width = self._scroll_width * 0.95
self._sub_height = (
50
+ len(self._entries) * self._spacing
+ 60
+ margin_bottom
+ top_extend
+ top_pad
)
self._subcontainer = bui.containerwidget(
parent=self._scrollwidget,
size=(self._sub_width, self._sub_height),
background=False,
)
h = 230
# (start below the top-edge extension plus padding so content
# sits just below where the soft blobs fade things out).
v = self._sub_height - top_extend - top_pad - 48
for i, entry in enumerate(self._entries):
entry_name = entry['name']
# If we haven't yet, record the default value for this name
# so we can reset if we want..
if entry_name not in bui.app.classic.value_test_defaults:
bui.app.classic.value_test_defaults[entry_name] = (
bui.app.classic.value_test(entry_name)
)
bui.textwidget(
parent=self._subcontainer,
position=(h, v),
size=(0, 0),
h_align='right',
v_align='center',
maxwidth=200,
text=entry['label'],
)
btn = bui.buttonwidget(
parent=self._subcontainer,
position=(h + 20, v - 19),
size=(40, 40),
autoselect=True,
repeat=True,
left_widget=self._back_button,
button_type='square',
label='-',
on_activate_call=bui.CallStrict(
self._on_minus_press, entry['name']
),
)
if i == 0:
bui.widget(edit=btn, up_widget=self._back_button)
entry['widget'] = bui.textwidget(
parent=self._subcontainer,
position=(h + 100, v),
size=(0, 0),
h_align='center',
v_align='center',
maxwidth=60,
text=f'{bui.app.classic.value_test(entry_name):.4g}',
)
btn = bui.buttonwidget(
parent=self._subcontainer,
position=(h + 140, v - 19),
size=(40, 40),
autoselect=True,
repeat=True,
button_type='square',
label='+',
on_activate_call=bui.CallStrict(
self._on_plus_press, entry['name']
),
)
if i == 0:
bui.widget(edit=btn, up_widget=self._back_button)
v -= self._spacing
v -= 35
bui.buttonwidget(
parent=self._subcontainer,
autoselect=True,
size=(200, 50),
position=(self._sub_width * 0.5 - 100, v),
label=_commonassets.strings.actions.reset,
right_widget=btn,
on_activate_call=self._on_reset_press,
)
def _get_entry(self, name: str) -> dict[str, Any]:
for entry in self._entries:
if entry['name'] == name:
return entry
raise bui.NotFoundError(f'Entry not found: {name}')
def _on_reset_press(self) -> None:
assert bui.app.classic is not None
for entry in self._entries:
bui.app.classic.value_test(
entry['name'],
absolute=bui.app.classic.value_test_defaults[entry['name']],
)
bui.textwidget(
edit=entry['widget'],
text=f'{bui.app.classic.value_test(entry['name']):.4g}',
)
def _on_minus_press(self, entry_name: str) -> None:
assert bui.app.classic is not None
entry = self._get_entry(entry_name)
bui.app.classic.value_test(entry['name'], change=-entry['increment'])
# pylint: disable=consider-using-f-string
bui.textwidget(
edit=entry['widget'],
text='%.4g' % bui.app.classic.value_test(entry['name']),
)
def _on_plus_press(self, entry_name: str) -> None:
assert bui.app.classic is not None
entry = self._get_entry(entry_name)
bui.app.classic.value_test(entry['name'], change=entry['increment'])
# pylint: disable=consider-using-f-string
bui.textwidget(
edit=entry['widget'],
text='%.4g' % bui.app.classic.value_test(entry['name']),
)
[docs]
@override
def get_main_window_state(self) -> bui.MainWindowState:
# Support recreating our window for back/refresh purposes.
cls = type(self)
# Pull values from self here; if we do it in the lambda we'll
# keep self alive which we don't want.
title = self.title
entries = self._entries_orig
return bui.BasicMainWindowState(
create_call=lambda transition, origin_widget: cls(
title=title,
entries=entries,
transition=transition,
origin_widget=origin_widget,
)
)
# Docs-generation hack; import some stuff that we likely only forward-declared
# in our actual source code so that docs tools can find it.
from typing import (Coroutine, Any, Literal, Callable,
Generator, Awaitable, Sequence, Self)
import asyncio
from concurrent.futures import Future
from pathlib import Path
from enum import Enum