Comprendre les instructions, l’indentation et les commentaires en Python

Ce tutoriel fournit une compréhension fondamentale des instructions, de l’indentation et des commentaires Python – éléments cruciaux pour écrire un code propre, efficace et maintenable.

Table des matières

1. Instructions Python
2. Indentation Python
3. Commentaires Python

Instructions Python

En Python, une instruction est une instruction unique exécutée par l’interpréteur. Bien qu’occupant généralement une seule ligne, les longues instructions peuvent s’étendre sur plusieurs lignes à l’aide de la continuation de ligne (barres obliques inversées ou parenthèses ()). Les instructions englobent les affectations, les appels de fonctions, les boucles et les instructions conditionnelles.

Exemples :

• Affectation : x = 10 (affecte 10 à x)
• Appel de fonction : print("Bonjour !")
• Instruction conditionnelle :

  
  if x > 5 :
      print("x est supérieur à 5")
  else :
      print("x n'est pas supérieur à 5")
  

• Instruction de boucle :

  
  for i in range(5) :
      print(i)
  

Indentation Python

Contrairement aux langages utilisant des accolades {} pour définir des blocs de code, Python utilise l’indentation. Cela détermine le groupement des instructions dans les blocs (if, else, for, while, fonctions, classes). Une indentation cohérente est obligatoire ; les incohérences provoquent une IndentationError.

Indentation correcte :

if x > 5 :
    print("x est supérieur à 5")
    y = x * 2
else :
    print("x n'est pas supérieur à 5")

Indentation incorrecte :

if x > 5 :
print("x est supérieur à 5")  # IndentationError
y = x * 2
else :
print("x n'est pas supérieur à 5") # IndentationError

Utilisez 4 espaces pour l’indentation ; évitez les tabulations.

Commentaires Python

Les commentaires sont des notes explicatives ignorées par l’interpréteur. Ils améliorent la lisibilité et la compréhension du code. Python propose deux types :

• Commentaires sur une seule ligne : Commencent par #. Tout ce qui suit # sur la même ligne est un commentaire.
• Commentaires sur plusieurs lignes (docstrings) : Enfermés entre trois guillemets (''' ou """). Fréquemment utilisés pour documenter les fonctions, les classes et les modules.

Exemples :

x = 10  # Commentaire sur une seule ligne

'''
Ceci est un
commentaire sur plusieurs lignes.
'''

def ma_fonction() :
    """Ceci est une docstring."""
    pass

Une bonne utilisation des commentaires est cruciale pour un code propre et maintenable. Gardez les commentaires concis et pertinents ; évitez les explications redondantes.