Rédaction d'une docstring
Vous avez décidé de développer le meilleur package Python open source au monde pour le traitement du langage naturel. Cela va révolutionner le travail avec du texte libre, tout 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(). Cette fonction prend une chaîne et une lettre unique, et renvoie le nombre d'occurrences de cette lettre dans la chaîne. Vous souhaitez que les utilisateurs de votre package open source puissent facilement comprendre le fonctionnement de cette fonction. Il est donc nécessaire de lui attribuer une docstring. Créez une docstring de style Google pour cette fonction en suivant les étapes suivantes.
Cet exercice fait partie du cours
Écrire des fonctions en Python
Exercice interactif pratique
Essayez 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])