{"id":15019713,"url":"https://github.com/marktennyson/flask-mailing","last_synced_at":"2025-02-27T19:19:41.451Z","repository":{"id":43844616,"uuid":"393883463","full_name":"marktennyson/flask-mailing","owner":"marktennyson","description":"Flask-Mailing is the ultimate solution for sending emails asynchronously in Flask applications. With its extensive features such as support for multiple email providers, file attachments, customizable templates, and encryption, Flask-Mailing makes email communication effortless and efficient.","archived":false,"fork":false,"pushed_at":"2024-08-30T10:07:39.000Z","size":968,"stargazers_count":33,"open_issues_count":6,"forks_count":10,"subscribers_count":4,"default_branch":"development","last_synced_at":"2024-10-29T23:33:53.237Z","etag":null,"topics":["aiosmtpd","async","asynchronous-mailing","asynchronous-programming","email","flask","flask-mail","mail","python","smtp"],"latest_commit_sha":null,"homepage":"https://marktennyson.github.io/flask-mailing/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marktennyson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"marktennyson","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"aniketsarkar","issuehunt":null,"otechie":null,"custom":["https://paytm.me/vA-DF7O","https://www.buymeacoffee.com/aniketsarkar"]}},"created_at":"2021-08-08T06:53:45.000Z","updated_at":"2024-08-30T10:11:50.000Z","dependencies_parsed_at":"2024-09-13T11:05:37.276Z","dependency_job_id":null,"html_url":"https://github.com/marktennyson/flask-mailing","commit_stats":{"total_commits":87,"total_committers":9,"mean_commits":9.666666666666666,"dds":0.4482758620689655,"last_synced_commit":"bd3db6727d8adeb8b27c63357be1c19e5afe4cd7"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marktennyson%2Fflask-mailing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marktennyson%2Fflask-mailing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marktennyson%2Fflask-mailing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marktennyson%2Fflask-mailing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marktennyson","download_url":"https://codeload.github.com/marktennyson/flask-mailing/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240953468,"owners_count":19884025,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiosmtpd","async","asynchronous-mailing","asynchronous-programming","email","flask","flask-mail","mail","python","smtp"],"created_at":"2024-09-24T19:53:55.498Z","updated_at":"2025-02-27T19:19:41.427Z","avatar_url":"https://github.com/marktennyson.png","language":"Python","funding_links":["https://github.com/sponsors/marktennyson","https://liberapay.com/aniketsarkar","https://paytm.me/vA-DF7O","https://www.buymeacoffee.com/aniketsarkar"],"categories":[],"sub_categories":[],"readme":"# ✉️ Flask-Mailing\n![Flask mail logo](https://github.com/marktennyson/flask-mailing/blob/main/logo/flask-mailing-logo-cropped.png?raw=true)\n\n__Flask-Mailing__ is a highly efficient and user-friendly package that enables `Asynchronous` email messaging in Flask applications. Asynchronous email messaging is becoming increasingly popular because it allows applications to continue running while emails are being sent in the background. This makes it an ideal solution for time-sensitive applications that require a fast and responsive user experience.\n\nWith Flask-Mailing, developers can easily integrate asynchronous email messaging capabilities into their Flask applications without the need for complex configurations or additional dependencies. The package offers a variety of features, including support for multiple email providers, email templates, and error handling. It also supports common email protocols, such as `SMTP`, `SSL`, and `TLS`.\n\nMoreover, Flask-Mailing offers a simple and intuitive API that allows developers to easily send emails in the background. It also provides advanced features, such as email tracking and reporting, which enable developers to monitor email performance and user engagement.\n\nWhether you're building a small-scale application or a large-scale enterprise system, Flask-Mailing provides a reliable and scalable solution for Asynchronous email messaging in Flask applications.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=marktennyson/flask-mailing\u0026type=Date)](https://star-history.com/#marktennyson/flask-mailing\u0026Date)\n\n\n\n### Key Features :sparkles:\n\n1. :arrows_counterclockwise: Supports asynchronous email sending using the built-in `asyncio` library in Python 3.5+.\n\n2. :link: Easily integrates with Flask applications using the provided `Mail` extension.\n\n3. :gear: Offers simple and intuitive configuration options for email providers such as SMTP, Sendgrid, and Mailgun.\n\n4. :envelope: Supports HTML and plain-text message formats, as well as the option to send both formats in a multi-part message.\n\n5. :paperclip: Provides support for file attachments in emails.\n\n6. :art: Includes customizable email templates and support for Jinja2 templates.\n\n7. :rocket: Offers a simple API for sending email messages, allowing for quick and easy implementation in any Flask project.\n\n8. :email: Supports bulk email sending, allowing for the efficient delivery of messages to large email lists.\n\n9. :bookmark_tabs: Provides options for customizing email headers and message priority levels.\n\n10. :chart_with_upwards_trend: Supports email tracking through message IDs and delivery status notifications.\n\n11. :microscope: Includes a comprehensive testing suite for ensuring the correct configuration and behavior of the email sending functionality.\n\n12. :lock: Supports email encryption and authentication using TLS and SSL protocols.\n\n13. :warning: Offers error handling and logging functionality for tracking and resolving email sending issues.\n\n14. :book: Provides detailed documentation and active community support for resolving any issues or questions related to the package.\n\n\nMore information on [Getting-Started](https://marktennyson.github.io/flask-mailing/getting-started)\n\n# 📥 Downloads\n[![Downloads](https://pepy.tech/badge/flask-mailing)](https://pepy.tech/project/flask-mailing) [![Downloads](https://pepy.tech/badge/flask-mailing/month)](https://pepy.tech/project/flask-mailing) [![Downloads](https://pepy.tech/badge/flask-mailing/week)](https://pepy.tech/project/flask-mailing)\n\u003cbr\u003e\n\n# 🚑 Package health score by [snyk.io](https://snyk.io)\n[![Flask-Mailing](https://snyk.io/advisor/python/Flask-Mailing/badge.svg)](https://snyk.io/advisor/python/Flask-Mailing)\n\n# 🔗 Important Links\n#### ❤️ [Github](https://github.com/marktennyson/flask-mailing)    \n#### 📄 [Documentation](https://marktennyson.github.io/flask-mailing)    \n#### 🐍 [PYPI](https://pypi.org/project/flask-mailing)    \n\n# 🔨 Installation ###\n\n```bash\n pip install flask-mailing\n```\nor install from the source code\n```bash\ngit clone https://github.com/marktennyson/flask-mailing.git \u0026\u0026 cd flask-mailing\npython -m pip install .\n```\n\n# 🦮 Guide\n\n\n```python\n\nfrom flask import Flask, jsonify\nfrom flask_mailing import Mail, Message\n\napp = Flask(__name__)\n\napp.config['MAIL_USERNAME'] = \"YourUserName\"\napp.config['MAIL_PASSWORD'] = \"strong_password\"\napp.config['MAIL_PORT'] = 587\napp.config['MAIL_SERVER'] = \"your mail server\"\napp.config['MAIL_USE_TLS'] = True\napp.config['MAIL_USE_SSL'] = False\napp.config['USE_CREDENTIALS'] = True\napp.config['VALIDATE_CERTS'] = True\napp.config['MAIL_DEFAULT_SENDER'] = \"youremailid@doaminname.com\"\n\nmail = Mail(app)\n\nhtml = \"\"\"\n\u003cp\u003eThanks for using Flask-Mailing\u003c/p\u003e \n\"\"\"\n\n\n@app.post(\"/email\")\nasync def simple_send():\n    message = Message(\n        subject=\"Flask-Mailing module\",\n        recipients=[\"recipients@email-domain.com\"],  # List of recipients, as many as you can pass \n        body=html,\n        subtype=\"html\"\n        )\n    await mail.send_message(message)\n    return jsonify(status_code=200, content={\"message\": \"email has been sent\"})     \n```\n\n# 🪜 List of Examples\n\nFor more examples of using flask-mailing please check [example](https://marktennyson.github.io/flask-mailing/example/) section\n\n# 👍 Contributing\nFeel free to open issues and send pull requests.\n\n## 😀 Contributors ✨\n\nThanks go to these wonderful people ([🚧]):\n\n\n\u003ctable\u003e\n\u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/marktennyson\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/46404058?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAniket Sarkar\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#maintenance-tbenning\" title=\"Answering Questions\"\u003e💬\u003c/a\u003e \u003ca href=\"https://github.com/marktennyson/flask-mailing\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"#maintenance-jakebolam\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\u003c/td\u003e\u003cbr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/jfkinslow\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/4458739?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJoshua Kinslow\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/agramfort\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/161052?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAlexandre Gramfort\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/ahmetkurukose\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/1325263?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003e\nahmetkurukose\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Sriram-bb63\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/71959217?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003e\nSriram\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/CharlesTWood\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/31315150?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eCharlesTWood\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\nThis project follows the [all-contributors](https://allcontributors.org) specification.\nContributions of any kind are welcome!\n\nBefore you start please read [CONTRIBUTING](https://github.com/marktennyson/flask-mailing/blob/main/CONTRIBUTING.md)\n\n\n\n# 📝 LICENSE\n\n[MIT](https://raw.githubusercontent.com/marktennyson/flask-mailing/development/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarktennyson%2Fflask-mailing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarktennyson%2Fflask-mailing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarktennyson%2Fflask-mailing/lists"}