Est-il possible de lancer l'audit en ligne de commande?

Bonjour,

On vient de me montrer l’outil ASQATASUN et c’est vraiment du super travail.
Du coup, je souhaiterais l’intégrer dans mon process d’intégration continue.
Pour cela, il faudrait pouvoir lancer l’audit (et donc l’export CSV) en ligne de commande (ou par l’intermédiaire d’une API).
Est-ce que cela est déjà possible ? Si oui, comment peut-on le faire car je ne trouve rien dans la documentation.
Si ce n’est pas possible, est-ce que cela est prévu pour la suite ?

Merci

Cordialement,

Stéphane

1 Like

Bonjour @scolalongo

Merci pour ton retour !

Pour ton besoin, tu peux plutôt utiliser le Asqatasun-Runner qui te générera des graphes dans ton Jenkins. (Pour voir le détails des audits, il faudra installer un Asqatasun complet à côté et le paramétrer sur la même base de données).

Sinon dans l’idée d’intégration continue, tu peux aussi utiliser l’image Docker de Asqatasun, à mon avis plus rapide à mettre en place.

En espérant que cela te soit utile
Matthieu

Bonjour @mfaure,

Merci pour ta réponse rapide. En fait, j’utilise déjà la version docker (simplicité d’installation et d’utilisation - 5 minutes pour tout mettre en place si docker est déjà installé).

Du coup, j’arrive correctement à accèder à l’interface graphique et à lancer des audits.

Par contre, je ne trouve pas comment lancer un audit (avec export CSV) pour que je puisse récupérer les résultats soit dans jenkins, soit (et c’est plus probable) dans une autre base de données qui sert aussi pour notre qualimétrie de code.

J’ai trouvé cela /master/documentation/en/20_User_doc/usage-cli-doc.md mais j’ai l"impression que cette doc n’est plus à jour.

Auriez-vous de la doc expliquant comment lancer l’audit avec l’export uniquement en ligne de commande ou via le runner ?

Merci

Cordialement,

Stéphane

Bonjour @scolalongo,

L’Asqatasun-Runner est un script qui renvoi des données sur la sortie standard. Donc pas d’export CSV mais des données bruts qui sont (si j’ai bien compris les explications de @koj) moins fournies qu’un export CSV via la webapp.

A priori, si tu as déjà la webapp qui tourne, il suffit de télécharger le fichier asqatasun-runner-X.Y.Z.i386.tar.gz disponible sur la page Github de la dernière release d’Asqatasun. Ensuite, c’est juste un fichier de configuration à modifier pour la connexion à la DB et lancer le script avec les bonnes options. Du coup, si tu utilise l’image docker, il faut rentrer dans le conteneur pour y faire les manips car le port de la DB n’est actuellement pas disponible à l’extérieur du conteneur Docker.

Pour l’intégration continue tu peux regarder le plugin Asqatasun Jenkins qui nécessite l’utilisation d’Asqatasun-Runner. L’utilisation de l’image Docker d’Asqatasun doit rendre compliqué l’usage de Jenkins… une installation sur une machine ou une VM pourrait rendre les choses plus facile.

Pour la documentation (runner + plugin Jenkins), c’est effectivement un point en retrait par rapport au reste de la documentation. C’est peut-être l’occasion d’améliorer l’ensemble… :wink:

@scolalongo, voici un exemple d’utilisation du runner
qui retourne beaucoup d’information qu’il doit être possible de parser.

La documentation pour le runner est en cours d’amélioration dans la branch develop :

Usage du Runner

cd /opt/asqa_runner/
bin/asqatasun.sh -d 99 -f /opt/firefox/firefox -r Rgaa30 http://www.asqatasun.org

Exemple de sortie du Runner

Audit terminated with success at 2016-07-05 13:44:34.0
Audit Id : 13
Subject : http://asqatasun.org/
RawMark : 100.0%
WeightedMark : 75.8789%
Nb Passed : 13
Nb Failed test : 0
Nb Failed occurences : 0
Nb Pre-qualified : 19
Nb Not Applicable : 119
Nb Not Tested : 123
Rgaa30-1-1-1: PASSED
Rgaa30-1-1-2: NOT_APPLICABLE
Rgaa30-1-1-3: NOT_APPLICABLE
Rgaa30-1-1-4: NOT_APPLICABLE
Rgaa30-1-2-1: NEED_MORE_INFO
 ->  NEED_MORE_INFO CheckNatureOfElementWithNotEmptyAltAttribute
    -> title:attribute-absent
    -> src:http://asqatasun.org/Images/logo/Asqatasun--550x260--kranken.io.png
    -> alt:Asqatasun
Rgaa30-1-2-2: NOT_APPLICABLE
Rgaa30-1-2-3: NOT_APPLICABLE
Rgaa30-1-2-4: NOT_APPLICABLE
Rgaa30-1-2-5: NOT_APPLICABLE
Rgaa30-1-3-1: NEED_MORE_INFO
 ->  NEED_MORE_INFO CheckNatureOfImageWithNotPertinentAlt
    -> title:attribute-absent
    -> src:http://asqatasun.org/Images/logo/Asqatasun--550x260--kranken.io.png
    -> alt:Asqatasun
Rgaa30-1-3-2: NOT_APPLICABLE
Rgaa30-1-3-3: NOT_APPLICABLE
Rgaa30-1-3-4: NOT_APPLICABLE
Rgaa30-1-3-5: NOT_APPLICABLE
Rgaa30-1-3-6: NOT_APPLICABLE
Rgaa30-1-3-7: NOT_APPLICABLE
Rgaa30-1-3-8: NOT_APPLICABLE
Rgaa30-1-3-9: NOT_APPLICABLE
Rgaa30-1-4-1: NOT_APPLICABLE
Rgaa30-1-4-2: NOT_APPLICABLE
Rgaa30-1-4-3: NOT_APPLICABLE
Rgaa30-1-4-4: NOT_APPLICABLE
Rgaa30-1-4-5: NOT_APPLICABLE
Rgaa30-1-4-6: NOT_APPLICABLE
Rgaa30-1-4-7: NOT_APPLICABLE
Rgaa30-1-4-8: NOT_APPLICABLE
Rgaa30-1-4-9: NOT_APPLICABLE
Rgaa30-1-5-1: NOT_APPLICABLE
Rgaa30-1-5-2: NOT_APPLICABLE
Rgaa30-1-6-1: NEED_MORE_INFO
 ->  NEED_MORE_INFO CheckNatureOfImageAndLongdescDefinition
    -> src:http://asqatasun.org/Images/logo/Asqatasun--550x260--kranken.io.png
    -> alt:Asqatasun
    -> longdesc:attribute-absent
Rgaa30-1-6-2: NOT_APPLICABLE
Rgaa30-1-6-3: NOT_APPLICABLE
Rgaa30-1-6-4: NOT_APPLICABLE
Rgaa30-1-6-5: NOT_APPLICABLE
Rgaa30-1-6-6: NOT_APPLICABLE
Rgaa30-1-6-7: NOT_APPLICABLE
Rgaa30-1-6-8: NOT_APPLICABLE
Rgaa30-1-7-1: NEED_MORE_INFO
 ->  NEED_MORE_INFO CheckNatureOfImageAndDescriptionPertinence
    -> src:http://asqatasun.org/Images/logo/Asqatasun--550x260--kranken.io.png
    -> alt:Asqatasun
Rgaa30-1-7-2: NOT_APPLICABLE
Rgaa30-1-7-3: NOT_APPLICABLE
Rgaa30-1-7-4: NOT_APPLICABLE
Rgaa30-1-7-5: NOT_APPLICABLE
Rgaa30-1-7-6: NOT_APPLICABLE
Rgaa30-1-7-7: NOT_APPLICABLE
Rgaa30-1-8-1: NEED_MORE_INFO
 ->  NEED_MORE_INFO CheckNatureOfImageAndStyledTextPresence
    -> src:http://asqatasun.org/Images/logo/Asqatasun--550x260--kranken.io.png
 ->  NEED_MORE_INFO CheckNatureOfImageAndStyledTextPresence

@scolalongo, la documentation du plugin Jenkins est actuellement disponible et en cours d’amélioration dans la branche develop du dépôt Git.