playframework/play-mailer
55.0
Adequate · 6 November 2026
896
lines of production code
Scala
with Java
4
measurements over time
What this system is
Features
Added compile-time DI sample with Jakarta Mail support
The samples/compile-timeDI location now includes a new sample application demonstrating compile-time dependency injection in Play. This sample uses the Jakarta Mail library (via commons-mail2) to send emails with inline attachments using Content-IDs, and updates the SMTP configuration host from typesafe.org to example.org.
samples/compile-timeDI · high confidence
Added compile-time and runtime DI sample applications
New sample projects for compile-time and runtime dependency injection have been added to the samples directory. The compile-time DI sample demonstrates a basic setup using \SimpleApplicationLoader\ with routes for sending emails, while the runtime DI sample provides Java and Scala controllers for sending emails, including an example of configuring a custom mailer module. Both samples are configured to build with sbt 2.1.0-M3 and the Play 3.1.0-M10 snapshot plugin.
samples · high confidence
Guice integration module added for Play Mailer
A new \play-mailer-guice\ module has been introduced to provide Google Guice bindings for the Play Mailer library. This includes \MailerModule\ and \SMTPConfigurationModule\ which wire \MailerClient\, \JMailerClient\, and \SMTPConfiguration\ to their implementations (such as \SMTPDynamicMailer\ and \MockMailer\), along with a \reference.conf\ file to automatically enable these modules in Guice-based Play applications.
play-mailer-guice, play-mailer-guice/src/main/scala/play/api/libs/mailer · high confidence
Removals
Removal of legacy Play Framework build configuration
The build configuration files for the inject sample project have been removed, including Build.scala, build.properties, and plugins.sbt. This eliminates the previous setup which relied on SBT 0.11.2 and the Play Framework 2.0-RC3 sbt plugin, effectively cleaning up the project structure by removing these specific build artifacts.
inject/sample/project · high confidence
Removal of legacy SBT build configuration
The SBT build files (Build.scala and build.properties) for the inject plugin have been removed from the repository. This eliminates the previous build setup which targeted Play Framework version 2.0-RC3 and used SBT 0.11.2, along with its associated dependencies like the OW2 Atinject spec and Guice annotations.
inject/project · high confidence
Removal of legacy inject sample application
The \inject/sample\ directory has been cleared of its previous Java-based sample application, including the controller, service classes, dependency module, views, and static assets. This change removes the old static injection example to prepare the location for a new sample demonstrating a staticless manual injection approach.
inject/sample · high confidence
Removal of the legacy Guice-based dependency injection plugin
The \inject\ module's legacy plugin implementation, which relied on a custom \MiniGuice\ injector and the \InjectPlugin\ framework, has been removed. This eliminates the ability to use the previous configuration-driven injection mechanism (via \inject.package\, \inject.modules\, and \inject.filter\) and the \InjectViaMiniGuicePlugin\ for automatic class scanning and injection in Play applications.
inject/src · high confidence
Behavioural changes
Default SSL server identity verification enabled
The play-mailer module now includes a default configuration file (reference.conf) that enables SSL server identity verification by default (play.mailer.props.ssl.checkserveridentity=true). This change improves security by ensuring that SSL certificates are validated against the server identity, reducing the risk of man-in-the-middle attacks when using SSL/TLS for email transmission. Users relying on the previous implicit behavior may notice stricter certificate validation, which could affect connections to servers with self-signed or mismatched certificates.
play-mailer · high confidence
Migration to Jakarta EE and support for streaming attachments
The mailer library has migrated its underlying dependencies from the legacy JavaMail API to the Jakarta Mail and Jakarta Activation namespaces, and switched the email sending engine to Apache Commons Email 2 (Jakarta). This change enables new attachment capabilities, allowing users to attach files via \java.io.File\, \java.net.URL\, or \jakarta.activation.DataSource\ in addition to raw byte arrays, which facilitates streaming large attachments without loading them entirely into memory. The configuration model has also been updated to support arbitrary SMTP properties via a new \props\ configuration block.
play-mailer/src/main/scala/play/api/libs/mailer · high confidence
Migration to Jakarta Mail API and new streaming attachment support
The play-mailer library has been updated to use the Jakarta Mail API (commons-email2) instead of the legacy JavaMail API, which may require users to update their dependency imports. Additionally, the \Attachment\ class now supports streaming attachments via \DataSource\ and \URL\ types, allowing for more efficient handling of large files without loading them entirely into memory.
play-mailer/src/main/java/play/libs/mailer · high confidence
Removal of legacy Play 1.x configuration and plugin files
The sample application in the \inject/sample/conf\ directory has removed its legacy Play 1.x configuration files, including \application.conf\, \play.plugins\, and \routes\. This cleanup eliminates the old dependency injection plugin registration (\InjectViaMiniGuicePlugin\) and the previous routing and application settings, aligning the sample with the new inject plugin structure.
inject/sample/conf · high confidence
Updated runtime DI sample to use Jakarta EE and inline image attachments
The runtime dependency injection sample has been updated to use the Jakarta EE namespace (jakarta.inject) and the Apache Commons Mail 2 Jakarta library, replacing the previous javax-based imports. The sample controllers now demonstrate sending emails with inline attachments using Content-IDs (cid), and include a new custom SMTP configuration module that binds to example.org:1234, allowing users to see how to override default mailer settings via runtime DI.
samples/runtimeDI · high confidence
Test coverage
Added tests for Guice integration and configuration validation; Added tests for MailerPlugin SMTP configuration and email creation.
Dependencies
Build infrastructure upgraded to sbt 2.1.0-M3 and Play 3.1.0-M10
The project's build system has been upgraded to use sbt version 2.1.0-M3, replacing the previous 1.x series. Dependency management is now centralized in a new \project/Dependencies.scala\ file, which defines Scala 2.13.18 and Scala 3.3.8 as the primary published versions, while also supporting Scala 3.9.0 and 3.10.0-RC3 for testing. The Play framework dependency is set to version 3.1.0-M10-e1f3c2a9-SNAPSHOT, configurable via system properties or environment variables. Common build settings, including organization details, licenses, and compiler options, have been consolidated into a new \project/Common.scala\ auto-plugin.
project · high confidence
Upgrade to Play 2.8, Scala 3, and Jakarta EE dependencies
The build has been updated to support Play 2.8 and Scala 3 (including versions 3.3.x and 3.9.x), requiring Java 17. Core dependencies have been migrated to Jakarta EE namespaces, specifically using \jakarta.inject-api\ 2.0.1 and \commons-email2-jakarta\ 2.0.0-M1, while \guice\ is upgraded to version 7.0.0. The \play-mailer\ module now depends on \typesafe:config\ 1.4.9 and \slf4j-api\ 2.0.20. Sample applications for compile-time and runtime DI have been added to demonstrate these updates.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 57 → 55 (-1.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 60 → 60 (+0.0)
- Architecture 81 → 81 (+0.0)
- Maturity 49 → 49 (+0.0)
- Readiness 68 → 66 (-1.7)
- Security 61 → 54 (-6.8)
Resolved (2)
- Documentation: no installation or build instructions (README.md)
- Documentation: no usage examples (README.md)
New (1)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
Changes since last survey
- 6 commits — 6 feature/other, 0 fixes
By area
- (repo) — 3 commits
- project/build.properties — 2 commits
- project/Dependencies.scala — 1 commit
Notable commits
- change: Merge pull request #609 from scala-steward/update/sbt-2.1.0-RC2
- change: Merge pull request #610 from scala-steward/update/patches
- change: Merge pull request #613 from scala-steward/update/sbt-2.1.0-RC3
- change: sbt 2.1.0-RC2 (was 2.1.0-RC1)
- change: sbt 2.1.0-RC3 (was 2.1.0-RC2)
- change: scala3-library 3.3.9 (was 3.3.8) + scala 3.10.0
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
playframework/play-mailer was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit f70a51af91ec3a815f1c5af2a2cea4328005cf57 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-410a2463fa58.