190 lines
8.7 KiB
Markdown
190 lines
8.7 KiB
Markdown
# pexpectation
|
||
|
||
Surcouche à pexpect pour formaliser les enchaînements de questions et éviter certains problèmes d’association question, réponse quand le contexte n’est pas suffisant.
|
||
|
||
## Principe
|
||
|
||
On constitue une collection de questions, réponses.
|
||
Dans cette collection, certaines questions sont exposées et utilisées pour la méthode expect du module pexpect.
|
||
Ce premier lot de question est associé à un contexte suffisamment large pour les discriminer entre elles.
|
||
D’autres questions sont liées à ces premières questions et les réponses sont enchaînées.
|
||
Pour gérer les embranchements conditionnels, on peut associer à chaque question liée un déclencheur (la réponse à la question précédente).
|
||
|
||
## Composition
|
||
|
||
```
|
||
.
|
||
├── eole_module_expectations
|
||
│ ├── eolebase_instance_pexpectations.py
|
||
│ ├── __init__.py
|
||
│ ├── register_zephir_pexpectations.py
|
||
│ └── zephir_instance_pexpectations.py
|
||
├── __init__.py
|
||
└── pexpectation.py
|
||
```
|
||
|
||
Le corps du module est constitué de deux classes dans le fichier pexpectation.py
|
||
* ExpectationCollection ;
|
||
* Expectation.
|
||
|
||
Le sous-module `eole_module_expectations` contient des exemples d’utilisation pour des procédures classiques des modules EOLE :
|
||
* instance ;
|
||
* enregistrement_zephir.
|
||
|
||
## Utilisation
|
||
|
||
Soit la transcription simplifiée de la procédure enregistrement_zephir (certains cheminement sont exclus parce qu’ils n’ont pas de sens dans ce contexte d’automatisation) :
|
||
``` dot
|
||
digraph G {
|
||
subgraph cluster_0 {
|
||
style=filled;
|
||
color=lightgrey;
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"Voulez-vous établir une configuration réseau minimale" -> "interface connectée sur l'extérieur" [label="oui"];
|
||
"interface connectée sur l'extérieur" -> "adresse IP" -> "masque de sous-réseau" -> "adresse de la passerelle";
|
||
}
|
||
|
||
subgraph cluster_1 {
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"Serveur déjà enregistré";
|
||
color=lightgrey;
|
||
style=filled;
|
||
}
|
||
subgraph cluster_2 {
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"créer le serveur dans la base du serveur Zéphir" -> "entrez le RNE de l’établissement" [label="non"];
|
||
"entrez le RNE de l’établissement" -> "entrez le n° identifiant le serveur l'application Zéphir" [label="rien"];
|
||
"entrez le RNE de l’établissement" -> "choix du serveur" [label="RNE"];
|
||
color=lightgrey;
|
||
style=filled;
|
||
}
|
||
subgraph cluster_3 {
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"Mise à jour des informations sur le matériel" -> "processeur" -> "disque dur";
|
||
color=lightgrey;
|
||
style=filled;
|
||
}
|
||
subgraph cluster_4 {
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"une procédure d'enregistrement à déjà eu lieu pour ce serveur";
|
||
color=lightgrey;
|
||
style=filled;
|
||
}
|
||
subgraph cluster_5 {
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"Entrez le numéro de votre choix";
|
||
color=lightgrey;
|
||
style=filled;
|
||
}
|
||
subgraph cluster_6 {
|
||
node [style=filled,color=white];
|
||
edge [style=dotted];
|
||
"Entrez l'adresse (nom DNS) du serveur Zéphir" -> "Entrez votre login pour l'application Zéphir" -> "Mot de passe pour l'application Zéphir";
|
||
color=lightgrey;
|
||
style=filled;
|
||
}
|
||
"Début de la procédure" -> "Voulez-vous établir une configuration réseau minimale";
|
||
"Début de la procédure" -> "Serveur déjà enregistré";
|
||
"Voulez-vous établir une configuration réseau minimale" -> "Entrez l'adresse (nom DNS) du serveur Zéphir" [label="non"];
|
||
"adresse de la passerelle" -> "Entrez l'adresse (nom DNS) du serveur Zéphir";
|
||
"Mot de passe pour l'application Zéphir" -> "créer le serveur dans la base du serveur Zéphir";
|
||
"entrez le n° identifiant le serveur l'application Zéphir" -> "une procédure d'enregistrement à déjà eu lieu pour ce serveur";
|
||
"entrez le n° identifiant le serveur l'application Zéphir" -> "Mise à jour des informations sur le matériel";
|
||
"disque dur" -> "Entrez le numéro de votre choix";
|
||
"Entrez le numéro de votre choix" -> "Fin de la procédure";
|
||
|
||
"Début de la procédure" [shape=Mdiamond];
|
||
"Fin de la procédure" [shape=Msquare];
|
||
}
|
||
```
|
||
Ce qui s’implémente de la façon suivante :
|
||
``` python
|
||
expectations = ExpectationCollection()
|
||
|
||
already_registered = Expectation("""1 -> Désinscrire ce serveur du serveur Zéphir
|
||
2 -> Relancer l'enregistrement
|
||
3 -> Ne rien faire
|
||
|
||
Entrez le numéro de votre choix :""", response='3', name='already_registered')
|
||
network_configuration = Expectation(""" Procédure d'enregistrement sur le serveur Zéphir
|
||
|
||
|
||
Voulez-vous établir une configuration réseau minimale (O/N) :""", response='N', name='network_configuration')
|
||
interface_name = Expectation("""interface connectée sur l'extérieur""", response='ens0', name='interface_name')
|
||
network_address = Expectation("""adresse_ip {variable} :""", response='192.168.1.2', name='')
|
||
network_netmask = Expectation("""masque de réseau pour {variable} :""", response='255.255.255.0', name='network_netmask')
|
||
gateway = Expectation("""adresse de la passerelle :""", response='192.168.1.1', name='gateway')
|
||
zephir_address = Expectation("""Entrez l'adresse (nom DNS) du serveur Zéphir :""", response='zephir', name='zephir_address')
|
||
zephir_admin = Expectation("""Entrez votre login pour l'application Zéphir (rien pour sortir) :""", response='admin_zephir', name='zephir_admin')
|
||
zephir_admin_password = Expectation("""Mot de passe pour l'application Zéphir pour {variable} :""", response='eole', name='zephir_admin_password')
|
||
new_server = Expectation("""créer le serveur dans la base du serveur Zéphir (O/N) :""", response='N', name='new_server')
|
||
rne = Expectation("""entrez le RNE de l'établissement correspondant au serveur,
|
||
(rien pour saisir directement un n° de serveur) :""", response='', name='rne')
|
||
server_id = Expectation("""entrez le n° identifiant le serveur l'application Zéphir :""", response='1', name='server_id')
|
||
hardware = Expectation("""Mise à jour des informations sur le matériel
|
||
matériel (Standard PC (Q35 + ICH9, 2009) par défaut) :""", response='', name='hardware')
|
||
processor = Expectation("""processeur ( Intel Core Processor (Skylake, IBRS) 3191 MHz par défaut) :""", response='', name='processor')
|
||
harddrive = Expectation("""disque dur (19 Go par défaut) :""", response='', name='harddrive')
|
||
key_available = Expectation("""(une procédure d'enregistrement à déjà eu lieu pour ce serveur)
|
||
continuer l'enregistrement (O/N) ?""", response='O', name='key_available')
|
||
final = Expectation("""1 -> Ne rien faire
|
||
2 -> Utiliser la configuration définie sur le serveur Zéphir
|
||
3 -> Non disponible
|
||
4 -> Modifier la variante du serveur
|
||
|
||
Entrez le numéro de votre choix :""", response='2', name='final')
|
||
|
||
|
||
expectations.add_expectation(already_registered)
|
||
expectations.add_expectation(network_configuration)
|
||
expectations.add_expectation(new_server)
|
||
expectations.add_expectation(hardware)
|
||
expectations.add_expectation(key_available)
|
||
expectations.add_expectation(final)
|
||
|
||
network_configuration.set_next_expectation(interface_name, triggers=['O', 'Oui', 'OUI'])
|
||
interface_name.set_next_expectation(network_address)
|
||
network_address.set_next_expectation(network_netmask)
|
||
network_netmask.set_next_expectation(gateway)
|
||
network_configuration.set_next_expectation(zephir_address, triggers=['N', 'Non', 'NON'])
|
||
|
||
new_server.set_next_expectation(rne, triggers=['N', 'Non', 'NON'])
|
||
rne.set_next_expectation(server_id, triggers='')
|
||
|
||
zephir_address.set_next_expectation(zephir_admin)
|
||
zephir_admin.set_next_expectation(zephir_admin_password)
|
||
|
||
hardware.set_next_expectation(processor)
|
||
processor.set_next_expectation(harddrive)
|
||
```
|
||
Et s’utilise comme suit :
|
||
``` python
|
||
patterns = expectations.get_patterns()
|
||
nb_expectations = expectations.count_expectations()
|
||
|
||
instance_process = pexpect.spawn('/usr/bin/enregistrement_zephir', encoding='utf-8', timeout=60, logfile=sys.stdout)
|
||
|
||
while some_index < nb_expectations:
|
||
p = instance_process.expect(patterns)
|
||
if p == 0:
|
||
break
|
||
if p == 1:
|
||
print(f'Some missing expectations for {instance_process.before}{instance_process.after}')
|
||
break
|
||
pattern = patterns[p]
|
||
for expectation in expectations.get_expectations_by_pattern(patterns[p]):
|
||
if expectation.is_the_one(instance_process.before):
|
||
expectation.answer(instance_process)
|
||
break
|
||
```
|
||
|
||
La méthode `get_patterns` renvoie uniquement les premières question des blocs (les questions qu’on peut discriminer avec le contexte ou qui ne suivent pas obligatoirement une autre question).
|
||
La méthode `is_the_one` est celle utilisant le contexte pour déterminer si la question est bien celle attendue.
|
||
La méthode `answer` envoie la réponse avec pexpect et enchaîne éventuellement sur les autres questions du bloc, en tenant compte des déclencheurs.
|