Lancement du programme
Pairing Software se lance en ligne de commande (par exemple, via cmd sous Terminal Windows)
Le lancement de Pairing SoftWare est très simple ; il suffit de se mettre en mode Terminal et de saisir le nom du programme (pairing) associé à une ou plusiuers options :
pairing [-i...] [-R] [-L] [-N] [-s...] [-S]
La liste des options possibles et les explications :
| Option | Description | Exemple |
|---|---|---|
| -i | Obligatoire - Précise le nom du fichier ini contenanat les paramètres du tournoi | pairing -itournoi.ini |
| -S | Indique que le mode sauvegarde automatique est activé (recommandé) | pairing -S -itournoi.ini |
| -R | Précise si une restauration des données est à prévoir au lancement. Obligatoire si ajournement et si une sauvagarde a été faite avant | pairing -R -itournoi.ini |
| -s | Précise si un fichier de simulation est à exécuter (test) | pairing -ssimulator50.txt -itournoi50.ini |
| -L | Indique que les principales actions seront tracées dans un fichier de log (trace.txt) | pairing -L -itournoi.ini |
| -N | Indique qu'un nouveau fichier de log sera créé si l'option L est positionné | pairing -L -N -itournoi.ini |
Sous Windows, cela donne (avec le fichier tournoi.ini de démonstration) :
c:\Programme>pairing -itournoi.ini
A noter que la balise -i associé au nom du fichier paramètre du tournoi est obligatoire.
Dans le cadre d'un FESTIVAL (plusieurs tournois en même temps), il est possible de lancer plusieurs instances de Pairing SoftWare mais dans des fenêtres "terminal" différentes.
Après lancement, le programme scanne le fichier des joueurs (format CSV) dont le chemin et le nom de fichier sont précisés dans le fichier tournoi.ini. Le préfixe 'pairing software>' apparait en début de ligne (dépend de la valeur de la balise PROMPT dans le fichier de configuration) et le programme vous invite à saisir une commande.
Liste des commandes
Les commandes (elles sont en anglais) et leur explication sont présentées ci-dessous.
| Commande | Action | Commentaire |
|---|---|---|
| start | Démarrer le tournoi | doit être lancé uniquement au démarrage avant la première ronde |
| info | Afficher les infos en cours sur le tournoi | peut être lancé n'importe quand |
| clear | Efface l'écran | pour continuer avec une page blanche |
| player | Afficher la liste des joueurs | dans l'ordre initial du fichier avec les pts acquis (avant restauration) |
| pairing | Démarrer l'appariement d'une ronde | doit être lancé à chaque début de ronde |
| round | Afficher au format HTML les appariements de la ronde | doit être lancé après les appariements et à la fin d'une ronde |
| result | Saisir un résultat d'un échiquier (ou table) | doit être saisi à chaque résultat d'une table ou échiquier |
| board | Afficher les résultats d'une ronde | peut être lancé dès la première ronde |
| close | Clôturer une ronde et passer à la suivante | doit être lancé à la fin de chaque ronde |
| ranking | Afficher le classement des joueurs | peut être lancé à partir de la fin de la première ronde |
| save | Sauvegarder les données en cours | pour restaurer à partir de la sauvegarde, précisez -R comme option au démarrage |
| export | Exporter les joueurs, rondes ou les classements au format HTML ou CSV | peut être lancé à partir de la fin de la première ronde |
| help | Afficher une aide | peut être lancé n'importe quand |
| quit | Quitter le programme | peut être lancé n'importe quand |
Exemple de séquence de commandes
c:\Programme>pairing -itournoi.ini
...
pairing software>info
...
pairing software>start
...
pairing software>pairing
pairing software>save
pairing software>round 1
...
pairing software>result 1 1
pairing software>result 2 3
pairing software>result 3 2
...
pairing software>close
pairing software>round 1
pairing software>save
...
pairing software>board 1 0
...
pairing software>ranking
...
pairing software>pairing
pairing software>save
etc.
Explications :
- Le tournoi commence avec la commande 'start'. Il faudra confirmer par 'o' ou 'y' en anglais (Oui ou Yes). Vous pouvez aussi saisir directement 'start y' si vous voulez confirmer de suite.
- Puis lancement des appariements de la première ronde par 'pairing' et confirmez par 'o' - Le programme sait que vous être à la première ronde
- A ce stade, création possible d'une page HTML pour afficher les appariements de la ronde par la commande 'round' et le numéro de la ronde, ex : round 1 (accessible via votre navigateur en lancant le fichier HTML généré)
- Puis saisir les résultats par 'result' puis saisir le N° de la table puis le résultat par un entier de 1 à 6 : 1=1-0, 2=0-1, 3=1/2-1/2, 4=1-F, 5=F-1, 6=F-F (F veut dire forfait)
- A la fin de la saisie des résultats pour une ronde, tapez 'close' pour clôturer la ronde (indispensable à la fin de chaque ronde). Un 'close' calcule l'attribution des points et interdit tout retour en arrière pour l'utilisateur. Cette commande ne peut être exécutée que si tous les résultats sont saisis. La commande 'close' permet aussi de mettre à jour le classement.
- Affichage de la ronde '1' avec tous les résultats avec la commande 'board'. Ex : 'board 2 0 ' affiche l'état de la ronde 2 dans sa totalité.
- De nouveau la commande 'ranking' pour apparieiller la deuxième ronde après la clôture, par 'close', de la première ronde
- etc.
A noter que, même en mode 'toutes rondes', vous devez lancer les appariements par la commande 'pairinf' à chaque début de ronde.
La commande 'info' permet d'afficher la situation du tournoi en cours et la valeurs des paramétres.
La commande 'save' sauvegarde dans 3 fichiers cryptés les données essentielles du tournoi et du programme. Attention, les trois fichiers sont liés au tournoi en cours et sont 'écrasés' à chaque sauvegarde liée à ce tournoi uniquement. Il est très important de lancer cette commande après chaque appariement (pairing) et fin (close) de chaque ronde.
La commande 'export' permet d'afficher les données des joueurs, rondes et classement au format HTML ou CSV. 'Export' permet d'afficher au format HTML et donc est très utilisée pour la diffusion des résultats.
Vous pouvez tester sans risque avec les fichiers joints au fichier ZIP (ou TAR) pour vous faire la main sur les commandes liées au programme. Par contre, vous pouvez changer évidemment le nom des fichiers CSV et INI, SAUF le fichier config.ini qui doit rester avec le même nom dans le même répertoire que le programme.
