Añade programas al PATH
Ejecuta un programa desde cualquier directorio vía CLI (línea de comandos).
Tabla de contenidos
Al igual que pueden crearse scripts con Bash, también es posible hacerlo con Kotlin y ejecutarlos desde la terminal. Puedes pasar argumentos y utilizar dependencias publicadas en repositorios maven.
En el siguiente ejemplo vamos a ver cómo hacer todo lo mencionado anteriormente, añadiendo OkHttp
para hacer una petición a la API de Rick and Morty y Moshi para transformar los diferentes JSON
a clases de Kotlin.
Crear un script de Kotlin
Simplemente crea un fichero llamado rick-and-morty.main.kts. Si lo abres desde IntelliJ IDEA,
obtendrás code highlighting, incluyendo de las dependencias que has añadido, siendo más fácil crear
el script utilizando el autocompletado.
Añadir dependencias
Es más sencillo incluso que en Gradle añadir cualquier dependencia a un script, simplemente en la
parte superior se puede utilizar la anotación DependsOn y se le pasa como argumento la dependencia
en cuestión.
@file:DependsOn("com.squareup.moshi:moshi:1.13.0")
@file:DependsOn("com.squareup.moshi:moshi-kotlin:1.13.0")
@file:DependsOn("com.squareup.okhttp3:okhttp:4.9.3")
Obtener los argumentos
El script va a recibir la identidad del personaje a obtener de la API, el cual es un número entero. Además se va a comprobar si dicho valor es correcto, y si no, se mostrará un error.
val id: Int =
checkNotNull(args.firstOrNull()?.toIntOrNull()) {
"ID is required and must be `Int`"
}
args es una lista de strings (List<String>).
Petición http
Como esto no es un tutorial sobre OkHttp o Moshi, puedes ver el código de la petición completo a
continuación. Si te interesa profundizar más en dichas dependencias, visita sus respectivos
repositorios de GitHub.
val client = OkHttpClient()
val request: Request =
Request
.Builder()
.url("https://rickandmortyapi.com/api/character/$id")
.build()
val moshi: Moshi =
Moshi
.Builder()
.addLast(KotlinJsonAdapterFactory())
.build()
val jsonAdapter: JsonAdapter<Character> = moshi.adapter(Character::class.java)
client.newCall(request).execute().use { response ->
val content: String? = response.body?.string()
if (response.code == 200 && content != null) {
val character = jsonAdapter.fromJson(content)
println(character)
}
}
data class Character(
val id: Int,
val name: String,
val status: String, val species: String,
)
Ejecutar el script
kotlin rick-and-morty.main.kts 20
20 es la identidad del personaje, puedes pasar cualquier número entero.
Se podrían pasar varios elementos separados por espacios (de ahí que args sea una lista), pero en
nuestro caso solo necesitamos pasar uno.
El script devolverá el resultado:
Character(id=20, name=Ants in my Eyes Johnson, status=unknown, species=Human)
Conclusión
Es muy sencillo y muy útil montar scripts en Kotlin incluso utilizando dependencias, personalmente los suelo utilizar para editar archivos en masa bastante a menudo cuando no puedo hacer una tarea de Gradle.
El código completo del ejemplo lo puedes ver a continuación:
@file:DependsOn("com.squareup.moshi:moshi:1.13.0")
@file:DependsOn("com.squareup.moshi:moshi-kotlin:1.13.0")
@file:DependsOn("com.squareup.okhttp3:okhttp:4.9.3")
import com.squareup.moshi.JsonAdapter
import com.squareup.moshi.Moshi
import com.squareup.moshi.kotlin.reflect.KotlinJsonAdapterFactory
import okhttp3.OkHttpClient
import okhttp3.Request
val id: Int =
checkNotNull(args.firstOrNull()?.toIntOrNull()) {
"ID is required and must be `Int`"
}
val client = OkHttpClient()
val request: Request =
Request
.Builder()
.url("https://rickandmortyapi.com/api/character/$id")
.build()
val moshi: Moshi =
Moshi
.Builder()
.addLast(KotlinJsonAdapterFactory())
.build()
val jsonAdapter: JsonAdapter<Character> = moshi.adapter(Character::class.java)
client.newCall(request).execute().use { response ->
val content: String? = response.body?.string()
if (response.code == 200 && content != null) {
val character = jsonAdapter.fromJson(content)
println(character)
}
}
data class Character(
val id: Int,
val name: String,
val status: String, val species: String,
)