feat: complete project

stats.py

@@ -0,0 +1,44 @@
+"""Provides functions to report statistics on books"""
+
+from typing import TypedDict
+
+
+class CharacterCount(TypedDict):
+    """Represents number of times a character is found in a book"""
+
+    char: str
+    num: int
+
+
+def count_words_in_book(book_content: str) -> int:
+    """Returns the count of words in the book"""
+
+    return len(book_content.split())
+
+
+def count_characters_in_book(book_content: str) -> dict[str, int]:
+    """Returns a dictionary of the number of times a character appears in the book"""
+
+    result = {}
+
+    for character in book_content:
+        normalized_character = character.lower()
+
+        if normalized_character in result:
+            result[normalized_character] += 1
+            continue
+
+        result[normalized_character] = 1
+
+    return result
+
+def sort_character_counts(counts: dict[str, int]) -> list[CharacterCount]:
+    """Returns a list of character counts in descending order"""
+    result: list[CharacterCount] = []
+
+    for entry in counts:
+        result.append({ "char": entry, "num": counts[entry] })
+
+    result.sort(reverse=True, key=lambda x: x["num"])
+
+    return result