PommaLabs.Liquimail
2.7.0
Prefix Reserved
dotnet add package PommaLabs.Liquimail --version 2.7.0
NuGet\Install-Package PommaLabs.Liquimail -Version 2.7.0
<PackageReference Include="PommaLabs.Liquimail" Version="2.7.0" />
paket add PommaLabs.Liquimail --version 2.7.0
#r "nuget: PommaLabs.Liquimail, 2.7.0"
// Install PommaLabs.Liquimail as a Cake Addin #addin nuget:?package=PommaLabs.Liquimail&version=2.7.0 // Install PommaLabs.Liquimail as a Cake Tool #tool nuget:?package=PommaLabs.Liquimail&version=2.7.0
Liquimail
Liquimail implements glue code to use Liquid templates with MailKit.
Library is feature complete and no further development is planned on this project, except for routine maintenance and bug fixes.
Liquimail templates are processed using DotLiquid library and mail messages are sent with MailKit.
Liquid templates can be stored in three different ways:
- Local file system,
- Embedded resources,
- SQL database table.
A fake, in-memory mail sender is also provided in order to easily perform unit tests.
Table of Contents
Install
NuGet package PommaLabs.Liquimail is available for download:
dotnet add package PommaLabs.Liquimail
Another package, PommLabs.Liquimail.AspNetCore, which is focused on ASP.NET Core integrations, is also available for download:
dotnet add package PommaLabs.Liquimail.AspNetCore
Usage
Liquimail exposes two main interfaces:
- IMailSender, which actually sends mail messages.
- IMailTemplatesManager, which loads mail templates.
Configuring the first interface is mandatory, while the second one is needed
only when using SendMail
overloads which use the templating system based on DotLiquid.
Maintainers
Contributing
MRs accepted.
Small note: If editing the README, please conform to the standard-readme specification.
Editing
Visual Studio Code, with Remote Containers extension, is the recommended way to work on this project.
A development container has been configured with all required tools.
Visual Studio Community is also supported
and an updated solution file, liquimail.sln
, has been provided.
Restoring dependencies
When opening the development container, dependencies should be automatically restored.
Anyway, dependencies can be restored with following command:
dotnet restore
Running tests
Tests can be run with following command:
dotnet test
Tests can also be run with following command, which collects coverage information:
./build.sh --target run-tests
License
MIT © 2018-2025 PommaLabs Team and Contributors
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
-
net8.0
- AngleSharp (>= 1.1.2)
- DotLiquid (>= 2.2.717)
- MailKit (>= 4.8.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 9.0.0)
-
net9.0
- AngleSharp (>= 1.1.2)
- DotLiquid (>= 2.2.717)
- MailKit (>= 4.8.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 9.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on PommaLabs.Liquimail:
Package | Downloads |
---|---|
PommaLabs.Liquimail.AspNetCore
Liquimail implements glue code to use Liquid templates with MailKit. This package contains ASP.NET Core extensions, helpers and components. For example, this package contains an health check which makes sure that SMTP server is reachable. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.7.0 | 200 | 11/27/2024 |
2.6.0 | 5,121 | 11/18/2023 |
2.5.1 | 971 | 12/18/2022 |
2.5.0 | 102 | 12/17/2022 |
2.4.0 | 5,802 | 11/21/2021 |
2.3.5 | 772 | 8/29/2021 |
2.3.4 | 236 | 8/19/2021 |
2.3.3 | 2,278 | 4/5/2021 |
2.3.2 | 510 | 4/4/2021 |
2.3.0 | 1,164 | 2/7/2021 |
2.2.0 | 674 | 11/21/2020 |
2.1.2 | 1,719 | 6/15/2020 |
2.1.1 | 662 | 6/14/2020 |
2.1.0 | 670 | 6/14/2020 |
2.0.2 | 570 | 6/11/2020 |
2.0.1 | 488 | 6/1/2020 |
2.0.0 | 599 | 3/9/2020 |
1.2.2 | 529 | 3/2/2020 |
1.2.1 | 557 | 2/23/2020 |
1.2.0 | 758 | 1/2/2020 |
1.1.6 | 2,462 | 8/31/2019 |
1.1.5 | 2,539 | 2/28/2019 |
1.1.4 | 1,601 | 12/28/2018 |
1.1.3 | 1,374 | 11/11/2018 |
1.1.2 | 1,447 | 9/1/2018 |
1.1.0 | 1,263 | 8/22/2018 |
1.0.2 | 872 | 8/17/2018 |
1.0.1 | 913 | 8/14/2018 |
1.0.0 | 1,068 | 6/2/2018 |
0.1.0 | 987 | 5/27/2018 |