Skip to content

Changelog

Version 3.0.1

Release Date: November 3, 2026

๐Ÿ› Bug Fixes

  • Invalid Content-Transfer-Encoding on multipart messages (#67): the outer multipart/* container was given Content-Transfer-Encoding: base64 because the charset was set on the container itself. RFC 2045 ยง6.4 only allows 7bit, 8bit or binary for multipart entities, and Python's email parser reported InvalidMultipartContentTransferEncodingDefect. The charset is now applied only to individual text parts. Attachments keep their base64 encoding, and decoded content is unchanged. Reported by @filak, who also found the cause and suggested the fix. Thank you!

๐Ÿงช Tests

  • Added a regression test that serializes and re-parses a message with HTML and an attachment, and checks that it has no MIME defects (#67).

๐Ÿ› ๏ธ Build & CI

  • Docker image build fixed: the dependency install step ran before README.md, LICENSE and the flask_mailing/utils subpackage were copied into the image, so pip install -e . failed. All files the build needs are now copied first.
  • Fixed a new ruff lint failure (PLC0207) in the test suite.

Version 3.0.0 ๐Ÿš€ 2026-Ready Release

Release Date: November 29, 2025

๐ŸŒŸ Future-Proof Architecture

This major release transforms Flask-Mailing into a 2026-ready email solution with cutting-edge Python features, enhanced security, and modern development practices.

๐Ÿ”ฅ Breaking Changes

  • Minimum Python version raised to 3.10 (modern union syntax support)
  • Minimum Flask version raised to 3.1 (latest Flask with async support)
  • Pydantic v2.11+ required (latest validation with ConfigDict)
  • Dependencies updated to latest stable versions
  • Enhanced type safety with stricter validation
  • Improved async context manager patterns

โœจ New Features

  • ๐Ÿš€ Python 3.10-3.14 support with modern union operators (|) and built-in generics
  • ๐Ÿ›ก๏ธ Advanced security module with RateLimiter and EmailSecurityValidator
  • โšก Enhanced async/await patterns with proper context managers
  • ๐Ÿ”’ Improved path traversal protection and content sanitization
  • ๐Ÿ“Š Rate limiting system to prevent abuse
  • ๐Ÿ” Email security validation with disposable email detection
  • ๐Ÿ—๏ธ Modern build system with ruff, mypy, and enhanced tooling

๐Ÿ“ฆ Updated Dependencies

  • aiosmtplib >= 4.0.2 (latest async SMTP client)
  • flask >= 3.1.0 (latest Flask with all security updates)
  • pydantic >= 2.11.0 (modern validation with v2.11 API)
  • pydantic-settings >= 2.9.0 (settings management)
  • email-validator >= 2.3.0 (enhanced email validation)
  • werkzeug >= 3.1.3 (latest WSGI utilities)
  • jinja2 >= 3.1.6 (modern templating)
  • typing-extensions >= 4.13.0 (extended typing support)
  • asgiref >= 3.9.0 (ASGI utilities)
  • blinker >= 1.9.0 (signals support)

๐Ÿ› ๏ธ Developer Experience

  • โœ… Modern pyproject.toml with ruff, black, isort, mypy configuration
  • โœ… Enhanced CI/CD pipeline with Python 3.10-3.14 support
  • โœ… Docker containerization support
  • โœ… Comprehensive security scanning
  • โœ… Better error messages with exception chaining
  • โœ… Type safety improvements throughout codebase

๐Ÿ”ง Performance & Reliability

  • โšก Connection timeout handling (30s default)
  • ๐Ÿ”„ Better connection cleanup in async contexts
  • ๐Ÿ“ˆ Improved memory usage with modern Python features
  • ๐Ÿ›ก๏ธ Enhanced error recovery mechanisms

๐Ÿ“š Documentation

  • Updated all documentation for v3.0.0
  • Modern code examples with Flask 3.1+ patterns
  • Comprehensive API reference tables
  • Installation guide with optional dependencies

Version 2.1.0

Release Date: August 30, 2025

๐Ÿš€ Major Release - Python 3.13 & Flask 3 Ready

This is a major modernization release that brings Flask-Mailing to 2026 standards.

Breaking Changes

  • Minimum Python version raised to 3.9 (was 3.6+)
  • Minimum Flask version raised to 3.0 (was 2.0+)
  • Updated all dependencies to modern versions
  • Removed deprecated Python 2/3.6/3.7/3.8 compatibility code

Added

  • โœ… Full Python 3.13 compatibility
  • โœ… Full Flask 3.x compatibility
  • โœ… Modern pyproject.toml configuration
  • โœ… Type annotations improvements
  • โœ… Better error handling and validation
  • โœ… py.typed file for better IDE support

Updated

  • ๐Ÿ“ฆ Dependencies modernized:
  • aiosmtplib >= 3.0.0
  • flask >= 3.0.0
  • pydantic >= 2.0.0
  • email-validator >= 2.0.0
  • httpx >= 0.25.0
  • werkzeug >= 3.0.0
  • typing-extensions >= 4.0.0

Fixed

  • ๐Ÿ› Pydantic v2 compatibility - Fixed deprecated Config class usage
  • ๐Ÿ› Type annotation improvements - Better type safety
  • ๐Ÿ› Email validation modernized - Uses latest email-validator
  • ๐Ÿ› Async/await patterns improved - Better async support
  • ๐Ÿ› Import error handling - Graceful dependency handling

Deprecated

  • โš ๏ธ Python < 3.9 support removed
  • โš ๏ธ Flask < 3.0 support removed

Development & Testing

  • ๐Ÿงช Test suite updated for modern pytest
  • ๐Ÿงช Tox configuration updated for Python 3.9-3.13
  • ๐Ÿงช CI/CD ready for modern Python versions

Migration Guide

To upgrade to v3.0.0: 1. Upgrade Python to 3.9+ (recommended: 3.11+ for best performance) 2. Upgrade Flask to 3.0+ 3. Update your requirements.txt with new minimum versions 4. Test your application - most APIs remain the same


Version 0.2.3

Release Date: September 19, 2023

Added

  • Introduced compatibility with Pydantic V2, ensuring seamless integration with the latest versions.

Fixed

  • Resolved several bugs related to configuration handling and email validation.
  • Improved overall stability and robustness of the library.

Version 0.2.2

Release Date: January 14, 2023

Updated

  • Enhanced the setup.py to streamline installation and dependency management.
  • Revised the README file for better clarity and up-to-date documentation.

Fixed

  • Addressed versioning inconsistencies to avoid compatibility issues.

Added

  • Full compatibility with Python 3.11.

Version 0.2.1

Release Date: January 11, 2023

Fixed

  • Resolved aioredis compatibility issues for Python 3.11.
  • Fixed a critical bug in the httpx library dependency.

Version 0.2.0

Release Date: Febuary 16, 2022

Added

  • Introduced send_mail and send_mass_mail methods, similar to Django or Flask-Mailman.
  • Added extensive docstrings for better API understanding.
  • Expanded the test suite with additional test cases to ensure reliability.

Fixed

  • Corrected a significant issue in the MAIL_START_TLS and MAIL_START_SSL configurations in the ConnectionConfig module.

Version 0.1.1

Release Date: January 19, 2022

Added

  • Enabled compatibility with aioredis > 2.0.0.
  • Introduced asynchronous support for the utils.email_check.EmailChecker class.

Fixed

  • Resolved test case issues with the fake Redis client.
  • Corrected typos in the utils.email_check file.

Updated

  • Updated the utils.email_check.EmailChecker class for the latest version of aioredis.
  • Refined dependency management to ensure compatibility with new versions.

Version 0.1.0

Release Date: January 12, 2022

Added

  • Included support for template parameters via the template_params variable in the schemas.Message class.
  • Added module-level docstrings to improve documentation clarity.
  • Documented a future roadmap for feature enhancements.
  • Expanded compatibility to Python 3.10.
  • Enabled users to create custom headers for email attachments.

Fixed

  • Resolved issue #20, allowing seamless usage of template parameters.
  • Addressed typos and configuration errors in the setup.py file.
  • Fixed broken test cases and improved test coverage.
  • Corrected variable naming issues in the config.ConnectionConfig class.
  • Fixed Literal import issues for Python 3.6 and 3.7.

Updated

  • Revised the MANIFEST.in file for better packaging.
  • Updated dependencies to the latest stable versions.

Older Versions

Version 0.0.7

  • Fixed the "long description not found" issue on the PyPI website.

Version 0.0.6

  • Enabled access to the Mail object via app.extensions['mailing'].

Version 0.0.5

  • Added a new configuration variable, MAIL_DEFAULT_SENDER, with functionality similar to MAIL_FROM.
  • Fixed the absence of the httpx module in setup.py.
  • Renamed MAIL_SSL and MAIL_TLS to MAIL_USE_SSL and MAIL_USE_TLS, respectively.
  • Introduced the add_recipient and attach methods in the schemas.Message class.
  • Updated documentation and resolved broken test cases.

Version 0.0.4

  • Added setup details to pyproject.toml to resolve dependency errors.

Version 0.0.2

  • Updated dependencies.