CreoleLint et CreoleCat
CreoleLint
et CreoleCat
sont des utilitaires permettant de faciliter les tests sur les dictionnaires et les templates :
CreoleLint
permet de valider la syntaxe des dictionnaires et des templates ;CreoleCat
permet d'instancier un seul template indépendamment des commandesinstance
etreconfigure
.
Vérifier les dictionnaires et templates avec CreoleLint
La commande CreoleLint
permet de valider la syntaxe des dictionnaires et des templates.
L'outil effectue une série de tests dans le but de détecter des erreurs dans la déclaration et l'utilisation des variables.
Sur un module installé, il est possible de lancer l'application sans option particulière :
# CreoleLint
Cette commande permet également :
de valider un seul template avec l'option
-t
:CreoleLint -t hostname
de ne lancer qu'un seul des tests lint avec l'option
-n nomDuTest
:CreoleLint -n valid_dtd
de ne lancer que la validation des dictionnaires avec l'option
-d
:CreoleLint -d
Les tests lint disponibles sont les suivants :
valid_dtd
: validation syntaxique des dictionnaires ;tabs_in_dicos
: recherche de tabulation dans les dictionnaires ;hidden_if_in_dicos
: recherche des conditions dépréciéeshidden_if_in
ethidden_if_not_in
;condition_without_target
: recherche des conditions sans cible associée (EOLE >=2.6.2) ;obligatoire_in_dicos
: recherche du validateur dépréciéobligatoire
;valid_slave_value
: recherche les variables esclaves avec une liste en valeur défaut (EOLE >= 2.5.2) ;wrong_dicos_name
: validation du nom des dictionnaires ;valid_var_label
: vérification des libellés des variables ;valid_separator_label
: vérification des libellés des séparateurs ;valid_help_label
: vérification des libellés de l'aide en ligne ;activation_var_without_help
: vérification des variables d'activation sans balise d'aide (EOLE >= 2.5.2) ;family_without_help
: vérification des familles sans balise d'aide ;family_without_icon
: vérification des familles sans icône spécifique ;old_fw_file
: recherche des anciens fichiers eole-firewall ;valid_parse_tmpl
: validation de tous les templates.
Truc & astuce
L'option -l
permet de choisir le niveau des messages (info, warning ou error).
La commande
CreoleLint
suivie du paramètre -h
permet d'obtenir de l'aide. Un manuel est également disponible :
# man CreoleLint
Instancier un template avec CreoleCat
La commande CreoleCat
permet d'instancier un seul template indépendamment des commandes instance
et reconfigure
.
Cette commande permet :
d'instancier un seule template existant sur le module en utilisant la ou les destinations déclarées dans le dictionnaire :
# CreoleCat -t hostname
d'instancier un template existant sur le module en redirigeant le résultat dans un fichier spécifique :
# CreoleCat -t hostname -o /tmp/hostname.txt
d'instancier un fichier template spécifique en redirigeant le résultat dans un fichier spécifique :
# CreoleCat -s /tmp/test.tmpl -o /tmp/test.txt
d'instancier un fichier template spécifique en affichant le résultat sur la console (EOLE >= 2.5.2) :
# CreoleCat -s /tmp/test.tmpl
Truc & astuce
L'option -l
permet de choisir le niveau des messages (info, warning ou error).
Les options -v
(--verbose
) ou -d
(--debug
) permettent de connaître le détail des opérations réalisées par le programme.
La commande
CreoleCat
suivie du paramètre -h
permet d'obtenir de l'aide.
Exemple
root@scribe:~# CreoleCat -d -t sympa.auth.conf
Instanciation du fichier '/etc/sympa/auth.conf' depuis '/var/lib/creole/sympa.auth.conf'
Copy template: '/usr/share/eole/creole/distrib/sympa.auth.conf' -> '/var/lib/creole'
Cheetah processing: '/var/lib/creole/sympa.auth.conf' -> '/etc/sympa/auth.conf'
Changing properties: chown sympa:sympa /etc/sympa/auth.conf
Changing properties: chmod 0644 /etc/sympa/auth.conf
Remarque
Dans le cas d'un template renommé, c'est le nom du template (défini dans l'attribut source) qu'il faut utiliser.