v2.0.0

Release Notes - v2.0.0

This major release introduces a significant enhancement to the App Engine Mail API, enabling SMTP fallback support alongside the existing App Engine Mail service.

🚀 New Features

SMTP Support for Mail API

• App Engine Mail API now includes an SMTP backend, allowing applications to send emails via an external SMTP server when the standard App Engine Mail service is not available or preferred.
• New environment variables for configuration:
  • APPENGINE_USE_SMTP_MAIL_SERVICE: Set to 'true' to enable SMTP usage.
  • APPENGINE_SMTP_HOST: The hostname of the SMTP server (Required).
  • APPENGINE_SMTP_PORT: The port of the SMTP server (Default: 587).
  • APPENGINE_SMTP_USER: Username for SMTP authentication.
  • APPENGINE_SMTP_PASSWORD: Password for SMTP authentication.
  • APPENGINE_SMTP_USE_TLS: Enable/disable TLS (Default: true).

Admin Email via SMTP

• New environment variable APPENGINE_ADMIN_EMAIL_RECIPIENTS allows specifying a list of comma-separated email addresses to receive admin notifications when using the SMTP service.

🐛 Bug Fixes & Improvements

• Improved error handling for email sending failures.
• Updated setup.py version to 2.0.0.

📦 Compatibility

• Includes comprehensive unit tests for the new SMTP functionality.
• Verified compatibility with existing App Engine Mail API usage (default behavior remains unchanged unless explicitly configured).

Full Changelog: v1.2.0-beta...v2.0.0

Releasing beta version for changes to modules API.

This release adds Admin API implementation to modules API. All the modules APIs have an admin API implementation where instead of making a call to appserver, direct call is made to admin API. The appserver implementation still exists and customers can toggle the usage between the two implementations by setting an environment variable in their applications app.yaml.
To opt in for the admin API implementation, customers can add the following to their application's app.yaml :

env_variables:
  APPENGINE_MODULES_USE_ADMIN_API: "true"

Key Features:

• Admin API implementation: Added admin API implementations for all modules APIs. Customers can opt in to these implementations using APPENGINE_MODULES_USE_ADMIN_API environment variable. Customers do not need to make any changes in the way they call these modules APIs.

Releasing beta version for testing changes to mail API.

This release introduces a major feature to the App Engine Mail API: the ability to send emails via an
external SMTP service. This provides a more flexible and robust way to send emails from your App Engine
application.

Mail API: SMTP Support

Key Features:

• SMTP Mail Sending: Implemented the ability to send emails through a configured SMTP server. This
  functionality can be enabled by setting the USE_SMTP_MAIL_SERVICE environment variable.
• Admin Email Support: AdminEmailMessage is now supported when using the SMTP transport. Recipients for
  admin emails are configured via the ADMIN_EMAIL_RECIPIENTS environment variable.
• Error Handling & Resilience: Added specific error handling for common SMTP issues, such as authentication
  and connection errors, which are now surfaced as standard Mail API exceptions.
• Comprehensive Tests: A full suite of unit tests has been added to ensure the reliability and correctness
  of the new SMTP sending functionality under various conditions.

v1.1.11

This release uses the 'legacy-cgi' package instead of the traditional cgi package which got removed from python 3.13.
legacy-cgi is used for python versions above 3.9.

v1.1.9

This version introduces a new environment variable (POOL_SIZE_URLLIB3) which can be used the configure the urllib3 connection pool size.
The value of this variable can be set in the range [10,100]. this value defaults to 10 in any other case. To use this feature, version number in requirements.txt should be such that v1.1.9 or above is picked up. (valid examples: appengine-python-standard>=1.0 or appengine-python-standard==1.1.9)

Example app.yaml file:

runtime: python39
app_engine_apis: true
env_variables:
          POOL_SIZE_URLLIB3: 50

v1.1.8

This version introduces a new environment variable which can be used the configure the urllib3 connection pool size.

v1.1.7

Bump version to 1.1.7 (#126)

v1.1.6

This version includes an update to the NDB package - the msgprop module was added to provide back-compatibility with App Engine first generation.

Additionally, an internal package was added to support this module - google.appengine._internal.protorpc.

v1.1.5

Update the Memcache SDK with 'peek' methods to fetch item timestamps.

v1.1.4

Limiting use of deprecated package - imp for python3.x