mirror of
https://github.com/praktimarc/kst4contest.git
synced 2026-11-19 01:52:29 +01:00
Add setup wizard state and its course rules
Written-by: Gemini 4 Hydrogen (Antigravity) Written-by: Claude Fable 5.2
This commit is contained in:
2 files changed
+614
No files matched your search
@@ -0,0 +1,319 @@
|
||||
package kst4contest.view.compose.wizard
|
||||
|
||||
import androidx.compose.runtime.getValue
|
||||
import androidx.compose.runtime.mutableStateOf
|
||||
import androidx.compose.runtime.setValue
|
||||
import kst4contest.controller.LoginConfiguration
|
||||
import kst4contest.model.ChatCategory
|
||||
import kst4contest.model.ChatPreferences
|
||||
|
||||
/** Where the answers of one group come from. */
|
||||
enum class WizardSource {
|
||||
/** Entered in the wizard, starting from the wizard's own empty values. */
|
||||
NEW,
|
||||
|
||||
/** What the profile already holds. */
|
||||
KEEP,
|
||||
}
|
||||
|
||||
/** The pages, in the order they can appear. */
|
||||
enum class WizardPage { ENTRY, PERSONAL, LOGIN, SITE, SUMMARY }
|
||||
|
||||
/**
|
||||
* A band the station can be active on.
|
||||
*
|
||||
* The labels are amateur shorthand and deliberately not in the translation files.
|
||||
*/
|
||||
enum class WizardBand(
|
||||
val label: String,
|
||||
val megahertz: Int,
|
||||
internal val isActive: (ChatPreferences) -> Boolean,
|
||||
internal val setActive: (ChatPreferences, Boolean) -> Unit,
|
||||
) {
|
||||
B50("50 MHz", 50, { it.isStn_bandActive50() }, { p, on -> p.setStn_bandActive50(on) }),
|
||||
B70("70 MHz", 70, { it.isStn_bandActive70() }, { p, on -> p.setStn_bandActive70(on) }),
|
||||
B144("144 MHz", 144, { it.isStn_bandActive144() }, { p, on -> p.setStn_bandActive144(on) }),
|
||||
B432("432 MHz", 432, { it.isStn_bandActive432() }, { p, on -> p.setStn_bandActive432(on) }),
|
||||
B1240("1240 MHz", 1240, { it.isStn_bandActive1240() }, { p, on -> p.setStn_bandActive1240(on) }),
|
||||
B2300("2300 MHz", 2300, { it.isStn_bandActive2300() }, { p, on -> p.setStn_bandActive2300(on) }),
|
||||
B3400("3400 MHz", 3400, { it.isStn_bandActive3400() }, { p, on -> p.setStn_bandActive3400(on) }),
|
||||
B5600("5600 MHz", 5600, { it.isStn_bandActive5600() }, { p, on -> p.setStn_bandActive5600(on) }),
|
||||
B10G("10 GHz", 10000, { it.isStn_bandActive10G() }, { p, on -> p.setStn_bandActive10G(on) }),
|
||||
}
|
||||
|
||||
/**
|
||||
* The setup wizard's answers and the rules of its course, free of any window.
|
||||
*
|
||||
* It reads the preferences once, when it is built, and does not touch them again until
|
||||
* [writeTo]: closing the wizard without saving therefore leaves the profile exactly as it
|
||||
* was. The design is in `docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md`.
|
||||
*
|
||||
* The answers are Compose state, so a composition reading them follows; nothing else here
|
||||
* depends on Compose.
|
||||
*
|
||||
* @param prefs the profile's preferences, already read from its file
|
||||
*/
|
||||
class SetupWizardState(prefs: ChatPreferences) {
|
||||
|
||||
private val loginConfigured = !LoginConfiguration.isUnconfigured(prefs)
|
||||
private val templateCredentials = LoginConfiguration.carriesTemplateCredentials(prefs)
|
||||
|
||||
/** The callsign the profile holds, for the label of "leave unchanged". */
|
||||
val storedCallsign: String = prefs.getStn_loginCallSign().orEmpty()
|
||||
private val storedPassword: String = prefs.getStn_loginPassword().orEmpty()
|
||||
private val storedName: String = prefs.getStn_loginNameMainCat().orEmpty()
|
||||
private val storedSecondName: String = prefs.getStn_loginNameSecondCat().orEmpty()
|
||||
|
||||
/** The locator the profile holds, for the label of "leave unchanged". */
|
||||
val storedLocator: String = prefs.getStn_loginLocatorMainCat().orEmpty()
|
||||
private val storedBands: Set<WizardBand> = WizardBand.entries.filter { it.isActive(prefs) }.toSet()
|
||||
private val storedCategory: Int? = prefs.getLoginChatCategoryMain()?.categoryNumber
|
||||
private val storedSecondChat: Boolean = prefs.isLoginToSecondChatEnabled()
|
||||
private val storedSecondCategory: Int? = prefs.getLoginChatCategorySecond()?.categoryNumber
|
||||
|
||||
/** A login can only be kept where an operator entered one. */
|
||||
val loginSources: List<WizardSource> = buildList {
|
||||
add(WizardSource.NEW)
|
||||
if (loginConfigured) add(WizardSource.KEEP)
|
||||
}
|
||||
|
||||
/**
|
||||
* A station can be kept unless the profile is the untouched template: its locator and
|
||||
* bands are then nobody's.
|
||||
*/
|
||||
val stationSources: List<WizardSource> = buildList {
|
||||
add(WizardSource.NEW)
|
||||
if (!templateCredentials) add(WizardSource.KEEP)
|
||||
}
|
||||
|
||||
/** Whether there is anything to choose on the entry page. */
|
||||
val hasEntryPage: Boolean = loginSources.size > 1 || stationSources.size > 1
|
||||
|
||||
var loginSource: WizardSource? by mutableStateOf(loginSources.singleOrNull())
|
||||
private set
|
||||
|
||||
var stationSource: WizardSource? by mutableStateOf(stationSources.singleOrNull())
|
||||
private set
|
||||
|
||||
private var appliedLoginSource: WizardSource? = null
|
||||
private var appliedStationSource: WizardSource? = null
|
||||
|
||||
/** The stored form of the language: a code, or empty for the system language. */
|
||||
var language: String by mutableStateOf(prefs.getGuiOptions_language().orEmpty())
|
||||
|
||||
/** Empty on an unconfigured profile: its stored name is the template's or another operator's. */
|
||||
var name: String by mutableStateOf(if (loginConfigured) storedName else "")
|
||||
|
||||
var callsign: String by mutableStateOf("")
|
||||
var password: String by mutableStateOf("")
|
||||
var locator: String by mutableStateOf("")
|
||||
|
||||
var bands: Set<WizardBand> by mutableStateOf(emptySet())
|
||||
private set
|
||||
|
||||
var category: Int? by mutableStateOf(null)
|
||||
private set
|
||||
|
||||
private var categoryChosenByOperator = false
|
||||
|
||||
var secondChat: Boolean by mutableStateOf(false)
|
||||
private set
|
||||
|
||||
var secondCategory: Int? by mutableStateOf(null)
|
||||
|
||||
private var loginShown by mutableStateOf(false)
|
||||
private var stationShown by mutableStateOf(false)
|
||||
|
||||
var page: WizardPage by mutableStateOf(if (hasEntryPage) WizardPage.ENTRY else WizardPage.PERSONAL)
|
||||
private set
|
||||
|
||||
init {
|
||||
if (!hasEntryPage) applySources()
|
||||
}
|
||||
|
||||
fun chooseLoginSource(source: WizardSource) {
|
||||
if (source in loginSources) loginSource = source
|
||||
}
|
||||
|
||||
fun chooseStationSource(source: WizardSource) {
|
||||
if (source in stationSources) stationSource = source
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads the answers of a group whose source changed. A group whose source is the one
|
||||
* already applied is left alone, so going back to the entry page costs nothing typed.
|
||||
*/
|
||||
private fun applySources() {
|
||||
if (loginSource != appliedLoginSource) {
|
||||
val keep = loginSource == WizardSource.KEEP
|
||||
callsign = if (keep) storedCallsign else ""
|
||||
password = if (keep) storedPassword else ""
|
||||
loginShown = !keep
|
||||
appliedLoginSource = loginSource
|
||||
}
|
||||
|
||||
if (stationSource != appliedStationSource) {
|
||||
val keep = stationSource == WizardSource.KEEP
|
||||
locator = if (keep) storedLocator else ""
|
||||
bands = if (keep) storedBands else emptySet()
|
||||
category = if (keep) storedCategory else null
|
||||
secondChat = keep && storedSecondChat
|
||||
secondCategory = if (keep) storedSecondCategory else null
|
||||
// A kept category is the operator's; the suggestion must not replace it.
|
||||
categoryChosenByOperator = keep
|
||||
stationShown = !keep
|
||||
appliedStationSource = stationSource
|
||||
}
|
||||
}
|
||||
|
||||
fun setBand(band: WizardBand, active: Boolean) {
|
||||
bands = if (active) bands + band else bands - band
|
||||
if (!categoryChosenByOperator) updateCategory(suggestCategory(bands))
|
||||
}
|
||||
|
||||
/** What the bands suggest, shown beside the picker whatever is chosen. */
|
||||
val suggestedCategory: Int?
|
||||
get() = suggestCategory(bands)
|
||||
|
||||
fun chooseCategory(number: Int) {
|
||||
categoryChosenByOperator = true
|
||||
updateCategory(number)
|
||||
}
|
||||
|
||||
private fun updateCategory(number: Int?) {
|
||||
category = number
|
||||
if (secondCategory == number) secondCategory = null
|
||||
}
|
||||
|
||||
fun chooseSecondChat(enabled: Boolean) {
|
||||
secondChat = enabled
|
||||
}
|
||||
|
||||
/** The main category is left out, as the Station tab does. */
|
||||
val secondCategoryOptions: List<Int>
|
||||
get() = CATEGORY_NUMBERS.filter { it != category }
|
||||
|
||||
/** The pages of this run, in order. */
|
||||
val pages: List<WizardPage>
|
||||
get() = buildList {
|
||||
if (hasEntryPage) add(WizardPage.ENTRY)
|
||||
add(WizardPage.PERSONAL)
|
||||
if (loginShown) add(WizardPage.LOGIN)
|
||||
if (stationShown) add(WizardPage.SITE)
|
||||
add(WizardPage.SUMMARY)
|
||||
}
|
||||
|
||||
private val personalComplete: Boolean
|
||||
get() = name.isNotBlank()
|
||||
|
||||
private val loginComplete: Boolean
|
||||
get() = isPlausibleCallsign(callsign) && password.isNotEmpty()
|
||||
|
||||
private val stationComplete: Boolean
|
||||
get() = isLocator(locator) && bands.isNotEmpty() && category != null &&
|
||||
(!secondChat || (secondCategory != null && secondCategory != category))
|
||||
|
||||
/** Whether everything the profile needs to log in is there. */
|
||||
val mandatoryComplete: Boolean
|
||||
get() = personalComplete && loginComplete && stationComplete
|
||||
|
||||
/** A callsign that was typed and does not look like one. An empty field is not an error yet. */
|
||||
val callsignRefused: Boolean
|
||||
get() = callsign.isNotBlank() && !isPlausibleCallsign(callsign)
|
||||
|
||||
/** A locator that was typed and is not one. An empty field is not an error yet. */
|
||||
val locatorRefused: Boolean
|
||||
get() = locator.isNotBlank() && !isLocator(locator)
|
||||
|
||||
val canGoNext: Boolean
|
||||
get() = when (page) {
|
||||
WizardPage.ENTRY -> loginSource != null && stationSource != null
|
||||
WizardPage.PERSONAL -> personalComplete
|
||||
WizardPage.LOGIN -> loginComplete
|
||||
WizardPage.SITE -> stationComplete
|
||||
WizardPage.SUMMARY -> false
|
||||
}
|
||||
|
||||
val canGoBack: Boolean
|
||||
get() = pages.indexOf(page) > 0
|
||||
|
||||
/**
|
||||
* Whether the remaining steps may be skipped. Only with every mandatory answer, because
|
||||
* a summary that cannot be saved helps nobody.
|
||||
*/
|
||||
val canFinish: Boolean
|
||||
get() = page != WizardPage.ENTRY && page != WizardPage.SUMMARY && mandatoryComplete
|
||||
|
||||
fun next() {
|
||||
if (!canGoNext) return
|
||||
if (page == WizardPage.ENTRY) applySources()
|
||||
page = pages[pages.indexOf(page) + 1]
|
||||
}
|
||||
|
||||
fun back() {
|
||||
if (canGoBack) page = pages[pages.indexOf(page) - 1]
|
||||
}
|
||||
|
||||
fun finish() {
|
||||
if (canFinish) page = WizardPage.SUMMARY
|
||||
}
|
||||
|
||||
/** Opens a step from the summary, also one this run skipped. */
|
||||
fun edit(target: WizardPage) {
|
||||
when (target) {
|
||||
WizardPage.LOGIN -> loginShown = true
|
||||
WizardPage.SITE -> stationShown = true
|
||||
WizardPage.PERSONAL -> Unit
|
||||
WizardPage.ENTRY, WizardPage.SUMMARY -> return
|
||||
}
|
||||
page = target
|
||||
}
|
||||
|
||||
/** The profile had a second chat and will have none. */
|
||||
val turnsOffSecondChat: Boolean
|
||||
get() = storedSecondChat && !secondChat
|
||||
|
||||
/**
|
||||
* A new station is set up, and this stage does not ask about log program, rotator,
|
||||
* AirScout and DX cluster server: they keep their stored values, and the summary says so.
|
||||
*/
|
||||
val leavesIntegrationsUntouched: Boolean
|
||||
get() = stationSource == WizardSource.NEW
|
||||
|
||||
companion object {
|
||||
|
||||
/** The categories the pickers offer, the way the Station tab builds them. */
|
||||
val CATEGORY_NUMBERS: List<Int> = ChatCategory(0).possibleCategoryNumbers.toList()
|
||||
|
||||
private val CALLSIGN = Regex("[A-Za-z0-9]+([-/][A-Za-z0-9]+)?")
|
||||
private val LOCATOR = Regex("[A-Ra-r]{2}[0-9]{2}[A-Xa-x]{2}")
|
||||
|
||||
/**
|
||||
* Whether a text can be a login callsign: letters and digits, at most one "-" or "/"
|
||||
* suffix, and a base of three characters with a letter and a digit. Deliberately
|
||||
* loose -- ON4KST decides what it accepts, this only catches a slip.
|
||||
*/
|
||||
fun isPlausibleCallsign(text: String): Boolean {
|
||||
val trimmed = text.trim()
|
||||
if (!CALLSIGN.matches(trimmed)) return false
|
||||
val base = trimmed.substringBefore('-').substringBefore('/')
|
||||
return base.length >= 3 && base.any(Char::isDigit) && base.any(Char::isLetter)
|
||||
}
|
||||
|
||||
/** Whether a text is a six-character Maidenhead locator, in either case. */
|
||||
fun isLocator(text: String): Boolean = LOCATOR.matches(text.trim())
|
||||
|
||||
/**
|
||||
* The chat category the lowest band belongs to: 1 for 50/70 MHz, 2 for 144/432 MHz,
|
||||
* 3 above. Null without a band. A suggestion only -- the operator confirms it.
|
||||
*/
|
||||
fun suggestCategory(bands: Set<WizardBand>): Int? {
|
||||
val lowest = bands.minOfOrNull { it.megahertz } ?: return null
|
||||
return when {
|
||||
lowest <= 70 -> ChatCategory.FIFTYSEVENTYMHz
|
||||
lowest <= 432 -> ChatCategory.VUHF
|
||||
else -> ChatCategory.MICROWAVE
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,295 @@
|
||||
package kst4contest.view.compose.wizard
|
||||
|
||||
import kst4contest.model.ChatCategory
|
||||
import kst4contest.model.ChatPreferences
|
||||
import org.junit.jupiter.api.Assertions.assertEquals
|
||||
import org.junit.jupiter.api.Assertions.assertFalse
|
||||
import org.junit.jupiter.api.Assertions.assertNull
|
||||
import org.junit.jupiter.api.Assertions.assertTrue
|
||||
import org.junit.jupiter.api.Test
|
||||
import java.nio.file.Path
|
||||
|
||||
/**
|
||||
* The wizard's rules without a window: which pages appear, what they start with, and when
|
||||
* the operator may go on. Nothing here reads or writes a file.
|
||||
*/
|
||||
class SetupWizardStateTest {
|
||||
|
||||
/** Preferences that never touch a file: the path is only read by read/write calls. */
|
||||
private fun prefs(configure: ChatPreferences.() -> Unit = {}): ChatPreferences =
|
||||
ChatPreferences(Path.of("setup-wizard-state-test-unused.xml")).apply(configure)
|
||||
|
||||
private fun freshInstallation() = prefs {
|
||||
setStn_loginCallSign("DO5AMF")
|
||||
setStn_loginPassword("changeMe")
|
||||
setStn_loginNameMainCat("KST4Contest1263")
|
||||
setStn_loginLocatorMainCat("JO54ME")
|
||||
setStn_bandActive144(true)
|
||||
setLoginChatCategoryMain(ChatCategory(2))
|
||||
setLoginToSecondChatEnabled(true)
|
||||
setLoginChatCategorySecond(ChatCategory(3))
|
||||
}
|
||||
|
||||
private fun duplicatedProfile() = prefs {
|
||||
setStn_loginCallSign("")
|
||||
setStn_loginPassword("")
|
||||
setStn_loginNameMainCat("Other Operator")
|
||||
setStn_loginLocatorMainCat("JO50AA")
|
||||
setStn_bandActive144(true)
|
||||
setStn_bandActive432(true)
|
||||
setLoginChatCategoryMain(ChatCategory(2))
|
||||
setLoginToSecondChatEnabled(false)
|
||||
}
|
||||
|
||||
private fun configuredProfile() = duplicatedProfile().apply {
|
||||
setStn_loginCallSign("DL0TEST")
|
||||
setStn_loginPassword("secret")
|
||||
setStn_loginNameMainCat("Philipp")
|
||||
}
|
||||
|
||||
/** Fills every mandatory answer of a first installation, leaving the wizard on SITE. */
|
||||
private fun SetupWizardState.fillFirstInstallation() {
|
||||
name = "Philipp"
|
||||
next()
|
||||
callsign = "DL0TEST"
|
||||
password = "secret"
|
||||
next()
|
||||
locator = "JO50AA"
|
||||
setBand(WizardBand.B144, true)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aFreshInstallationHasNoEntryPageAndStartsEmpty() {
|
||||
val state = SetupWizardState(freshInstallation())
|
||||
|
||||
assertFalse(state.hasEntryPage)
|
||||
assertEquals(WizardPage.PERSONAL, state.page)
|
||||
assertEquals(
|
||||
listOf(WizardPage.PERSONAL, WizardPage.LOGIN, WizardPage.SITE, WizardPage.SUMMARY),
|
||||
state.pages,
|
||||
)
|
||||
assertEquals("", state.name, "the template's name is nobody's name")
|
||||
assertEquals("", state.callsign)
|
||||
assertEquals("", state.locator)
|
||||
assertTrue(state.bands.isEmpty())
|
||||
assertNull(state.category)
|
||||
assertFalse(state.secondChat)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aDuplicatedProfileIsAskedOnlyAboutTheStation() {
|
||||
val state = SetupWizardState(duplicatedProfile())
|
||||
|
||||
assertEquals(listOf(WizardSource.NEW), state.loginSources)
|
||||
assertEquals(listOf(WizardSource.NEW, WizardSource.KEEP), state.stationSources)
|
||||
assertTrue(state.hasEntryPage)
|
||||
assertEquals(WizardPage.ENTRY, state.page)
|
||||
assertEquals(WizardSource.NEW, state.loginSource, "a single option is chosen already")
|
||||
assertNull(state.stationSource, "nothing is preselected where there is a choice")
|
||||
assertFalse(state.canGoNext)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aConfiguredProfileMayKeepBoth() {
|
||||
val state = SetupWizardState(configuredProfile())
|
||||
|
||||
assertEquals(listOf(WizardSource.NEW, WizardSource.KEEP), state.loginSources)
|
||||
assertEquals(listOf(WizardSource.NEW, WizardSource.KEEP), state.stationSources)
|
||||
assertEquals("Philipp", state.name, "a configured profile keeps its operator's name")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun keepingTheStationSkipsItsStepAndCarriesTheStoredValues() {
|
||||
val state = SetupWizardState(duplicatedProfile())
|
||||
state.chooseStationSource(WizardSource.KEEP)
|
||||
state.next()
|
||||
|
||||
assertEquals(
|
||||
listOf(WizardPage.ENTRY, WizardPage.PERSONAL, WizardPage.LOGIN, WizardPage.SUMMARY),
|
||||
state.pages,
|
||||
)
|
||||
assertEquals("JO50AA", state.locator)
|
||||
assertEquals(setOf(WizardBand.B144, WizardBand.B432), state.bands)
|
||||
assertEquals(2, state.category)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aNewStationStartsEmptyEvenOnAProfileThatHasOne() {
|
||||
val state = SetupWizardState(duplicatedProfile())
|
||||
state.chooseStationSource(WizardSource.NEW)
|
||||
state.next()
|
||||
|
||||
assertEquals("", state.locator)
|
||||
assertTrue(state.bands.isEmpty())
|
||||
assertNull(state.category)
|
||||
assertTrue(state.pages.contains(WizardPage.SITE))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun goingBackToTheEntryPageAndOnAgainKeepsWhatWasTyped() {
|
||||
val state = SetupWizardState(duplicatedProfile())
|
||||
state.chooseStationSource(WizardSource.NEW)
|
||||
state.next()
|
||||
state.name = "Philipp"
|
||||
state.back()
|
||||
state.next()
|
||||
|
||||
assertEquals("Philipp", state.name)
|
||||
|
||||
state.next()
|
||||
state.callsign = "DL0TEST"
|
||||
state.back()
|
||||
state.back()
|
||||
state.chooseStationSource(WizardSource.KEEP)
|
||||
state.next()
|
||||
|
||||
assertEquals("JO50AA", state.locator, "a changed source loads its own values")
|
||||
state.next()
|
||||
assertEquals("DL0TEST", state.callsign, "the login source did not change")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun callsignsWithSuffixAndLowerCaseAreAccepted() {
|
||||
listOf("DL0TEST", "DL0TEST/P", "DO5AMF-2", "do5amf", " DL0TEST ").forEach {
|
||||
assertTrue(SetupWizardState.isPlausibleCallsign(it), "'$it' must be accepted")
|
||||
}
|
||||
listOf("", "DL", "ABC", "123", "DL0 TEST", "DL0TEST|X", "DL0-TEST-2", "DL0TEST/").forEach {
|
||||
assertFalse(SetupWizardState.isPlausibleCallsign(it), "'$it' must be refused")
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
fun onlyASixCharacterLocatorIsAccepted() {
|
||||
listOf("JO50AA", "jo50aa", " JN49FL ").forEach {
|
||||
assertTrue(SetupWizardState.isLocator(it), "'$it' must be accepted")
|
||||
}
|
||||
listOf("", "JO50", "JO50AAA", "SS50AA", "JO50YY", "JO5OAA").forEach {
|
||||
assertFalse(SetupWizardState.isLocator(it), "'$it' must be refused")
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
fun theCategoryIsSuggestedFromTheLowestBand() {
|
||||
assertNull(SetupWizardState.suggestCategory(emptySet()))
|
||||
assertEquals(1, SetupWizardState.suggestCategory(setOf(WizardBand.B50, WizardBand.B144)))
|
||||
assertEquals(1, SetupWizardState.suggestCategory(setOf(WizardBand.B70)))
|
||||
assertEquals(2, SetupWizardState.suggestCategory(setOf(WizardBand.B144, WizardBand.B1240)))
|
||||
assertEquals(2, SetupWizardState.suggestCategory(setOf(WizardBand.B432)))
|
||||
assertEquals(3, SetupWizardState.suggestCategory(setOf(WizardBand.B1240, WizardBand.B10G)))
|
||||
}
|
||||
|
||||
@Test
|
||||
fun theSuggestionFollowsTheBandsUntilTheOperatorChooses() {
|
||||
val state = SetupWizardState(freshInstallation())
|
||||
|
||||
state.setBand(WizardBand.B1240, true)
|
||||
assertEquals(3, state.category)
|
||||
|
||||
state.setBand(WizardBand.B144, true)
|
||||
assertEquals(2, state.category)
|
||||
|
||||
state.chooseCategory(3)
|
||||
state.setBand(WizardBand.B50, true)
|
||||
assertEquals(3, state.category, "an operator's choice is not overwritten")
|
||||
assertEquals(1, state.suggestedCategory, "the suggestion is still shown")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aSecondChatNeedsADifferentCategory() {
|
||||
val state = SetupWizardState(freshInstallation())
|
||||
state.fillFirstInstallation()
|
||||
assertTrue(state.canGoNext)
|
||||
|
||||
state.chooseSecondChat(true)
|
||||
assertFalse(state.canGoNext, "the second chat has no category yet")
|
||||
assertFalse(state.secondCategoryOptions.contains(2), "the main category is not offered twice")
|
||||
|
||||
state.secondCategory = 3
|
||||
assertTrue(state.canGoNext)
|
||||
|
||||
state.chooseCategory(3)
|
||||
assertNull(state.secondCategory, "the same chat cannot be opened twice")
|
||||
assertFalse(state.canGoNext)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun finishNeedsEveryMandatoryAnswer() {
|
||||
val state = SetupWizardState(freshInstallation())
|
||||
|
||||
state.name = "Philipp"
|
||||
assertFalse(state.canFinish)
|
||||
state.next()
|
||||
state.callsign = "DL0TEST"
|
||||
state.password = "secret"
|
||||
assertFalse(state.canFinish, "a new station still lacks its locator")
|
||||
state.next()
|
||||
state.locator = "JO50AA"
|
||||
assertFalse(state.canFinish, "no band yet")
|
||||
state.setBand(WizardBand.B144, true)
|
||||
assertTrue(state.canFinish)
|
||||
|
||||
state.finish()
|
||||
assertEquals(WizardPage.SUMMARY, state.page)
|
||||
assertTrue(state.mandatoryComplete)
|
||||
assertFalse(state.canFinish, "the summary has Save instead")
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aKeptStationLetsTheOperatorFinishAfterTheLogin() {
|
||||
val state = SetupWizardState(duplicatedProfile())
|
||||
state.chooseStationSource(WizardSource.KEEP)
|
||||
state.next()
|
||||
state.name = "Philipp"
|
||||
state.next()
|
||||
state.callsign = "DL0TEST/P"
|
||||
state.password = "secret"
|
||||
|
||||
assertTrue(state.canFinish)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aRefusedEntryIsOnlyShownOnceSomethingWasTyped() {
|
||||
val state = SetupWizardState(freshInstallation())
|
||||
|
||||
assertFalse(state.callsignRefused, "an empty field is not an error yet")
|
||||
state.callsign = "DL"
|
||||
assertTrue(state.callsignRefused)
|
||||
state.callsign = "DL0TEST"
|
||||
assertFalse(state.callsignRefused)
|
||||
|
||||
assertFalse(state.locatorRefused)
|
||||
state.locator = "JO50"
|
||||
assertTrue(state.locatorRefused)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun changeFromTheSummaryOpensAStepThatWasSkipped() {
|
||||
val state = SetupWizardState(configuredProfile())
|
||||
state.chooseLoginSource(WizardSource.KEEP)
|
||||
state.chooseStationSource(WizardSource.KEEP)
|
||||
state.next()
|
||||
state.next()
|
||||
assertEquals(WizardPage.SUMMARY, state.page)
|
||||
|
||||
state.edit(WizardPage.LOGIN)
|
||||
|
||||
assertEquals(WizardPage.LOGIN, state.page)
|
||||
assertEquals("DL0TEST", state.callsign, "the kept value is there to be changed")
|
||||
state.callsign = "DL0TEST/P"
|
||||
state.next()
|
||||
assertEquals(WizardPage.SUMMARY, state.page)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun theSummarySaysWhatIsSwitchedOffAndWhatIsLeftAlone() {
|
||||
val fresh = SetupWizardState(freshInstallation())
|
||||
assertTrue(fresh.turnsOffSecondChat, "the template has the second chat on, a new station has it off")
|
||||
assertTrue(fresh.leavesIntegrationsUntouched)
|
||||
|
||||
val kept = SetupWizardState(duplicatedProfile())
|
||||
kept.chooseStationSource(WizardSource.KEEP)
|
||||
kept.next()
|
||||
assertFalse(kept.turnsOffSecondChat)
|
||||
assertFalse(kept.leavesIntegrationsUntouched)
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user