Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sabuhish/fastapi-mail
Fastapi mail system sending mails(individual, bulk) attachments(individual, bulk)
https://github.com/sabuhish/fastapi-mail
fastapi fastapi-mail fastmail
Last synced: 5 days ago
JSON representation
Fastapi mail system sending mails(individual, bulk) attachments(individual, bulk)
- Host: GitHub
- URL: https://github.com/sabuhish/fastapi-mail
- Owner: sabuhish
- License: mit
- Created: 2020-01-25T11:52:29.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-24T01:11:09.000Z (about 1 month ago)
- Last Synced: 2025-01-14T23:42:49.832Z (12 days ago)
- Topics: fastapi, fastapi-mail, fastmail
- Language: Python
- Homepage: https://sabuhish.github.io/fastapi-mail/
- Size: 1.07 MB
- Stars: 733
- Watchers: 13
- Forks: 83
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-fastapi - FastAPI Mail - Lightweight mail system for sending emails and attachments (individual and bulk). (Third-Party Extensions / Email)
- awesome-fastapi - FastAPI Mail - Lightweight mail system for sending emails and attachments (individual and bulk). (Third-Party Extensions / Email)
- best-of-web-python - GitHub - 15% open · ⏱️ 18.07.2023): (Email)
README
# Fastapi-mail
The fastapi-mail is a simple lightweight mail system, for sending emails and attachments(individual && bulk)
[](https://raw.githubusercontent.com/sabuhish/fastapi-mail/master/LICENSE)
[](https://github.com/sabuhish/fastapi-mail/stargazers)
[](https://github.com/sabuhish/fastapi-mail/network)
[](https://github.com/sabuhish/fastapi-mail/issues)
[](https://pepy.tech/project/fastapi-mail)
### 🔨 Installation ###
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install fastapi-mail
for aioredis and httpx
pip install 'fastapi-mail[aioredis]'
pip install 'fastapi-mail[httpx]'
```
Alternatively, if you prefer to use `poetry` for package dependencies:
```bash
poetry shell
poetry add fastapi-mail
for aioredis and httpx
poetry add 'fastapi-mail[aioredis]'
poetry add 'fastapi-mail[httpx]'
```
---
**Documentation**: [FastApi-MAIL](https://sabuhish.github.io/fastapi-mail/)
---
The key features are:
- sending emails either with FastApi or using asyncio module
- sending emails using FastApi background 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 available classes ```DefaultChecker``` and ```WhoIsXmlApi```
- Unittests using FastapiMail
More information on [Getting-Started](https://sabuhish.github.io/fastapi-mail/getting-started/)
### Guide
```python
from typing import List
from fastapi import BackgroundTasks, FastAPI
from fastapi_mail import ConnectionConfig, FastMail, MessageSchema, MessageType
from pydantic import BaseModel, EmailStr
from starlette.responses import JSONResponse
class EmailSchema(BaseModel):
email: List[EmailStr]
conf = ConnectionConfig(
MAIL_USERNAME ="username",
MAIL_PASSWORD = "**********",
MAIL_FROM = "[email protected]",
MAIL_PORT = 465,
MAIL_SERVER = "mail server",
MAIL_STARTTLS = False,
MAIL_SSL_TLS = True,
USE_CREDENTIALS = True,
VALIDATE_CERTS = True
)
app = FastAPI()
html = """
Thanks for using Fastapi-mail
"""
@app.post("/email")
async def simple_send(email: EmailSchema) -> JSONResponse:
message = MessageSchema(
subject="Fastapi-Mail module",
recipients=email.dict().get("email"),
body=html,
subtype=MessageType.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](https://sabuhish.github.io/fastapi-mail/example/) section.
## Contributors ✨
Thanks goes to these wonderful
[People](https://github.com/sabuhish/fastapi-mail/blob/master/contributors.txt)
# Contributing
Contributions of any kind are welcome!
Before you start, please read [CONTRIBUTING](https://github.com/sabuhish/fastapi-mail/blob/master/CONTRIBUTING.md)
## LICENSE
[MIT](LICENSE)