Note

pywws documentation is now located at http://pywws.readthedocs.org/fr/. This copy is no longer being updated and may be out of date.

Pré-requis

La liste des logiciel requis par pywws peut être effrayante au premier abord. Cependant, plusieurs de ces paquets ne sont pas nécessaires pour la plupart des utilisateurs. Ce que vous avez besoin dépend de ce que vous voulez faire avec pywws. Rappelez-vous que pywws est “un ensemble de pièces” plutôt qu’une application monolithique.

Vous devriez être en mesure d’installer la plupart de ceux-ci en utilisant le gestionnaire de paquets de votre système d’exploitation; ce qui est beaucoup plus facile que de télécharger et compiler à partir des fichiers source du site Web du projet. Notez que quelques distributions de Linux emploient différents noms pour certains paquets, par exemple pour Ubuntu, pyusb se nomme python-usb.

Alternativement, vous devriez pouvoir installer des versions plus récentes de certaines bibliothèques à partir du Python Package Index (PyPI). Je recommande d’installer `pip < http://www.pip-installer.org/ >`_ (le paquet peut s’appeler python-pip) ou le `easy_install de < http://peak.telecommunity.com/DevCenter/EasyInstall >`_. Chacun d’eux simplifient l’installation de logiciel à partir de PyPI. Par exemple, pour installer PyUSB à partir de PyPI en utilisant la commande pip:

sudo pip install pyusb

Essentiel

  • Python version 2.5 ou plus récent.

La version 3 de python est supportée, mais certains modules pourraient ne pas fonctionner correctement. Si vous trouvez un problème avec python 3, svp envoyez un message sur la `liste pywws < http://groups.google.com/group/pywws >`_ ou soumettez un rapport de bogue sur GitHub.

Librairie USB

Pour lire les données d’une station météorologique, pywws a besoin d’une bibliothèque python qui lui permet de communiquer par l’intermédiaire d’un port USB. Il y a un grand choix de bibliothèques USB qui peuvent être employées. Elles ne sont pas toutes disponibles sur toutes les plates-formes, ce qui peut limiter votre choix.

Sous MacOS X le pilote du système d’exploitation “réclame” la station météorologique, ce qui empêche le fonctionnement de libusb. Ceci limite les utilisateurs de Mac à l’option 3 ou 4.

  • Librairies USB option 1 (préférable, sauf sous MacOS)

  • Librairies USB option 2 (Si PyUSB 1.0 n’est pas disponible)

  • Librairies USB option 3 (préférable pour MacOS)

  • Librairies USB option 4

Graphes

Le module pywws.Plot utilise gnuplot pour générer les graphes. Si vous voulez produire des graphiques de données météo, par exemple pour inclure dans une page Web, vous devez installer l’application gnuplot:

Téléversement web sécurisé (sftp)

Le module pywws.Upload peut utiliser “FTP sur ssh” (sftp) pour envoyer les fichiers sur votre site web. L’envoi normal emploi simplement les modules standard Python, mais si vous souhaitez utiliser sftp vous devez installer ces deux modules:

Mise à jour Twitter

The pywws.ToTwitter module can be used to send weather status messages to Twitter. Posting to Twitter requires all four of these modules:

Modifié dans la version 13.06_r1023: pywws previously used the tweepy library instead of python-twitter and python-oauth2.

Pour créer une nouvelle traduction

pywws peut être configuré pour utiliser d’autres langues que l’anglais, et la documentation peut aussi être traduite dans d’autres langues. Voir Comment utiliser pywws dans une autre langue pour plus d’informations. Le paquet gettext est nécessaire pour extraire les phrases pouvant être traduites, et pour compiler les fichiers de traduction.

Pour ‘compiler’ la documentation

La documentation de pywws est produite en “texte ReStructurées”. Un programme appelé Sphinx est utilisé pour convertir ce format facile à écrire, au format HTML pour une utilisation avec un navigateur web. Si vous souhaitez créer une copie locale de la documentation (donc vous n’avez pas à dépendre de la version en ligne, ou pour tester une traduction que vous travaillez) vous devez installer Sphinx.

Commentaires et questions? SVP, abonnez-vous à la liste pywws http://groups.google.com/group/pywws et faites-vous entendre.