Cette page est le compte-rendu de la session classroom organisée par gpocentek le 17 mai 2007 sur le canal IRC #ubuntu-fr-classroom.
Dans ce cours, nous verrons :
debian/watch
Pour suivre ce cours, vous devez connaître les bases du packaging avec debhelper et cdbs. Nous ne reviendrons donc pas sur ce qui a été vu dans les sessions précédentes sauf sur le fichier debian/rules.
Le but de ce fichier est en fait d'installer les fichiers du logiciel dans debian/paquet. Par exemple, si vous récupérez sur Internet un script foo.sh, il suffit de copier ce fichier dans debian/foo/usr/bin/ pour créer le paquet.
Tout d'abord, créez un répertoire propre (~/packaging/classroom par exemple) pour éviter les soucis, placez-vous dedans et récupérez l'archive suivante :
wget http://gauvain.pocentek.net/u-classroom/2007-05-17/packages/u-script.tar.gz tar xvf u-script.tar.gz
Entrer dans le dossier "u-script/" puis exécutez :
dpkg-source -x *dsc
Entrez dans le dossier source (venant d'être crée) qui contient le dossier debian/ pour le paquet, et le script u-script.sh. Il n'y a rien d'autre, en particulier pas de Makefile ou autre donc cela va être au packageur de gérer l'installation (en respectant les standards).
Le dossier debian contient :
changelog compat control copyright dirs install rules u-classroom watch
Les fichiers qui vont nous intéresser sont dirs, install, rules, u-classroom et watch.
Le but est donc :
Comment installer ces 2 fichiers ?
Les fichiers debian/dirs et debian/install servent à cela et ils sont respectivement utilisés par dh_installdirs et dh_install.
Le fichier debian/rules :
Nous pouvons déjà remarquer qu'il n'y a pas de cible "configure:". En effet, c'est inutile puisqu'il n'y a rien à configurer.
Il y a une cible "build:", qui ne fait rien (rien à compiler) mais elle doit être là (respect de la debian policy).
Par contre la règle "install:" s'occupe d'installer les fichiers :
dh_installdirs va lire le fichier debian/dirs et créer les dossiers nécessaires dans "debian/u-classroom/" (dans notre cas "usr/bin/" et "usr/share/u-classroom/").
Lancer le debuild du paquet pour construire le paquet source :
debuild -us -uc
Fin de cette partie :)
Reprenez l'exemple précédent.
Dans le dossier source (u-script-1.0/) Lancez :
uscan
En regardant dans le répertoire parent
ls ..
vous voyez que la version 0.2 a été téléchargée et l'archive des sources est présente avec un lien vers u-script_0.2.orig.tar.gz.
Nous allons nous servir de cela pour mettre à jour le paquet.
Restez dans le répertoire source (u-script-1.0/) et lancez :
uupdate ../u-script_0.2.orig.tar.gz
Puis placez vous de le répertoire nouvellement crée, comme le suggère le script
cd ../u-script-0.2
Enfin, construisez le paquet source
debuild -us -uc
Le paquet est mis à jour :)
Il est composé de 2 lignes :
version=3
qui doit toujours être à cette valeur, et
http://gauvain.pocentek.net/u-classroom/2007-05-17/archive/u-script-(.*)\.tar\.gz
Le répertoire où se trouvent les sources est donc http://gauvain.pocentek.net/u-classroom/2007-05-17/archive et la fin de la ligne est une expression régulière qui laisse le choix pour la version. Les '.' dans les regexp sont des caractères particuliers donc ils doivent être "échappés" d'où le '\' devant.
Pour plus d'informations sur uscan et ses recettes magiques :
man uscan
En fait, empaqueter du python c'est comme empaqueter n'importe quoi mais il y a quelques règles à respecter : la fameuse Python Policy.
Pour suivre ce cours, récupérez l'archive suivante :
wget http://gauvain.pocentek.net/u-classroom/2007-05-17/packages/pyhw.tar.gz
Il y a 4 versions du même paquet dans ce paquet source et nous allons commencer avec la version 1.
Pour cela :
tar zxvf pyhw.tar.gz cd pyhw/v1 dpkg-source -x *dsc
Tout va se passer dans les fichiers control, rules et pycompat.
Le fichier debian/pycompat contient juste "2", tout comme debian/compat contient "5". Ceci est juste une indication de compatibilité.
Pour ce qui concerne le fichier debian/control, c'est un peu plus "compliqué". Nous allons construire un module publique (module python) et nous allons avoir besoin des paquets python-dev et python-central pour construire le paquet. Il faut donc qu'ils soient installés sur votre système.
Ces deux dépendances n'ont rien à voir avec les sources, c'est vraiment propre au packaging avec Python.
C'est pour cela (en simplifiant) qu'elles sont listées dans Build-Depends-Indep.
XS-Python-Version: current permet de dire que l'on construit ce module pour la version courante de python, c'est à dire la version 2.5 depuis feisty.
XB-Python-Version: ${python:Versions} est un champ qui va être utilisé pour savoir avec quelle(s) version(s) de python va être compatible le paquet binaire.
Depends: ${python:Depends} permet de calculer les dépendances python (en incluant la version) et pycentral.
${python:Provides} : Dans notre exemple, cela ne sert à rien car notre paquet est arch: all (fonctionnel pour toutes les architectures) mais pour les modules privés de python (des .so), cela permet de définir des paquets virtuels.
Par exemple si le module est compatible python 2.4 et 2.5 nous obtiendrons Provides: python2.4-foo et python2.5-foo. L'utilisateur pourra utiliser ces paquets virtuels comme n'importe quel autre paquet.
Essayons maintenant de compiler le paquet (installez les paquets python-dev python-central si nécessaire) :
cd pyhw-1.0 debuild -us -uc
Nous obtiendrons une erreur :
install: ne peut créer le répertoire `/usr/lib/python2.4/site-packages/HelloWorld': Permission non accordée
Le problème se situe dans le Makefile. Ouvrez ce fichier pour comprendre pourquoi. Vous voyez alors :
install -d /usr/lib/python2.4/site-packages/HelloWorld
qui permet de créer un dossier mais /usr/lib/python2.4/site-packages/HelloWorld est inaccessible puisque nous ne sommes pas "root" et nous essayons de créer le dossier dans debian/python-helloworld…
Cela ne peut pas marcher et il faudra donc modifier le Makefile pour utiliser $(DESTDIR)/usr/lib/python2.4/site-packages/HelloWorld (où DESTDIR sera en fait debian/python-helloworld).
Comme tout bon packageur, vous savez qu'il ne faut pas modifier les sources de upstream. Nous allons donc patcher le Makefile…
Nous venons de voir ci-dessus qu'il était nécessaire de patcher le Makefile (et non modifier directement le fichier) et pour cela nous allons utiliser la v2 du paquet pyhw précédemment téléchargé :
cd pyhw/v2 && dpkg-source -x *.dsc
Dans le dossier debian, nous avons un dossier patches qui contient le patch 01-makefile.dpatch et le fichier 00list, qui est en fait la liste des patches à appliquer.
On utilise ici dpatch comme système de patch.
Le fichier debian/rules contient :
# Include dpatch stuff. include /usr/share/dpatch/dpatch.make
Ceci permet d'inclure des règles toute faites qui automatisent le "patchage/dépatchage".
Bien sûr, le paquet dpatch doit être installé sur votre système.
Pour la cible build: on ajoute patch et unpatch pour la cible clean :, de façon à patcher les sources avant la compilation/installation et remettre les sources en l'état après la construction du paquet source.
configure:, c'est là qu'il faudra appliquer patch.
Maintenant que vous savez appliquer les patches, voyons comment en créer !
Pour ce faire, nous allons repartir de zéro, et supprimer le patch déja présent dans le paquet :
rm debian/patches/*
Pour créer un patch, il existe un outil très pratique: dpatch-edit-patch
Exécuter la commande suivant pour créer le patch :
dpatch-edit-patch 01-makefile
le nom du patch est arbitraire. Ici nous nommons le patch 01-makefile car c'est le premier patch crée (à appliquer) et qu'il agit sur le Makefile…
Nous nous retrouvons dans un nouveau shell.
Faites alors les modifications voulues, c'est à dire ajoutez $(DESTDIR) dans le Makefile, ce qui donne :
install -d $(DESTDIR)/usr/lib/python2.4/site-packages/HelloWorld install -m 644 src/*py $(DESTDIR)/usr/lib/python2.4/site-packages/HelloWorld/
Enregistrez le fichier, puis lorsque la modification pour ce patch est terminée, tapez :
exit 0
pour quitter le shell "spécial" et revenir à votre shell habituel.
Vous pouvez vérifier le contenu de debian/patches et vous y trouverez le patch 01-makefile qui vient d'être crée.
Il ne reste plus qu'à créer un fichier debian/patches/00list qui contient la liste des patches à appliquer. Le contenu sera alors ici :
01-makefile
Vous venez de patcher le makefile :)
Vous pouvez ensuite construire le paquet source :
debuild -us -uc
Un Warning apparaîtra, nous reviendrons dessus plus bas :
W: python-helloworld: script-not-executable ./usr/share/pycentral/python-helloworld/site-packages/HelloWorld/HelloWorld.py
En lançant la commande
dpkg -f *deb
vous verrez que pycentral a correctement remplacé les dépendances par les paquets appropriés :
Le Makefile installait dans /usr/lib/python2.4 et au final le script HelloWorld.py se trouvera dans /usr/share/pycentral/python-helloworld/site-packages/HelloWorld/.
Python-central a donc complètement géré les problèmes de version de python (Depends: python, python-central (>= 0.5.8)).
Nous allons passer directement à la version 4 de notre paquet pyhw (la v3 étant la même que la 2 mais version cdbs)
cd pyhw/v4 && dpkg-source -x *.dsc
Dans debian/patches, le fichier 00list a disparu, et les extensions des patchs sont .patch, et non plus .dpatch (cdbs peut gérer n'importe quelle extension mais c'est 'patch' par défaut).
Le fichier debian/rules contient la ligne :
include /usr/share/cdbs/1/rules/simple-patchsys.mk
qui sert à inclure tout le système de patch de CDBS qui traitera tous fichier avec extension .patch du répertoire debian/patches.
Nous allons refaire le 2ème patch du paquet. Celui-ci corrigera le Warning que nous avons eu plus haut.
Supprimer donc le fichier debian/patches/02-shebang.patch et exécutez :
cdbs-edit-patch 02-shebang
Ce Warning est assez courant avec tous les scripts et les modules python sont pas destinés à être exécutés et donc le shebang (#!/usr/bin/env python) n'a pas à sa place ici.
Il faut donc supprimer la première ligne du fichier src/HelloWorld.py
Une fois la modification effectuée, tapez
exit 0
pour quitter cdbs-edit-patch.
Votre patch est créé.