Lurgle.Alerting 1.2.2

Alerting library that accelerates getting projects up and running with FluentEmail. Use text/HTML or Razor, Fluid, or Handlebars templates!

Install-Package Lurgle.Alerting -Version 1.2.2

dotnet add package Lurgle.Alerting --version 1.2.2

<PackageReference Include="Lurgle.Alerting" Version="1.2.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Lurgle.Alerting --version 1.2.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Lurgle.Alerting, 1.2.2"

#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.

// Install Lurgle.Alerting as a Cake Addin
#addin nuget:?package=Lurgle.Alerting&version=1.2.2

// Install Lurgle.Alerting as a Cake Tool
#tool nuget:?package=Lurgle.Alerting&version=1.2.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Readme

Why alert when you can Lurgle?

Lurgle.Alerting is an implementation of FluentEmail that accelerates getting your project up and running with email alerting. It bundles the Smtp and MailKit senders with Razor, Liquid, and Handlebars template rendering, and adds bonuses like an integrated mail host connectivity check, debug mode that helps avoid data leakage, inbuilt automatic handling of comma/semi-colon delimited emails, and email address validation. It includes settings for default Mail From, To, and Debug email addresses, along with a default subject - so you can add Lurgle and start sending simple alerts without specifying the email address every time! You can even have email addresses in your config file and load them from config at need.

The net effect is a predictable alerting implementation with good templating capabilities to suit your needs, that preserves and enhances the FluentEmail approach to building and sending emails.

You can use Lurgle.Alerting by itself, or with Lurgle.Logging to Lurgle your apps even further with a standardised Serilog implementation!

Keep an eye on my Blog of Doom for updates about the latest releases!

Why alert when you can Lurgle?

The net effect is a predictable alerting implementation with good templating capabilities to suit your needs, that preserves and enhances the FluentEmail approach to building and sending emails.

You can use Lurgle.Alerting by itself, or with Lurgle.Logging to Lurgle your apps even further with a standardised Serilog implementation!

Keep an eye on my Blog of Doom for updates about the latest releases!

Release Notes

- Add MailKit as default sender
- Add mail host authentication
- Add additional targets
- Add test Razor template
- Add XML docs
- Code refactor
- Add AlertConfig constructor for passing config and optional overrides
- Expose MailTestTimeout to allow configuring the SMTP mail host test timeout (or disable with 0)
- Add MailSubject config to allow configuring a default subject
- Add sending an attachment from a stream
- Add Alerting.SetDebug for global debug mode
- Add MailDebug setting
- Consistently handle comma delimited email address strings
- Filter out invalid email addresses
- Validate default MailHost, From, To, Debug, Subject configs and return results to Alerting.AlertFailures
- Add Handlebars renderer, based on https://github.com/matthewturner/FluentEmail.Handlebars
- Automatically determine attachment content type
- Expose errors on send for examination by code
- Add unit tests
- Add processing for plain text and HTML