La classe ConfigParser implémente un langage basique de fichier
de configuration qui fournit une structure similaire à celle que vous
trouveriez dans les fichiers INI de Microsoft Windows. Vous pouvez
utiliser cette classe pour écrire des programmes Python qui peuvent être
adaptés facilement aux besoins des utilisateurs finaux.
Le fichier de configuration consiste en sections, qui commencent par
un en-tête "[section]" et se poursuivent par des couples
"nom: valeur", avec les règles de continuation définies dans
RFC 822; "nom=valeur" est également accepté.
Notez que les espaces de début sont enlevés des valeurs.
Les valeurs optionnelles peuvent contenir des chaînes de formattage
qui se réfèrent à d'autres valeurs de la même section, ou à des valeurs
qui se trouvent dans une section spéciale, DEFAULT. Des valeurs
par défaut supplémentaires peuvent être fournies au moment de
l'initialisation et de l'extraction. Les lignes qui commencent
par "#" ou ";" sont ignorées et peuvent être
utilisées pour fournir des commentaires.
Par exemple:
reptruc: %(dir)s/quoidonc
dir=machin
remplacerait "%(dir)s" par la valeur de
"dir" ("machin" dans cet exemple). Toutes les expansions de
références sont faites à la demande.
Des valeurs par défaut peuvent être spécifiées en les passant au
constructeur de ConfigParser sous forme de dictionnaire. D'autres
valeurs par défaut pourront être passées à la méthode get()
qui écrasera toutes les autres.
- ConfigParser([defauts])
-
Retourne une nouvelle instance de la classe ConfigParser. Si
defauts est fourni, il sert à initialiser le dictionnaire des
valeurs par défaut intrinsèques. Les clés doivent être des chaînes de
caractères, et les valeurs doivent être acceptables pour l'interpolation
de chaînes par "%()s". Notez que __name__ est une valeur
par défaut intrinsèque; sa valeur est le nom de la section, et écrasera
toute valeur fournie dans defauts.
NoSectionError-
Exception déclenchée quand une section spécifiée n'est pas trouvée.
DuplicateSectionError-
Exception déclenchée quand plusieurs sections de même nom sont
trouvées, ou si add_section() est appelé avec un nom de
section déjà présent.
NoOptionError-
Exception déclenchée quand une option spécifiée n'est pas trouvée dans
la section spécifiée.
InterpolationError-
Exception déclenchée quand des problèmes se produisent dans
l'interpolation de chaînes de caractères.
InterpolationDepthError-
Exception déclenchée quand l'interpolation ne peut pas aboutir parce
que le nombre d'itérations dépasse MAX_INTERPOLATION_DEPTH.
MissingSectionHeaderError-
Exception déclenchée quand on essaie d'interpréter un fichier qui n'a pas
d'en-tête de section.
ParsingError-
Exception déclenchée quand des erreurs se produisent en essayant
d'interpréter un fichier.
MAX_INTERPOLATION_DEPTH-
La profondeur maximum pour l'interpolation récursive pour get()
quand le paramètre raw est faux. Affecter une valeur à cette donnée
ne change pas la profondeur de récursion autorisée.
Voir aussi:
- Module shlex:
- Support pour créer des mini-langages du type
shell Unix qui peuvent être utilisés comme format
alternatif pour des fichiers de configuration
d'applications.
Sous-sections
- ConfigParser Objects
