Manual para ajustar y usar Eneboo-Assembler de EnebooTools en linux.

• CREADO POR: deavid – Gestiweb
• MODIFICADO POR: miguelajsmaps@gmail.com
• EDITADO POR: miguelajsmaps@gmail.com en https://github.com/Miguel-J/eneboo/wiki (YA NO EXISTE)
• FECHA PRIMERA EDICIÓN:
• ACTUAL: miguelajsmaps@gmail.com en http://manuales-eneboo-pineboo.org/enebootools-introduccion/eneboo-assembler-en-windows/eneboo-tools-assembler-en-linux/
• ULTIMA ACTUALIZACIÓN:Last updated: noviembre 8, 2018 at 17:51 pm

INSTALACIÓN DE ENEBOO-TOOLS EN LINUX:

• volver a la página de Introducción a Eneboo Toolshttp://manuales-eneboo-pineboo.org/enebootools-introduccion/

Indice:

1. PASO 1: HACERSE CON UN LINUX

Haz clic aquí para volver al índice

Proyecto NUEVO DE MEZCLA CON Eneboo-tools en LINUX

NOTA: Para hacerlo en Windows seguir:

https://github.com/Miguel-J/eneboo/wiki/Eneboo-Tools-en-Windows

INSTALACIÓN PREVIA (Dependencias):

PASOS 1 a 4: Visitar la página:

https://github.com/Miguel-J/eneboo/wiki/EnebooTools—Instalaci%C3%B3n-en-linux

INDICE:

• PASO 1: HACERSE CON UN LINUX
  • Por qué? …pues porque parece ser que necesitamos unas «librerías» para el programa Python…y no hay versión «viable» en Windows…
• PASO 2: INSTALAR PYTHON:
  • 2.c-PASO A-INSTALAR PYTHON: (Linux ya lo trae de fábrica)
  • 2.c-PASO B-INSTALAR LIBXML2 y LIBXSLT:
• PASO 3: CLONAR EL GITHUB DE ENEBOO-TOOLS (eneboo-modules y eneboo-features):
• PASO 4: INSTALACIÓN DE ENEBOO-TOOLS

• PASO 5: CONFIGURACIÓN DE ENEBOO-TOOLS (Esta página)
  • PASO 5-A: CONFIGURACIÓN INICIAL DE ASSEMBLER:
    • PASO 5-A-1.-Introducción-para qué sirve:
    • PASO 5-A-2.-Assembler: Configuración previa:
    • OPCIÓN: AÑADIR REPOSITORIOS PARTICULARES A LA MEZCLA:
    • PASO 5-A-3.- ACTUALIZAR CAMBIOS DE RUTAS A LOS REPOSITORIOS:
  • PASO 5-B : ASSEMBLER «NEW» – (ASISTENTE AUTOMÁTICO PARA CREAR PROYECTOS o EXTENSIONES o SET´s):
  • PASO 5-C : ASSEMBLER «BUILD» – (COMPILAR/CREAR UN PROYECTO) :

Haz clic aquí para volver al índice

PASO 5-A: CONFIGURACIÓN INICIAL DE ASSEMBLER:

PASO 5-A-1.-Introducción-para qué sirve:

eneboo-assembler es una herramienta de «collage» de código fuente. Toma como base unos módulos y les aplica una serie de parches en un orden determinado para conseguir un proyecto modificado de cierta forma, que cumpla ciertas especificaciones.

Es una buena forma para mantener centenares de versiones distintas del mismo programa al día, gestionando correctamente los cambios propios que tiene cada versión.

Haz clic aquí para volver al índice

PASO 5-A-2.-Assembler: Configuración previa:

Ir a la consola de linux: Ctrl+Alt+F1 (volver a entorno ventana: Ctrl+Alt+F7)

El comando «eneboo-assembler» es el que usaremos normalmente para realizar las mezclas desde consola. Es muy sencillo y práctico.

Este comando tiene unas configuraciones y una base de datos de caché. Para que genere los primeros ficheros es conveniente lanzar la acción «dbupdate»::

Cabe destacar que eneboo-assembler no depende de en qué carpeta lo ejecutes.

Para empezar, necesitaremos como mínimo 2 repositorios para empezar:

• …hay que COPIARLOS (descargados de Github «gestiweb» o «klo-manolo») en una CARPETA-SUBDIRECTORIO, por ejemplo «eneboo-proyecto1″…

Todas las acciones de ENEBOO-ASSEMBLER leen los directorios INDICADOS en los ARCHIVOS de las CONFIGURACIONES. Para que esto funcione como debe, es necesario revisar la configuración que nos crea en:

En ese fichero, que es muy sencillo de editar a mano (ATENCIÓN: ES UN FICHERO OCULTO, MOSTRARLO CON Ctrl+H o por Menú-Ver-Mostrar lo oculto) (está en un subdirectorio creado por eneboo-tools…fijarse en el «.» antes del nombre o buscar por menu-Herramientas…), debemos incluir las RUTAS de la CARPETA-SUBDIRECTORIO (en este caso: «eneboo-proyecto1»)…donde hemos puesto los módulos («eneboo-modules») y las funcionalidades o «extensiones(«eneboo-features»), en mi caso:

OPCIÓN: AÑADIR REPOSITORIOS PARTICULARES A LA MEZCLA:

Si tenemos repositorios privados, se pueden agregar también.

Se deben modificar las rutas si el/los directorios de los módulos/extensiones particulares son distintos a los directorios donde están los oficiales.

Al añadir las rutas a «assembler-config.ini» hay que tener en cuenta que las líneas de abajo toman preferencia sobre las de arriba. Se recomienda poner al final siempre los repositorios públicos para que tomen preferencia.

EJEMPLO: Este sería un ejemplo de configuración, en mi caso:

Haz clic aquí para volver al índice

PASO 5-A-3.- ACTUALIZAR CAMBIOS DE RUTAS A LOS REPOSITORIOS:

Siempre que modificamos la ruta de una extensión, o ponemos o quitamos alguna, es necesario ejecutar «dbupdate», que almacenará en caché dónde están los módulos y extensiones. Si no lo hacéis luego os dará errores de que no encuentra las extensiones nuevas:

Las extensiones si os fijáis son carpetas con ficheros de configuración y con los parches para aplicar dentro.

Hay un proyecto de ejemplo creado que une cuatro extensiones muy básicas.

Haz clic aquí para volver al índice

PASO 5-B : ASSEMBLER «NEW» – (ASISTENTE AUTOMÁTICO PARA CREAR PROYECTOS o EXTENSIONES o SET´s):

UTILIDAD: Proceso automático de «listar» los módulos y extensiones ANTES de COMPILARLOS (paso 5-C)

Hasta hace poco para crear las extensiones nuevas que el assembler pueda leer había que crear los ficheros y carpetas a mano. Como son unas cuantas, esto era un tanto costoso.

Para facilitar las cosas hemos creado una acción «new» que contiene un asistente que realizará las preguntas necesarias y luego escribirá en disco la extensión.

Si se ejecuta sin argumentos, preguntará los datos mí­nimos para crear la plantilla:

(el valor debe seguir el formato A999 (A puede ser un número)).

Si se le pasa el nombre de la carpeta y la descripción, omite los pasos iniciales y pasa directamente al menú:

Aparecerá el menú principal como se muestra a continuación:

La opción d) Dependencias sirve para añadir módulos y funcionalidades. Una vez dentro del menú de dependencias, para facilitar la tarea de agregado podemos utilizar caracteres comodÃín. Por ejemplo, si introducimos «flfact*» y pulsamos tabulador, pondrá todos los módulos que empiecen por «flfact».

En el caso de las rutas, también existe autocompletado con el sistema de ficheros, que se activa con la tecla de tabulador.

Por defecto las extensiones se crean en la primera carpeta de extensiones que haya en la configuración, se puede cambiar la carpeta de destino en una opción del menú.

Haz clic aquí para volver al índice

PASO 5-C : ASSEMBLER «BUILD» – (COMPILAR/CREAR UN PROYECTO) :

ERRORES CONOCIDOS: ANTES de hacer este paso hay que ACTUALIZAR: «$ eneboo-assembler dbupdate -v» , porque de lo contrario dará el ERROR: «ERROR: Funcionalidad xxxx desconocida» y «ERROR: Error al generar las instrucciones de compilado»

UTILIDAD: Sirve para que Eneboo-Tools «COPIE» los módulos y extensiones LISTADOS por Assembler NEW o MANUALMENTE.

Para crear un proyecto (lo que llamamos «compilar») se lanza la acción «build» seguida del proyecto y del target. El «target» es qué es lo que se quiere crear, la idea es muy similar al make. El modo de empleo es:

[FEATURE] es el nombre corto (quitando la numeración) de la funcionalidad, es decir, para el proyecto prj0002-standard habrí­a que poner standard.

[TARGET] puede tomar los valores:

Novedad: Podemos usar «revfullpatch» para que nos calcule un parche inverso, lo cual desaplicarí­a una extensión a un proyecto dado.

Cuando compilamos algo, nos lo deja dentro de la carpeta build/ en la carpeta de la extensión que habíamos compilado.

Por ejemplo::

Si os fijáis, la idea es en el futuro, «apilar» parches, es decir, que cuando modificamos una extensión creamos otro parche distinto, que tiene que ser aplicado después del original. Esto ayudará a que si dos personas trabajan a la vez sobre el mismo parche, sea mucho más fácil mezclarlo.

De momento, no hay soporte para parche incremental, pues casi todos los diff y patch contextuales son incapaces de realizar un patch incremental (la única excepción es el de XML). Así­ que de momento sólo se pueden guardar cambios reemplazando todos los anteriores (con fullpatch).

Para guardar un cambio, después de haberlo probado con test-fullpatch y habiendo comprobado que no hemos perdido nada, se usa la acción «save-fullpatch» del siguiente modo::

Eso sí­, la operación ES DESTRUCTIVA y reemplazará lo que habí­a antes sin que se pueda recuperar. No recomiento usar esto si no tenemos la carpeta bajo control de versiones (GIT, SVN, etc), porque en un descuido nos podemos quedar sin parche.

Aún faltan cosas básicas por desarrollar, como por ejemplo:

Packager

Esta herramienta permite empaquetar código eneboo en un sólo fichero .eneboopkg. Este tipo de ficheros presentan varias ventajas frente al código tradicional ordenado en carpetas de módulos, a saber:

• Se pueden importar de forma cómoda desde la opción Sistema > Administración > Cargar Paquete de Módulos de eneboo.
• Ocupan menos, ya que el código está comprimido.
• Son más fáciles de trasladar y descargar.

Para empaquetar un directorio que contenga código eneboo podemos usar:

Para conocer todas las opciones de la herramienta:

Haz clic aquí para volver al índice