Déclaration, indentation et commentaries en Python

Les instructions écrites dans le code source pour l’exécution sont appelées instructions. Il existe différents types d’instructions dans le langage de programmation Python, telles que les instructions d’affectation, les instructions conditionnelles, les instructions de boucle, etc. Elles aident toutes l’utilisateur à obtenir la sortie requise.

Par exemple :

n = 50 est une instruction d’affectation.

Les Instructions multilignes : les instructions en Python peuvent être étendues à une ou plusieurs lignes à l’aide de parenthèses (), d’accolades {}, de crochets [], de point-virgule (;), de caractère de continuation slash ().

Lorsque le programmeur a besoin de faire de longs calculs et ne peut pas tenir ses déclarations sur une seule ligne, on peut utiliser ces caractères.

Exemple

Déclaré à l'aide du caractère de continuation (\) :
s = 1 + 2 + 3 + \
     4 + 3 +3 

Déclaré entre parenthèses () :
chiffres = (1 * 2 * 3 + 7 + 8 + 9)

Déclaré entre crochets [] :
footballeur = ['BMW',
           'AUDI',
           'GOLF']

Déclaré à l'aide d'accolades {} :
x = {9 + 4 + 3 + 7 + 1 + 6 + 7 + 8 + 2}

Déclaré en utilisant des points-virgules (;) :
epee = 2; baton = 3 ; arc = 1

L’indentation

Un bloc est une combinaison de toutes ces instructions. Le bloc peut être considéré comme le regroupement d’instructions dans un but précis. La plupart des langages de programmation comme C, C++, Java utilisent des accolades { } pour définir un bloc de code. L’une des caractéristiques distinctives de Python est son utilisation de l’indentation pour mettre en évidence les blocs de code. L’espace blanc est utilisé pour l’indentation en Python. Toutes les instructions avec la même distance vers la droite appartiennent au même bloc de code. Si un bloc doit être plus profondément imbriqué, il est simplement en retrait plus à droite. Vous pouvez mieux le comprendre en regardant les lignes de code suivantes :

# indentation en Python
 
test = 'aaa'
 
if test== 'aaa':
    print('Je suis connecté')
else:
    print('Retapper')
print('Ok !')

Les lignes print(‘Je suis connecté’) et print(‘Retapper.’) sont deux blocs de code distincts. Les deux blocs de code de notre exemple d’instruction if sont tous deux indentés de quatre espaces. L’impression finale (‘Ok !’) n’est pas en retrait et n’appartient donc pas au bloc else.

L’indentation de la boucle

j = 1
while(j<= 10):
     print(j)
     j = j + 1

Résultat

1
2
3
4
5
6
7
8
9
10

Pour indiquer un bloc de code en Python, vous devez indenter chaque ligne du bloc du même espace. Les deux lignes de code de la boucle while sont toutes deux en retrait de quatre espaces. Il est nécessaire pour indiquer à quel bloc de code appartient une instruction. Par exemple, j=1 et while(j<=10) : n’est pas indenté et ne se trouve donc pas dans le bloc while. Ainsi, le code Python structure par indentation.

Les commentaires en Python

Les développeurs Python utilisent souvent le système de commentaires car, sans l’utiliser, les choses peuvent devenir très déroutantes, très rapidement.

Les commentaires sont les informations utiles que les développeurs fournissent pour faire comprendre au lecteur le code source. Il explique la logique ou une partie de celle-ci utilisée dans le code.

Les commentaires sont généralement utiles à quelqu’un qui maintient ou améliore votre code lorsque vous n’êtes plus là pour répondre à des questions à ce sujet. Celles-ci sont souvent citées comme une convention de programmation utile qui ne participe pas à la sortie du programme mais améliore la lisibilité de l’ensemble du programme.

Il existe deux types de commentaires en Python :

Commentaires sur une seule ligne : le commentaire sur une seule ligne Python commence par un symbole de hashtag sans espaces blancs (#) et dure jusqu’à la fin de la ligne. Si le commentaire dépasse une ligne, placez un hashtag sur la ligne suivante et continuez le commentaire. Les commentaires sur une seule ligne de Python se sont avérés utiles pour fournir de brèves explications sur les variables, les déclarations de fonctions et les expressions. Voir l’extrait de code suivant illustrant le commentaire sur une seule ligne :

Exemple 1 :

# Ceci est un commentaire
# Ceci est un deuxième commentaire
print("Mon code affiché")

Exemple 2 :

a, b = 1, 3 # Déclaration de 2 variables
sum = a + b # Addition de 2 integer
print(sum) # Mon résulat output

Le commentaire multiligne en Python

Le commentaire multiligne Python est un morceau de texte entouré d’un délimiteur («  » ») à chaque extrémité du commentaire. Encore une fois, il ne devrait pas y avoir d’espace blanc entre les délimiteurs («  » »). Ils sont utiles lorsque le texte du commentaire ne tient pas sur une seule ligne ; doivent donc s’étendre sur plusieurs lignes. Les commentaires ou paragraphes sur plusieurs lignes servent de documentation pour les autres lecteurs de votre code. Voir l’extrait de code suivant illustrant le commentaire multiligne :

"""
Ceci est un commentaire en mutligne
je peux écrire à l'infini à l'intérieur pour donner des 
Explication dans mon code afin que mes cher collegues développeurs
Puisse comprendre mon code :))
"""
print("Bonjour")
'''Cela fonctionne 
Aussi de cette manière'''
 
print("Bonjour")