updates

app.py

@@ -1,156 +1,110 @@
 '''
-AWS Exam Simulator v.03.2
+AWS Exam Simulator v.05
 Program Developed by Ruslan Magana Vsevolovna
 The purpose of this program is help to practice the questions of AWS Exams.
 '''
 import gradio as gr
-from gradio_client import Client
-import os
-import json
-
-# Function to load question sets from a directory
-def load_question_sets_vce(directory='questions'):
-    question_sets = []
-    for root, dirs, files in os.walk(directory):
-        for file in files:
-            if file.endswith(".json"):
-                question_sets.append(os.path.join( file)[:-5])  # remove the .json extension
-    return question_sets
-
-exams = load_question_sets_vce('questions/')
-print("question_sets:", exams)
-
-def select_exam_vce(exam_name):
-    file_path = os.path.join(os.getcwd(), 'questions', f'{exam_name}.json')
-    try:
-        with open(file_path, 'r') as f:
-            questions = json.load(f)
-            print(f"Loaded {len(questions)} questions")
-            return questions  # Ensure the questions are returned here
-    except FileNotFoundError:
-        print(f"File {file_path} not found.")
-        return []  # Return an empty list to indicate no questions were found
-
-import time
-import httpx
-# Text-to-speech clients 
-client_1 = Client("ruslanmv/text-to-speech-fast")
-client_2 = Client("ruslanmv/Text-To-Speech")
-client_3 = Client("ruslanmv/Text-to-Voice-Transformers")
-clients = [client_1, client_2, client_3]
-# Text-to-speech function with rate limiting, retry mechanism, and client rotation
-def text_to_speech(text, retries=3, delay=5):
-    client_index = 0  # Start with the first client
-    
-    for attempt in range(retries):
-        try:
-            client = clients[client_index]
-            print(f"Attempt {attempt + 1}")
-
-            if client_index == 0:
-                result = client.predict(
-                    language="English",
-                    repo_id="csukuangfj/vits-piper-en_US-hfc_female-medium|1 speaker",
-                    text=text,
-                    sid="0",
-                    speed=0.8,
-                    api_name="/process"
-                )
-            else:
-                result = client.predict(
-                    text=text,
-                    api_name="/predict"
-                )
-
-            return result
-
-        except httpx.HTTPStatusError as e:
-            if e.response.status_code == 429:
-                print(f"Rate limit exceeded. Retrying in {delay} seconds...")
-                client_index = (client_index + 1) % len(clients)  # Rotate to the next client
-                time.sleep(delay)
-            else:
-                raise e
-
-    print("Max retries exceeded. Could not process the request.")
-    return None
-
+from tool import *  # Assuming this module contains your exam data and text-to-speech functionality
+from backend1 import *
 
 
+# Global variable to store the currently selected set of exam questions
+selected_questions = []
 
+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."""
 
-# Global variable to store selected questions
-selected_questions = []
+# --- FUNCTION DEFINITIONS ---
 
-# Function to start exam
 def start_exam(exam_choice, audio_enabled):
+    """Starts the exam by selecting questions, setting up UI."""
     global selected_questions
     selected_questions = select_exam_vce(exam_choice)
     question, options, audio_path = display_question(0, audio_enabled)
     return (
+        # Hide start screen elements
         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=False), # Hide the audio_checkbox
+        # Show quiz elements
         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, "", audio_path
+        gr.update(visible=True), gr.update(visible=True), gr.update(visible=True), 0, "", audio_path, gr.update(visible=True),
+        gr.update(visible=True), None  # None for the audio stop signal
     )
 
-# Function to display a question
 def display_question(index, audio_enabled):
+    """Displays a question with options and generates audio (if enabled)."""
     if index < 0 or index >= len(selected_questions):
         return "No more questions.", [], None
-    question_text_ = selected_questions[index]['question']
-    question_text = f"**Question {index + 1}:** {question_text_}"  # Numbering added
-    choices_options = selected_questions[index]['options']
+    question_text_ = selected_questions[index].get('question', 'No question text available.')
+    question_text = f"**Question {index + 1}:** {question_text_}"
+    choices_options = selected_questions[index].get('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 show_explanation(index):
+    """Shows the explanation for the current question and hides previous results."""
+    if 0 <= index < len(selected_questions):
+        explanation = selected_questions[index].get('explanation', 'No explanation available for this question.')
+        return (
+            f"**Explanation:** {explanation}", 
+            gr.update(visible=True),  # Show explanation_text
+            gr.update(visible=True)   # Show result_text
+        )
+    else:
+        return "No explanation available for this question.", gr.update(visible=False), gr.update(visible=False)
+
 def check_answer(index, answer):
-    correct_answer = selected_questions[index]['correct']
+    """Checks the given answer against the correct answer."""
+    correct_answer = selected_questions[index].get('correct', 'No correct answer provided.')
     if answer == correct_answer:
         return f"Correct! The answer is: {correct_answer}"
     else:
         return f"Incorrect. The correct answer is: {correct_answer}"
 
-# Function to update the question
 def update_question(index, audio_enabled):
+    """Updates the displayed question when the index changes."""
     question, options, audio_path = display_question(index, audio_enabled)
     return question, gr.update(choices=options), index, audio_path
 
-# Function to handle the answer submission
-def handle_answer(index, answer, audio_enabled):
+def handle_answer(index, answer, audio_enabled, current_audio):
+    """Handles answer submission, provides feedback, and generates audio."""
+    # Handle the case when no answer is selected
+    if answer is None:
+        return "Please select an option before submitting.", None, None
+    
+    # Stop the current question audio before playing the answer audio
+    stop_audio = True if current_audio else False
     result = check_answer(index, answer)
-    audio_path = text_to_speech(result) if audio_enabled else None
-    return result, audio_path
+    answer_audio_path = text_to_speech(result) if audio_enabled else None
+    return result, answer_audio_path, stop_audio
+
 
-# Function to handle the next question
 def handle_next(index, audio_enabled):
+    """Moves to the next question and updates the UI."""
     new_index = min(index + 1, len(selected_questions) - 1)
     question, options, new_index, audio_path = update_question(new_index, audio_enabled)
-    return question, options, new_index, "", audio_path
+    return question, options, new_index, "", audio_path, gr.update(visible=False)  # Hide explanation
 
-# Function to handle the previous question
 def handle_previous(index, audio_enabled):
+    """Moves to the previous question and updates the UI."""
     new_index = max(index - 1, 0)
     question, options, new_index, audio_path = update_question(new_index, audio_enabled)
-    return question, options, new_index, "", audio_path
+    return question, options, new_index, "", audio_path, gr.update(visible=False)  # Hide explanation
 
-# Function to return to the home page
 def return_home():
+    """Returns to the home screen."""
     return (
+        # Show start screen elements
         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=True), # Show the audio_checkbox
+        # Hide quiz elements
         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), "", ""
+        gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), "", "", gr.update(visible=False), gr.update(visible=False),
+        gr.update(visible=False)  # Hide explain button
     )
 
-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="**AWS Exam Simulator (Quiz)**")
@@ -159,15 +113,18 @@ with gr.Blocks() as demo:
     audio_checkbox = gr.Checkbox(label="Enable Audio", value=True)
     start_button = gr.Button("Start Exam")
 
-    #Quiz elements (initially hidden)
+    # Quiz elements (initially hidden)
     question_state = gr.State(0)
+    current_audio_state = gr.State(None)  # State to track the current audio playing
     question_text = gr.Markdown(visible=False, elem_id="question-text")
     choices = gr.Radio(visible=False, label="Options")
     result_text = gr.Markdown(visible=True)
+    explanation_text = gr.Markdown(visible=False)
     answer_button = gr.Button("Submit Answer", visible=False)
     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)
+    explain_button = gr.Button("Explain", visible=False)
     question_audio = gr.Audio(visible=False, label="Question Audio", autoplay=True)
     answer_audio = gr.Audio(visible=False, label="Answer Audio", autoplay=True)
 
@@ -187,16 +144,16 @@ with gr.Blocks() as demo:
     with gr.Row():
         gr.Column([choices])
     with gr.Row():
-        gr.Column([result_text, answer_audio])
+        gr.Column([result_text, explanation_text, answer_audio])
     with gr.Row():
         gr.Column([prev_button], scale=1)
         gr.Column([], scale=8)
         gr.Column([next_button], scale=1)
     with gr.Row():
-        gr.Column([answer_button])
+        gr.Column([answer_button, explain_button])
     with gr.Row():
         gr.Column([home_button])
-
+    
     # Connect the start button to start the exam
     start_button.click(
         fn=start_exam, 
@@ -205,21 +162,23 @@ with gr.Blocks() as demo:
             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, question_audio
+            next_button, prev_button, home_button, question_state, result_text, question_audio,
+            explain_button, current_audio_state  # Add current_audio_state to the outputs
         ]
     )
+    
     # Connect the quiz buttons to their functions
-    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])
+    answer_button.click(fn=handle_answer, inputs=[question_state, choices, audio_checkbox, current_audio_state], outputs=[result_text, answer_audio, current_audio_state])
+    next_button.click(fn=handle_next, inputs=[question_state, audio_checkbox], outputs=[question_text, choices, question_state, result_text, question_audio, explanation_text])
+    prev_button.click(fn=handle_previous, inputs=[question_state, audio_checkbox], outputs=[question_text, choices, question_state, result_text, question_audio, explanation_text])
+
+    explain_button.click(fn=show_explanation, inputs=[question_state], outputs=[explanation_text, result_text, explanation_text])  # Output to both to toggle visibility
+
     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
+        next_button, prev_button, home_button, question_state, result_text, explanation_text, explain_button
     ])
 
 demo.launch()
-
-### Notes revision v0.3.1
-#In this revised code, JavaScript is used to stop any currently playing audio when a new audio is about to be played. The _js parameter is added to the click function of the buttons that play audio (answer_button, next_button, and prev_button) to ensure that no multiple audios are played simultaneously