Écrire du bon code

Écrire du code lisible

Techniquement, Python nous permet d’écrire du code comme ceci.

a=5;b=3;c=8;d=(a+b)/c;print("Yin" if d==5 else "Yang")

Yang

Cependant, pour la lisibilité, il est recommandé d’écrire les instructions individuelles sur des lignes séparées. Ajoutez également des lignes vides entre les sections et introduisez des commentaires pour expliquer pourquoi les choses sont faites.

# initialize program
a=5
b=3
c=8

# compute result before we can evaluate it
d=(a+b)/c

Si vous travaillez avec des notebooks Jupyter, affichez les résultats intermédiaires pour permettre au lecteur de voir ce qui se passe.

d

1.0

Pensez à mettre des espaces entre les variables, les opérateurs et les nombres, car c’est plus facile àlirequecela,n’est-cepas?

d = (a + b) / c
d

1.0

Certaines personnes sont d’accord avec de telles déclarations courtes :

print("Yin" if d==5 else "Yang")

Yang

D’autres préfèrent écrire le code de manière plus détaillée.

if d == 5:
    print("Yin")
else:
    print("Yang")

Yang