Je sais, je ferais mieux d'être constructif, au lieu de râler, et
de dire du mal des autres programmeurs. Mais c'est trop énervant, il
faut que je me défoule : lorsqu'on écrit un programme en
Démonstration avec la bibliothèque seenthis-python,
qui permet d'accéder au service de court-bloguage et de partage de
liens SeenThis. seenthis-python dépend
de deux paquetages, SimpleTAL, un système de
Commençons par le grand classique, car c'est le seul distribué avec
Python, dans la bibliothèque standard, et sur lequel tout le monde
peut compter : distutils. Le principe
est qu'on écrit un fichier
from distutils.core import setup
setup(name='SeenThis',
version='0.0',
description='Use the SeenThis API',
license='BSD',
author='Stephane Bortzmeyer',
author_email='stephane+seenthis@bortzmeyer.org',
url='https://github.com/bortzmeyer/seenthis-python',
)
Ce fichier peut ensuite être exécuté avec des options qui vont dire
par exemple d'installer le paquetage (
distutils a des tas de limites. Par exemple, il ne permet pas de
faire des
requires=['SimpleTAL', 'FeedParser']
mais c'est purement décoratif. La documentation ne le dit pas mais
cette variable est complètement ignorée par distutils.
Au passage, le langage d'expression des dépendances (qui ne sert à
rien, on l'a vu) permet également d'indiquer un numéro de version, par
exemple le fait que, pour FeedParser, en raison de la
bogue #91 («
Lorsque le débutant en Python se plaint de cet état de chose, les vieux experts blanchis sous le harnais lui rétorquent que tout le monde le sait, et que personne n'utilise le système standard (alors, pense le débutant naïf, pourquoi est-ce que ce truc reste dans la bibliothèque standard ?). Et c'est là que les choses se compliquent, car il existe plusieurs remplaçants possibles.
D'abord, le premier, setuptools (le
lien pointe vers PyPi puisque, à partir de là, on n'est plus dans la
bibliothèque standard, ce qui oblige l'utilisateur qui va installer
la bibliothèque à installer un autre programme d'abord, alors que le
but était de lui simplifier la vie). Il existe une bonne documentation pour débutant. En gros, on remplace la
première ligne de code du
from setuptools import setup
et on a alors des fonctions et variables supplémentaires comme
D'autant plus que, on l'a vu, des paquetages fréquemment répandus, comme SimpleTAL, ne sont pas forcément disponibles dans PyPi... (SimpleTAL est arrivé plus tard.)
Bon, troisième tentative : distribute, qui
prétend remédier aux problèmes de setuptools. Il reprend en partie son
nom (ce qui contribue beaucoup à la confusion des programmeurs, par
exemple le paquetage Debian de distribute se nomme setuptools) :
from distribute_setup import use_setuptools
use_setuptools()
from setuptools import setup
[puis setup.py comme avant]
Comme setuptools, il permet de
déclarer
des dépendances, mais il les gère tout aussi mal :
# python setup.py install
...
Searching for simpletal
Reading http://pypi.python.org/simple/simpletal/
Reading http://www.owlfish.com/software/simpleTAL/index.html
No local packages or download links found for simpletal
error: Could not find suitable distribution for Requirement.parse('simpletal')
% python
Python 2.6.6 (r266:84292, Dec 27 2010, 00:02:40)
[GCC 4.4.5] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import simpletal
>>>
(La dernière commande montre que SimpleTAL est pourtant bien installé.)
Bref, on a trois systèmes concurrents et dont aucun ne permet
d'assurer une tâche aussi simple que « vérifie que simpletal est bien
disponible ». Pire, rien dans la documentation n'indique leurs
limites. Ainsi tous les programmeurs Python semblent savoir que
distutils est très limité mais cela n'apparaît pas dans la
documentation de la bibliothèque standard. Et ce n'est pas fini. Comme l'écrit Victor Stinner «Le packaging Python est une série à la
Le problème du
Un petit truc : si on veut regarder la variété des fichiers
Pour terminer, une bonne série de lectures, due à Nicolas Chauvat :