Cheat sheet: Python

Ce document résume en quelques pages les éléments essentiels de la syntaxe du langage python. Quelques lignes suffisent pour découvrir la version installée :

<<<

import sys

print(sys.version)

>>>

    3.10.12 (main, Sep 11 2024, 15:47:36) [GCC 11.4.0]

Avec la version 3.x, le langage a introduit quelques changements importants qui seront précisés. Il est préférable de choisir la version 3 plutôt que 2.7. Outre le fait qu’elle contient les dernières évolutions, elle est beaucoup plus cohérente en ce qui concerne les chaînes de caractères.

Le langage

Quelques rappels sur le langage :

  • Il n’y a pas de séparateur d’instructions, il faut écrire une instruction par ligne et décaler les lignes dans une boucle, un test, une fonction, une classe. Pour écrire une instruction sur plusieurs lignes, il faut utiliser le caractères \ sur toutes les lignes de l’instruction sauf la dernière. Il ne doit rien y avoir derrière ce caractère, ni espace, ni commentaires. Cette règle n’est nécessaire s’il s’agit d’une liste d’éléments séparés par des virgules.

  • On peut mettre autant d’espaces qu’on veut. Il peut n’y en avoir aucun sauf derrière une instruction for, if, …

  • Les commentaires dans un programme commencent par le symbole # et vont jusqu’à la fin de la ligne.

  • L’instruction print permet d’afficher n’importe quelle information. Elle affiche le résultat de la méthode __str__ pour les classes. Version 3.x : print est une fonction, tout ce qui doit être affiché doit l’être entre parenthèses.

  • L’instruction help affiche l’aide associée à une variable, une fonction, une classe, une méthode, un module. Pour une fonction, une classe, une méthode du programme, cette aide correspond à une chaîne de caractères encadrée par trois ". Ce message d’aide peut s’étaler sur plusieurs lignes.

<<<

def fonction():
    """fonction de
    démonstration"""
    return 0


help(fonction)

>>>

    Help on function fonction in module sphinx_runpython.runpython.sphinx_runpython_extension:
    
    fonction()
        fonction de
        démonstration

2 astuces en cas de problème

En cas de doute sur une partie de code, un calcul, une priorité entre opérateurs, le résultat d’une fonction, il est possible d’utiliser la fonction print pour afficher une valeur intermédiaire pendant un calcul. Il ne faut pas non plus hésiter à vérifier sur un petit exemple dans un petit programme que des lignes douteuses font exactement ce pour quoi elles ont été écrites.

Il est souvent utile de chercher sur Internet des exemples de programmes pour corriger une syntaxe incorrecte, utiliser un moteur de recherche en ajoutant une requête commençant par le mot python. Pour les erreurs, il est parfois intéressant de recopier intégralement le message d’erreur sur un moteur de recherche, les réponses obtenues sont souvent assez claires.

Les variables

Le nom d’une variable commence par une lettre ou un blanc souligné, il peut également inclure par la suite des chiffres. Python distingue les minuscules des majuscules. La portée d’une variable, c’est-à-dire la portion de code où elle définie, s’étend depuis sa déclaration (première affectation) jusqu’à la fin du programme ou de la fonction où elle est définie. Pour déclarer une variable portant le nom va, il suffit d’écrire :

va = <valeur>

Le type de <valeur> détermine le type de la variable va. Si une variable de même portée portait déjà ce nom-là, son contenu est écrasé (perdu aussi). L’instruction type(x) retourne le type de la variable x. Un identificateur qu’il désigne une variable, une fonction, une classe ou un module garde la valeur de sa dernière affectation.

Les types immuables

Les variables de type immuable ne peuvent pas être modifiées.

  • None, ce type veut dire rien, il est utilisé comme convention de programmation pour dire qu’un algorithme, un calcul ne s’est pas terminé correctement ou une valeur n’a pas encore été calculée.

  • bool : un booléen (résultat d’un test)

  • int : un entier

  • float : un réel

  • complex : un complexe

  • str : une chaîne de caractères ou string, elle apparaît entre guillemets, entre apostrophes, entre trois guillements (""") si elle s’étend sur plusieurs lignes. s = "exemple".

  • tuple : un vecteur d’éléments de types identiques ou différents, il apparaît entre parenthèses, on accède à un de ses éléments à l’aide de crochets. Les éléments d’un t-uple t sont indicés de 0 à len(t)-1 inclus.

    t = ()        # tuple vide
    t = (2, "e")  # tuple de deux éléments
    print(t[0])   # affiche le premier élément
    

L’affectation d’une valeur de type immuable à une variable est une copie. On peut appliquer sur les types numériques les opérations usuelles (+ * - / \% ** += *= -= /= \%= **=) ** est le symbole pour puissance : 3 ** 4 = 3^4. On rappelle que a += 10 est équivalent à a = a + 10, ceci signifie que la valeur de a avant le calcul n’a plus besoin d’exister. Le et logique et le ou logique sont notés and et or. Les priorités sont celles usuellement utilisées en mathématique, en cas de doute, il faut utiliser des parenthèses.

Les opérateurs de comparaison (< > == <= >=) s’appliquent sur tous les types numériques ainsi que sur les chaînes de caractères. Rappel : les minuscules sont classées après les majuscules.

<<<

print("A" < "a")

>>>

    True

Fréquente source de bug :

  • une division entière a pour résultat un réel. Autrement dit : 1/2 = 0.5. Pour une division entière, il faut utiliser // : 1//2 = 0.

Pour convertir une information d’un type à un autre, il suffit d’utiliser le nom de ce type suivi de la valeur à convertir entre parenthèses : b = float ("2.145") équivaut à la conversion d’une chaîne de caractères en réel.

L’addition d’un t-uple et d’une valeur retourne un t-uple incluant cette valeur à la fin (plus long d’un élément). L’addition de deux t-uples concatène les deux t-uples. L’addition de deux chaînes de caractères retourne leur concaténation.

Pour savoir si un élément x fait partie d’un t-uple t, il faut utiliser la syntaxe x in t dont la réciproque est x not in t.

La fonction len retourne la longueur d’un tuple ou d’une chaîne de caractères. Les éléments ou les caractères d’un tuple ou d’une chaîne de caractères t sont indicés de 0 à len (t)-1 inclus.

t[i:j]  # correspond à un sous-ensemble allant des indices i à j exclu
t[:j]   #  = t[0: j]
t[i:]   #  = t[i: len(t)]

Pour les chaînes de caractères, on utilise fréquemment les méthodes suivantes :

st = "langage python"
st = 'langage python'          # idem
st = 'un guillement "'         # chaîne contenant un guillement
st = "un guillement \""        # chaîne contenant un guillement, il faut ajouter \
                               #     pour ne pas confondre avec l'autre guillement
st = st.upper()                # mise en lettres majuscules
i  = st.find("PYTHON")         # on cherche "PYTHON" dans st
print(i)                       # affiche 8
print(st.count("PYTHON"))      # affiche 1
print(st.count("PYTHON", 9))   # affiche 0

count( sub[, start[, end]])

Retourne le nombre d’occurences de la chaîne de caractères sub, les paramètres par défaut start et end permettent de réduire la recherche entre les caractères d’indice start et end exclu. Par défaut, start est nul tandis que end correspond à la fin de la chaîne de caractères.

find( sub[, start[, end]])

Recherche une chaîne de caractères sub, les paramètres par défaut start et end ont la même signification que ceux de la fonction count. Cette fonction retourne -1 si la recherche n’a pas abouti.

isalpha()

Retourne True si tous les caractères sont des lettres, False sinon.

isdigit()

Retourne True si tous les caractères sont des chiffres, False sinon.

replace( old, new[, count])

Retourne une copie de la chaîne de caractères en remplaçant toutes les occurrences de la chaîne old par new. Si le paramètre optionnel count est renseigné, alors seules les count premières occurrences seront remplacées.

split( [sep [,maxsplit]])

Découpe la chaîne de caractères en se servant de la chaîne sep comme délimiteur. Si le paramètre maxsplit est renseigné, au plus maxsplit coupures seront effectuées.

upper()

Remplace les minuscules par des majuscules.

lower()

Remplace les majuscules par des minuscules.

join( li )

li est une liste, cette fonction agglutine tous les éléments d’une liste séparés par sep dans l’expression sep.join(["un", "deux"]).

Quelques fonctions s’appliquant aux chaînes de caractères, l’aide associée au langage python fournira la liste complète. Certains des paramètres sont encadrés par des crochets, ceci signifie qu’ils sont facultatifs. L’affichage de réels nécessite parfois de tronquer la partie décimale ce qui est fait grâce à la syntaxe suivante :

<<<

x = 0.123456789
print("%1.2f" % x)  # donne 0.12
s = "%2.2e %s" % (3.14159, "est une approximation de pi")
print(s)

>>>

    0.12
    3.14e+00 est une approximation de pi

Les types modifiables

python fournit deux types modifiables : les listes et les dictionnaires. Pour ces deux types, il faut faire attention à chaque affectation.

a = [1,2]
b = a

La seconde ligne ne fait pas une copie de la première liste, elle ne fait que créer un second nom pour nommer la même liste. Pour copier une liste ou un dictionnaire, il faut utiliser :

a = [1,2]
import copy
b = copy.copy(a)

ou, si la liste inclut également d’autres listes ou dictionnaires :

a = [1,2]
import copy
b = copy.deepcopy(a)

Cette remarque s’applique à tout type modifiable, liste, dictionnaire ou tout autre classe. La suppression d’une variable n’implique pas la suppression de toutes les variables se référant à une seule et même instance de classe.

Liste

Une liste est une sorte de tableau qui permet de mémoriser un ensemble d’éléments de types variés. C’est une sorte de t-uple modifiable.

x = [4,5]               # création d'une liste composée de deux entiers
x = ["un",1,"deux",2]   # création d'une liste composée deux chaînes de caractères
                        # et de deux entiers, l'ordre d'écriture est important
x = [3,]                # création d'une liste d'un élément, sans la virgule,
                        # le résultat reste une liste
x = [ ]                 # crée une liste vide
x = list()              # crée une liste vide

Opérations qu’une liste supporte.

x in s

vrai si x est un des éléments de l

x not in s

réciproque de la ligne précédente

l + t

concaténation de l et t

l * n

concatène n copies de l les unes à la suite des autres

l[i]

retourne le ième élément de l, à la différence des T-uples, l’instruction l [i] = "3" est valide, elle remplace l’élément i par 3.

l[i:j]

retourne une liste contenant les éléments de l d’indices i à j exclu. Il est possible de remplacer cette sous-liste par une autre en utilisant l’affectation `` l[i:j] = l2 `` où l2 est une autre liste (ou un T-uple) de dimension différente ou égale.

l[i:j:k]

retourne une liste contenant les éléments de l dont les indices sont compris entre i et j exclu, ces indices sont espacés de k (le pas) : i, i+k, i+2k, i+3k, ... Ici encore, il est possible d’écrire l’affectation suivante : l[i:j:k] = l2 mais l2 doit être une liste (ou un T-uple) de même dimension que l[i:j:k]

len(l)

nombre d’éléments de l

min(l)

plus petit élément de l, résultat difficile à prévoir lorsque les types des éléments sont différents

max(l)

plus grand élément de l, résultat difficile à prévoir lorsque les types des éléments sont différents

sum(l)

retourne la somme de tous les éléments

del l [i:j]

supprime les éléments d’indices entre i et j exclu. Cette instruction est équivalente à l [i:j] = [].

list(x)

convertit x en une liste quand cela est possible

Opérations disponibles sur les listes, identiques à celles des T-uples, on suppose que l et t sont des listes, i et j sont des entiers. x est quant à lui quelconque.

l.count(x)

Retourne le nombre d’occurrences de l’élément x. count est une méthode de la classe list.

l.index(x)

Retourne l’indice de la première occurrence de l’élément x dans la liste l. Si celle-ci n’existe, une exception est déclenchée.

l.append(x)

Ajoute l’élément x à la fin de la liste l. Si x est une liste, cette fonction ajoute la liste x en tant qu’élément, au final, la liste l ne contiendra qu’un élément de plus.

l.extend(k)

Ajoute tous les éléments de la liste k à la liste l. La liste l aura autant d’éléments supplémentaires qu’il y en a dans la liste k.

l.insert(i,x)

Insère l’élément x à la position i dans la liste l.

l.remove(x)

Supprime la première occurence de l’élément x dans la liste l. S’il n’y a aucune occurrence de x, cette méthode déclenche une exception.

l.pop([i])

Retourne l’élément l[i] et le supprime de la liste. Le paramètre i est facultatif, s’il n’est pas précisé, c’est le dernier élément dont la valeur est d’abord retournée puis il est supprimé de la liste.

l.reverse(x)

Retourne la liste, le premier et dernier élément échangent leurs places, le second et l’avant dernier, et ainsi de suite.

l.sort([key=None, reverse=False])

Cette fonction trie la liste par ordre croissant. Le paramètre f est facultatif, il permet de préciser une fonction qui associe une clé de tri à chaque élément. Le paramètre reverse permet de trier dans un sens ou dans l’autre.

Opérations permettant de modifier une liste on suppose que l est une liste, x est quant à lui quelconque. Les listes peuvent aussi être définies à partir d’une écriture abrégée :

<<<

li = list(range(0, 5))  # liste des entiers de 0 à 5 exclu
y = [i for i in li if i % 2 == 0]  # sélection des éléments pairs
print(y)
z = [i + j for i in li for j in li]  # construit tous les nombres i+j possibles
print(z)

>>>

    [0, 2, 4]
    [0, 1, 2, 3, 4, 1, 2, 3, 4, 5, 2, 3, 4, 5, 6, 3, 4, 5, 6, 7, 4, 5, 6, 7, 8]

Dictionnaire

Un dictionnaire est un tableau pour lequel les indices ou clés ne sont pas uniquement des entiers mais tout type non modifiable (le plus souvent un entier, un réel, une chaîne de caractères, un t-uple).

<<<

x = {"cle1": "valeur1", "cle2": "valeur2"}
print(x["cle1"])
x[(0, 1)] = "clé tuple"  # ajoute une nouvelle valeur dont la clé est (0,1)
#   les parenthèses sont superflues
print(x)
y = {}  # crée un dictionnaire vide
z = dict()  # crée aussi un dictionnaire vide

>>>

    valeur1
    {'cle1': 'valeur1', 'cle2': 'valeur2', (0, 1): 'clé tuple'}

Opérations qu’un dictionnaire supporte.

x in d

vrai si x est une des clés de d

x not in d

réciproque de la ligne précédente

l[i]

retourne l’élément associé à la clé i

len(d)

nombre d’éléments de d

min(d)

plus petite clé

max(d)

plus grande clé

del l [i]

supprime l’élément associé à la clé i

list(d)

retourne une liste contenant toutes les clés du dictionnaire d.

dict(x)

convertit x en un dictionnaire si cela est possible, en particulier, d est égal à dict(d.items())

Opérations disponibles sur les dictionnaires, d est un dictionnaire, x est quant à lui quelconque.

d.copy()

Retourne une copie de d.

x in d

Retourne True si x est une clé de d.

d.items()

Retourne un itérateur parcourant contenant tous les couples (clé, valeur) inclus dans le dictionnaire. Pour obtenir une liste, il faut écrire list(d.items()).

d.keys()

Retourne un itérateur parcourant toutes les clés du dictionnaire d.

d.values()

Retourne un itérateur parcourant toutes les valeurs du dictionnaire d.

d.get(k[,x])

Retourne d[k], si la clé k est manquante, alors la valeur None est retournée à moins que le paramètre optionnel x soit renseigné, auquel cas, ce sera ce paramètre qui sera retourné.

d.clear()

Supprime tous les éléments du dictionnaire.

d.update(d2)

Pour chaque clé de d1, d[k] = d2[k]

d.setdefault(k[,x])

Retourne d[k] si la clé k existe, sinon, affecte x à d[k].

d.popitem()

Retourne un élément et le supprime du dictionnaire.

Méthodes associées aux dictionnaires, d, d2 sont des dictionnaires, x est quant à lui quelconque.

Tableaux numériques

Ce type ne fait pas partie du langage python standard mais il est couramment utilisé.

import numpy
a = numpy.array([0, 1])

Il permet de convertir des listes en une structure plus appropriée au calcul qui sont nettement plus rapides. En contrepartie, il n’est pas aussi rapide d’ajouter ou supprimer des éléments.

Tests et boucles

Tests

Les tests permettent d’exécuter telle ou telle instruction selon la valeur d’une condition. Le test est suivi de : et les instructions dépendant de ce test sont indentées (décalées vers la droite).

if x < 5 :
    x = x * 2
    ...

Il peut y avoir une contrepartie :

if x < 5:
    x = x * 2
    ...
else:
    x = x * 3
    ...

S’il n’y a qu’une seule instruction, elle peut s’écrire en bout de ligne :

if x < 5:
    x = x * 2
else:
    x = x * 3

Il peut y avoir plusieurs conditions qui s’enchaînent :

if x < 5:
    x = x*2
elif x > 5:
    x = x*3
else:
    x = x*6

Il existe un raccourci pour les intervalles :

if 5 < x and x < 10 :     # peut être écrit : if 5 < x < 10 :
    ...

for ou while

Il y a deux types de boucles, la boucle for parcourt un ensemble, la boucle while continue tant qu’une condition est vraie. Comme pour les tests, une boucle est suivie du syumbol :, les lignes incluses dans cette boucle sont indentées à moins qu’il n’y en ait qu’une seule, auquel cas elle peut être écrite après le symbole : sur la même ligne.

while condition :
    # lignes décalées
    # contenu de la boucle

Quelques exemples de boucles for :

for i in range(0,n) :             # parcourt tous les entiers de 0 à n-1 inclus
for i in xrange(0,n) :            # même chose mais en plus rapide
                                  # Version 3.x : la fonction xrange n'existe plus,
                                  #               et range équivaut à xrange
for i in range(n,0,-1) :          # parcourt tous les entiers de n à 1 inclus
                                  #                  dans le sens décroissant
for i in range(2,1000,3) :        # parcourt tous les entiers de 2 à 1000 de 3 en 3
                                  #                                     (2,5,8,...)
for e in li :                     # parcourt tous les éléments de la liste li
for cle,valeur in di.items() :    # parcourt tous les éléments du dictionnaire di

Pour toutes les boucles, l’instruction break permet de sortir de la boucle, l’instruction continue passe directement à l’itération suivante sans exécuter les instructions qui suivent l’instruction continue.

Fonction enumerate

On peut écrire :

l = [ 4, 5, 6 ]
s = 0
for i in range(0,len(l)) :
    s += l[i]

Ou utiliser la fonction enumerate qui retourne chaque élément et sa position dans l’ensemble :

l = [ 4, 5, 6 ]
s = 0
for i,x in enumerate(l) :
    s += x

Fonction zip

Pour faire la somme de deux listes terme à terme, on peut écrire :

l = [ 4, 5, 6 ]
g = [ 3,10,11 ]
s = 0
for i in range(0,len(l)) :
    s += l[i] + g[i]

Ou utiliser la fonction zip :

l = [ 4, 5, 6 ]
g = [ 3,10,11 ]
s = 0
for x,y in zip(l,g) :
    s += x + y

Fonction map

Il est possible d’éviter une fonction pour éviter d’écrire une boucle avec la fonction map. Elle applique une fonction à chaque élément d’un ensemble.

<<<

def fonction(x):
    return x % 2


li = [3, 4, 5]
li2 = map(fonction, li)
print(list(li2))

>>>

    [1, 0, 1]

A priori, l’ensemble qui en résulte contient autant d’éléments sauf si on utilise la fonction filter. L’exemple suivant affiche tous les nombres pairs.

<<<

def fonction(x):
    if x % 2 == 0:
        return True


li = [3, 4, 5]
li2 = filter(fonction, li)
print(list(li2))

>>>

    [4]

Autres mot-clés

Le mot-clé with est utile lorsqu’on une utilise une variable pour une portion réduite de code. Cette notation cache deux appels implicites à deux méthodes comme indiqué ci-dessous.

with random_matrix(1000,1000) as mat :
    #   appelle mat.__enter__()
    ...
    #   appelle mat.__exit__()

Lorsque ces méthodes sont surchargées, l’utilisation de cette syntaxe réduit la taille du code. C’est le cas des fichiers.

Fonctions

Définition, paramètres

Les fonctions ou sous-programmes permettent de faire la même chose sans avoir à recopier le code informatique plusieurs fois dans le programme. Elles acceptent plusieurs paramètres ou aucun, elles peuvent retourner plusieurs résultats ou aucun. Leur déclaration suit le schéma suivant :

def exemple_fonction(p1, p2, p3) :
    # code de la fonction
    return r1, r2

a,b = exemple_fonction(1, 2, 3)   # exemple d'appel de la fonction

L’instruction return n’est pas obligatoire mais si elle est présente à un ou plusieurs endroits, aucune autre instruction de la fonction ne sera exécutée après l’exécution de la première instruction return rencontrée lors de l’exécution de la fonction. Les fonctions peuvent être récursives et inclure des paramètres par défaut : ces paramètres reçoivent une valeur même si celle-ci n’est pas précisée lors de l’appel.

def exemple_fonction(p1, p2=4, p3=7):
    # code de la fonction
    return r1, r2

a,b = exemple_fonction(1)          # = exemple_fonction(1,4,7)
a,b = exemple_fonction(1, 2, 3)    # = exemple_fonction(1,2,3)
a,b = exemple_fonction(1, 2)       # = exemple_fonction(1,2,7)
a,b = exemple_fonction(1, p3=2)    # = exemple_fonction(1,4,2)

Les paramètres par défaut doivent tous être mis en fin de déclaration, l’exemple suivant n’est pas correct :

def exemple_fonction(p1, p2=4, p3):
    # code de la fonction
    return r1, r2
# affiche le message d'erreur : SyntaxError: non-default argument follows default argument

En ce qui concerne les paramètres, les paramètres de type non modifiable sont passés par valeur (une modification à l’intérieur de la fonction n’a pas de répercution à l’extérieur).

<<<

def exemple_fonction(p1):
    p1 = 3


a = 1
exemple_fonction(a)
print(a)

>>>

    1

Les paramètres de type modifiable sont passés par référence (une modification à l’intérieur de la fonction a des répercutions à l’extérieur).

<<<

def exemple_fonction(p1):
    p1[0] = 3


a = [1]
exemple_fonction(a)
print(a)

>>>

    [3]

mot-clé lambda

Le mot-clé lambda permet de définir des fonctions au sein d’une expression.

<<<

def fonction(x):
    return x % 2


li = [3, 4, 5]
li2 = map(fonction, li)
print(list(li2))

>>>

    [1, 0, 1]

Peut-être écrit comme :

<<<

li = [3, 4, 5]
li2 = map(lambda x: x % 2, li)
print(list(li2))

>>>

    [1, 0, 1]

Et si on veut ajouter un paramètre à la fonction lambda :

<<<

li = [3, 4, 5]
k = 2
li2 = map(lambda x, y=k: x % y, li)
print(list(li2))

>>>

    [1, 0, 1]

mot-clé yield

La programmation fonctionnelle est de plus en plus utilisée. En python, elle se décline sous la forme d’itérateur.

<<<

def iterate_double_on_list(l):
    for x in l:
        yield x * 2


print(iterate_double_on_list([4, 5, 6]))

>>>

    <generator object run_python_script_139913957325120.<locals>.iterate_double_on_list at 0x7f400321e340>

La fonction itère sur un ensemble mais ne fait rien tant qu’on ne parcourt pas l’ensemble qu’elle génère :

<<<

def iterate_double_on_list(l):
    for x in l:
        yield x * 2


for x in iterate_double_on_list([4, 5, 6]):
    print(x)

>>>

    8
    10
    12

La version 3 du langage python a changé des fonctions pour qu’elle retourne un itérateur sur un ensemble et non l’ensemble lui-même.

Classes

Les classes sont un moyen de définir de nouveaux types modifiables de variables. Peu de programmes ne les utilisent pas. Une classe est un ensemble d’attributs (ou variables) et de méthodes (ou fonctions). Un programme utilisant les classes est orienté objet. Il est possible de faire les mêmes choses avec ou sans classes mais leur utilisation rend d’ordinaire les grands programmes plus facile à comprendre et à construire.

Déclaration d’une classe

Pour déclarer une classe, on procède comme suit :

<<<

class ma_classe:
    def __init__(self, att1, att2, att3):
        self.att1 = att1
        self.att2 = att2
        self.att3 = att3
        self.att4 = att1 * att2 * att3


a = ma_classe(-1, 1, 2)  # déclare une variable de type ma_classe
print(a.att1)  # affiche -1
print(a.att2)  # affiche 3
print(a.att3)  # affiche 4
print(a.att4)  # affiche -12

>>>

    -1
    1
    2
    -2

Lors de la déclaration de la variable a, le langage python exécute la méthode __init__ aussi appelée constructeur. Elle permet de définir les attributs de la classe directement à partir des paramètres ou comme le résultat d’un calcul ou d’une fonction. Le constructeur comme toutes les autres méthodes possède comme premier paramètre self qui permet d’accéder aux attributs et aux méthodes de la classe. Le programme suivant est équivalent au premier.

<<<

class ma_classe:
    def __init__(self, att1, att2, att3):
        self.att1 = att1
        self.att2 = att2
        self.att3 = att3
        self.att4 = self.calcule4()

    def calcule4(self):
        return self.att1 * self.att2 * self.att3


a = ma_classe(-1, 1, 2)  # déclare une variable de type ma_classe
print(a.att1)  # affiche -1
print(a.att2)  # affiche 3
print(a.att3)  # affiche 4
print(a.att4)  # affiche -12

>>>

    -1
    1
    2
    -2

Attributs et méthodes

Les attributs sont déclarés le plus souvent à l’intérieur du constructeur, plus généralement à l’intérieur de toute méthode, voire à l’extérieure de la classe. Pour y faire référence à l’intérieur d’une méthode on fait précéder le nom de l’attribut de self., à l’extérieur de la classe, c’est le nom de l’instance suivi d’un point . qui précède le nom de l’attribut comme le montre le précédent exemple.

Une méthode est déclarée à l’intérieur de la classe. Elle accepte invariablement au moins un paramètre qui est self comme dans le précédent exemple. Les règles d’accès sont les mêmes que pour les attributs. Elles acceptent également la récursivité et les paramètres par défaut à l’exception du premier. Chaque instance de classe est également munie d’un dictionnaire __dict__ qui recense tous les attributs.

<<<

class ma_classe:
    def __init__(self, att1, att2, att3):
        self.att1 = att1  # attribut
        self.att2 = att2  # attribut
        self.att3 = att3  # attribut
        self.att4 = att1 * att2 * att3  # attribut

    def calcule(self, x):  # méthode
        return self.att1 * self.att2 * self.att3 * x


a = ma_classe(1, 2, 3)
print(a.att1)  # affiche 1
print(a.__dict__["att1"])  # affiche aussi 1, ligne équivalente à la précédente
print(a.calcule(2))  # appel d'une méthode

>>>

    1
    1
    12

Méthodes statiques

Les méthodes statiques sont comme des fonctions : elle ne nécessite pas d’instance d’un object pour être appelée.

<<<

class ma_classe:
    def __init__(self, att1, att2, att3):
        # ...
        pass

    @staticmethod
    def calcule_static(x, y):  # méthode statique
        return x * y


print(ma_classe.calcule_static(2, 3))  # appel d'une méthode statique

>>>

    6

Opérateurs

Les opérateurs sont des méthodes qui permettent une manipulation plus simple des objets. Leur nom est fixé par convention par le langage python, ils commencent et terminent par __.

class ma_classe :
    def __init__ (self, att1, att2, att3) :
        self.att1 = att1
        self.att2 = att2
        self.att3 = att3
        self.att4 = att1 * att2 * att3

    def __add__ (self, a) :
         return ma_classe (self.att1 + a.att1, self.att2 + a.att2,
                           self.att3 + a.att3, self.att4 + a.att4)

a = ma_classe (1,2,3)
b = ma_classe (4,5,6)
c = a + b              # n'a de sens que si l'opérateur __add__ a été redéfini

Il existe un opérateur spécifique pour chaque opération, cet opérateur permet de donner un sens à une addition, une soustraction, …, de deux instances d’une classe. L’opérateur __str__ retourne une chaîne de caractères et est appelé par l’instruction print. L’opérateur __cmp__ retourne un entier permettant à des instances de la classe d’être comparées et triées par une liste.

Copie d’instances

Les instances de classes sont des objets modifiables, comme pour les listes, une simple affectation ne signifie pas une copie mais un second nom pour désigner le même objet.

<<<

class ma_classe:
    def __init__(self, att1, att2, att3):
        self.att1 = att1
        self.att2 = att2
        self.att3 = att3
        self.att4 = att1 * att2 * att3


a = ma_classe(1, 2, 3)
b = a
b.att1 = -16
print(a.att1)  # affiche -16
print(b.att1)  # affiche -16

>>>

    -16
    -16

Il faut donc copier explicitement l’instance pour obtenir le résultat souhaité.

<<<

class ma_classe:
    def __init__(self, att1, att2, att3):
        self.att1 = att1
        self.att2 = att2
        self.att3 = att3
        self.att4 = att1 * att2 * att3


a = ma_classe(1, 2, 3)
import copy

b = copy.copy(a)
b.att1 = -16
print(a.att1)  # affiche 1
print(b.att1)  # affiche -16

>>>

    1
    -16

Lorsque une classe inclut une variable de type classe, il faut utiliser la fonction deepcopy et non copy.

Héritage

L’héritage est l’intérêt majeur des classes et de la programmation orientée objet. Lorsqu’une classe hérite d’une autre, elle hérite de ses attributs et de ses méthodes. Le simple fait d’hériter crée donc une classe équivalente.

class ma_classe :
    def __init__ (self, att1, att2, att3) :
        self.att1 = att1
        self.att2 = att2
        self.att3 = att3
        self.att4 = att1 * att2 * att3

class ma_classe2 (ma_classe) :      # héritage simple
    pass                            # pour dire que la classe est vide

Mais hériter permet de faire deux choses :

  1. ajouter des attributs et ajouter des méthodes

  2. modifier le comportement d’une méthode existante

<<<

class ma_classe:
    def __init__(self, att1):
        self.att1 = att1
        self.att2 = self.calcul()

    def calcul(self):
        return self.att1**2


class ma_classe2(ma_classe):
    def calcul(self):
        # dans cette méthode, on change le comportement
        # de la méthode calcul tout en se servant de celui
        # de la classe mère
        return ma_classe.calcul(self) * self.att1


a = ma_classe(2)
b = ma_classe2(2)
print(a.att2)  # affiche 4 = 2 * 2
print(b.att2)  # affiche 8 = (2*2) * 2

>>>

    4
    8

Décorateur

Le langage python permet quelques simplifications de code avec les décorateurs comme dans l’exemple suivant :

<<<

def makebold(fn):
    def wrapped():
        return "<b>" + fn() + "</b>"

    return wrapped


def makeitalic(fn):
    def wrapped():
        return "<i>" + fn() + "</i>"

    return wrapped


@makebold
@makeitalic
def hello():
    return "hello world"


print(hello())  ## returns <b><i>hello world</i></b>

>>>

    <b><i>hello world</i></b>

Il est possible aussi de définir des propriétés ou properties. Cela permet de séparer l’affectation de l’accès à un membre d’une classe sans changer la notation :

<<<

class C(object):
    def __init__(self):
        self._p = 1

    @property
    def p(self):
        return self._p

    @p.setter
    def p(self, val):
        self._p = val * 2


obj = C()
print(obj.p)  # utilise p_get, affiche 1
obj.p = 5  # utilise p_set
print(obj.p)  # utilise p_get affiche 10

>>>

    1
    10

Fichiers

L’écriture et la lecture dans un fichier s’effectuent toujours de la même manière. On ouvre le fichier en mode écriture ou lecture, on écrit ou on lit, puis on ferme le fichier, le laissant disponible pour une utilisation ultérieure. Ce paragraphe ne présente pas l’écriture ou la lecture dans un format binaire car celle-ci est peu utilisée dans ce langage.

Ecriture dans un fichier texte

L’écriture dans un fichier texte s’effectue toujours selon le même schéma :

f = open ("nom-fichier", "w") # ouverture en mode écriture "w" ou écriture ajout "a"

f.write (  s )                # écriture de la chaîne de caractères  s
f.write (  s2 )               # écriture de la chaîne de caractères  s2
...

f.close ()  # fermeture

Certains codes sont fort utiles lors de l’écriture de fichiers texte :

  • \n : passage à la ligne \

  • \t : insertion d’une tabulation, indique un passage à la colonne suivante dans le logiciel Excel

Version 3.x : une autre écriture est possible qui permet d’éviter l’appel à la méthode close.

with open ("nom-fichier", "w") as f :
    f.write (  s )
    f.write (  s2 )

L’usage d’un encoding est fréquent lorsqu’on manipule des fichiers issus d’Internet. Le plus répandu est utf8. Il est spécifié en-tête des pages web téléchargées. L’exemple qui suit n’est valable qu’avec la version 3. Il est recommandé de l’utiliser dès qu’on manipule les encodings.

with open ("nom-fichier", "w", encoding = "utf8") as f :
    f.write (  s )
    f.write (  s2 )

Lecture dans un fichier texte

La lecture est le symétrique de l’écriture. En voici un exemple, la seule chose qui change d’un programme à l’autre est ce qu’on fait des lignes extraites.

f = open ("essai.txt", "r")   # ouverture du fichier en mode lecture
l = f.readlines ()            # lecture de toutes les lignes,
                              #   elles sont placées dans une liste
f.close ()                    # fermeture du fichier

for s in l : print (s)        # on affiche les lignes à l'écran

Version 3.x : la même syntaxe avec le mot-clé with et l’encoding existe.

Lors le programme précédent lit une ligne dans un fichier, le résultat lu inclut le ou les caractères (\backslash n \; \backslash r qui marquent la fin d’une ligne. C’est pour cela que la lecture est parfois suivie d’une étape de nettoyage.

with open ("essai.txt", "r") as f:  # ouverture du fichier en mode lecture
    l = f.readlines ()              # lecture de toutes les lignes,
                                    # elles sont placées dans une liste placées dans une liste

l_net = []                      # contiendra la liste nettoyée des lignes du fichier
for s in l :
    s2 = s.replace ("\n", "")   # on supprime le code de fin de ligne \n
    s2 = s2.replace ("\r", "")  # on supprime le code de fin de ligne \r
                                #                   (Windows uniquement)
      s2 = s2.strip("\r\n")       # cette ligne est équivalente aux deux précédentes
    l_net.append (s2)           # on ajoute le résultat à la liste nettoyée

Les fichiers textes ont de nombreux formats, on peut citer HTML ou XML qui sont des formats à balises. Leur lecture utilise des modules comme HTMLParser ou xml.sax dont la description sort du cadre de ce document. Un autre format est souvent utilisé avec le logiciel Excel. Lorsqu’on enregistre une feuille de calcul sous format texte, le fichier obtenu est organisé en colonnes : sur une même ligne, les informations sont disposées en colonnes délimitées par un séparateur qui est souvent une tabulation (\t) ou un point virgule.

nom  ; prénom ; livre
Hugo  ; Victor  ; Les misérables
Kessel ; Joseph  ; Le lion
Woolf ; Virginia  ; Mrs Dalloway
Calvino ; Italo  ; Le baron perché

Pour lire ce fichier, il est nécessaire de scinder chaque ligne en une liste de chaînes de caractères. On utilise pour cela la méthode split des chaînes de caractères.

with open ("essai.txt", "r") as f:  # ouverture du fichier en mode lecture
    l = f.readlines ()              # lecture de toutes les lignes, placées dans une liste

for s in l :
    s2 = s.replace ("\n", "")   # on supprime le code de fin de ligne \n
    s2 = s2.replace ("\r", "")  # on supprime le code de fin de ligne \r (Windows uniquement)
    case = s2.split (";")
    if len (case) >= 3 :
        print (case [1], " ", case [0], " a écrit ", case [2])

Modules

Le concept de module permet de répartir différentes parties d’un programme sur plusieurs fichiers. Il existe deux types de modules : ceux disponibles sur Internet (programmés par d’autres) et ceux que l’on programme soi-même. Les premiers sont souvent fournis avec un programme d’installation automatique ou dans le cas où ils sont manquants, des instructions permettant de l’installer. Les seconds sont écrits dans le même répertoire que le fichier principal. On enregistre le module suivant sous le nom geometrie.py.

# définition du module geometrie.py

def carre (x) :
    return x ** 2

class point :
    def __init__ (self,x,y) :
        self.x, self.y = x,y

    def norme (self) :
        return (self.x ** 2 + self.y ** 2) ** 0.5

Pour utiliser une fonction ou une classe du module geometrie.py, on utilise une des syntaxes suivantes :

  • Première syntaxe :

    import geometrie
    print (geometrie.carre (1.5))
    p = geometrie.point (1,2)
    
  • Deuxième syntaxe :

    import geometrie as GEO  # on donne un pseudonyme au module geometrie
    print (GEO.carre (1.5))
    p = GEO.point (1,2)
    
  • Troisième syntaxe : le module est utilisé très souvent, même un pseudonyme est trop long, il faut néanmoins s’assurer que les modules importés de cette même manière n’incluent pas des fonctions ou classes portant des noms identiques. Dans ce cas, c’est toujours le dernier qui gagne.

    from  geometrie import *
    print (carre (1.5))
    p = point (1,2)
    

Dans le cas des modules installés, les trois syntaxes d’utilisation sont aussi valables. On voit aussi souvent apparaître dans un module la condition :

if __name__ == "__main__" :
    # quelques instructions ici

Ces instructions ne sont exécutées que si le module est utilisé en tant que programme principal. Lorsque ce fichier est importé, elles ne sont jamais exécutées. Cela permet d’écrire des instructions qui permettent de vérifier si le module ne contient pas d’erreurs. Une fois cette étape effectuée, il ne sert à rien de la répéter à chaque fois que le module est importé. C’est pourquoi elles ne sont exécutées que si la condition if __name__ == "__main__" : est vérifiée, c’est-à-dire si le module est le programme principal et non un module.

Exceptions

Le petit programme suivant déclenche une erreur parce qu’il effectue une division par zéro.

def inverse (x):
    y = 1.0 / x
    return y
b = inverse (0)
print (b)

Il déclenche une erreur ou ce qu’on appelle une exception.

Traceback (most recent call last):
  File "cours.py", line 2, in ?
    y = 1.0 / x
ZeroDivisionError: float division

Le mécanisme des exceptions permet au programme de « rattraper » les erreurs, de détecter qu’une erreur s’est produite et d’agir en conséquence afin que le programme ne s’arrête pas :

<<<

def inverse(x):
    y = 1.0 / x
    return y


try:
    b = inverse(0)  # déclenche une exception
    print(b)
except:
    print("le programme a déclenché une erreur")

>>>

    le programme a déclenché une erreur

On protège la partie du code à l’aide des mots-clés try et except. Entre ces deux instructions, s’il se produit une erreur, le programme passe immédiatement à ce qui suit l’instruction except. On peut même récupérer le message d’erreur correspondant :

<<<

def inverse(x):
    y = 1.0 / x
    return y


try:
    print(inverse(2))
    print(inverse(0))
except Exception as exc:
    print("exception de type ", exc.__class__)
    # affiche exception de type  exceptions.ZeroDivisionError
    print("message ", exc)
    # affiche le message associé à l'exception

>>>

    0.5
    exception de type  <class 'ZeroDivisionError'>
    message  float division by zero

On peut aussi décider que le programme agira différemment selon l’erreur produite. Dans l’exemple suivant, le programme teste d’abord si l’erreur est de type ZeroDivisionError auquel cas il affiche le message division par zéro. Pour un autre type d’erreur, il regarde s’il y a d’autres instructions except qui s’y rapportent. S’il y en a une, il exécute les lignes qui la suivent, sinon, le programme s’arrête et déclenche une erreur.

def inverse (x):
    y = 1.0 / x
    return y
try :
    print ((-2.1) ** 3.1)
    print (inverse (2))
    print (inverse (0))
except ZeroDivisionError:
    print ("division par zéro")
except Exception as exc:
    print ("erreur insoupçonnée : ", exc.__class__)
    print ("message ", exc)

Les instructions try et except peuvent apparaître dans le programme principal, dans une boucle, un test, une fonction, s’imbriquer les unes dans les autres. Il est possible de déclencher soi-même une exception avec l’instruction raise et ou de définir ses propres exceptions en créant une classe héritant d’une classe d’exception. L’exemple suivant regroupe tous ces cas.

<<<

class AucunChiffre(Exception):
    """chaîne de caractères contenant
    aussi autre chose que des chiffres"""

    def __init__(self, s, f=""):
        Exception.__init__(self, s)
        self.s = s
        self.f = f

    def __str__(self):
        return (
            f"exception AucunChiffre, lancée depuis la fonction {self.f} "
            f"avec le paramètre {self.s}"
        )


def conversion(s):
    """conversion d'une chaîne de caractères en entier"""
    if not s.isdigit():
        raise AucunChiffre, (s, "conversion")
    return int(s)


try:
    s = "123a"
    i = conversion(s)
    print(s, " = ", i)
except AucunChiffre as exc:
    print(AucunChiffre.__doc__, " : ", exc)
    print("fonction : ", exc.f)

>>>

    
    [runpythonerror]
    File "<stdin>", line 23
        raise AucunChiffre, (s, "conversion")
                          ^
    SyntaxError: invalid syntax

Erreurs, confusions fréquentes

Variables

Chaîne de caractères = tableau de caractères

Une chaîne de caractères est un tableau de caractères : pour accéder à un caractère, on procède comme pour une liste.

<<<

s = "abcdefghijklmnopqrstuvwxyz"
print(s[4])  # affiche "e"
print(s[4:6])  # affiche "ef"

>>>

    e
    ef

Guillemets ou pas

Doit-on mettre des guillemets ou non ?

l  = [ un, deux, trois, quatre ]
up = []
for i in range (0, len (l)) :
    up.append ( l [i].upper () )

Le code précédent ne fonctionne pas car il n’y a pas de guillemets autour de un, deux, trois, quatre. Le langage considère alors ces quatre mots comme des variables : un identificateur qui désigne une information. Mais comme ces variables n’existent pas, ces identifiants ne sont reliés à aucun contenu et l’interpréteur python ne comprend pas.

Un mot entouré de guillemets (ou d’apostrophes) définit un contenu. Sans guillemet (ou apostrophe), il définit une variable qui permet de manipuler un contenu tout simplement en donnant la possibilité au programmeur de le nommer. Autrement dit, pour manipuler une chaîne de caractères, il faut affecter ce contenu à une variable. Les guillemets n’apparaissent plus par la suite car on doit utiliser la variable pour la manipuler.

Boucles

range ou pas range

Les deux programmes suivant sont équivalents. La seule différence réside dans l’écriture dans la boucle for qui utilise dans le premier cas la fonction range et dans l’autre non.

l  = [ "un", "deux", "trois", "quatre" ]
up = []
for i in range (0, len(l)) :
    up.append ( l [i].upper() )

Lorsqu’on utilise la fonction range, on dispose lors de la boucle de deux informations, l’indice i et l’élément l [i]. Si l’indice n’est pas utile, il est possible de simplifier la boucle comme suit.

l  = [ "un", "deux", "trois", "quatre" ]
up = []
for m in l :
    up.append ( m.upper() )

En général, on se sert de la boucle qui utilise la fonction range dans deux cas :

  1. On souhaite faire des opérations sur les éléments qui précèdent ou suivent l’élément en question, ce qui nécessite de connaître l’indice.

  2. On parcourt deux listes de même taille à la fois : l’indice désigne la position de deux éléments, un dans chaque liste.

Initialisation

Une boucle est souvent utilisée pour faire une somme, calculer un maximum : garder un unique résultat en parcourant une liste. Une boucle de ce type est toujours précédée d’une étape d’initialisation qui consiste à donner une valeur au résultat : celle qu’il aurait si la liste était vide.

l = [ "un", "deux", "trois", "quatre" ]
s = ""
for m in l :
    s += m # concaténation des mots en une seule chaîne de caractères

Différence entre print et return

A la fin d’un calcul, afin de voir son résultat, on utilise souvent l’instruction print. On peut se demander alors si à la fin de chaque fonction, il ne faudrait pas utiliser l’instruction print. A quoi servirait alors l’instruction return ? On suppose qu’un calcul est en fait le résultat de trois calculs à la suite :

a = calcul1 (3)
b = calcul2 (a)
c = calcul3 (b) # c résultat souhaité et affiché

Chaque terme calculx cache une fonction or seul le résultat de la dernière nous intéresse et doit être affiché. Pour les deux premières, la seule chose importante est que leur résultat soit transmis à la fonction suivante et ceci ne peut se faire que grâce à l’instruction return. L’instruction print insérée dans le code de la fonction calcul1 ou calcul2 permettra d’afficher le résultat mais ne le transmettra pas : l’instruction return est donc indispensable, print facultative.

En revanche, dans la dernière fonction calcul3, il est possible de se passer de return et de se contenter uniquement d’un print. Cependant, il est conseillé d’utiliser quand même return au cas où le résultat de la fonction calcul3 serait utilisé par une autre fonction, calcul4 par exemple.

<<<

def calcul1(x):
    return x + 3


y = calcul1(4)
print(y)  # affiche None
# car la fonction calcul1 ne retourne pas de résultat, elle l'affiche

>>>

    7

Cela peut provoquer des erreurs lorsqu’on essaye d’utiliser ce résultat dans un calcul par la suite.

def calcul1(x):
    print (x+3)
def calcul2(x):
    return calcul1(x) + 5
y = calcul2(4)     # affiche l'erreur
ported operand type(s) for +: 'NoneType' and 'int'

Il faut retenir que l’instruction print n’a aucun impact sur le résultat d’un programme.

Trois conseils pour écrire un programme

Des petites fonctions

Pour plusieurs raisons :

  1. Il est plus facile de corriger un programme qui est constitué de petites fonctions plutôt que de quelques grandes. Chaque fonction peut être vérifiée séparément.

  2. Il est plus facile de réutiliser des petites fonctions.

  3. Il est plus facile de répartir le travail sur plusieurs personnes.

Il vaut mieux éviter les variables globales qui sont considérées que comme des paramètres cachés.

Séparer les calculs, le chargement des données, l’interface graphique

Pour plusieurs raisons :

  1. Il est plus facile de vérifier un calcul s’il est dans une fonction indépendante plutôt que caché dans le code d’une interface graphique.

  2. C’est facile de faire un calcul une fois lorsqu’un utilisateur appuie sur un bouton, si on veut faire ce calcul cent fois, on ne peut pas lui demander d’appuyer cent fois sur le même bouton.

  3. Les calculs ou le chargement des données peuvent être utilisés dans d’autres programmes.

Utiliser des tests unitaires

Ces fonctions peuvent être exécutées au début du programme pour vérifier que certaines parties du programme fonctionnent toujours même après les avoir modifiées.

L’exemple suivant considère une fonction qui doit retourner une somme réelle même si les éléments de la liste sont entiers. On écrit la fonction qui vérifie cela.

def somme_double(liste):
    return 1.0 * sum(liste)

def test_somme_double():
    y = somme_double([ 1 ]) / 2
    if y == 0:
        raise AssertionError("valeur > 0 attendue")

if __name__ == "__main__" :
    test_somme_double()

Si plus tard, quelqu’un modifie la fonction somme_double en enlevant la multiplication parce qu’il considère cela inutile. La fonction de test provoquera une erreur. Elle est là pour rappeler que la fonction a été programmée pour retourner un nombre réel et que quiconque l’utilise s’attend à ce qu’elle retourne ce type de résultat.

Traceback (most recent call last):
  File "conseil.py", line 10, in <module>
    test_somme_double()
  File "conseil.py", line 7, in test_somme_double
    if y == 0:
        raise AssertionError("valeur > 0 attendue")
Exception: valeur > 0 attendue

Trucs et astuces

Partager du code

Il existe aujourd’hui des solutions qui permettent d’éviter les envois de programme par email. Des outil comme DropBox, SkyDrive, GoogleDrive permettent de partager un répertoire. Un même répertoire peut être partagé sur plusieurs ordinateurs et plusieurs personnes. Une modification (y compris une suppression) sur l’une des répliques sera propagée sur tous les ordinateurs dès qu’ils sont connectés à Internet.

Il est possible de coupler cette solution avec SVN ou TortoiseSVN qui sont des logiciels de suivis de source. On garde à la fois la dernière version et l’historique des modifications.

Moteurs de recherche

Lorsqu’on ne comprend un message d’erreur, il est souvent utile de recopier le texte dans un moteur de recherche (Google, Bing, …). Il est très rare de ne pas réussir à trouver d’indices.