Comment tester Ncooker ?

Cette page explique comment tester la version en cours de développement de Ncooker.

Avant toute chose, il est important de préciser que personne n’est responsable des dégâts que Ncooker pourrait causer à votre système/ordinateur. Il s’agit d’un programme en cours de développement et qui manipule les fichiers de votre système, risquant de le rendre inutilisable. Vous êtes seul responsable dans le choix de l’exécuter sur votre système.

Il est fortement recommandé de lire les explications jusqu’à la fin avant de lancer la moindre commande.

Note : les instructions barrées ne sont plus nécessaires pour tester la branche principale de Ncooker. Elles sont, par contre, nécessaires pour tester les branches utilisant encore le fichier infos (au format XML).

Avant d’installer Ncooker, vous devez disposer notamment des logiciels suivants sur votre système :

• bash >= 3.0 (http://www.gnu.org/)
• xmlstarlet >= 1.0.1 (http://xmlstar.sourceforge.net/)
• p7zip >= 4.20 (http://p7zip.sourceforge.net/)

La version de développement de Ncooker peut être récupéré sur le dépôt Subversion de la façon suivante :

$ svn co svn://svn.gna.org/svn/nasgaia/trunk/nlib
$ svn co svn://svn.gna.org/svn/nasgaia/trunk/ncooker

Ces deux commandes vont récupérer :

• l’ensemble des librairies partagées “nlib” (dans un sous-répertoire du répertoire courant nommé “nlib”)
• la dernière version de développement de Ncooker (dans un sous-répertoire du répertoire courant nommé “ncooker”).

Un moyen permet de construire Ncooker sans l’installer sur votre système. Avec un utilisateur quelconque, vous pouvez taper ceci :

$ cd ncooker
$ make clean && make CONFIG=MConfig.cwd

Il convient d’abord de créer un fichier de configuration personnel :

$ mkdir ~/.Ncooker
$ vi ~/.Ncooker/Ncooker.conf
NC_PKG_AUTHOR='Prenom Nom <adresse@electronique.org>'
NC_ROOT_DIR=${HOME}'/root'
:wq

La variable NC_PKG_AUTHOR doit être obligatoirement définie pour construire un Nbuild. Elle sert à indiquer l’auteur des Nbuilds et des NBAs créés avec Ncooker. Il faut y mettre votre nom ou votre pseudonyme ainsi qu’une adresse électronique où vous pouvez être contacté.

La variable NC_ROOT_DIR n’a rien d’obligatoire mais elle est fortement conseillé si vous testez en tant qu’utilisateur quelconque ou si vous ne voulez pas toucher à votre système. En effet, cette variable définit la racine du système dans laquelle les paquets NBA seront installés/supprimés par Ncooker. Vous pouvez y définir n’importe quel répertoire existant, pour peu qu’il n’aura aucun impact sur votre système.

Il faut ensuite initialiser la base de données Ncooker : <code> $ Ncooker config –initdb </code> Dans le répertoire que vous avez défini comme racine de système, vous pouvez alors constater que Ncooker y a créé des répertoires et des fichiers servant de base de données.

À partir de là, vous pouvez faire tous les tests que vous voulez. Si vous ne savez pas par où commencer, un point de départ est peut-être de lancer la commande Ncooker –help pour afficher l’aide de Ncooker.

Néanmoins, voici quelques manipulations basiques.

Le plus simple est de générer un répertoire de travail pour faire un paquet Nbuild à partir des modèles de fichier infos project, package et build fournis avec Ncooker :

$ Ncooker wizard foobar

Cette commande crée un sous-répertoire nommé foobar dans le répertoire courant, contenant des modèles de fichier infos project, package et build. Ces deux fichiers sont totalement commentés. Vous devez les compléter/modifier avec les informations nécessaires pour compiler le projet que vous voulez. Si vous ne voulez pas des commentaires, vous pouvez ajouter l’option –no-comment à la ligne de commande ci-dessus.

Le fichier build est optionnel. S’il n’y en pas dans le Nbuild, Ncooker utilisera un comportement par défaut pour compiler le projet.

Vous pouvez créer un paquet Nbuild en faisant :

$ Ncooker pack foobar

Vous obtenez alors un paquet Nbuild dans le répertoire courant.

Vous pouvez obtenir un paquet NBA en tapant :

$ Ncooker build foobar-1.0-nga1.nbuild

Si tout se passe bien, vous devez obtenir un paquet NBA nommé foobar-1.0-nga1-i686.nba

Le paquet NBA s’installe en tapant :

$ Ncooker install foobar-1.0-nga1-i686.nba

Le paquet NBA s’installe dans la racine spécifiée par la variable de configuration NC_ROOT_DIR.

Pour désinstaller, vous pouvez taper :

$ Ncooker remove foobar

Il y a plusieurs manières d’indiquer le paquet à désinstaller. Lancer Ncooker remove –help pour plus d’infos.

Il est possible de ne taper que les premières lettres d’une commande pour la lancer. Exemple :

$ Ncooker w foobar

Cette syntaxe lance la commande « wizard ». Si plusieurs commandes correspondent aux lettres saisies, la première commande trouvée dans l’ordre alphabétique est lancée. Il est recommandée de taper au minimum deux ou trois lettres.

Si vous détectez une anomalie ou bien que quelque chose vous semble anormal, vous pouvez (par ordre de préférence) :

• utiliser le gestionnaire d’anomalies pour rapporter les dysfonctionnements (https://gna.org/bugs/?group=nasgaia) ;
• en discuter sur la liste de diffusion nasgaia-dev (https://mail.gna.org/listinfo/nasgaia-dev/) ;
• en discuter sur le canal IRC (serveur irc.freenode.net, canal #nasgaia).

Bons tests !