Source code for maillib.views

'''
This module contains view functions for the maillib package.

Functions:
    -home(request): Accepts input from the `maillib/home.html` template form
        and checks the validity of the receiver email address. If the email address
        is valid, the email is sent to the recepient and a status message is shown
        to the sender. If the email address is invalid, the email is not sent, and
        the error message is shown to the user.

Constants:
    -API_KEY: This is stored as an environment variable for security
    -VALIDATE_URL: This is the endpoint called to validate the email address
    -SEND_MAIL_URL: Upon successful validation, this is the endpoint called to
    send the email to the specified email address.
'''

import os
from django.shortcuts import render
from django.contrib import messages
import requests
from dotenv import load_dotenv

load_dotenv()

API_KEY = os.getenv('API_KEY')
VALIDATE_URL = f'https://100085.pythonanywhere.com/api/v1/mail/{API_KEY}/?type=validate'
SEND_MAIL_URL = f'https://100085.pythonanywhere.com/api/v1/mail/{API_KEY}/?type=send-email'

[docs]def home(request): """ Renders the home page and handles the submission of the email form form `templates/home.html`. If the HTTP request method is POST, this function extracts the form data from the request object and sends it to a validation API. If the validation API returns a success response, the email sending API is called with the form data. If the email sending API returns a success response, a success message is added to the messages framework. Otherwise, an error message is added. The message is then displayed back to the user in the home.html. Args: request (HttpRequest): The HTTP request object. Variables: API_KEY(str): A string containig the api key stored in the .env file VALIDATE_URL(str): a string containing the validation url endpoint SEND_MAIL_URL(str): a string containing the send email url endpoint Returns: HttpResponse: A rendered HTML template for the home page with any messages from form submission. """ if request.method== "POST": body = { "email": request.POST.get('toEmail'), "name":request.POST.get('fullName'), "fromName":request.POST.get('fullName'), "fromEmail" : request.POST.get('fromEmail'), "subject" : request.POST.get('subject'), "body" : request.POST.get('message') } response_from_validation_call = requests.post(VALIDATE_URL, json=body) validate_response = response_from_validation_call.json() if validate_response['success'] is True: response_from_email_call = requests.post(SEND_MAIL_URL, json=body) mail_response = response_from_email_call.json() if mail_response['success'] is True: messages.add_message(request, messages.INFO, mail_response['message']) else: messages.add_message(request, messages.ERROR, mail_response['message']) else: messages.add_message(request, messages.ERROR, validate_response['message']) return render(request, 'maillib/home.html')