cours-python/sessions/python-11.md

% Programmation avec Python (chapitre 11) % Dimitri Merejkowsky

\center \huge Retour sur les exceptions

A quoi sert finally?

try:
    fp = open("file.txt")
    1 / 0
except ZeroDivisionError:
    print("got you")
finally:
    print("closing")
    fp.close()

versus

try:
    fp = open("file.txt")
    1 / 0
except ZeroDivisionError:
    print("got you")

fp.close()

Réponse:

Que se passe-t-il si l’exception n’est pas ZeroDivisionError?

\center \huge Utiliser des bibliothèques tierces

Rappel

import foo

answer = foo.get_answer()

Fonctionne si:

• Il y a un foo.py quelque part qui contient une fonction get_answer
• Dans le dossier courant
• Ou dans la bibliothèque standard Python

Parlons de PATH

• Vous connaissez peut-être la variable PATH, qui dit où sont les exécutables.

PATH="/bin:/usr/bin:/usr/sbin"
$ ifconfig
# résout sur /usr/sbin/ifconfig
$ ls
# résount sur /bin/ls

sys.path

En Python c’est pareil.

import sys
print(sys.path)

Sur mon Arch

* ''   # vide = chemin courant
* /usr/lib/python3.7
* /usr/lib/python3.7/lib-dynload
* /home/dmerej/.local/lib/python3.7/site-packages
* /usr/lib/python3.7/site-packages

• Le chemin courant à la priorité sur la bibliothèque standard!

À noter

Seul deux des composants sont accessibles en écriture par mon utilisateur courant:

• Le chemin courant
• Un chemin dans mon $HOME (~/.local/lib/python3.7/site-packages/)

Même principe sur macOS et Windows (presque)

Bibliothèques tierces

Par example, pour faire des jolis tableaux:

import tabulate

scores = [
  ["John", 345],
  ["Mary-Jane", 2],
  ["Bob", 543],
]
table = tabulate.tabulate(score)
print(table)

---------  ---
John       345
Mary-Jane    2
Bob        543
---------  ---

Le problème

On peut trouver le code source de tabulate facilement.

Mais comment faire pour le mettre dans sys.path?

À la main

On peut récupérer les sources et les installer avec python3 setup.py install --user

• Quasiment tous les projets python ont un setup.py utilisable de cette façon.

• On utilise --user pour éviter des problèmes de permissions

• Démo!

Anatomie du setup.py

Un appel à setuptools.setup(). C’est tout

from setuptools import setup

setup(
  name='tabulate',
  version='0.8.1',
  description='Pretty-print tabular data',
  py_modules=["tabulate"],
  scripts=["bin/tabulate"],
  ...
)

À noter

Sur linux, si le paquet contient des scripts, ils arriveront dans ~/.local/bin.

Sous macOS et Windows, ce sera un autre emplacement, mais qui dépendra de la version de Python.

• Utilisez python3 -m quand c’est possible!

Avec pip

• pip vient par défaut avec Python3
• Vous pouvez aussi l’installer avec get-pip.py
• Toujours le lancer avec python3 -m pip.

Dépendances

Prenons une autre bibliothèque: cli-ui.

Elle sert à faire des jolis programmes en couleur:

import cli_ui

cli_ui.info_1("Ceci est une info importante")
cli_ui.info("Ceci est en", cli_ui.bold, "gras")

Dépendances de cli-ui

En fait, cli-ui utilise d’autres bibliothèques.

Par exemple:

headers=["name", "score"]
data = [
  [(bold, "John"), (green, 10.0)],
  [(bold, "Jane"), (green, 5.0)],
]
cli_ui.info_table(data, headers=headers)

Devinez qui s’occupe d’afficher le tableau!

Déclaration des dépendances

Aussi dans setup.py:

setup(
  name="cli-ui",
  version="0.9.1",
  install_requires=[
     "tabulate",
     ...
  ],
  ...
)

Intérêt de pip

• Va chercher tout seul sur pypi

• Lance setup.py tout seul (pour trouver les dépendances, et les installer)

• S’utilise avec python3 -m pip install --user ...

Fonctionnalités en plus

• Peut supprimer quelque chose installé - python3 -m pip uninstall <>
• Peut chercher sur pypi directement - python3 -m pip search <>
• Peut lister ce qui est installé - python3 -m pip list

Limitations de pip seul

• Il faut penser à utiliser --user
• Si le paquet est déjà installé dans le système (genre /usr/lib/ sous Linux), pip ne saura pas le mettre à jour - il faudra passer par le gestionnaire de paquet de la distribution

Versions de dépendances

Parfois, les versions sont incompatibles entre elles!

https://tankerhq.github.io/python-cli-ui/changelog.html#v0-8-0

Solution

On peut donner des versions dans setup.py:

install_requires=[
   "cli-ui <= 0.8",
   ...
]

Plusieurs projets

• Projet A utilise cli-ui 0.7
• Projet B utilise cli-ui 0.9

Comment faire pour travailler sur les deux projets?

Environements virtuels

• Un chemin isolé du reste du système.
• Contient un binaire python légèrement différent du binaire ordinaire.
• Se crée avec python3 -m venv <le chemin> - sauf sous Debian ;-(

Avec virtualenv

• Vous pouvez aussi installer virtualenv avec pip puis utiliser virtualenv

$ python3 -m pip install virtualenv --user
$ python3 -m virtualenv <le chemin>

L’isolation en pratique

• Plus de chemin dans ~/.local/lib
• Moins de chemins dans le système
• Les scripts restent dans le virtualenv

Pip + Virtualenv = <3

Et vous avez aussi un pip spécial dans /le chemin/bin/pip

• Plus besoin de --user
• On peut créér deux virtualenvs différent pour les projets A et B

Activer un virtualenv

Si taper le chemin du virtualenv vous embête, vous pouves l’activer avec source bin/activate

Pour sortir: deactivate.

Les règles

• Un virtualenv par projet et par version de Python
• Toujours utiliser pip depuis un virtualenv

C’est plus long, mais ça vous évitera un tas de problèmes ...

Pour aller plus loin

• requirements.txt
• pipenv
• poetry

Veillez à bien comprendre le problème que ces outils résolvent avant de vous en servir!

On y reviendra