Programmation PYTHON - Zenk - Security - Repository

Bonnes pratiques et optimisation du code
CHAPITRE 13
la classe Extension, qui décrit un module d’extension C ou C++.
La fonction setup() prend en paramètres un certain nombre d’options, dont :
name : un objet string représentant le nom du module ;
version : un objet string contenant un numéro de version pour le module ;
ext_modules : une liste d’objets de type Extension, à construire ;
maintainer : le nom du développeur en charge du module ;
maintainer_email : son e-mail ;
description : une description courte, sous la forme d’une ligne de texte ;
long_description : une description plus détaillée.
La classe Extension est construite quant à elle avec :
name : le nom du module d’extension ;
sources : la liste des fichiers sources C, C++ ;
include_dirs : la liste des répertoires contenant des en-têtes C, C++ à inclure à
la compilation. Le répertoire contenant Python.h est automatiquement ajouté et
ce paramètre n’est à utiliser que pour ajouter de nouvelles dépendances ;
library_dirs : la liste des répertoires contenant des bibliothèques à inclure à la
liaison, si nécessaire.
Créer un fichier d’installation consiste donc à coder un fichier Python contenant un
appel à setup(). Par convention, ce fichier est nommé setup.py.
Dans notre exemple, les fichiers nécessaires à la compilation de l’extension sont
exemple.c et exemple_wrap.c.
Fichier setup.py
from distutils.core import setup
from distutils.extension import Extension
extension = Extension(name='_exemple',
sources=['exemple.c', 'exemple_wrap.c'])
setup(name="_exemple", ext_modules=[extension])
Le code généré par SWIG préfixe le nom du module par le caractère _ et il est nécessaire
d’en tenir compte dans la création de setup.py.
Ce module est ensuite invoqué en ligne de commande, avec l’option build pour
compiler le module d’extension, et install pour le placer dans l’interpréteur.
467