tests_paheko/README.md

# Tests Paheko

Suite de tests du [logiciel de gestion d'association Paheko](https://fossil.kd2.org/paheko)

## Outils
- [Selenium IDE](https://www.selenium.dev/selenium-ide)
- [Selenium runner](https://www.selenium.dev/selenium-ide/docs/en/introduction/command-line-runner)

### Remarques
- l'IDE produit du code en version 2
- le runner veut du code version 3
- il faut donc convertir le fichier produit par l'IDE avec la commande `npx @seleniumhq/side-migrate`
(voir Makefile)

## Config serveur
- définir un hôte virtuel : `test.paheko.localhost`

## Exécuter les tests
- Avant d'exécuter les tests, il faut désactiver le profiler
- Le script `runtest.sh` permet d'exécuter un, plusieurs ou tous les
tests d'un fichier de test *Selenium* ; il positionne quelques
constantes, convertit le fichier produit par l'IDE si nécessaier et
copie dans /tmp les fichiers requis par les tests.
- Il y a un bug en fin d'exécution (voir commentaire dans le script) ;
pour le contourner, le script *tue* le processus quand le message de
fin apparaît.

### Options en ligne de commande
-  -f fichier    : fichier de test
-  -a            : exécuter tous les tests du fichier
-  -c            : afficher la fenêtre de chrome
-  -n            : ne pas tuer le processus en fin de test
-  -v            : afficher la ligne de commande
-  -z répertoire : sauver une copie d'écran dans le répertoire en cas d'échec
-  -t timeout    : définir une attente max (défaut : 200000 ms)
-  -h            : afficher cette aide
-  test          : nom (partiel ou complet) d'un test ou d'une suite à exécuter ;
				  si absent, affiche un sélecteur pour choisir une des suites du fichier

### Exemples
  - passer tous les tests : `./runtest.sh -f membres.side -a`
  - certains tests  : `./runtest.sh -f membres.side 08` va passer les tests dont le titre commence par 08

## Tests installation

## Tests de connexion

## Tests des membres