SummaPack
=========

Mapa global de los paquetes, ejecutables y flujos del proyecto: ../MAPA-FLUJOS.txt. Incluye el calculo, los graficos, la web y las herramientas de instalacion/publicacion, con sus archivos y pantallas.

Politica comun de todos los programas del conjunto, pendiente de implementar:
la salida nueva conserva el nombre original y la anterior se guarda como
NOMBRE_vN.EXT, con numeracion creciente y sin perder respaldos.
Regla completa y condiciones de seguridad: ../POLITICA-ARCHIVOS.txt.

La politica comun tambien fija entrada completa por stdin, resultados por stdout y generacion de archivos solo con -save; para graficos, X por defecto, -noX para no mostrar y -save para guardar SVG. Es una especificacion pendiente de aplicar, no una afirmacion sobre las opciones actuales de cada herramienta.

El proyecto tiene todavía un grado de avance pequeño: apenas lo necesario para instalar los paquetes del proyecto Simusol. Reúne construcción, descarga, preparación de dependencias, instalación y publicación; no es un gestor universal para cualquier sistema.

El esquema completo --de nuestras fuentes al servidor y al usuario, que se
publica, por formato y por distribucion, y con que orden de sp se hace cada
paso-- esta en el manual, doc/summapack.tex (apendice "Esquema").

Criterios para sp
-----------------
sp y sus packlets se escriben íntegramente en Bash básico, con construcciones sencillas que funcionen también en las bases antiguas. Para construir e instalar paquetes llaman a las herramientas propias de cada sistema.

Para los proyectos de este árbol se prefiere construir desde las fuentes disponibles e instalar mediante el gestor de paquetes de la máquina, siempre que el formato esté soportado. Las fuentes pueden estar en SVN, en otro directorio local o en una entrega publicada. Para distribuir binarios se construye en el Podman de la base antigua correspondiente a cada familia y se prueba el resultado en las versiones destinatarias. Fedora y openSUSE tienen construcciones RPM separadas.

Plan de instalación y pruebas de sp: véase la sección con ese título en doc/summapack.tex y en el PDF de summapack-doc. Incluye las formas de entrega, la aceptación y reversión por etapa y la modalidad posterior para ejecutar desde el árbol.

Las tres capas
--------------

Decision del autor (16/11/2026). Tenemos NUESTRAS fuentes; de ellas summa
genera las fuentes de cada distribucion --deb, rpm, tgz--; y de esas fuentes
en adelante se sigue con las herramientas de cada distro, sin summa.

  nuestras fuentes         el .summa, el MANIFIESTO y los archivos propios
  (capa summapack)         del proyecto. Estan en el svn. Es lo unico que
        |                  se edita
        |  summa las genera (sp paquete: sp-manifiesto, summa-automake.sh,
        |  summa-debian.sh, summa-rpm.sh, autoreconf)
        v
  fuentes de distribucion  el tarball con la capa automake adentro, mas la
  (capas automake y        capa de cada distro: debian/ para deb, el .spec
  deb/rpm)                 para rpm
        |
        |  herramientas de la distro, y nada mas: dpkg-buildpackage,
        |  rpmbuild, ./configure && make
        v
  paquetes                 .deb, .rpm, .tgz

POR QUE ASI. Lo mas probable es que Debian nunca acepte a summapack en sus
repositorios --es una herramienta de empaquetado propia, que hace lo que alla
hacen dpkg y debhelper--, y lo mismo las demas distros. Entonces un paquete
nuestro solo puede entrar, o construirse en la maquina de otro, si sus
fuentes de distribucion NO necesitan summapack: ni como dependencia de
construccion ni llamando a una herramienta suya. summa trabaja de nuestro
lado y entrega fuentes que ya no lo nombran.

Las capas, y para quien es fuente cada una:

  capa        que es                                fuente      fuente
                                                    para        para la
                                                    nosotros    distro
  ---------   -----------------------------------   ---------   --------
  summapack   el .summa y el MANIFIESTO, y los      SI          no la ve
              archivos del proyecto que el
              MANIFIESTO declara
  automake    lo que sale del .summa y del          no: se      SI
              MANIFIESTO --instalar.am, dist.am,    genera
              m4/summapack.m4-- y lo que escribe
              autoreconf: configure, Makefile.in.
              Si el proyecto no compila nada,
              tambien configure.ac y Makefile.am
              enteros
  deb/rpm     debian/control, rules, copyright,     no: se      SI
              source/format, los .install; el       genera
              .spec

Un proyecto que compila codigo trae su configure.ac y su Makefile.am escritos
a mano: esos estan en el MANIFIESTO y son nuestros, de la primera capa. summa
les agrega el include de instalar.am y nada mas.

REGLAS

1. Se edita la primera capa. NUNCA a mano lo generado: exportar() corre los
   generadores sobre la copia y sobreescribe lo que haya.

2. Lo generado no se versiona, pero SI se distribuye. No se versiona porque
   una copia que no se usa y que nadie compara termina mintiendo: en
   sceptresimusol el debian/control comiteado tenia tres dependencias que el
   .summa habia perdido --bison entre ellas-- y le faltaban las cinco de
   texlive. Y se distribuye porque para la distro SI es fuente: sin debian/
   no hay paquete fuente de Debian, sin configure no se compila el tarball.
   De debian/ se versiona solo el changelog, que es historia escrita a mano.

3. Nada de la primera capa se llama desde las otras dos. Un Makefile.am o un
   debian/rules que invoque una herramienta de summapack rompe la
   construccion donde summapack no esta. Paso: un check-local con
   "sp-manifiesto comprobar" en simusol y dia-simusol hacia fallar
   dh_auto_test. Las comprobaciones nuestras van en sp paquete --exportar()
   corre sp-manifiesto comprobar antes de copiar--, no en lo que viaja.

4. Cuando el proyecto tiene MANIFIESTO.excluidos, sp incluye los archivos nuevos que no coinciden con una exclusión y los agrega al MANIFIESTO de la copia de construcción. De esa lista sale también EXTRA_DIST para make dist. Sin archivo de exclusiones se usa la lista declarada.

5. Lo que no es fuente de nadie no entra en ninguna capa: objetos, binarios,
   PDF generados, paquetes construidos. Si una pieza tiene que quedar en el
   arbol como historica, queda sin versionar y excluida de las dos vias.

SP FUENTES: EL PRIMER TRAMO

  sp fuentes [LUGAR/]NOMBRE [SALIDA]

genera las fuentes de distribucion de un proyecto y no hace nada mas: no
compila, no instala, no sube, no toca el arbol. Deja

  NOMBRE_ARRIBA.orig.tar.gz      el programa: la copia del MANIFIESTO con la
                                 capa automake adentro, configure hecho, y
                                 sin debian/. Uno solo para todas las
                                 distros
  NOMBRE_ARRIBA-N.debian.tar.xz  la capa deb
  NOMBRE_ARRIBA-N.dsc            el paquete fuente de Debian, 3.0 (quilt)
  NOMBRE-ARRIBA-N.src.rpm        el paquete fuente de RPM, con el mismo
                                 tarball como Source0

y el segundo tramo ya es de la distro:

  deb   dpkg-source -x NOMBRE_*.dsc; cd NOMBRE-*; dpkg-buildpackage -b
  rpm   rpmbuild --rebuild NOMBRE-*.src.rpm
  tgz   tar xzf NOMBRE_*.orig.tar.gz; ./configure && make && make install

ARRIBA es la version del programa y -N la revision del empaquetado, que es
lo que escribe sp-version. Por eso el formato es 3.0 (quilt) --el de casi
todo Debian--: un paquete nativo no puede llevar revision. Nosotros seguimos
usando sp para todo; estas fuentes son para que otro construya el paquete
sin tener summapack.

Para comprobar un proyecto: lintian --profile debian -I NOMBRE_*.dsc, y
construir el segundo tramo con el PATH sin el arbol.

QUE SE PUBLICA Y COMO SE INSTALA (decision del autor, 16/11/2026)

El usuario tipico no recibe binarios nuestros: recibe NUESTRAS fuentes y las
construye en su maquina con sp. Quien usa sceptre ya compila Fortran cada vez
que simula --sceptre genera el modelo y lo compila--, asi que gfortran, make
y lo demas tienen que estar igual: compilar nuestros proyectos no le agrega
ninguna herramienta. Y es mucho mas simple que fabricar un binario por
distribucion y por version.

Tampoco hace falta un repositorio apt ni dnf: sp maneja las dependencias.
Las de la distribucion (gfortran, bison, perl...) las instala con el gestor
de la maquina --packlets de apt, dnf, zypper, pacman, emerge y urpmi--,
traduciendo cada nombre con diccionariodepaquetes; esas vienen firmadas por
la distro. Las nuestras (slex, exprtk, unidades, tabular2...) son proyectos
mas: sp las baja y las construye igual, leyendo el .summa de cada una.

En el servidor, entonces, va:

  summapack         lo unico que llega armado: el sp autonomo (lleva el
                    .tgz de summapack adentro), 0-README-como-instalar,
                    diccionariodepaquetes y fuentesexternas
  PROYECTO.summa    uno por proyecto, arriba: de el sp saca la version
                    estable y las dependencias, sin bajar el tarball
  PROYECTO/NOMBRE_VERSION.tar.gz   las fuentes de cada proyecto: la copia
                    del MANIFIESTO con la capa automake adentro y configure
                    ya hecho. El .summa y el MANIFIESTO viajan adentro,
                    aunque no los use nadie: las fuentes llevan siempre la
                    capa de la que salieron
  cada uno con su .md5

Las fuentes de distribucion de "sp fuentes" (.orig.tar.gz, .dsc, .src.rpm)
son para un empaquetador de una distro, si aparece; no hacen falta para el
usuario.

LO QUE HACE EL USUARIO

  curl -fsSLO https://www.simusol.org/downloads/sp
  sh sp --para fuentes-paquete calcula

La primera vez el sp autónomo instala SummaPack. Con fuentes-paquete, prepara las dependencias de construcción, compila las fuentes, arma el paquete nativo y lo instala con el gestor de la máquina. Para trabajar desde una copia local con su .summa y MANIFIESTO, con o sin SVN:

  sp --arbol /ruta/a/las/fuentes --para fuentes-paquete install SOURCE calcula

Otras operaciones:

  sp --para fuentes --prefijo ~/.local calcula   en el home, sin root
  sp --para fuentes-paquete calcula   compila aca, arma un .deb o .rpm
                                      para esta maquina y lo instala con
                                      apt, dnf o zypper (en /usr)
  sp remove calcula                   desinstala con la lista
  sp list-source                      lo instalado desde fuentes
  sp --ensayo --para fuentes calcula  dice que haria, sin hacerlo

LO QUE HACEMOS NOSOTROS PARA PUBLICAR (en el arbol, con todo comiteado)

  sp paquete LUGAR/NOMBRE    arma: deja NOMBRE_VERSION.tar.gz y
                             NOMBRE_VERSION.summa (y los paquetes de esta
                             maquina, que no se suben)
  sp subir --prueba --tipo fuentes LUGAR/NOMBRE   dice que subiria
  sp subir --tipo fuentes LUGAR/NOMBRE   sube el tar.gz y el .summa, como
                             UNSTABLE: lo baja quien pide --inestable
  sp estable LUGAR/NOMBRE    lo subido pasa a estable: PROYECTO.summa
                             arriba con la VERSION nueva
  sp subir --bootstrap LUGAR/summapack   la raiz: el sp autonomo, la guia
                             y los catalogos
  sp iso ututo2027           la ISO de Ututo 2027, desde nuestras fuentes:
                             adentro instala cada proyecto con sp --para
                             fuentes-paquete install, y las fuentes quedan
                             en la ISO (/usr/src/ututo2027)

Se publica cada proyecto y cada dependencia nuestra; el orden no importa
para el usuario mientras esten todos antes de pasar a estable. Comitear no
autoriza a subir: cada subida la decide el autor.

LO QUE TODAVIA NO CUMPLE (estudiado el 16/11/2026)

  generados que siguen versionados   sceptresimusol: instalar.am y dist.am
                                     (dist.am por decision del 09/11/2026,
                                     anterior a esta regla: hay que
                                     revisarla). simplot: debian/control,
                                     copyright, rules, source/format, watch,
                                     y dos restos de construccion,
                                     debian/files y simplot.substvars
  los errores de lintian de cada     sp fuentes los deja a la vista. Limpios
  proyecto                           (ningun error ni aviso): simusol,
                                     dia-simusol, sceptresimusol. Con make o
                                     coreutils en Build-Depends: siru,
                                     exprtk, simplot. Con pkg-config, que es
                                     obsoleto: slex, unidades, tabular2. Con
                                     binarios o HTML sin fuente declarados
                                     en el MANIFIESTO: slex, tabular2,
                                     simplot. exprtk: 176 archivos sin
                                     copyright. A todos les falta
                                     debian/watch, que es solo una nota
  sp paquete no pasa por las         sp paquete sigue armando el .deb desde
  fuentes de distribucion            la copia, sin pasar por el .dsc
  el .rpm y el .tgz binarios         hoy salen de desarmar el .deb, no de
                                     sus fuentes
  mem_util                           slex y tabular2 la piden para construir
                                     y para correr, y vive dentro del
                                     paquete fuente summapack: mientras sea
                                     asi, esos dos dependen de que summapack
                                     este


Lenguaje y dependencias
-----------------------

summapack es la capa basica: tiene que funcionar en una distribucion recien
instalada, ANTES de que haya perl, python o cualquier otro interprete, y con
shells elementales --el /bin/sh de la distro, dash o ash, no solo bash--. De
eso depende poder instalar todo lo demas: si summapack necesitara un
interprete para arrancar, habria que instalar ese interprete antes con otra
herramienta, y se pierde lo que lo hace util, que es arrancar en una maquina
pelada.

Por eso se escribe en shell, y en el camino de arranque e instalacion se
evita ademas lo que no sea POSIX. La unica excepcion prevista es mem_util, la
biblioteca en C.

Conviene distinguir dos caminos, porque no corren el mismo riesgo:

  arranque e instalacion    sp, sp-bootstrap, installsumma, distro,
                            bajar-paquetes, instalar-tgz, packinstall: es lo
                            que corre en una maquina pelada y lo que no puede
                            depender de nada
  construccion/publicacion  sp paquete, summa, subir-paquetes: corre en la
                            maquina de quien arma los paquetes, que ya tiene
                            herramientas; aun asi va al mismo destino

El nucleo del empaquetado esta en Bash: summa.sh consulta el .summa y coordina los generadores summa-crear.sh, summa-debian.sh, summa-rpm.sh y summa-automake.sh. Otras funciones, como la sincronizacion web, conservan programas en Python.

Componentes actuales
--------------------

  consulta          summapack, distro (distro.sh en las fuentes)
  instalación       sp (arranque público e interfaz instalada), bajar-paquetes (motor interno), instalar-tgz
  dependencias      preparar, packinstall, diccionariodepaquetes, fuentesexternas
  construcción      .summa, summa.sh, armar-proyecto, hacer-pkg.inc, makefile.lib
  otras distros     distros/: Podman viejos para binarios y nuevos para
                    probar fuentes; armar-bibliotecas (proyecto "comunes",
                    /usr/lib/simusol), espejo-fuentes, compilar y entornos
  publicación       subir-paquetes, subir-doc, sp subir --bootstrap summapack
  escritorio        icon_install, findbinlib
  compatibilidad    templatesumma y el enlace hacer-deb.inc -> hacer-pkg.inc
  biblioteca C      mem_util: memoria, archivos, rutas, cadenas y fechas
  documentación     doc/summapack.tex y doc/web/ (HTML para TinyMCE)
  pruebas           pruebas/ y mem_util/tests o sus pruebas de src/

Paquetes producidos
-------------------

  summapack         herramientas y datos comunes (arquitectura all)
  libmem-util0      biblioteca C de ejecución
  libmem-util-dev   encabezados, enlace de desarrollo y mem_util.pc

Pedir summapack como paquete arrastra libmem-util-dev y la biblioteca. Las herramientas adicionales para construir, compilar fuentes, publicar o usar el escritorio dependen de la operación: ver el manual; no todas están garantizadas por instalar el paquete básico.

Inicio
------

La guía pública única y vigente es https://www.simusol.org/downloads/0-README-como-instalar. Describe los formatos, las dependencias y cómo revisar el recorrido sin instalar.

Para instalar Calcula directamente en Debian/Ubuntu:

    curl -fsSLO https://www.simusol.org/downloads/sp
    sh sp --para deb calcula

Es una sola orden de instalación: instala SummaPack, Calcula y sus dependencias. No hace falta instalar SummaPack antes ni ejecutar dos veces sp. Sin nombres de proyecto, sh sp --para deb instala sólo SummaPack.

Desde las fuentes, se prefiere sh sp --para fuentes-paquete calcula cuando la distribución está soportada. La forma directa, sh sp --para fuentes calcula, compila en la máquina e instala mediante make install en /usr/local, o en --prefijo, con un registro para desinstalar mediante sp remove calcula. Para construir paquetes .deb o .rpm e instalarlos con el gestor de la distribución, usar --para fuentes-paquete. Son alternativas, no pasos sucesivos.

Desde el arbol de svn y sin internet, en una maquina de cero: svn/siru/summapack/sp/sp, sin ninguna orden (sin «sh» delante: ese sp es bash, y con el sh de Debian y Ubuntu, que es dash, no arranca). Arma el paquete de la distribucion con la version del arbol y lo instala, despues de instalar lo que hace falta para fabricarlo; con --ensayo dice que haria. No usa el servidor de descargas. Las herramientas para fabricar el paquete se revisan una por una y solo se instala lo que falte, con el gestor de la distribucion: estando todas no se usa la red, y por eso funciona sin internet; si falta alguna y no hay red, arma los tres paquetes de summapack y, si hay compilador, los de la biblioteca mem_util tambien, y los instala: eso es hacer-pkg-minimo, que los escribe A MANO --el .deb armando el ar, el .rpm con armar-rpm.sh y el .tgz, sin dpkg-dev ni rpmbuild-- e instala los que entienda el gestor de la distribucion, que siempre esta: con dpkg o apt los deb, con rpm los rpm, sin ninguno de los dos los tgz con instalar-tgz. Si no hay descompresores no hay paquete posible y --forma directo pone los archivos en su lugar, como make install. Si no hay compilador avisa y siguen los de summapack solo. La version queda marcada ~minimo para que el paquete completo lo actualice en cuanto haya con que fabricarlo. Sirve tambien para actualizar: si la version instalada es mas vieja que la del arbol, hace lo mismo. Si lo instalado ya esta al dia, sp a secas dice que falta la operacion, como siempre. Y si no esta el arbol y lo unico que hay es el sp suelto, el ejecutable publico de Descargas, ese sp lleva el paquete .tgz adentro como datos (lo pega distros/armar-sp despues de la marca __SP_TGZ__, en base64): con --sin-red, o si la descarga falla, lo saca del propio archivo y lo instala con hacer-pkg-minimo --desde-tgz, que arma el deb o el rpm desde ese tgz --el tgz es el arbol de archivos del paquete-- y los instala con el gestor, o instala el tgz derecho si no hay ni dpkg ni rpm. Todo el recorrido, los formatos escritos a mano byte por byte, lo que se midio y lo que no, en doc/instalar-sin-red-ni-herramientas.md.

Con sp instalado: sp install calcula, sp remove calcula y sp search gsl. Los binarios se construyen en las bases de distribución previstas por el proyecto; su formato no garantiza compatibilidad con todas las bibliotecas del destino. Ver la guía canónica para elegir el recorrido.

Construir paquetes: sp paquete LUGAR/NOMBRE arma en el formato de esta maquina (deb, rpm propio en Fedora y SUSE, pacman en Arch, tgz en las demas), desde el .summa y el MANIFIESTO; sp binarios LUGAR/NOMBRE DISTRO... lo hace en el Podman de cada distribucion. Construir no instala ni publica. Ningun proyecto trae su propia receta (17/11/2026: se retiraron los hacer-pkg). Los formatos, herramientas y dependencias estan en doc/formatos-de-paquete.md. hacer-deb.inc se conserva como enlace compatible.

Documentación
-------------

  doc/0-README-como-instalar      guía pública de descargas: cero, uno o varios proyectos
  doc/summapack.tex              el manual: todo summapack, y en sus apéndices
                                lo que eran BIN.md, PAQUETES.md, ESQUEMA.md,
                                MAKEFILE-LIB.md, sp/README.md, sp/CONTRATO.md,
                                distros/README.md, doc/web/README.md y los .md
                                de doc/ (integrados el 17/11/2026: el .tex es
                                la única fuente). Se instala como PDF con el
                                paquete summapack-doc.
  mem_util/README               API C, integración y unidades de fechas

Pruebas: make prueba; python3 pruebas/prueba-distro.py; python3 pruebas/prueba-subir-doc.py; make -C mem_util check una vez configurada y compilada la biblioteca.

Publicación: subir-paquetes publica software; ./subir-doc publica únicamente los PDF. Ninguno cambia CMSimple. Usar la configuración ~/.config/simusol/subir y revisar el alcance de --prueba en cada herramienta: no es una opción universal ni promete cero actividad de red.

sp subir --bootstrap summapack publica doc/0-README-como-instalar en la raíz de descargas, con el sp autónomo y los catálogos. El nombre con 0 lo sitúa antes que los demás nombres en el índice ordenado ascendentemente. subir-paquetes --reorganizar conserva esta guía y los catálogos del bootstrap.

Los programas retirados viven en viejo/ y no son la interfaz recomendada. Los archivos .summa, catálogos de recetas y plantillas pueden contener órdenes ejecutables: utilizar solamente fuentes de confianza.
