Criando uma docstring
Você decidiu escrever o maior pacote Python de processamento de linguagem natural de código aberto do mundo. Ele revolucionará o trabalho com texto em formato livre, da mesma forma que o numpy
fez com as matrizes, o pandas
fez com os dados tabulares e o scikit-learn
fez com o aprendizado de máquina.
A primeira função que você escreve é count_letter()
. Ele recebe uma cadeia de caracteres e uma única letra e retorna o número de vezes que a letra aparece na cadeia. Você deseja que os usuários do seu pacote de código aberto consigam entender facilmente como essa função funciona, portanto, será necessário fornecer uma docstring a ela. Crie uma docstring do Google Style para essa função seguindo estas etapas.
Este exercício faz parte do curso
Como escrever funções em Python
Exercício interativo prático
Experimente este exercício preenchendo este código de exemplo.
# 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])