Programmation PYTHON - Zenk - Security - Repository

Variables globales spécifiques
Conventions de codage
CHAPITRE 7
Un ensemble de variables globales spécifiques peut suivre le bloc de commentaire.
Toutes ces variables sont optionnelles et en général préconisées par des outils tiers de
génération automatique de documentation, la référence étant celles utilisées par le
module pydoc.
Les variables utilisées par pydoc
__author__ = "Tarek Ziadé "
__date__ = "26 February 2005"
__version__ = "$Revision: 1.5 $"
__credits__ = """Thanks to my mother."""
Clauses d’importations
Chaque clause d’importation doit être sur une ligne distincte, en évitant de réunir plusieurs
clauses sur la même ligne, sauf lorsque les éléments importés appartiennent au
même module. Pour ce dernier cas, une écriture explicite est tout de même préférable.
Cette notation facilite la lecture, surtout lorsque les clauses d’importation sont nombreuses.
Exemples et contre-exemples
# écriture incorrecte :
import smtplib, imaplib
# écriture correcte :
import smtplib
import imaplib
# plusieurs éléments du même module, souvent utilisé :
from smtplib import SMTP, SMTP_PORT
# plusieurs éléments du même module, préférable :
from smtplib import SMTP
from smtplib import SMTP_PORT
Les jokers
Comme vu au chapitre 4, Python permet de faire des importations avec des jokers
pour avoir accès à l’ensemble des fonctions, classes et méthodes d’un module, dans
votre espace de noms.
209