DEV Community: Aniket Sarkar

How to send emails while using Python Flask fully asynchronously ?

Aniket Sarkar — Wed, 08 Sep 2021 08:45:42 +0000

Introduction

Sending emails is one of the important work of Flask micro web framework. Now a days people are using the old and unmaintained module Flask-Mail to send emails. Flask-Mail is totally dead now. This is time to shift or migrate to Flask-Mailing module to send emails fully asynchronously(The new Flask-2.0 has the asynchronous support). Flask-Mailing module internally using the aiosmtplib lib to provide the asynchronous SMTP connection.

Github Repo: https://github.com/marktennyson/flask-mailing 🔱

Official Documentation: https://marktennyson.github.io/flask-mailing/ 🔶

Key features of the `Flask-Mailing` module:

➿ Fully asynchronous support for email sending.
📤 sending emails with either with Flask or using asyncio module.
⚜️ Able to perform any TLS of SSL based encryption.
⚔️ sending files either from form-data or files from server.
🗞️ Using Jinja2 HTML Templates.
🩹 email utils (utility allows you to check temporary email addresses, you can block any email or domain).
🧲 email utils has two available classes DefaultChecker and WhoIsXmlApi.

More information will be available at the Getting-Started section. 😀

❤️ Configure `Flask-Mailing` with a simple `Flask application`:

👋 install or update the Flask-Mailing module on your machine from PYPI using PIP

pip install -U flask-mailing

🧛‍♀️ Create a simple flask application, like this:

from flask import Flask

app= Flask(__name__)

@app.route("/")
def index():
    return "hello from Pluto."

if __name__ == "__main__":
    app.run(debug=True)

⛹️‍♀️ Now import the Mail and Message class from flask-mailing and set the app's default config variable:

from flask_mailing import Mail, Message

app.config['MAIL_USERNAME'] = "your-email@your-domain.com"
app.config['MAIL_PASSWORD'] = "world_top_secret_password"
app.config['MAIL_PORT'] = 587
app.config['MAIL_SERVER'] = "your-email-server.com"
app.config['MAIL_TLS'] = True
app.config['MAIL_SSL'] = False

mail = Mail(app)

🏋️‍♀️ Now configure a route to initialize the Message class to create a message instance.

@app.get("/email")
async def simple_send():

    message = Message(
        subject="Flask-Mailing module",
        recipients=["aniketsarkar@yahoo.com"],
        body="This is the basic email body",
        )
    await mail.send_message(message)
    return jsonify(status_code=200, content={"message": "email has been sent"})

🐻 Here is the complete example for better understanding of the working procedure:

from flask import Flask, jsonify
from flask_mailing import Mail, Message

mail = Mail()

def create_app():
    app = Flask(__name__)


    app.config['MAIL_USERNAME'] = "your-email@your-domain.com"
    app.config['MAIL_PASSWORD'] = "world_top_secret_password"
    app.config['MAIL_PORT'] = 587
    app.config['MAIL_SERVER'] = "your-email-server.com"
    app.config['MAIL_TLS'] = True
    app.config['MAIL_SSL'] = False
    mail.init_app(app)

    return app

#send a simple email using flask_mailing module.

app = create_app()

@app.get("/email")
async def simple_send():

    message = Message(
        subject="Flask-Mailing module",
        recipients=["aniketsarkar@yahoo.com"],
        body="This is the basic email body",
        )


    await mail.send_message(message)
    return jsonify(status_code=200, content={"message": "email has been sent"})

🐼 For more example plese click here

Support 😇:

I have created some more python Flask extensions including Flask-Express, to support the Flask as well as the Python community.
If you find this project to be useful then you can support me using the Buy Me a Coffee link below so I can continue chasing my dream of building useful Projects that will help the Python developer community and the general audience and will allow me to change my life as well 😇

buy me a coffee ❤️

Paytm

UPI: aniketsarkar@ybl

Special Note 🔴

If you would like to use Django's email implementation, you should probably go with waynerv's Flask-Mailman package.

Please give a star to the Github Repo of Flask-Mailing. It will help to reach out to many users

Feel free to Like and Share this post 😇

Share your feedback by Commenting below 💬

Drop me a Follow for more Awesome content related to Web Development and Programming 🙌

Thank you for your support ❤️

Feel like ExpressJs while using Python Flask

Aniket Sarkar — Tue, 27 Jul 2021 06:38:11 +0000

Introduction

Do you love to write back-end code using ExpressJs? Do you like the auto completion features of Vscode while using typing based language or framework? Do you want to get all of above mentioned features while using a Python based framework called Flask ?

I have created a new python module called Flaske, to provide these features.

How flaske provide you the features like expressjs

Flaske basically provides you the request and response object as the parameters of the view function very similar to the view functions of expressJs. The inbuilt properties and the methods of the request and response object will provide you a interactive feel like expressJs. We are using the munch module to provide the attribute-style access very similar to the Javascript. Below I have tried to mention some of the examples to demonstrate the features of Flaske better.

Installation

Install from official PYPI

python3 -m pip install flaske

Or It could be installed from the source code.

git clone https://github.com/marktennyson/flaske.git && cd flaske/
python3 setup.py install

Important Links

PYPI link

Github link

Documentation link

Examples

A Basic example:

from flaske import Flask

app = Flask(__name__)

@app.get("/")
def index(req, res):
    return res.json(req.header)

Now the flask 2.0 support the asynchronus view function. You can implement this with flaske too.

from flaske import Flask

app = Flask(__name__)

@app.get("/")
async def index(req, res):
    return res.json(req.header)

You can use the python typing for a better view of the codes and auto completion.

from flaske import Flask
from flaske.typing import Request, Response

app = Flask(__name__)

@app.get("/")
def index(req:Request, res:Response):
    return res.json(req.header)

Basic Documentation

The official and full documentation for this project is available at: https://flaske.vercel.app.
Here I have tried to provide some of the basic features of this project.

Request class:

N.B: all of the properties of the Request class will return an instance of Munch.
This will provide you the feel of the Javascript object.

property - json

So if your app is receiving data as json format, you can use json property of the request class to access the data.
It's internally using the get_json method to provide the data.

For example:

@app.post("/send-json")
def send_json(req, res):
    name = req.json.name
    email = req.json.email
    return res.json(name=name, email=email)

property - query

This object provides you the url based parameter.
It's internally using the args property to provide the data.

For example:

@app.get("/get-query")
def get_query(req, res):
    name=req.query.name
    email = req.query.email
    return res.send(dict(name=name, email=email))

property - body

This object provides you the all the parameters from the Form.
It's internally using the form property to provide the data.

For example:

@app.get("/get-form-data")
def get_form_data(req, res):
    name=req.body.name
    email = req.body.email
    return res.send(dict(name=name, email=email))

property - header

This object provides you the all the parameters of the request header.
It's internally using the header property to provide the data.

For example:

@app.get("/get-form-data")
def get_form_data(req, res):
    return res.send(req.header)

Response class

The default response class and the methods or functions of the response class are the following.

function - set_status

This is used to set the response header status.

for example:

@app.route("/set-status")
def set_statuser(req, res):
    return res.set_status(404).send("your requested page is not found.")

function - flash

To flash a message at the UI.

for example:

@app.route('/flash')
def flasher(req, res):
    return res.flash("this is the flash message").end()

function - send

It sends the HTTP response.

for example:

@app.route("/send")
def sender(req, res):
    return res.send("hello world")
    #or
    return res.send("<h1>hello world</h1>")
    #or
    return res.set_status(404).send("not found")

function - json

To return the json seriliazed response.

for example:

@app.route("/json")
def jsoner(req, res):
    return res.json(name="aniket sarkar")
    #or
    return res.json({'name': 'aniket sarkar'})
    #or
    return res.json([1,2,3,4])

function - end

To end the current resonse process.

for example:

@app.route("/end")
def ender(req, res):
    return res.end()
    #or
    return res.end(404) # to raise a 404 error.

function - render

Renders a html and sends the rendered HTML string to the client.

for example:

@app.route('/render')
def renderer(req, res):
    context=dict(name="Aniket Sarkar", planet="Pluto")
    return res.render("index.html", context)
    #or
    return res.render("index.html", name="Aniket Sarkar", planet="Pluto")

function - redirect

redirect to specified route.

for example:

@app.post("/login")
def login(req, res):
#if login success
return res.redirect("/dashboard")

function - get

Get the header information by the given key.

for example:

@app.route("/get")
def getter(req, res):
    print (res.get("Content-Type"))
    return res.end()

function - set

Set the header information.

for example:

@app.route("/header-seter")
def header_setter(req, res):
    res.set('Content-Type', 'application/json')
    #or
    res.set({'Content-Type':'application/json'})
    return res.end()

function - type

Sets the Content-Type HTTP header to the MIME type as determined by the specified type.

for example:

@app.route("/set-mime")
def mimer(req, res):
    res.type('application/json')
    #or
    res.type(".html")
    #or
    res.type("json")

function - attachment

send the attachments by using this method.
The default attachment folder name is attachments.
You can always change it by changing the config parameter.
the config parameter is ATTACHMENTS_FOLDER.

for example:

@app.route('/attachments')
def attach(req, res):
    filename = req.query.filename
    return res.attachment(file_name)

function - send_file

Send the contents of a file to the client.Its internally using the send_file method from werkzeug.

function - clear_cookie

Clear a cookie. Fails silently if key doesn't exist.

function - set_cookie

Sets a cookie.

function - make_response

make a http response. It's same as Flask.wrappers.Request

Development

Contribution procedure.

Form and clone this repository.
Make some changes as required.
Write unit test to showcase its functionality.
Submit a pull request under development branch.

Run this project on your local machine.

create a virtual environment on the project root directory.
install all the required dependencies from requirements.txt file.
make any changes on you local code.
then install the module on your virtual environment using python setup.py install command.
The above command will install the flaske module on your virtual environment.
Now create a separate project inside the example folder and start testing for your code changes.
If you face any difficulties to perform the above steps, then plese contact me at: aniketsarkar@yahoo.com.

DEV Community: Aniket Sarkar

How to send emails while using Python Flask fully asynchronously ?

Introduction

Github Repo: https://github.com/marktennyson/flask-mailing 🔱

Official Documentation: https://marktennyson.github.io/flask-mailing/ 🔶

Key features of the Flask-Mailing module:

❤️ Configure Flask-Mailing with a simple Flask application:

Support 😇:

buy me a coffee ❤️

Paytm

UPI: aniketsarkar@ybl

Special Note 🔴

Feel like ExpressJs while using Python Flask

Introduction

How flaske provide you the features like expressjs

Installation

Important Links

Examples

A Basic example:

Now the flask 2.0 support the asynchronus view function. You can implement this with flaske too.

You can use the python typing for a better view of the codes and auto completion.

Basic Documentation

Request class:

property - json

property - query

property - body

property - header

Response class

function - set_status

function - flash

function - send

function - json

function - end

function - render

function - redirect

function - get

function - set

function - type

function - attachment

function - send_file

function - clear_cookie

function - set_cookie

function - make_response

Development

Contribution procedure.

Run this project on your local machine.

Key features of the `Flask-Mailing` module:

❤️ Configure `Flask-Mailing` with a simple `Flask application`: