Tworzenie docstringa
Postanawiasz napisać najlepszy na świecie pakiet Pythona do przetwarzania języka naturalnego w modelu open-source. Ma zrewolucjonizować pracę z tekstem swobodnym – tak jak numpy zrewolucjonizował tablice, pandas dane tabelaryczne, a scikit-learn uczenie maszynowe.
Pierwszą funkcją, którą piszesz, jest count_letter(). Przyjmuje ona ciąg znaków i pojedynczą literę, a zwraca liczbę wystąpień tej litery w ciągu. Chcesz, żeby użytkownicy twojego pakietu łatwo rozumieli, jak działa ta funkcja – potrzebujesz więc docstringa. Zbuduj docstring w stylu Google dla tej funkcji, wykonując poniższe kroki.
To ćwiczenie jest częścią kursu
Pisanie funkcji w Pythonie
Interaktywne ćwiczenie praktyczne
Spróbuj tego ćwiczenia, uzupełniając ten przykładowy kod.
# 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])