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.

Certains paquets Python sont nécessaires, ils peuvent être téléchargés à partir de Python Package Index (PyPI). Je recommande l’utilisation de pip pour en faire l’installation.

Vous devriez être en mesure d’installer les autres dépendances en utilisant le gestionnaire de paquets de votre système d’exploitation. C’est beaucoup plus simple que de télécharger et de compiler les fichiers source depuis les sites Web des projets. Notez que certaines distributions de Linux utilisent des noms différents pour certains paquets, par exemple dans Ubuntu, pyusb est nommé python-usb.

Remarque : certaines de ces bibliothèques peuvent avoir leurs propres dépendances que vous devrez peut-être installer. Suivez les liens pour en savoir plus sur les exigences de chaque bibliothèque.

Essentiel

  • Python version 2.5 2.5 ou supérieur

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.

Vous serez probablement en mesure d’installer pip avec le gestionnaire de paquets de votre système, où il peut être nommé python-pip, python3-pip ou quelque chose de similaire. Sinon, téléchargez et exécutez “”get-pip.py”” à partir du site web de pip. Dans les deux cas, vous devez immédiatement utiliser pip pour installer la dernière version:

sudo pip install --upgrade pip

Assurez-vous d’installer la bonne version Python de pip. Si vous souhaitez installer pywws tant pour Python 2 que Python 3 vous aurez besoin de pip2 et pip3.

C’est un petit module qui fournit des informations sur votre fuseau horaire local. Il vaut mieux l’installer avec « pip »”:

sudo pip install tzlocal

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.

Mac OS X

Sur MacOS X, le pilote hid générique du système d’exploitation « réclame » la station météo, ce qui rend très difficile l’utilisation de tout autre interface USB. Malheureusement, vous aurez besoin de télécharger et compiler hidapi vous-même.

  • hidapi
  • ctypes (Votre gestionnaire de paquet peut le connaître sous le nom python-ctypes )

Si vous ne pouvez pas installer ctypes alors, vous pouvez essayer l’interface à hidapi avec Cython à la place :

  • cython-hidapi
  • cython (Votre gestionnaire de paquet peut le connaître sous le nom python-Cython)

Autre systèmes

D’autres systèmes utilisent une interface Python pour la librairie système libusb. Il y a un choix d’interfaces et version de le bibliothèque - installez la dernière qui est disponible pour votre ordinateur.

  • libusb version 1.x (Devraient être disponibles à partir du gestionnaire de paquets )
  • python-libusb1 version 1.3
pip install libusb1

or

  • libusb version 1.x or version 0.1 (Devraient être disponibles à partir du gestionnaire de paquets )
  • PyUSB version 1.0
pip install pyusb --pre

L’indicateur “”–pre”” permet l’installation de versions « pré-production », comme l’actuelle version bêta (version 1.0.0b2) de pyusb.

Si aucune de ces options ne fonctionne pour vous, alors vous pouvez utiliser hidapi – voir les instructions pour le Mac OS X ci-dessus.

Modifié dans la version 15.01.0.dev1265: Ajout de la possibilité d’utiliser l’interface python-libusb1.

Tâches chronométrées flexibles

Le module pywws.Tasks peut accomplir des tâches à des moments et / ou des dates particulières. Cela nécessite la bibliothèque croniter. (les tâches simple horaire, quotidienne ou les tâches “Live” n’ont pas besoin de cette bibliothèque.)

pip install croniter

S’exécute comme daemon

Le programme pywws.livelogdaemon exécute l’historisation Live de pywws comme un processus démon UNIX appropriée. Exige la bibliothèque python-daemon:

pip install python-daemon

Graphes

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

  • gnuplot v4.2 or supérieur (Devraient être disponibles à partir du gestionnaire de paquets)

Après l’installation de gnuplot, Vous devez éditer weather.ini (voir weather.ini - format du fichier de configuration) et définissez l” élément de configuration « gnuplot version ». Trouver la version de gnuplot installé est facile:

gnuplot -V

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:

sudo pip install pycrypto paramiko

Mise à jour Twitter

Le module pywws.ToTwitter peut être utilisé pour envoyer les messages météorologiques sur Twitter. La publication sur Twitter nécessite ces modules:

sudo pip install python-twitter oauth2

or

sudo pip install tweepy oauth2

A noter que tweepy semble être le moins fiable des deux. Si vous avez des problèmes, e. g. avec le codage de caractères, essayez plutôt d’installer python-twitter.

Modifié dans la version 13.10_r1086: Réactivé l’utilisation de la bibliothèque tweepy comme alternative à python-twitter. python-oauth2 est toujours requis par pywws.TwitterAuth.

Modifié dans la version 13.06_r1023: pywws a auparavant utilisé la bibliothèque tweepy au lieu de python-twitter et python-oauth2.

MQTT

Nouveau dans la version 14.12.0.dev1260.

Le module pywws.toservice peut être utilisé pour envoyer des données météorologiques à un courtier MQTT. Cela exige le module paho-mqtt:

sudo pip install paho-mqtt

Pour créer une nouvelle traduction

pywws peut être configuré pour utiliser d’autres langues que l’anglais, comme décrit dans Comment utiliser pywws dans une autre langue. Le paquet Babel est nécessaire pour extraire les chaînes à traduire et à compiler les fichiers de traduction.

sudo pip install babel

La copie de fichiers vers ou depuis Transifex nécessite le paquet transifex-client.

sudo pip install transifex-client

Traduire la documentation à l’aide de fichiers locaux nécessite le paquet sphinx-intl.

sudo pip install sphinx-intl

Modifié dans la version 14.05.dev1209: pywws a auparavant utilisé le paquet gettext.

Pour “compiler” la documentation

La documentation de pywws est écrite en « texte restructuré ». Un programme appelé Sphinx est utilisée pour convertir ce format facile à écrire en code HTML pour l’utiliser avec un navigateur web. Si vous souhaitez créer une copie locale de la documentation (pour ne pas avoir à compter sur la version en ligne, ou pour tester une traduction sur laquelle vous travaillez), vous devez installer Sphinx, version 1.3 ou ultérieure.

sudo pip install sphinx

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