provide quiz modules

scripts/quiz/generators.py

@@ -0,0 +1,35 @@
+from .questions import generate_question_answer_pair
+from .utils import get_next_level
+
+
+def start_interactive_math(successful_answers=0, wrong_answers=0, level="easy"):
+    if wrong_answers > 2:
+        wrong_answers = 0
+        successful_answers = 0
+        level = get_next_level(level, False)
+    elif successful_answers > 2:
+        successful_answers = 0
+        wrong_answers = 0
+        level = get_next_level(level)
+        
+    question_data = generate_question_answer_pair(level)
+    question = question_data['question']
+    proper_answer = question_data['answer']
+    current_number = question_data['current_number']
+    ordinal_number = question_data['ordinal_number']
+
+    numbers_group = [current_number, ordinal_number, proper_answer]
+    if "times" in question_data:
+        times = question_data['times']
+        numbers_group.append(times)
+
+    data_to_return = {
+        "text": question,
+        "question_numbers": numbers_group,
+        "right_answer": proper_answer,
+        'number_correct': successful_answers,
+        'number_incorrect': wrong_answers,
+        "hints_used": 0
+    }
+    return data_to_return
+

scripts/quiz/hints.py

@@ -0,0 +1,34 @@
+from random import random
+
+
+import random
+
+def generate_hint(question_numbers, number_correct, number_incorrect, hints_used):
+    ordinal_number = question_numbers[1]
+    right_answer = question_numbers[2]
+    equation = right_answer - 2 * ordinal_number - 1
+    least_number = equation if equation > 0 else 0
+    seq_before_answer = " ".join(
+        [str(num) for num in range(right_answer - ordinal_number, least_number, -ordinal_number)][::-1]
+    )
+    seq_after_answer = " ".join(
+        [str(num) for num in range(right_answer + ordinal_number, right_answer + 2 * ordinal_number + 1, ordinal_number)]
+    )
+    hints = [
+        f"What number will fill the gap in a sequence {seq_before_answer} ... {seq_after_answer}?",
+        f"What number is {ordinal_number} in the account after {right_answer - ordinal_number}?",
+        f"What number is {ordinal_number} in the account before {right_answer + ordinal_number}?",
+        f"What number is greater than {right_answer - 1} and less than {right_answer + 1}?"
+    ]
+    random_hint = random.choice(hints)
+    hints_used += 1
+
+    data_to_return = {
+        "text": random_hint,
+        "question_numbers": question_numbers,
+        "right_answer": right_answer,
+        'number_correct': number_correct,
+        'number_incorrect': number_incorrect,
+        "hints_used": hints_used
+    }
+    return data_to_return

scripts/quiz/questions.py

@@ -0,0 +1,81 @@
+import random
+from typing import Literal
+
+
+def generate_question_answer_pair(level: Literal["easy", "medium", "hard"] = "easy"):
+    """generate question and correct answer to it
+    
+    :param mode: number we add to current number to get an outcome
+    :param current_number: current number we are counting up from
+    :param ordinal_number: the number we count up by"""
+
+    numbers = generate_numbers_by_level(level)
+    current_number = numbers['current_number']
+    ordinal_number = numbers['ordinal_number']
+    times = numbers['times']
+    proper_outcome = current_number + ordinal_number * times
+
+    question_data = [
+        {
+            "question": f"Let's practice counting. After {current_number}, what number is next?",
+            "current_number": current_number,
+            "ordinal_number": ordinal_number,
+            "answer": current_number + 1
+        },
+        {
+            "question": f"What number comes {ordinal_number} number after {current_number}?",
+            "current_number": current_number,
+            "ordinal_number": ordinal_number,
+            "answer": current_number + ordinal_number 
+        },
+        {
+            "question": f"We're counting up by {times}s. What number is {ordinal_number} after {current_number}?",
+            "current_number": current_number,
+            "ordinal_number": ordinal_number,
+            "times": times,
+            "answer": proper_outcome
+        },
+        {
+            "question": f"If we count up {ordinal_number} from {current_number}, what number is next?",
+            "current_number": current_number,
+            "ordinal_number": ordinal_number,
+            "answer": current_number + ordinal_number
+        },
+        {
+            "question": f"Let's count up by {ordinal_number}s. What number is next if we start from {current_number}",
+            "current_number": current_number,
+            "ordinal_number": ordinal_number,
+            "answer": current_number + ordinal_number
+        }
+    ]
+    random_choice = random.choice(question_data)
+    return random_choice
+
+
+def generate_numbers_by_level(level: Literal["easy", "medium", "hard"] = "easy"):
+    """generate current number, ordinal number and times parameter
+    
+    returns
+    dict with params:
+    :param current_number: current number
+    :param ordinal numebr: the number we count up by
+    :param times: the number of times we count up by ordinal number"""
+
+    if level == "easy":
+        current_number = random.randint(1, 8)
+        ordinal_number = random.randint(1, 2)
+        times = 1
+    elif level == "medium":
+        current_number = random.randint(1, 90)
+        ordinal_number = random.randint(1, 5)
+        times = random.randint(1, 2)
+    elif level == "hard":
+        current_number = random.randint(1, 425)
+        ordinal_number = random.randint(1, 25)
+        times = random.randint(1, 3)
+
+    return {
+        "current_number": current_number,
+        "ordinal_number": ordinal_number,
+        "times": times
+    }

scripts/quiz/utils.py

@@ -0,0 +1,13 @@
+from typing import Literal
+
+def get_next_level(current_level, levep_up: Literal[True, False] = True):
+    if levep_up:
+        if current_level == "easy":
+            return "medium"
+        else:
+            return "hard"
+    else:
+        if current_level == "medium":
+            return "easy"
+        else:
+            return "medium"