Update app.py

app.py

@@ -1,15 +1,22 @@
-import gradio as gr
+'''
+AWS Exam Simulator v.01
+Program Developed by Ruslan Magana Vsevolovna
+The purpose of this program is help to practice the questions of AWS Exams.
+https://ruslanmv.com/
+'''
 
-# Define the exam options
-#exams = ["AWS"]
+import gradio as gr
+from gradio_client import Client
 import os
 import re
-# Simulating the loading of question sets from a directory
+
+# Function to load question sets from a directory
 def load_question_sets(directory='questions'):
     question_sets = [f.split('.')[0] for f in os.listdir(directory) if f.endswith('.set')]
     return question_sets
+
 exams = load_question_sets()
-print("question_sets:",exams)
+print("question_sets:", exams)
 
 def parse_questions(file_path):
     with open(file_path, 'r', encoding='utf-8') as file:
@@ -17,7 +24,7 @@ def parse_questions(file_path):
     questions_raw = re.split(r'## ', content)[1:]
     questions = []
     for q in questions_raw:
-        parts = q.split('\n')  # changed from '\\\\n' to '\n'
+        parts = q.split('\n')
         question_text = parts[0].strip()
         options = [opt.strip() for opt in parts[1:] if opt.strip()]
         correct_options = [opt for opt in options if opt.startswith('- [x]')]
@@ -31,53 +38,56 @@ def parse_questions(file_path):
             'correct': correct_answer
         })
     return questions
-# Function to test questions
+
+# Function to select exam questions
 def select_exam_(exam_name):
     questions = parse_questions(f'questions/{exam_name}.set')
-    #return questions
-    num_questions=len(questions)
-    num_questions=2
-    print("num_questions",num_questions)
+    num_questions = len(questions)
+    #num_questions = 2
+    print("num_questions", num_questions)
     selected_questions = questions[:int(num_questions)]
     cleaned_questions = [
         {'question': q['question'], 
-        'options': [o.replace('- [ ] ', '').replace('- [x] ', '') for o in q['options']], 
-        'correct': q['correct'].replace('- [ ] ', '').replace('- [x] ', '')} 
+         'options': [o.replace('- [ ] ', '').replace('- [x] ', '') for o in q['options']], 
+         'correct': q['correct'].replace('- [ ] ', '').replace('- [x] ', '')} 
         for q in selected_questions
     ]
     return cleaned_questions
 
+# Text-to-speech function
+def text_to_speech(text):
+    client = Client("ruslanmv/Text-To-Speech")
+    result = client.predict(
+        text=text,
+        api_name="/predict"
+    )
+    return result  # result is already the path to the audio file
+
 # Global variable to store selected questions
 selected_questions = []
 
-def start_exam(exam_choice):
+# Function to start exam
+def start_exam(exam_choice, audio_enabled):
     global selected_questions
-
-
-    # Define the questions for each exam
-    #exam_questions = {
-    #    "AWS": [
-    #        {'question': 'AWS allows users to manage their resources using a web based user interface. What is the name of this interface?', 'options': ['AWS CLI.', 'AWS API.', 'AWS SDK.', 'AWS Management Console.'], 'correct': 'AWS Management Console.'},
-    #        {'question': 'Which of the following is an example of horizontal scaling in the AWS Cloud?', 'options': ['Replacing an existing EC2 instance with a larger, more powerful one.', 'Increasing the compute capacity of a single EC2 instance to address the growing demands of an application.', 'Adding more RAM capacity to an EC2 instance.', 'Adding more EC2 instances of the same size to handle an increase in traffic.'], 'correct': 'Adding more EC2 instances of the same size to handle an increase in traffic.'}
-    #    ]
-    #}
-    #selected_questions = exam_questions[exam_choice]
-
-    selected_questions=select_exam_(exam_choice)
-    question, options = display_question(0)
+    selected_questions = select_exam_(exam_choice)
+    question, options, audio_path = display_question(0, audio_enabled)
     return (
         gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), gr.update(visible=False),
+        gr.update(visible=False),  # Hide the audio_checkbox
         gr.update(visible=True), question, gr.update(choices=options, visible=True), gr.update(visible=True),
-        gr.update(visible=True), gr.update(visible=True), gr.update(visible=True), 0, ""
+        gr.update(visible=True), gr.update(visible=True), gr.update(visible=True), 0, "", audio_path
     )
 
-def display_question(index):
+# Function to display a question
+def display_question(index, audio_enabled):
     if index < 0 or index >= len(selected_questions):
-        return "No more questions.", []
+        return "No more questions.", [], None
     question_text = selected_questions[index]['question']
     choices_options = selected_questions[index]['options']
-    return question_text, choices_options
+    audio_path = text_to_speech(question_text + " " + " ".join(choices_options)) if audio_enabled else None
+    return question_text, choices_options, audio_path
 
+# Function to check the answer
 def check_answer(index, answer):
     correct_answer = selected_questions[index]['correct']
     if answer == correct_answer:
@@ -85,36 +95,52 @@ def check_answer(index, answer):
     else:
         return f"Incorrect. The correct answer is: {correct_answer}"
 
-def update_question(index):
-    question, options = display_question(index)
-    return question, gr.update(choices=options), index
+# Function to update the question
+def update_question(index, audio_enabled):
+    question, options, audio_path = display_question(index, audio_enabled)
+    return question, gr.update(choices=options), index, audio_path
 
-def handle_answer(index, answer):
+# Function to handle the answer submission
+def handle_answer(index, answer, audio_enabled):
     result = check_answer(index, answer)
-    return result
+    audio_path = text_to_speech(result) if audio_enabled else None
+    return result, audio_path
 
-def handle_next(index):
+# Function to handle the next question
+def handle_next(index, audio_enabled):
     new_index = min(index + 1, len(selected_questions) - 1)
-    question, options, _ = update_question(new_index)
-    return question, options, new_index, ""
+    question, options, new_index, audio_path = update_question(new_index, audio_enabled)
+    return question, options, new_index, "", audio_path
 
-def handle_previous(index):
+# Function to handle the previous question
+def handle_previous(index, audio_enabled):
     new_index = max(index - 1, 0)
-    question, options, _ = update_question(new_index)
-    return question, options, new_index, ""
+    question, options, new_index, audio_path = update_question(new_index, audio_enabled)
+    return question, options, new_index, "", audio_path
 
+# Function to return to the home page
 def return_home():
     return (
         gr.update(visible=True), gr.update(visible=True), gr.update(visible=True), gr.update(visible=True),
+        gr.update(visible=True),  # Show the audio_checkbox
         gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), gr.update(visible=False),
         gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), "", ""
     )
 
+
+description_str="""Developed by Ruslan Magana, this interactive quiz platform is designed to help you prepare and assess your knowledge in a variety of exams. 
+For more information about the developer, please visit [ruslanmv.com](https://ruslanmv.com/).
+
+**Get Started with Your Quiz** 
+
+Select an exam from the dropdown menu below and start testing your skills. You can also choose to enable audio feedback to enhance your learning experience. Simply toggle the "Enable Audio" checkbox to turn it on or off."""
+
 with gr.Blocks() as demo:
     # Home page elements
-    title = gr.Markdown(value="Exam Simulator (Quiz)")
-    description = gr.Markdown(value="Select an exam and start your quiz!")
+    title = gr.Markdown(value="**AWS Exam Simulator (Quiz)**")
+    description = gr.Markdown(value=description_str)
     exam_selector = gr.Dropdown(label="Select an exam", choices=exams)
+    audio_checkbox = gr.Checkbox(label="Enable Audio", value=True)
     start_button = gr.Button("Start Exam")
 
     # Quiz elements (initially hidden)
@@ -126,24 +152,25 @@ with gr.Blocks() as demo:
     next_button = gr.Button("Next Question", visible=False)
     prev_button = gr.Button("Previous Question", visible=False)
     home_button = gr.Button("Return to Home", visible=False)
-
+    question_audio = gr.Audio(visible=False, label="Question Audio", autoplay=True)
+    answer_audio = gr.Audio(visible=False,label="Answer Audio",autoplay=True)
     # Layout for the home page
     with gr.Row():
         gr.Column([title])
     with gr.Row():
         gr.Column([description])
     with gr.Row():
-        gr.Column([exam_selector])
+        gr.Column([exam_selector, audio_checkbox])
     with gr.Row():
         gr.Column([start_button])
 
     # Layout for the quiz
     with gr.Row():
-        gr.Column([question_text])
+        gr.Column([question_text, question_audio])
     with gr.Row():
         gr.Column([choices])
     with gr.Row():
-        gr.Column([result_text])
+        gr.Column([result_text, answer_audio])
     with gr.Row():
         gr.Column([prev_button], scale=1)
         gr.Column([], scale=8)
@@ -156,20 +183,21 @@ with gr.Blocks() as demo:
     # Connect the start button to start the exam
     start_button.click(
         fn=start_exam, 
-        inputs=exam_selector, 
+        inputs=[exam_selector, audio_checkbox], 
         outputs=[
             title, description, exam_selector, start_button,
+            audio_checkbox,  # Ensure the checkbox visibility is updated
             question_text, question_text, choices, answer_button, 
-            next_button, prev_button, home_button, question_state, result_text
+            next_button, prev_button, home_button, question_state, result_text, question_audio
         ]
     )
-
     # Connect the quiz buttons to their functions
-    answer_button.click(fn=handle_answer, inputs=[question_state, choices], outputs=result_text)
-    next_button.click(fn=handle_next, inputs=question_state, outputs=[question_text, choices, question_state, result_text])
-    prev_button.click(fn=handle_previous, inputs=question_state, outputs=[question_text, choices, question_state, result_text])
+    answer_button.click(fn=handle_answer, inputs=[question_state, choices, audio_checkbox], outputs=[result_text, answer_audio])
+    next_button.click(fn=handle_next, inputs=[question_state, audio_checkbox], outputs=[question_text, choices, question_state, result_text, question_audio])
+    prev_button.click(fn=handle_previous, inputs=[question_state, audio_checkbox], outputs=[question_text, choices, question_state, result_text, question_audio])
     home_button.click(fn=return_home, inputs=None, outputs=[
         title, description, exam_selector, start_button,
+        audio_checkbox,  # Ensure the checkbox visibility is updated
         question_text, question_text, choices, answer_button, 
         next_button, prev_button, home_button, question_state, result_text
     ])