Manuel d`installation

Transcription

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, placezvous 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
Green Harvest – Manuel d'Installation
Installation sous Windows
Installation de Python 2.5
Récupérez l'installateur adapté à votre version sur le site officiel de Python :
http://www.python.org/download/releases/2.5.2/
Il s'agit ensuite d'un installateur Windows tout ce qu'il y a de plus classique, vous ne devriez donc
pas rencontrer de difficultés.
Installation de PyQt4
Récupérez l'installeur sur le site de riverbank. Celui-ci inclus aussi QT4 (à l'installation vous n'êtes
pas obligé d'installer les outils de développement si vous ne comptez pas vous en servir) :
http://www.riverbankcomputing.co.uk/static/Downloads/PyQt4/PyQt-Py2.5-gpl-4.4.3-1.exe
Installation de simplejson
Lancer l'installeur simplejson-2.0.4.win32.exe présent dans le répertoire wininstall.
Note: cet installeur a été créé par mes soins pour faciliter l'installation, les sources de simplejson se
trouvent à cette adresse :
http://pypi.python.org/pypi/simplejson
Installation de Green Harvest
Exécuter le programme greenharvest-0.1.win32.exe (dans le répertoire wininstall de l'archive zip)
Et voilà !
Il est aussi possible de l'installer selon la procédure « Python » utilisée pour les UNIX, mais la
solution proposée içi est plus dans la logique Windows.
Le programme est alors installé dans C:\Python25\Scripts\greenharvest.exe
Des raccourcis sont normalement créés sur le bureau et dans le menu démarrer.
Autres systèmes (UNIX, MacOSX...)
Ne disposant pas de X environnements, j'indique içi la procédure standard qui devrait pouvoir
s'appliquer.
Installation de Python 2.5
Si Python n'est pas inclus de base, rendez-vous sur le site officiel de Python, et trouvez votre
bonheur dessus (Python est écrit en C, et devrait pouvoir être installé sur n'importe quel système
disposant d'un compilateur C tel que gcc) :
http://www.python.org/download/releases/2.5.2/
6
Green Harvest – Manuel d'Installation
Installation de PyQt4
Il peut être nécessaire d'installer QT4 au préalable.
QT est une bibliothèque graphique écrite en C++, à priori portable :
http://trolltech.com/downloads/opensource/appdev
Sous MacOSX
La version X11 de PyQt4 est dans Fink :
http://pdb.finkproject.org/pdb/browse.php?summary=pyqt
Pour la version native, il va certainement falloir en passer par la recompilation des sources !
(j'ai aperçu des versions binaires sur sourceforge, mais elles semblent très très obsolètes...)
Ils se trouvent ici : http://www.riverbankcomputing.co.uk/software/pyqt/download (pyqt-mac-gpl)
Cela sort un peu du cadre de ce manuel, et comme je ne dispose pas de MacOSX, il faudra vous
débrouiller par vous-même :)
Autres UNIX :
Si vous utilisez un BSD, solaris ou autre système UNIX, la recompilation ne devrait pas vous poser
de problèmes : http://www.riverbankcomputing.co.uk/software/pyqt/download (pyqt-x11-gpl)
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.
Les sources se trouvent à cette adresse : http://pypi.python.org/pypi/simplejson/
Installation de Green Harvest
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, placezvous dans le répertoire src de l'archive décompressée de Green Harvest puis :
$ /bin/sh dist/greenharvest-0.1a1-py2.5.egg
Cela permet d'évaluer facilement l'application. Une installation reste plus pratique pour les
utilisateurs convaincus !
7
Green Harvest – Manuel d'Installation
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.1a1-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 n'avez plus qu'à lire le Manuel de l'utilisateur !
Bonne utilisation !
8