wiki/python.mdwn

155 lines
4.7 KiB
Markdown

#Python
## Virtualenv et pip
### Aller voir SamEtMax
### Installer un package depuis des fichiers locaux
Rien de bien sorcier si le package est bien fait
pip install chemin/vers/le/package
Le chemin/vers/le/package peut être une archive tar.gz créé avec **python setup.py sdist**
## Créer un package près à installer avec pip
Le but de cette partie est d'expliquer comment ranger et mettre en forme les fichiers pythons pour permettre l'installation avec pip d'un package de notre cru.
### Forme du package
Un package a une forme particulière qui se présente ainsi
file/
LICENSE.txt
README.txt
MANIFEST
setup.py
moduleA/
__init__.py
moduleA.py
moduleB/
__init__.py
moduleB.py
Le fichier LICENSE.txt contient la licence du package.
Le fichier README.txt (à vérifier s'il ne peut pas être en markdown) voir [ici](http://guide.python-distribute.org/creation.html#readme-txt-description)
Le fichier MANIFEST contiendra la liste de tous les fichiers à inclure (s'il n'existe pas, il sera créé automatiquement).
Le fichier setup.py est le plus important. C'est lui qui décrit tout le package et qui va permettre l'installation (en particulier).
Ensuite on a les différents dossiers avec les modules. C'est là que le code est rangé. Même s'il est vide, il faut qu'il y est le fichier _ _ init _ _ .py .
Pour créer un setup.py basique, on adapte le contenu suivant:
#!/usr/bin/env python
from distutils.core import setup
setup(name='PackageName',
version='0.0.2',
description='A super description',
author='You, your friends, your fingers',
author_email='you@your.home',
url='http://www.python.org/sigs/distutils-sig/',
packages=['moduleA', 'moduleB'],
)
Les éléments de *packages* sont les noms des dossiers.
Pour plus d'info [documentation officiel](http://docs.python.org/2/distutils/setupscript.html).
Maintenant le packages est près à être distribué et installer (/!\ si dans le code les *import* ne sont pas fait correctement, l'exécution du package installé ne marchera pas - voir la partie *Relative import*).
Pour distribuer le package, on peut lancer la commande
python setup.py sdist
_
Elle aura pour effet de créer une archive du projet dans le répertoire *dist*.
### Relative import
Comme dit au dessus, quand on essaie de faire un package et que l'on veut l'utiliser, les chemins vers les différents fichiers sont modifiés et les import ne se font plus correctement. On a en général le droit à une belle erreur
ImportError: No module named ...
Imaginons que l'on soit dans cette configuration
moduleA/
moduleA1.py
moduleA2.py
Et que dans *moduleA2.py*, il y est
from moduleA1 import plop
Quand on lance depuis le dossier *moduleA*
python moduleA2
pas de soucis.
Par contre si l'on a installé notre package et que l'on veut import le moduleA2, on a alors l'erreur
ImportError: No module named moduleA1
Cela est dû aux chemins qui ont été modifiés.
Pour résoudre ce soucis, il va falloir convertir l'import absolue du moduleA2 en import relatif. Pour cela, il faut ajouter un "." devant de nom du module.
from .moduleA1 import plop
Maintenant l'import du package moduleA2 marche mais plus sont "lancement" qui renvoie l'erreur
SystemError: Parent module '' not loaded, cannot perform relative import
Pas très pratique... Pour refaire marcher le lancement, il faut se placer dans le répertoire parent de *moduleA* et lancer
python -m moduleA.moduleA2
## Quelques reférences
### Virtualenv et pip
* http://docs.python.org/2/distutils/setupscript.html
### Créer son package
* http://docs.python.org/2/distutils/setupscript.html
### Relative import
* https://www.inkling.com/read/learning-python-mark-lutz-4th/chapter-23/why-use-package-imports
## Pandas
### Installation de Pandas
pip install pandas
pip install xlrd
Puis on peut le charger avec un
>>> import pandas as pd
### Lire des fichiers talbeur
Première chose, Pandas ne sais pas lire les fichiers *ods*, il faut donc enregistrer le fichier en xls (xlsx ne semble pas marcher chez moi).
Ensuite on peut importer le fichier en question
>>> donnees = pd.read_excel('<nom du fichier>', '<nom de la fiche de calcul>')
>>> donnes
Pour afficher les *clés*
>>> for i in donnes.keys():
... print(i)
Supprimer une colonne (ici la première)
>>> donnees = donnees.drop(donnees.columns[0], 1)
### Quelques références au sujet de pandas
* Lecture et écriture des fichiers: http://pandas.pydata.org/pandas-docs/stable/io.html
* http://sametmax.com/le-pandas-cest-bon-mangez-en/