Nov 23, 2024

Wiki

Python

Aide

edit SideBar

Search

Conventions De Nommage


Les conventions suivantes, concernant les noms des fonctions, des variables, etc. n'ont rien d'obligatoires : ce sont des recommandations, qui sont suivies par bon nombre de programmeurs Python. Elles forment un tout cohérent, qu'il est bon de suivre.

Variables, constantes et arguments

Les variables

Une variable doit avoir un nom court, en minuscule.

  • Si un simple mot ne suffit pas,
    • mettre un _ entre les mots,
    • et ne pas mettre de majuscule par la suite.
On parle alors de convention lower_case.
  • Si la variable contient un booléen, la nommer avec is_ ou has_ (si l'on utilise des noms anglais), ou avec est_ en français :
  >>> is_empty = True
  • Si la variable contient une liste ou un tuple, mettre son nom au pluriel.

>>> acceleration_gravitationnelle = 9.81 >>> couleurs = ['vert', 'rouge', 'bleu']

Les constantes

Les constantes suivent les mêmes conventions de nommage que les variables, à ceci près qu'elles doivent être toute en majuscule :

  >>> INVERSE_PI = 0.3183098

Les arguments

Les arguments des méthodes et des fonctions suivent les mêmes conventions que les variables.

Modules

Un module est écrit en minuscule : toto.py.

Il est suffixé de lib s'il réalise l'implémentation d'un protocole : smtplib.py...

Les classes

Elles s'écrivent avec un ou plusieurs mots concaténés, dont chaque première lettre est en majuscule : TemplateFile...

Fonctions et méthodes

Les fonctions suivent la convention lower_case, quand les méthodes sont écrites en mixedCase. On utilise, de plus, is, has ou est en préfixe si le retour est un booléen, et on met au pluriel si le retour est une liste ou un tuple.

Enfin, la concaténation NomClasse.nomMethode doit être complémentaire, et non redondante : MyList.get() plutôt que MyList.getList()...

Page Actions

Recent Changes

Group & Page

Back Links