Construye en Windows

El Lenguaje Ñ está escrito en C++ usando el sistema de construcción CMake. Antes de empezar, debes instalar CMake y un compilador de C++ moderno para poder construir tanto las diferentes partes de Ñ como sus dependencias. Además, para obtener el código de los repositorios debes instalar git.

Instala las dependencias

Para construir el Lenguaje Ñ necesitarás las bibliotecas LLVM y docopt.cpp:

• LLVM

  En el momento actual, los binarios disponibles de LLVM para Windows no incluyen algunos módulos y subproyectos necesarios en Ñ, como por ejemplo lld. Por tanto, para construir el proyecto necesitarás construir tú mismo LLVM a partir de su código fuente. En la página oficial de LLVM puedes encontrar las instrucciones necesarias, pero un ejemplo rápido de cómo construir esta biblioteca sería:

  git clone --depth 1 --config core.autocrlf=false https://github.com/llvm/llvm-project.git llvm
  
  mkdir c:\llvm
  mkdir obra
  cd obra
  
  cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=c:/llvm -DLLVM_TARGETS_TO_BUILD="all" -DLLVM_TARGET_ARCH="host" -DLLVM_BUILD_EXAMPLES=ON -DLLVM_BUILD_TOOLS=ON -DLLVM_ENABLE_THREADS=ON -DLLVM_INCLUDE_EXAMPLES=ON -DLLVM_INCLUDE_TOOLS=ON -DLLVM_OPTIMIZED_TABLEGEN=ON -DLLVM_PARALLEL_COMPILE_JOBS="16" -DLLVM_PARALLEL_LINK_JOBS="16" ..\llvm\llvm
  cmake --build . --parallel
  cmake --build . --target install
  

• docopt.cpp

  La biblioteca docopt.cpp está enteramente en inglés. Para disfrutar de una versión traducida al español empleo la bifurcación en este repositorio, que incluyo como un submódulo para facilitar su inclusión en el Lenguaje Ñ.

 

Consigue el código de Ñ

Una vez tengas preparadas todas las dependiencias, clona este repositorio para obtener el código de Ñ, en este caso dentro de una nueva carpeta llamada ./ñ.

mkdir ñ
cd ñ
git clone --recurse-submodules https://github.com/eduardogarre/lenguaje .

 

Construye el Lenguaje Ñ

El repositorio contiene dos proyectos: el compilador y la biblioteca estándar.

• Compilador

  Sus archivos principañes se encuentran en las carpetas ./compilador y ./ñ. Para construirlo da las siguientes órdenes:

  mkdir obra
  mkdir proyecto
  cd obra
  cmake -DCMAKE_BUILD_TYPE=Release ..
  cmake --build . --parallel 4
  cd ..

  Estas órdenes generarán un ejecutable ñ.exe dentro de la carpeta ./proyecto.

• Biblioteca estándar

  Sus archivos principales se encuentran en la carpeta ./biblioteca. Para construirlo da las siguientes órdenes:

  mkdir obra
  cd obra
  cmake -DCMAKE_BUILD_TYPE=Release ../biblioteca
  cmake --build . --parallel 4
  cd ..

  Estas órdenes generarán una biblioteca bibñ.lib dentro de la carpeta ./proyecto.

 

Añade el Lenguaje Ñ a la ruta de archivos ejecutables

  PENDIENTE

 

Pasa las pruebas

Para comprobar que el proyecto se ha construido correctamente, usa el compilador en ./proyecto/ñ.exe para construir el proyecto de prueba que se encuentra en la carpeta ./pruebas/. Para ello, construye el proyecto de pruebas con la siguiente orden:

.\proyecto\ñ.exe .\pruebas\*.ñ -s prueba

Esta orden compila todos los archivos .ñ en la carpeta pruebas/, y como salida crea un archivo ejecutable llamado prueba.exe.

Tras ejecutar esa orden correctamente, el compilador ñ.exe debería crear un nuevo ejecutable prueba.exe en la carpeta actual. Para terminar, ejecuta prueba.exe y comprueba su salida. Cada prueba que se ejecute satisfactoriamente debería imprimir un punto y seguido en la consola. Algo parecido a esto:

PS> .\prueba.exe
.............................................................................................
.............................................................................................
.........
PS> 

Si observas un resultado similar a éste, enhorabuena, has construido Ñ con éxito y funciona correctamente.