Open source et architecture logicielle

Dans ce billet, je vous propose un petit composant que j'ai �crit sous la forme d'une classe tr�s courte pour charger un catalogue d'objets depuis un fichier XML.

J'ai pris le parti d'utiliser la biblioth�que standard de manipulation XML lxml pour me faciliter la t�che. Cette librairie s'installe directement avec la commande pip install lxml depuis toute station Unix ou Windows connect�e � internet (nano PC de type raspberry compris).
Voici le fichier XML que je vais parser :

Code xml :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
<?xml version="1.0" encoding="UTF-8"?>
<clients>
    <client>
        <nom>
            Ponsable
        </nom>
        <prenom>
            Thérèse
        </prenom>
        <email>
            "[email protected]"
        </email>
        <tel>
            "01020304"
        </tel>
    </client>
     <client>
        <nom>
            Rambo
        </nom>
        <prenom>
            John
        </prenom>
        <email>
            "[email protected]"
        </email>
        <tel>
            "12356498"
        </tel>
    </client>
    <client>
        <nom>
            Rocky
        </nom>
        <prenom>
            Balboa
        </prenom>
        <email>
            "[email protected]"
        </email>
        <tel>
            "12356498"
        </tel>
    </client>
    <client>
        <nom>
            Starsky
        </nom>
        <prenom>
            David
        </prenom>
        <email>
            "[email protected]"
        </email>
        <tel>
            "12356498"
        </tel>
    </client>
</clients>

On remarque que le catalogue de clients est sous le tag <clients> et que chaque client poss�de un nom, un prenom, un email et un telephone. J'ai choisi de composer des entit�s XML � partir d'Element XML, mais j'aurais tout aussi bien pu utiliser des attributs. La discussion autour du choix entre attribut et �l�ment restera en dehors du scope de ce billet.
L'objectif de mon chargeur est de cr�er une liste d'objets Client depuis cette source XML.
Voici le code source de ma classe Client :

Code python :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
7
8
9
10
11
12
class Client :
    rang = 0
    def __init__(self, nom, prenom, email, tel):
        Client.rang += 1
        self.ident = Client.rang
        self.nom = nom
        self.prenom = prenom
        self.email = email
        self.tel = tel
 
    def afficher(self):
        print(str(self.ident) + " " + self.nom + " " + self.prenom + " " + self.email + " " + self.tel)

J'ai logiquement ajout� � cet objet une m�thode qui lui permet de s'afficher. Je l'ai �galement �quip� d'un attribut static rang initialis� � 0 qui s'incr�mente � la construction de chaque nouvelle instance, pour servir d'index dans ma collection.
Voici enfin le code source de mon composant :

Code python :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
class Carnet :
    def  __init__(self):
        self.clients = list()
 
    def ajouter(self, client):
        self.clients.append(client)
 
    def afficher(self):
        for client in self.clients:
            client.afficher()
 
    def charger(self, nomFichier):
        tree = etree.parse(nomFichier)
        for client in tree.xpath("/clients/client"):
            self.ajouter(Client(client.find("nom").text, client.find("prenom").text, client.find("email").text, client.find("tel").text))

Je n'utilise qu'un objet de la biblioth�que lxml : la classe etree qui me permet de parser un fichier XML et de mapper l'ensemble des �l�ments de mon fichier XML dans une collection Python, comme le font les langages modernes (pour feignants) tels que PowerShell.
Pour le test, il suffit de charger le fichier et de l'afficher de cette fa�on :

Code python :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
carnet = Carnet()
carnet.charger("clients.xml")
carnet.afficher()

Attention, cette petite classe est un composant de dev � modifier pour les besoins de chacun, mais ne constitue en aucun cas une source utilisable en production. En effet, aucun test de validit� des valeurs du fichier XML n'est r�alis� au chargement.