Programmation PYTHON - Zenk - Security - Repository

208
Éléments du langage
DEUXIÈME PARTIE
Python 2.3 a introduit une nouvelle directive à placer en première ou deuxième ligne
du fichier, qui permet de spécifier l’encoding. L’encodage en général utilisé par les
programmeurs francophones est l’utf-8.
Directive d’encodage
# -*- encoding: utf8 -*-
À SAVOIR Encodage d’un fichier Python
Les éditeurs de code Python recherchent généralement cette ligne pour déterminer l’encodage du fichier,
s’il diffère de celui du système.
Copyright et licence
Les lignes suivantes peuvent concerner le copyright, ainsi que la licence du fichier.
La structure de ces informations est libre.
Tags
Si vous utilisez CVS ou SVN (Subversion), la dernière ligne du commentaire peut
être utilisée pour mettre en place un tag de version, utilisé par le système de versionning
pour placer un certain nombre d’informations.
Tag vierge
# $Id: $
Ce tag sera renseigné lors du premier commit.
Tag après commit
# $Id: test_mailmessageeditview.py,v 1.2 2005/02/09 10:44:06 tziade Exp $
Docstring de module
Le docstring général au module vient se placer juste après le bloc de commentaire et
contient un descriptif complet de tous les éléments et de leur utilisation. Il peut aussi
contenir des informations relatives aux dépendances, c’est-à-dire à l’ensemble des
programmes et modules tiers nécessaires. En outre, si le module est directement exécutable,
on retrouvera dans ce docstring la liste des paramètres d’exécution.