Création d'une docstring
Vous avez décidé d'écrire le plus grand paquetage Python de traitement du langage naturel en libre accès au monde. Il révolutionnera le travail avec le texte libre, comme numpy
l'a fait pour les tableaux, pandas
pour les données tabulaires et scikit-learn
pour l'apprentissage automatique.
La première fonction que vous écrivez est count_letter()
. Il prend une chaîne et une seule lettre et renvoie le nombre de fois que la lettre apparaît dans la chaîne. Vous souhaitez que les utilisateurs de votre paquetage open-source puissent comprendre facilement le fonctionnement de cette fonction, vous devrez donc lui donner une docstring. Créez une docstring Google Style pour cette fonction en suivant les étapes suivantes.
Cet exercice fait partie du cours
Écrire des fonctions en Python
Exercice interactif pratique
Essayez-vous à cet exercice en complétant cet exemple de code.
# 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])