submit.py

"""Module for Submit Processing"""

import requests


def _api_response(submit_url: str, submission_data: dict) -> tuple:
    try:
        response = requests.post(submit_url, json=submission_data, timeout=60)
        response.raise_for_status()
        return response, None
    except requests.exceptions.HTTPError as e:
        error_detail = f"Server responded with status {e.response.status_code}."
        try:
            error_json = e.response.json()
            error_detail += f" Detail: {error_json.get('detail', e.response.text)}"
        except requests.exceptions.JSONDecodeError:
            error_detail += f" Response: {e.response.text[:500]}"
        error_message = f"Submission Failed: {error_detail}"
        print(error_message)
        return None, error_message
    except requests.exceptions.Timeout:
        error_message = "Submission Failed: The request timed out."
        print(error_message)
        return None, error_message
    except requests.exceptions.RequestException as e:
        error_message = f"Submission Failed: Network error - {e}"
        print(error_message)
        return None, error_message
    except Exception as e:  # pylint: disable=broad-exception-caught
        error_message = f"An unexpected error occurred during submission: {e}"
        print(error_message)
        return None, error_message


def _final_status_from_response(response: requests.Response) -> tuple:
    try:
        result_data = response.json()
        final_status = (
            f"Submission Successful!\n"
            f"User: {result_data.get('username')}\n"
            f"Overall Score: {result_data.get('score', 'N/A')}% "
            f"({result_data.get('correct_count', '?')}/{result_data.get('total_attempted', '?')} correct)\n"  # pylint: disable=line-too-long
            f"Message: {result_data.get('message', 'No message received.')}"
        )
        print("Submission successful.")
        return final_status, None
    except requests.exceptions.JSONDecodeError as e:
        print(f"Error decoding JSON response from Submit endpoint: {e}")
        print(f"Response text: {response.text[:500]}")
        error_message = f"Error decoding server Submit response for Final Status: {e}"
        return None, error_message
    except Exception as e:  # pylint: disable=broad-exception-caught
        error_message = f"An unexpected error occurred during submission: {e}"
        print(error_message)
        return None, error_message


def submit_answers(submit_url: str, submission_data: dict) -> tuple:
    """Submit Answers returning Final Status"""
    response, error_message = _api_response(
        submit_url=submit_url, submission_data=submission_data
    )
    if not response:
        return None, error_message
    final_status, error_message = _final_status_from_response(response=response)
    if not final_status:
        return None, error_message
    return final_status, None