Programmation PYTHON - Zenk - Security - Repository

Variables globales
Conventions de codage
CHAPITRE 7
Les variables globales suivent les clauses d’importation et peuvent être réunies par
thèmes séparés par un saut de ligne.
Exemple
TIMEOUT = 12
SLEEP = 2
DEFAULT_SERVER = 'localhost'
DEFAULT_PORT = 25
Fonctions et classes, le corps du module
Le reste du module est bien sûr réservé aux différentes fonctions et classes qui le
composent. L’ordre de ces éléments est en général guidé par la logique des
interactions : une classe de base est toujours placée au dessus de ses classes héritées.
De la même manière, une fonction qui doit être appelée pour toutes les classes d’une
application se placera toujours juste après cette classe.
Organisation logique des classes et fonctions
class BaseDataStream:
"""Classe de base pour les flux."""
def read_stream(self):
"""Lecture d'un flux."""
raise NotImplementedError
class RSSDataStream(BaseDataStream):
"""Classe pour les flux RSS."""
def read_stream(self):
"""Lecture d'un flux RSS."""
...
registerClass(RSSDataStream)
Structuration d’une classe
Une dernière partie importante en terme de structuration concerne l’organisation d’une
classe. Lorsqu’une classe implémente beaucoup de méthodes, c’est en général une bonne
idée de faire des regroupements logiques séparés par des blocs de commentaires.
211