Dos idiomas: el idioma en el núcleo

// La hora «de verdad» del sistema (aquí, inventada para el ejemplo).
fun horaDelSistema(): Int = 9
 
// El saludo recibe UNA FUNCIÓN que da la hora, no la hora.
// `() -> Int` se lee «algo que, al llamarlo sin nada, devuelve un Int».
// Por defecto es la del sistema: `::horaDelSistema` es la función misma, sin llamarla.
class Saludo(private val hora: () -> Int = ::horaDelSistema) {
    // `hora()` la llama AHORA: si la hora cambia, el saludo también.
    fun texto() = if (hora() < 12) "Buenos días" else "Buenas tardes"
}
 
// Recorre las preferencias EN ORDEN y devuelve el primer plato que la carta tenga.
fun primeroDisponible(preferidos: List<String>, carta: Map<String, String>): String {
    for (idioma in preferidos) {
        val plato = carta[idioma]
        // `return` dentro de un `for` sale de la función entera.
        if (plato != null) return plato
    }
    return "sin carta"
}
 
fun main() {
    println(Saludo().texto())               // la hora del sistema
    println(Saludo(hora = { 18 }).texto())  // `{ 18 }` es una función de una línea: devuelve 18
    val carta = mapOf("en" to "Soup", "es" to "Sopa")
    println(primeroDisponible(listOf("ca", "es", "en"), carta))  // el catalán no está: gana el español
    println(primeroDisponible(listOf("ca", "en"), carta))        // sin español, gana el inglés
    println(primeroDisponible(listOf("ca"), carta))              // ninguno
}

Buenos días
Buenas tardes
Sopa
Soup
sin carta

src/commonMain/kotlin/com/sebastiannarvaez/pokedex/core/Idioma.kt
src/androidMain/kotlin/com/sebastiannarvaez/pokedex/core/Idioma.android.kt
src/iosMain/kotlin/com/sebastiannarvaez/pokedex/core/Idioma.ios.kt
src/jvmMain/kotlin/com/sebastiannarvaez/pokedex/core/Idioma.jvm.kt

package com.sebastiannarvaez.pokedex.core
 
/**
 * Los idiomas que quiere el usuario, en orden de preferencia.
 *
 * Devuelve una lista y no un idioma porque el sistema tampoco tiene uno: quien
 * configura «catalán, español, inglés» espera que se intente en ese orden.
 * Siempre termina en `en`, que es el único que PokeAPI garantiza.
 */
expect fun idiomasPreferidos(): List<String>
 
/**
 * El código corto, que es lo que usa PokeAPI: `es`, no `es-ES`.
 * Corta por el primer `-` o `_` y pasa a minúsculas: `es-ES` → `es`, `pt_BR` → `pt`.
 */
internal fun String.codigoCorto(): String = substringBefore('-').substringBefore('_').lowercase()

# en [versions]
coreKtx = "1.19.0"
# en [libraries]
androidx-core-ktx = { module = "androidx.core:core-ktx", version.ref = "coreKtx" }

        androidMain.dependencies {
            implementation(libs.koin.android)
            // Cada plataforma usa su motor: el cliente de Ktor es común, quien
            // hace la petición de verdad no lo es.
            implementation(libs.ktor.client.okhttp)
            // LocaleListCompat: la lista de idiomas, con el idioma por app.
            implementation(libs.androidx.core.ktx)
        }

./gradlew :shared:dependencies --configuration androidCompileClasspath | grep "^+--- androidx.core:core-ktx"

package com.sebastiannarvaez.pokedex.core
 
import androidx.core.os.LocaleListCompat
 
actual fun idiomasPreferidos(): List<String> {
    // `getAdjustedDefault()` tiene en cuenta el idioma por app de Android 13,
    // no solo el del sistema.
    val lista = LocaleListCompat.getAdjustedDefault()
    // La lista no es una `List` de Kotlin: se recorre por posición, de la 0 a la
    // última (`0 until n` son los números 0, 1… n-1). De cada idioma se toma su
    // código corto; si alguna posición viniera vacía (`?.`), `mapNotNull` la
    // descarta en lugar de dar error.
    val codigos = (0 until lista.size()).mapNotNull { lista[it]?.language?.codigoCorto() }
    // `+ "en"` y `distinct()`: el inglés siempre cierra la lista, sin repetirse.
    return (codigos + "en").distinct()
}

package com.sebastiannarvaez.pokedex.core
 
import platform.Foundation.NSLocale
import platform.Foundation.preferredLanguages
 
actual fun idiomasPreferidos(): List<String> {
    // `preferredLanguages` respeta el orden que el usuario puso en Ajustes, e
    // incluye el idioma por app si lo cambió desde ahí. Kotlin lo recibe como
    // una lista de «cualquier cosa» (`List<*>`) porque Objective-C no declara
    // el tipo de los elementos; `filterIsInstance<String>()` se queda con los
    // textos y devuelve ya una `List<String>`.
    val codigos = NSLocale.preferredLanguages
        .filterIsInstance<String>()
        .map { it.codigoCorto() }
    return (codigos + "en").distinct()
}

package com.sebastiannarvaez.pokedex.core
 
import java.util.Locale
 
// La versión de la JVM, la de los tests del módulo compartido.
actual fun idiomasPreferidos(): List<String> =
    listOf(Locale.getDefault().language.codigoCorto(), "en").distinct()

import com.sebastiannarvaez.pokedex.core.idiomasPreferidos

internal class PokemonRepository(
    private val api: PokeApi,
    private val dispatchers: AppDispatchers,
    // Una función y no una lista: se evalúa en cada ficha, así que si el
    // usuario cambia el idioma con la app abierta, la siguiente ficha lo respeta.
    private val idiomas: () -> List<String> = ::idiomasPreferidos,
) {

            genus = especie.textoEnEspanol { it.genera.map { g -> g.genus to g.language.name } },
            description = especie.textoEnEspanol { it.flavorTexts.map { f -> f.text to f.language.name } }
                .limpiarSaltos(),

            genus = especie.enElIdioma(idiomas()) { it.genera.map { g -> g.genus to g.language.name } },
            description = especie.enElIdioma(idiomas()) { it.flavorTexts.map { f -> f.text to f.language.name } }
                .limpiarSaltos(),

/**
 * El texto en el primer idioma de la lista que PokeAPI traiga.
 *
 * `extraer` devuelve parejas (`Pair`): cada texto con el código de su idioma.
 * `.first` es el texto (el primer valor de la pareja) y `.second` el idioma (el
 * segundo). `firstOrNull { … }` es «el primero que cumpla esto, o `null` si
 * ninguno».
 *
 * Se recorre la lista de preferencias EN ORDEN. Hacerlo al revés (buscar por
 * cada texto cuál encaja) daría el primero del array, que es el que PokeAPI
 * devuelva primero, no el que el usuario quiere.
 */
private fun SpeciesDto.enElIdioma(
    preferidos: List<String>,
    extraer: (SpeciesDto) -> List<Pair<String, String>>,
): String {
    val textos = extraer(this)
    for (idioma in preferidos) {
        val texto = textos.firstOrNull { it.second == idioma }
        // `return` dentro de un `for` sale de la función entera.
        if (texto != null) return texto.first
    }
    // Si no hay ninguno de la lista, el primero que haya; y si no, vacío.
    return textos.firstOrNull()?.first.orEmpty()
}

    // El idioma se fija en el test y no se hereda de la máquina: así pasa igual
    // en tu Mac, en español o en inglés.
    private fun repo(
        falla: Boolean = false,
        scheduler: kotlinx.coroutines.test.TestCoroutineScheduler,
        idiomasDelTest: List<String> = listOf("es", "en"),
    ) = PokemonRepository(
        FakePokeApi(total = 10, falla = falla),
        TestDispatchers(StandardTestDispatcher(scheduler)),
        // Una función que siempre devuelve la lista del test.
        idiomas = { idiomasDelTest },
    )

    // La otra mitad de la regla: con el teléfono en inglés, el texto llega en inglés.
    @Test
    fun conElTelefonoEnInglesElTextoLlegaEnIngles() = runTest {
        val detalle = repo(scheduler = testScheduler, idiomasDelTest = listOf("en")).detail(1)
 
        assertEquals("Seed Pokemon", detalle.genus)
        // Este texto lo inventa el `FakePokeApi` (fichero `Dobles.kt`), que ya
        // trae una ficha en español y otra en inglés.
        assertEquals("Texto en ingles.", detalle.description)
    }
 
    // Un idioma que PokeAPI no trae (`eu` es el euskera) cae al inglés, que siempre está.
    @Test
    fun unIdiomaQueNoExisteCaeAlIngles() = runTest {
        val detalle = repo(scheduler = testScheduler, idiomasDelTest = listOf("eu", "en")).detail(1)
 
        assertEquals("Seed Pokemon", detalle.genus)
    }

./gradlew :shared:jvmTest :shared:testAndroidHostTest

open shared/build/reports/tests/jvmTest/index.html
open shared/build/reports/tests/testAndroidHostTest/index.html