Instalar Elm

En la página anterior logramos instalar software para editar código Elm, así que el próximo paso es obtener el archivo ejecutable de nombre elm. Aquí tienes los links de instalación:

• Mac: instalador
• Linux: instrucciones
• Windows: instalador

Después de que completes la instalación, abre el terminal en tu computador. Puede que se llame cmd.exe o Command Prompt en Windows.

Primero navega a tu escritorio en el terminal:

# Mac y Linux
cd ~/Desktop

# Windows (pero cambia <usuario> por tu nombre de usuario)
cd C:\Users\<usuario>\Desktop

El paso siguiente es familiarizarte con el comando elm. Personalmente, me costó mucho aprender comandos del terminal, así que puse mucho esfuerzo en que el comando elm sea fácil de usar. Vamos a ver cómo se usa en ciertas situaciones específicas.

elm init

Puedes empezar un proyecto Elm corriendo:

elm init

Corre este comando para crear un archivo elm.json y un directorio src/.

• elm.json describe tu proyecto.
• src/ contendrá todos tus archivos Elm.

Ahora crea un archivo src/Main.elm en tu editor, y copia el código del ejemplo de los botones dentro de él.

elm reactor

elm reactor te ayuda a crear proyectos Elm sin lidiar demasiado con el terminal. Corre este comando en el directorio raíz de tu proyecto:

elm reactor

Esto inicializa un servidor en http://localhost:8000. Desde ahí puedes navegar a cualquier archivo Elm que tenga main para ejecutarlo. Corre elm reactor, abre el link de localhost, y busca tu archivo src/Main.elm en tu navegador.

elm make

Puedes compilar tu código Elm a HTML o JavaScript con comandos como este:

# Crea un archivo index.html que puedes abrir directamente en tu navegador.
elm make src/Main.elm

# Crea un archivo JS optimizado que puedes vincular desde un documento HTML de
# tu creación.
elm make src/Main.elm --optimize --output=elm.js

Corre estos comandos sobre tu archivo src/Main.elm.

Esta es la forma más general de compilar código Elm. Es extremadamente útil una vez que tu proyecto se haya vuelto demasiado avanzado para elm reactor.

Este comando produce los mismos mensajes que has visto en el editor online y con elm reactor. Hemos puesto años de trabajo en ellos, pero por favor reporta cualquier mensaje confuso o poco útil. Estoy seguro de que aún podemos mejorarlos.

elm install

Los paquetes de Elm los encuentras todos en package.elm-lang.org.

Supongamos que después de buscar, decides que necesitas elm/http y elm/json para hacer solicitudes HTTP. Puedes configurarlos en tu proyecto con estos comandos:

elm install elm/http
elm install elm/json

Esto añade esas dependencias a tu archivo elm.json, dejando los paquetes disponibles dentro de tu proyecto. Esto te permitirá importarlos usando import Http y usar funciones como Http.get en tus programas.

Tips

Primero, no te canses tratando de memorizar todo lo de arriba.

Cuando te haga falta, puedes correr elm --help para ver un recordatorio de lo que el comando elm te permite hacer.

También puedes correr comandos como elm make --help y elm repl --help para obtener ayuda sobre comandos específicos. Es muy útil si quieres revisar detalles sobre lo que hace cada uno y las opciones que reciben.

Segundo, no te preocupes si te toma un poco de tiempo acostumbrarte a usar el terminal.

Yo llevo más de una década usándolo, y todavía no recuerdo cómo comprimir archivos, encontrar todos los archivos Elm en un directorio, etc. ¡Todavía tengo que buscar ayuda para hacer muchas cosas!

Ahora que ya tenemos nuestro editor configurado y elm disponible en el terminal, ¡sigamos aprendiendo Elm!