Rédiger une docstring
Vous avez décidé de créer le meilleur progiciel Python libre au monde pour le traitement du langage naturel. Il va révolutionner le travail avec du texte libre, comme numpy l'a fait pour les tableaux, pandas pour les données tabulaires et scikit-learn pour le machine learning.
La première fonction que vous écrivez est count_letter(). Elle reçoit une chaîne de caractères et une seule lettre, puis renvoie le nombre de fois où cette lettre apparaît dans la chaîne. Vous voulez que les utilisatrices et utilisateurs de votre progiciel libre comprennent facilement le fonctionnement de cette fonction; vous devez donc lui ajouter une docstring. Rédigez une docstring au format Google pour cette fonction en suivant les étapes ci-dessous.
Cette activité fait partie du cours
Écrire des fonctions en Python
Exercice interactif pratique
Essayez cet exercice en complétant ce code d’exemple.
# Add a docstring to count_letter()
def count_letter(content, letter):
____
if (not isinstance(letter, str)) or len(letter) != 1:
raise ValueError('`letter` must be a single character string.')
return len([char for char in content if char == letter])