Simple lightwigh mail sending for FastApi
Project description
Fastapi-mail
The fastapi-mail simple lightweight mail system, sending emails and attachments(individual && bulk)
🔨 Installation
$ pip install fastapi-mail
Documentation: FastApi-MAIL
The key feature are:
- sending emails with either with FastApi or using asyncio module
- sending emails using FastApi backroung task managment
- 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 avalibale class
DefaultChecker
andWhoIsXmlApi
- Unittests using FastapiMail
More information on Getting-Started
Guide
from fastapi import FastAPI, BackgroundTasks, UploadFile, File, Form
from starlette.responses import JSONResponse
from starlette.requests import Request
from fastapi_mail import FastMail, MessageSchema,ConnectionConfig
from pydantic import EmailStr
from pydantic import EmailStr, BaseModel
from typing import List
class EmailSchema(BaseModel):
email: List[EmailStr]
conf = ConnectionConfig(
MAIL_USERNAME = "YourUsername",
MAIL_PASSWORD = "strong_password",
MAIL_FROM = "your@email.com",
MAIL_PORT = 587,
MAIL_SERVER = "your mail server",
MAIL_TLS = True,
MAIL_SSL = False,
USE_CREDENTIALS = True
)
app = FastAPI()
template = """
<p>Hi this test mail using BackgroundTasks, thanks for using Fastapi-mail</p>
"""
@app.post("/email")
async def simple_send(email: EmailSchema) -> JSONResponse:
message = MessageSchema(
subject="Fastapi-Mail module",
recipients=email.dict().get("email"), # List of recipients, as many as you can pass
body=html,
subtype="html"
)
fm = FastMail(conf)
await fm.send_message(message)
return JSONResponse(status_code=200, content={"message": "email has been sent"})
List of Examples
for more examples of using fastapi-mail please check example section
Contributing
Fell free to open issue and send pull request.
Contributors ✨
Thanks goes to these wonderful people (🚧):
Sabuhi Shukurov 💬 👀 🚧 |
Tural Muradov 📖 👀 🔧 |
Hasan Aliyev 📖 🚧 👀 |
Ashwani 🚧 |
Leon Xu 🚧 |
Gabriel Oliveira 📖 🚧 |
Onothoja Marho 📖 🚧 🔧 |
Tim Kiely 🚧 |
Dmitriy Solodkiy 🚧 |
Peter Boers 🚧 |
This project follows the all-contributors specification. Contributions of any kind are welcome!
Before you start please read CONTRIBUTING
LICENSE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
fastapi-mail-0.3.3.0.tar.gz
(15.1 kB
view details)
Built Distribution
File details
Details for the file fastapi-mail-0.3.3.0.tar.gz
.
File metadata
- Download URL: fastapi-mail-0.3.3.0.tar.gz
- Upload date:
- Size: 15.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.55.1 CPython/3.7.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 622cf3242dda3cf78e1b47abc7689e52ca4b28dbca57409c2c2de8a94f236a27 |
|
MD5 | d6645afbe585ed6e16cf47f3e639c8b0 |
|
BLAKE2b-256 | 52629cc43ff8046f76735f6b8d4bf4949c8a2098d7839007058b560dc099a58c |
File details
Details for the file fastapi_mail-0.3.3.0-py3-none-any.whl
.
File metadata
- Download URL: fastapi_mail-0.3.3.0-py3-none-any.whl
- Upload date:
- Size: 18.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.55.1 CPython/3.7.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 09094498b10f7e5963b55adbe20d061c4e7808a655aba647251f11302382d1b7 |
|
MD5 | 9ca076fefbfb0e09989ff70b0dbba9a0 |
|
BLAKE2b-256 | 4e7c9505923a274d56600324ed9f7fb4fc78d88ed089a1829f9e478a0b60291d |