commonMain.com.vanniktech.locale.Region.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of multiplatform-locale-jvm Show documentation

Type Safe Kotlin Multiplatform Locale implementation

The newest version!

package com.vanniktech.locale

enum class Region(
  /** ISO 3166-1 alpha-2 code - https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 */
  override val code: String,
  /** ISO 3166-1 alpha-3 code - https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3 */
  override val code3: String,
  /** The [Continent]s it belongs to. Sometimes there can be more than one. */
  override val continents: List,
) : Territory {
  EUROPEAN_UNION(code = "EU", code3 = "EUE", continents = listOf(Continent.EUROPE)),
  LATIN_AMERICA(code = "419", code3 = "419", continents = listOf(Continent.NORTH_AMERICA, Continent.SOUTH_AMERICA)),
  CANARY_ISLANDS(code = "IC", code3 = "", continents = listOf(Continent.EUROPE)),
  INTERNATIONAL_WATERS(code = "XZ", code3 = "XZZ", continents = listOf()), // https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#User-assigned_code_elemen
  ;

  override val emoji: String? get() =
    when (this) {
      EUROPEAN_UNION -> """🇪🇺"""
      LATIN_AMERICA -> null
      CANARY_ISLANDS -> """🇮🇨"""
      INTERNATIONAL_WATERS -> """🌊"""
    }

  companion object {
    fun fromOrNull(identifier: String?) = when {
      identifier.isNullOrBlank() -> null
      else -> entries.firstOrNull { it.code.equals(identifier, ignoreCase = true) || it.code3.equals(identifier, ignoreCase = true) }
    }

    fun fromLocaleOrNull(locale: String?): Region? {
      val splits = localeSplit(locale)
      return fromOrNull(splits.getOrNull(1))
    }

    /** Tries every possible combination that I know to somehow get a meaningful country. */
    fun fromLenientOrNull(string: String?) = entries.firstOrNull { it.name.equals(string, ignoreCase = true) }
      ?: fromOrNull(string)
      ?: fromLocaleOrNull(string)
  }
}