format

Author: rachel-mack

source/integrations/flask-celery-integration.txt

@@ -139,22 +139,25 @@ Define the necessary configurations by adding the following code to your ``confi
    import os
 
    class Config:
-      MAIL_SERVER = 'smtp.gmail.com'
-      MAIL_PORT = 587
-      MAIL_USE_TLS = True
       MAIL_USERNAME = '<username>' # Your email address without '@gmail.com'
       MAIL_PASSWORD = '<app password>'
-      ALLOWED_IPS = ['127.0.0.1']
+      MAIL_DEFAULT_SENDER = '<email address>'
       MONGO_URI = '<mongodb connection string>'
+      ALLOWED_IPS = ['127.0.0.1']
+      MAIL_SERVER = 'smtp.gmail.com'
+      MAIL_PORT = 587
+      MAIL_USE_TLS = True
       CELERY_BROKER_URL = 'amqp://guest:guest@localhost//'
       RESULT_BACKEND = MONGO_URI + '/celery_results'
 
-You must provide your Gmail credentials (``MAIL_USERNAME`` and ``MAIL_PASSWORD``) to enable your application to send emails. For security purposes, we recommend that you generate an app password to use, rather than using your primary password. For more information, see the `App Password settings <https://myaccount.google.com/apppasswords>`__ in your Google Account.
+You must provide your Gmail credentials and email (``MAIL_USERNAME``, ``MAIL_PASSWORD``, and ``MAIL_DEFAULT_SENDER``) to enable your application to send emails. For security purposes, we recommend that you generate an app password to use, rather than using your primary password. For more information, see the `App Password settings <https://myaccount.google.com/apppasswords>`__ in your Google Account.
 
-You must also create a connection string to set into the ``MONGO_URI`` environment variable. For more information see the :ref:`Create a Connection String <pymongo-get-started-connection-string>` section of this guide.
+You must also provide a connection string to set into the ``MONGO_URI`` environment variable. For more information see the :ref:`Create a Connection String <pymongo-get-started-connection-string>` section of this guide.
 
 The provided Celery broker URL (``CELERY_BROKER_URL``) specifies RabbitMQ as its broker, but you can customize this URL to support other implementations. For more information, see the `Broker Settings <https://docs.celeryq.dev/en/stable/userguide/configuration.html#broker-settings>`__ section of the Celery documentation.
 
+The ``ALLOWED_IPS`` list is used to control access to the :guilabel:`Send Newsletter` page. The rest of the variables configure the Flask and Celery components.
+
 Initialize Flask, MongoDB, and Celery
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -241,11 +244,11 @@ Define your ``send_emails()`` method by adding the following code to your ``task
 Define Your Routes
 ~~~~~~~~~~~~~~~~~~
 
-In Flask, the ``@app.route()`` decorator assigns a URL path to a specific function. In the following code, it is used to define the root (``/``), ``/admin``, ``/subscribe``, and ``/send-newsletter`` routes. The optional ``methods`` parameter is used in some cases to define a list of allowable HTTP methods.
+In Flask, the ``@app.route()`` decorator assigns a URL path to a specific function. In the following code, it is used to define the root (``/``), ``/admin``, ``/subscribe``, and ``/send-newsletters`` routes. The optional ``methods`` parameter is used in some cases to define a list of allowable HTTP methods.
 
 The ``@app.before_request()`` method sets a function to run before every request. In this case, the function provides some basic security by limiting access to the ``admin`` page to IP addresses listed in the ``ALLOWED_IPS`` parameter defined in the ``config.py`` file. Specifically, access is only allowed for the ``localhost``.
 
-The root and ``/admin`` routes render pages using the ``render_template()`` method. The ``/subscribe`` and ``/send-newsletter`` routes access request parameters in ``request.form[]`` to execute commands, and then return HTTP responses.
+The root and ``/admin`` routes render pages using the ``render_template()`` method. The ``/subscribe`` and ``/send-newsletters`` routes access request parameters in ``request.form[]`` to execute commands, and then return HTTP responses.
 
 Define your routes by adding the following code to your ``routes.py`` file:
 
@@ -313,7 +316,7 @@ Create Your Pages
 
 The HTML files in the ``templates`` directory define the user interface, and are written using standard HTML. Since this application uses asynchronous HTTP requests, the scripts in these files use :wikipedia:`Fetch API calls <XMLHttpRequest#Fetch_alternative>`. These scripts also handle timeouts and errors.  
 
-Subscribe Pages
+Subscribe Page
 ```````````````
 
 Copy the following code into your ``subscribe.html`` file to create your :guilabel:`Subscribe to Newsletter` page.
@@ -516,7 +519,7 @@ You can apply a style sheet to your templates by adding the following code to th
       color: #666;
    }
 
-Testing the Platform
+Test the Application
 ~~~~~~~~~~~~~~~~~~~~
 
 After you complete the previous steps, you have a working application that uses MongoDB, Flask, and Celery to manage a newsletter platform.
@@ -532,6 +535,24 @@ You can use the following steps to test your application:
       documentation <https://www.rabbitmq.com/docs/platforms>`__ for your
       operating system.
 
+      On MacOS:
+
+      .. code-block:: bash
+
+         brew services start rabbitmq
+
+      On Windows:
+
+      .. code-block:: bash
+
+         rabbitmq-service start
+
+      On Linux/Unix:
+
+      .. code-block:: bash
+
+         sudo systemctl start rabbitmq-server
+
    .. step::  Start your application
 
       Use the following code to start your application:
@@ -548,7 +569,7 @@ You can use the following steps to test your application:
 
    .. step::  Create a subscriber
 
-      Navigate to ``localhost:5000`` in your browser to open the
+      Navigate to `<localhost:5000>`__ in your browser to open the
       :guilabel:`Subscribe to our Newsletter` page.
 
       Enter the subscriber information and click :guilabel:`Subscribe`.
@@ -559,7 +580,7 @@ You can use the following steps to test your application:
 
    .. step::  Dispatch a newsletter
 
-      Navigate to ``localhost:5000/admin`` in your browser to open the
+      Navigate to `<localhost:5000/admin>`__ in your browser to open the
       :guilabel:`Send Newsletter` page. Enter the newsletter details and click
       :guilabel:`Send`. 
 
@@ -579,16 +600,12 @@ You can use the following steps to test your application:
 Next Steps
 ~~~~~~~~~~
 
-This application demonstrates how to integrate with the Celery task queue to
-manage subscriber data, and send batch emails. You can further enhance this
-platform by integrating analytics, customizing email templates, and implementing
-automated responses.
+This application demonstrates how to integrate a Flask application with the Celery task queue to manage subscriber data, and send batch emails. You can further enhance this platform by integrating analytics, customizing email templates, and implementing automated responses.
 
 More Resources
 --------------
 
-For more information about the components used in this tutorial, see the following
-resources:
+For more information about the components used in this tutorial, see the following resources:
 
 - `Flask <https://flask.palletsprojects.com>`__
 - `Flask Mail <https://pypi.org/project/Flask-Mail/#files>`__