Changes between Version 4 and Version 5 of TolPackageRulesAndComments

Timestamp:

Jun 17, 2010, 6:04:48 PM (15 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

TolPackageRulesAndComments

@@ -1 @@
-= Reglas de construcción y comentarios acerca de paquetes y repositorios =
+= !TolPackage: Un sistema de desarrollo modular en red  =
 
- * Un paquete es un tipo de NameBlock especial que se carga con la orden
-   #Require nombre_de_paquete y que se lee directamente de un archivo .oza
-   almacenado previamente en un directorio local predeterminado por el sistema.
- * Los paquetes están disponibles en repositorios remotos o locales desde los
-   cuales es posible instalarlos y manejarlos mediante las utilidades de 
-   {{{StdLib::TolPackage::Client}}}
- * Las correspondientes funciones de creación y mantenirmiento de los 
-   respositorios están disponibles en {{{StdLib::TolPackage::Server}}}
- * Los nombres de los paquetes deben seguir el estilo CamelCase 
+== Objetivos ==
+
+El objetivo principal de este sistema es que los usuarios finales que no
+colaboran en el desarrollo de las librerías de uso más o menos genérico, 
+no tengan que preocuparse de dónde se encuentra el código fuente de las 
+mismas ni tenga que tener instalados programas para compartir código como 
+CSV o SVN. El usuario sólo necesita saber una URL remota o un camino local 
+donde se encuentran los paquetes y el nombre de los que necesita. El 
+sistema se ocupa de instalar todo lo necesario de forma automática si se 
+desea o manualmente si se trata de procesos críticos.
+
+El otro gran objetivo es fomentar la creación de utilidades concretas que
+se puedan cargar atómicamente sin necesidad de compilar cantidades ingentes 
+de código del cual luego se usa sólo una pequeña parte la mayor parte de 
+las veces. El usuario no necesita saber qué paquetes dependen de cuáles 
+sino que son ellos mismos quienes se autogestionan.
+
+Por último, hay que permitir que cada paquete evolucione sin excesivas 
+ataduras de compatibilidad hacia atrás para que pueda progresar pero sin
+dejar tirados a los usuarios que por motivos de seguridad no pueden 
+arriesgarse a actualizarse cada poco tiempo.
+
+== Arquitectura ==
+
+Un paquete es un tipo de NameBlock especial que se carga con la orden 
+{{{
+  #Require nombre_de_paquete 
+}}}
+y que se lee directamente de un archivo OIS almacenado previamente en un 
+directorio local predeterminado por el sistema al que llamaremos almacén
+del cliente y que es común para todas las instalaciones de TOL que haya
+en una misma máquina.
+
+Un repositorio es un sitio web o un directorio local al que llamaremos
+también almacén servidor, donde se encuentra disponible una colección de 
+paquetes ya preparados para que los usuarios puedan descargarlos a su 
+almacén de cliente.
+
+Los paquetes disponibles en repositorios remotos o locales se instalan,
+actualizan y manejarlos mediante las utilidades de 
+{{{StdLib::TolPackage::Client}}}
+
+Las utilidades para la creación de repositorios se encuentran en 
+{{{StdLib::TolPackage::Server}}}
+
+== Creación de paquetes ==
+ 
  * Un paquete se crea como un NameBlock en un fichero principal del mismo 
    nombre con extensión .tol y dentro de un directorio raíz llamado igual. El 
@@ -15 +53 @@
    necesite con nombre libre pero ubicación paralela o en subdirectorios del 
    raíz.
+ * En [source:/tolp/OfficialTolArchiveNetwork] pueden verse ejemplos de 
+   paquetes. Cada subdirectorio es un paquete.
+ * Los nombres de los paquetes deben seguir el estilo CamelCase 
  * Cuando un paquete requiere de otros se debe incluir las correspondientes
    sentencias #Require antes de la declaración del primer miembro.
@@ -68 +109 @@
  * También debe tener una batería de tests estándar en un directorio test 
    colgando directamente de la raíz del paquete.
+
+== Creación de repositorios ==
+
  * El repositorio es un directorio plano con unos archivos obligatorios:
   * index.tol: Contiene características generales del repositorio como el 
@@ -73 +117 @@
   * index.csv: Listado de los paquetes y su información asociada: fecha,
     versión, dependencias, etc.
+ * En el archivo [source:/tolp/OfficialTolArchiveNetwork/_upload.tol]
+   puede verse como ejemplo el programa de creación y subida de [http://packages.tol-project.org/OfficialTolArchiveNetwork/ OfficialTolArchiveNetwork], el repositorio
+   oficial de paquetes del equipo de desarrollo de TOL.
  * Debe haber un comité o alguien responsable de probar todos los paquetes de
    un repositorio antes de publicar las actualizaciones de los paquetes para