Primeros pasos con clojure

Instalación y configuración

Opción 1: Leiningen

Requiere JDK 6 o posterior.

La forma más fácil de comenzar con Clojure es descargar e instalar Leiningen, la herramienta estándar de facto para administrar proyectos de Clojure, luego ejecutar lein repl para abrir un REPL.

###Linux

curl https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein > ~/bin/lein
export PATH=$PATH:~/bin
chmod 755 ~/bin/lein

OS X

Siga los pasos de Linux anteriores o instale con los administradores de paquetes de macOS.

Instalar con Homebrew

brew install leiningen

Instalar con MacPorts

Primero instale Clojure

sudo port -R install clojure

Instale Leiningen, una herramienta de compilación para Clojure

sudo port -R install leiningen
lein self-install

ventanas

Consulte [la documentación oficial] (https://github.com/technomancy/leiningen#windows).

Opción 2: Distribución oficial

Requiere JRE 6 o posterior.

Las versiones de Clojure se publican como archivos JAR simples para ejecutarse en la JVM. Esto es lo que suele suceder dentro de las herramientas de compilación de Clojure.

  1. Vaya a http://clojure.org y descargue el último archivo de Clojure
  2. Extraiga el archivo ZIP descargado en un directorio de su elección
  3. Ejecute java -cp clojure-1.8.0.jar clojure.main en ese directorio

Es posible que deba sustituir clojure-1.8.0.jar en ese comando por el nombre del archivo JAR que realmente descargó.

Para una mejor experiencia de REPL en la línea de comandos (por ejemplo, recorrer los comandos anteriores), es posible que desee instalar rlwrap: rlwrap java -cp clojure-1.8.0.jar clojure.main

Opción 3: Arranque

Requiere JDK 7 o posterior.

Boot es una herramienta de compilación de Clojure multipropósito. Comprenderlo requiere cierto conocimiento de Clojure, por lo que puede no ser la mejor opción para principiantes. Consulte [el sitio web] [inicio] (haga clic en Comenzar allí) para obtener instrucciones de instalación.

Una vez que esté instalado y en su RUTA, puede ejecutar boot repl en cualquier lugar para iniciar un Clojure REPL.

“¡Hola Mundo!” en el REPL

La comunidad de Clojure pone un gran énfasis en el desarrollo interactivo, por lo que gran parte de la interacción con Clojure ocurre dentro de un REPL (read-eval-print-loop). Cuando ingresa una expresión, Clojure la lee, la evalúa e imprime el resultado de la evaluación, todo en un bucle.

Debería poder iniciar un Clojure REPL ahora. Si no sabe cómo hacerlo, siga la sección Instalación y configuración de este tema. Una vez que lo tengas funcionando, escribe lo siguiente en él:

(println "Hello, world!")

Luego presione Enter. Esto debería imprimir ¡Hola, mundo!, seguido del valor de retorno de esta expresión, nil.

Si desea ejecutar algún clojure al instante, intente REPL en línea. Por ejemplo http://www.tryclj.com/.

“¡Hola Mundo!” usando Arranque

Nota: debe instalar Boot antes de probar este ejemplo. Consulte la sección Instalación y configuración si aún no la ha instalado.

Boot permite crear archivos Clojure ejecutables usando la línea shebang (#!). Coloque el siguiente texto en un archivo de su elección (este ejemplo asume que está en el “directorio de trabajo actual” y se llama hello.clj).

#!/usr/bin/env boot

(defn -main [& args]
  (println "Hello, world!"))

Luego márquelo como ejecutable (si corresponde, generalmente ejecutando chmod +x hello.clj). …y ejecútelo (./hello.clj).

El programa debería mostrar “¡Hola, mundo!” y acaba.

Crear una nueva aplicación

Después de seguir las instrucciones anteriores e instalar Leiningen, inicie un nuevo proyecto ejecutando:

lein new <project-name>

Esto configurará un proyecto de Clojure con la plantilla predeterminada de Leiningen dentro de la carpeta <nombre-del-proyecto>. Hay varias plantillas para Leiningen, que afectan la estructura del proyecto. Lo más común es que se utilice la plantilla “aplicación”, que agrega una función principal y prepara el proyecto para empaquetarlo en un archivo jar (siendo la función principal el punto de entrada de la aplicación). Esto se puede lograr con esto ejecutando:

lein new app <project-name> 

Suponiendo que usó la plantilla de la aplicación para crear una nueva aplicación, puede probar que todo se configuró correctamente ingresando al directorio creado y ejecutando la aplicación usando:

lein run

Si ve Hello, World! en su consola, está todo listo para comenzar a construir su aplicación.

Puede empaquetar esta sencilla aplicación en dos archivos jar con el siguiente comando:

lein uberjar

Crear una nueva aplicación (con arranque)

boot -d seancorfield/boot-new new -t app -n <appname>

Este comando le indicará a boot que tome la tarea boot-new de https://github.com/seancorfield/boot-new y ejecute la tarea con la plantilla app (consulte el enlace para ver otras plantillas). La tarea creará un nuevo directorio llamado <appname> con una estructura de aplicación típica de Clojure. Consulte el LÉAME generado para obtener más información.

Para ejecutar la aplicación: boot run. Otros comandos se especifican en build.boot y se describen en el LÉAME.