View source for Listage des éléments d'Apertium en ligne de commandes

[[Listing Apertium element using command-line|In English]]

== Changement du mode d'implantation d'Apertium ==

A l'origine, ou en tout cas pendant une dizaine d'années, le projet Apertium était archivé sur sourceforge grâce au logiciel '''subversion'''.

Le projet était alors organisé sous la forme d'une arborescence :

* Le répertoire apertium du dépôt était composé exclusivement de sous-répertoires appelés ''[[Classement des paires de langues selon leur état d'avancement|branches]]''.
* Chaque branche comportait plusieurs sous-répertoires dont chacun contenait l'un des trois éléments suivants :
** des logiciels du projet Apertium,
** une paire de langues,
** les fichiers de référence d'un langage.

Les paires de langues, pouvaient être implantées dans 4 répertoires distincts (incubator, nursery, staging et trunk) en fonction de leur état d'avancement.

Dans l'implantation actuelle d'Apertium, tous les éléments du projet sont directement implantés dans un sous-répertoire de la racine "apertium" (https://github.com/apertium/) et les branches, qui correspondaient aux sous-répertoires de premier niveau :

* apertium-incubator
* apertium-nursery
* apertium-staging
* apertium-trunk
* apertium-languages
* apertium-tools

contient seulement une liste d'éléments du projet.

== Listage d'une branche (liste d'éléments) du projet ==

Pour obtenir la liste des éléments d'une branche, il suffit de récupérer la page web :
 <nowiki>https://github.com/apertium/apertium-</nowiki>''<nom_branche>''/blob/master/.gitmodules

et d'en extraire soit les lignes contenant '''"submodule"''' , soit les lignes contenant '''<nowiki>'<span class="pl-e">'</nowiki>''' (ce sont apparemment les mêmes).

Ensuite, il suffit de ne conserver que les noms d'éléments du projet dans les lignes récupérées.

Exemple de code permettant de récupérer les données des lignes contenant "submodule" :

 #!/bin/sh<br />
 <nowiki>motifsed='<span class="pl-e">'</nowiki><br />
 wget -q <nowiki>https://github.com/apertium/apertium-$1/blob/master/.gitmodules</nowiki><br />
 fgrep "submodule" .gitmodules |
 sed "s/.*$motifsed//
      s/<\/span>.*//" | sort<br />
 rm .gitmodules*

Exemple d'appel (en supposant que la commande s'appelle listebranche) :

 listebranche trunk

== Date de dernière modification d'un élément du projet (méthode triviale) ==

Cette méthode consiste aussi à récupérer une information dans une page web. Il s'agit de la page :
 <nowiki>https://api.github.com/repos/apertium/</nowiki>''<nom_élément>''

On récupèrera la date et l'heure qui figure dans le ligne qui contient '''"pushed_at"'''

Exemple de code :

 #!/bin/sh<br />
 wget -q <nowiki>https://api.github.com/repos/apertium/$1</nowiki><br />
 fgrep "pushed_at" $1 |
 sed "s/.*: \"//
      s/T/ /
      s/Z.*//"<br />
 rm $1

Ce système fonctionne bien avec les éléments du projet Apertium modifiés récemment. Toutefois, pour les autres éléments, on ne trouve jamais de date antérieure à mars 2018. En effet, c'est en mars 2018 que le projet Apertium a été transféré de sourceforge à github.

Pour les éléments qui n'ont pas été modifiés depuis longtemps, il est possible d'utiliser la commande '''svn list''' et de supprimer les références aux fichiers du dépot git (ils commencent par un . ) avant de chercher le plus récemment modifié.

== Listage des fichiers et répertoires d'un élément du projet ==

Pour lister des fichiers et répertoires d'un élément du projet, on peut exécuter la commande '''svn list -v''' sur le sous-répertoire '''trunk''' (!!!) de cet élément.

Par exemple, pour le langage apertium-fra :

 svn list -v <nowiki>http://github.com/apertium/apertium-fra/trunk</nowiki>

Le message d'une ligne qui apparait au début peut être supprimé, tout comme les fichiers git et la référence au répertoire courant dont les noms commencent par .

Enfin, si on appelle la commande '''svn list''' sur un élément qui n'existe pas, subversion demande un mot de passe. On peut éviter ce problème en redirigeant l'entrée standard sur /dev/null

Exemple de code :

 #!/bin/sh<br />
 svn list -v <nowiki>http://github.com/apertium/$1/trunk</nowiki> < /dev/null |
 fgrep -v " ." | tail -n +2

== Date de dernière modification d'un élément du projet (avec svn) ==

=== Solution avec svn list -v ===

Pour chercher la date de dernière modification d'un élément du projet, il suffit de chercher dans le résultat d'une commande '''svn list''' le dernier fichier qui a été modifié. Dans le cas du projet Apertium, les modifications importantes sont dans le répertoire racine de l'élément du projet. On n'examinera pas le contenu des sous-répertoires.

Cependant, avec la commande '''svn list -v''', deux problèmes se posent pour l'affichage des dates :

* Un nom de mois abrégé est affiché, ce serait plus facile avec un numéro de mois
* Pour les fichiers modifiés dans les 6 derniers mois, on a l'heure de modification à la place de l'année. La modification peut avoir eu lieu cette année ou à la fin de l'année précédente.

Il faudra transformer les dates affichées pour résoudre ces problèmes. On pourra faire ces transformations en utilisant 2 commandes '''sed''' et en créant deux "sedfiles" (fichiers de commandes sed). 

Le premier de ces fichiers dépendra de la langue dans laquelle est affichée les noms de mois. Si l'affichage est en langue anglaise (ce que l'on peut forcer en faisant '''LANG=en_US.UTF-8'''), on pourra utiliser le fichier 
'''numerote-mois''' suivant :

 s/ Jan / m01 /
 s/ Feb / m02 /
 s/ Mar / m03 /
 s/ Apr / m04 /
 s/ May / m05 /
 s/ Jun / m06 /
 s/ Jul / m07 /
 s/ Aug / m08 /
 s/ Sep / m09 /
 s/ Oct / m10 /
 s/ Nov / m11 /
 s/ Dec / m12 /

Un deuxième fichier sed va générer un numéro d'année avant le numéro de mois. Le contenu de ce fichier changera chaque mois. On utilisera un premier script pour le générer :

 #!/bin/sh<br />
 an=`date +%Y`
 changemois=`date +%m`<br />
 > an_mois<br />
 mois=01<br />
 while [ $mois -le $changemois ]
 do
     echo "s/ m$mois /$an $mois /" >> an_mois
     mois=`expr $mois + 101 | cut -c2-`
 done<br />
 an=`expr $an - 1`<br />
 while [ $mois -le 12 ]
 do
     echo "s/ m$mois /$an $mois /" >> an_mois
     mois=`expr $mois + 101 | cut -c2-`
 done

Le script principal permettant de chercher la date de dernière modification de l'élément du projet va procéder de la manière suivante :

* faire un '''svn list -v''' sur le sous-répertoire ''trunk'' de l'élément
* supprimer les fichiers et répertoires dont le nom commence par .
* réordonner les colonnes pour faire un affichage an mois jour nom_fichier (attention, pour les répertoire (identifiables par un / après le nom) le champ taille_du_fichier est vide)
* remplacer les noms de mois abrégés par m suivi d'un numéro de mois (sur 2 chiffres)

Deux cas se présentent alors :

1) Tous les fichiers sont vieux d'au moins 6 mois : toutes les lignes commencent par l'année.

Dans ce cas, on tri les lignes obtenues par ordre alphabétique. La date de la modification la plus récente est celle du fichier (ou du sous-répertoire) qui apparait en dernière ligne.

2) Certains fichiers ont été modifiés dans les 6 dernier mois. On trouve des heures en début de ligne qu'on peut identifier par la présence du symbole :

Dans ce cas, il suffit de s'intéresser à ces fichiers. On enlèvera l'heure en début de ligne pour mettre l'année à la place. Puis après un tri alphabétique, on prendra la date qui apparait en dernier.

Le script qui effectue ce traitement est le suivant :

 #!/bin/sh<br />
 liste1=/tmp/listepaire1_$$
 liste2=/tmp/listepaire2_$$<br />
 svn list -v <nowiki>http://github.com/apertium/$1/trunk</nowiki> < /dev/null |
 fgrep -v " ." | tail -n +2 > $liste1<br />
 grep -v "/$" $liste1 | awk '{print $6 " " $4 " " $5}'  > $liste2
 grep    "/$" $liste1 | awk '{print $5 " " $3 " " $4}' >> $liste2<br />
 sed -f numerote-mois $liste2 | sort > $liste1<br />
 fgrep : $liste1 > $liste2<br />
 if test -s $liste2
 then
     cut -c6- $liste2 | sed -f an_mois | sort | tail -1 |
     awk '{print $3 " " $2 " " $1}'
 else
     tail -1 $liste1 | sed "s/m//" |
     awk '{print $3 " " $2 " " $1}'
 fi<br />
 rm $liste1 $liste2

=== Solution avec svn list --xml ===

Avec cette option de la commande svn, le nom du fichier et sa date de mise à jour apparaissent sur des lignes distinctes et sont entourés de balises XML.

Il faudra sélectionner ces lignes et les regrouper.

Comme précédemment, après avoir enlevé les lignes concernant des fichiers dont le nom commence par . puis conservé seulement la date et fait un tri par ordre alphabétique, c'est la date qui apparait en dernier qui nous intéresse.

Voici un exemple de script qui fait le traitement.

 #!/bin/sh<br />
 svn list --xml <nowiki>http://github.com/apertium/$1/trunk</nowiki> < /dev/null | egrep "<(nam|dat)e>" |
 paste - - | fgrep -v ">." | sed "s/.*<date>//" | sort | tail -1 | cut -c1-10

Dans cet exemple, la date apparait sous la forme an-mois-jour

On pourrait continuer le traitement pour avoir un affichage jour/mois/an et également afficher l'heure de la mise à jour qui apparaitrait aussi si on n'avait pas tronqué l'affichage aux 10 premiers caractère.

[[Category:Documentation]]
[[Category:Documentation en français]]