5.7.1 ConfigParser Objects

Les instances de ConfigParser possèdent les méthodes suivantes:

defaults()

Retourne un dictionnaire qui contient les valeurs par défaut applicables à l'instance.

sections()

Retourne une liste des sections disponibles; DEFAULT n'est pas inclus dans la liste.

add_section(section)

Ajoute une section appelée section à l'instance. Si une section du même nom existe déjà, DuplicateSectionError est déclenchée.

has_section(section)

Indique si la section est présente dans la configuration. La section DEFAULT n'est pas reconnue.

options(section)

Retourne une liste des options disponibles dans la section spécifiée.

has_option(section, option)

Si la section indiquée existe, et contient l'option donnée, retourne 1; sinon retourne 0. (Nouveau en 1.6)

read(nomsfichiers)

Lit et interprète une liste de noms de fichiers. Si nomsfichiers est une chaîne de caractères ou une chaîne Unicode, elle est traitée comme un nom de fichier unique.

readfp(fp[, nomfichier])

Lit et interprète des données de configuration depuis le fichier ou l'objet de type fichier dans fp (seule la méthode readline() est utilisée). Si nomfichier est omis et que fp possède un attribut name, celui-ci est utilisé à la place de nomfichier; la valeur par défaut est "<???>".

get(section, option[, brut[, vars]])

Lit une valeur option depuis la section indiquée. Toutes les interpolations par "%" sont réalisées dans les valeurs de retour, en se basant sur les valeurs par défaut passées au constructeur, ainsi que les options vars fournies, à moins que l'argument brut ne soit vrai.

getint(section, option)

Une méthode pratique qui convertit l'option de la section spécifiée en un entier.

getfloat(section, option)

Une méthode pratique qui convertit l'option de la section spécifiée en un nombre à virgule flottante.

getboolean(section, option)

Une méthode pratique qui convertit l'option de la section spécifiée en un booléen. Notez que les seules valeurs acceptées pour l'option sont "0" et "1", toutes les autres valeurs déclencheront ValueError.

set(section, option, valeur)

Si la section donnée existe, affecte la valeur spécifiée à l'option; sinon, déclenche NoSectionError. (Nouveau en 1.6)

write(objetfichier)

Ecrit une représentation de la configuration dans l'objet fichier spécifié. Cette représentation pourra être interprétée par un appel ultérieur à read(). (Nouveau en 1.6)

remove_option(section, option)

Enlève l'option spécifiée de la section. Si la section n'existe pas, déclenche NoSectionError. Si l'option à enlever existait, retourne 1; sinon retourne 0. (Nouveau en 1.6)

remove_section(section)

Enlève la section spécifiée de la configuration. Si la section existait, retourne 1. Sinon retourne 0.