Manuel d`installation

Manuel d'installation
Table des matières
Introduction..........................................................................................................................................2
Pré-requis..............................................................................................................................................2
Python 2.5........................................................................................................................................2
PyQT4..............................................................................................................................................2
simplejson........................................................................................................................................3
Culture Générale : Installer une application ou un module en Python.................................................3
Installation Sous GNU/Linux...............................................................................................................3
Installation de Python 2.5................................................................................................................3
Installation de PyQt4.......................................................................................................................4
Installation de simplejson................................................................................................................4
Installation de Green Harvest..........................................................................................................5
Mode sans Installation................................................................................................................5
Mode avec Installation................................................................................................................5
Installation sous Windows....................................................................................................................6
Installation de Python 2.5................................................................................................................6
Installation de PyQt4.......................................................................................................................6
Installation de simplejson................................................................................................................6
Installation de Green Harvest..........................................................................................................6
Autres systèmes (UNIX, MacOSX...)..................................................................................................6
Installation de Python 2.5................................................................................................................6
Installation de PyQt4.......................................................................................................................7
Sous MacOSX.............................................................................................................................7
Autres UNIX :.............................................................................................................................7
Installation de simplejson................................................................................................................7
Installation de Green Harvest..........................................................................................................7
Mode sans Installation................................................................................................................7
Mode avec Installation................................................................................................................8

Green Harvest – Manuel d'Installation
Introduction
Green Harvest est écrit en langage Python. Afin de simplifier sa distribution, son installation et son
utilisation, Green Harvest utilise les setuptools (easy_install).
Les setuptools permettent d'installer très simplement les applications, quelque soit la plate-forme
(Linux, Windows, MacOSX, autre UNIX...). Si setuptools n'est pas déjà installé sur votre système,
il s'installera (avec votre accord) tout seul, comme un grand (pour peu que vous disposiez d'une
connexion Internet fonctionnelle et d'un interpréteur Python >= 2.4).
Pour en savoir plus sur les setuptools, et sur easy_install (ce n'est pas nécessaire pour la suite de
l'installation) : http://peak.telecommunity.com/DevCenter/EasyInstall
Note: comme il est écrit en Python, qui est un langage interprété, il n'est pas obligatoire de
l'installer pour pouvoir l'exécuter, cela peut être fait depuis le répertoire source de l'application à
l'aide des scripts greenharvest.sh (UNIX) ou GreenHarvest.bat (Windows), à condition bien sûr de
disposer des programmes et modules nécessaires...
Pré-requis
Python 2.5
Pour pouvoir installer Green Harvest, il est au préalable nécessaire de disposer d'une installation
de Python (2.5 de préférence) fonctionnelle sur votre système.
Green Harvest a été développé avec Python 2.5. Il fonctionne à priori aussi avec la version 2.4.
La version 2.6 de Python est sortie il y a peu (1er octobre 2008). Cette version étant très récente, je
vous déconseille toutefois de la choisir, non pas qu'elle ne soit pas stable, mais car il sera plus
complexe de trouver certaines extensions pour cette version (je pense à PyQt4, disponible pour
Python 2.6 en version de développement seulement pour Windows, peu stable lors de mes tests).
La version recommandée si aucune version de Python n'est déjà installée sur votre système est donc
Python 2.5.2 !
PyQT4
PyQt4 est une extension Python permettant d'utiliser le ToolKit graphique QT 4 (prononcez
« Cute » ou « kioute ») de TrollTech (http://trolltech.com) écrit en C++.
Il s'agit d'un toolkit graphique très élégant, multi-plateformes, permettant de développer des
applications graphiques évoluées.
Il est distribué sous une double licence :
–licence GPL si utilisé dans une application GPL (ce qui est le cas de Green Harvest)
–licence commerciale pour les applications commerciales
http://trolltech.com/about/open-source-business-model
PyQT est développé et distribué sous le même système de double licence que Qt, par la société
Riverbank Computing Limited (http://www.riverbankcomputing.co.uk).
2

Green Harvest – Manuel d'Installation
La version 4 est nécessaire, les codes générés automatiquement depuis QTDesigner ne sont pas
compatibles avec les version antérieures de QT.
simplejson
Enfin, Green Harvest utilise le module « simplejson ». Si il n'est pas déjà installé sur votre
système, l'installeur easy_install l'installera pour vous. Pour Windows, un executable d'installation
est fourni.
Culture Générale : Installer une application ou un module en
Python
Qu'il s'agisse de Green Harvest ou d'un autre module (simplejson par exemple), généralement la
procédure d'installation d'un module Python consiste à taper, dans un shell de commande (même
sous Windows) :
python setup.py install
C:\Python25\python.exe setup.py install
Généralement depuis le répertoire source de l'application (là où vous trouvez le fichier setup.py, qui
d'une certaine façon est à Python ce que le Makefile est au C ).
Ceci étant dit, voici la démarche complète et détaillée à suivre pour les différents systèmes...
Installation Sous GNU/Linux
Etant donné le nombre de distributions différentes, seules les instructions pour les distributions les
plus courantes seront indiquées. Si votre distribution est suffisamment récente/à jour, il est de toutes
façons fort possible que tout le nécessaire soit déjà en place.
Installation de Python 2.5
Python est souvent utilisé par des scripts composant la base du système, il est donc fort
probablement déjà disponible sur votre système !
Pour le savoir, taper dans un shell de commandes :
$ python -V
Python 2.5.2
Ici la version installée est Python 2.5.2 (il est possible que plusieurs versions de Python soit
installées sur votre système, généralement la commande 'python' invoque la dernière version
disponible).
Si Python n'est pas déjà installé, ou dans une version trop ancienne, utilisez le système de gestion de
paquets de votre distribution.
3

Green Harvest – Manuel d'Installation
Au passage regardez si le module setuptools n'est pas disponible via votre système de gestion de
paquet (facultatif).
Pour les distributions de type Debian/Ubuntu (en tant que root, ou en précédant la commande de
« sudo ») :
# aptitude install python2.5 python-setuptools
Pour les distributions de type RedHat/Fedora/CentOS (en tant que root, ou en précédant la
commande de « sudo »:
# yum install python python-setuptools
Note: il semble que la version courante de RedHat/CentOS soit la version 2.4 (ce qui ne pose pas à
priori pas de problème en soi).
Pour Mandriva :
# urpmi python
Pour les autres distributions (Gentoo, Novell/Suse, ArchLinux,...), si vous les utilisez vous savez
certainement comment utiliser le système de paquet pour chercher et installer Python !
Voilà, vous devriez maintenant disposer d'une installation fonctionnelle du meilleur langage de
programmation au Monde ! ;)
Installation de PyQt4
Encore une fois, il est recommandé d'utiliser le système de gestion de paquet de votre distribution
préférée pour installer PyQT4, il y est probablement disponible.
Pour les distributions de type Debian/Ubuntu :
# aptitude install python-qt4
Pour les distributions de type RedHat/Fedora/CentOS :
# yum install PyQt4
Pour Mandriva :
# urpmi python-qt4
Installation de simplejson
Il n'est à priori pas nécessaire d'installer simplejson à part, l'installation de Green Harvest le fera
pour vous. Par contre, si vous souhaitez éxecuter Green Harvest sans installation (cf. ci-dessous),
alors il est nécessaire d'installer simplejson préalablement.
4

Green Harvest – Manuel d'Installation
La plupart des distributions GNU/Linux proposent un paquet intitulé python-simplejson.
Sinon, les sources se trouvent à cette adresse : http://pypi.python.org/pypi/simplejson/
Installation de Green Harvest
Si Python et PyQT4 sont correctement installés, alors vous avez déjà fait le plus dur !
Green Harvest est distribué sous la forme d'un Egg Python, qui est à Python ce que le jar est Java
(enfin pas tout fait...).
Pour en savoir plus (ou pas) : http://peak.telecommunity.com/DevCenter/PythonEggs
Mode sans Installation
Il est possible de lancer l'application sans même l'installer. Depuis un shell de commandes, placez-
vous dans le répertoire src de l'archive décompressée de Green Harvest puis :
$ /bin/sh dist/greenharvest-0.1-py2.5.egg
Cela permet d'évaluer facilement l'application. Une installation reste plus pratique pour les
utilisateurs convaincus !
Mode avec Installation
Depuis un shell de commande, placez-vous dans le répertoire src de l'archive décompressée de
Green Harvest.
Si vous avez installé les setuptools, la commande easy_install devrait être disponible.
Auquel cas, l'installation se fait en tapant :
# easy_install dist/greenharvest-0.1-py2.5.egg
Sinon :
# python setup.py install
Cela devrait déclencher tout ce qui est nécessaire pour installer Green Harvest, y compris le
téléchargement des setuptools si non présents sur votre système, de même pour le module
simplejson.
Après cela, deux scripts « lanceurs » auront été installés dans /usr/bin :
–greenharvest : application graphique
–greenharvest_cli : version ligne de commande « à la UNIX » pour les courageux
Vous pouvez bien sûr créer des raccourcis sur votre bureau, ou dans le menu de votre gestionnaire
de bureau préféré.
5