Tolitech.Infrastructure.Mail 1.0.0-preview.5

Tolitech.Infrastructure.Mail

A comprehensive .NET library providing essential utilities for sending emails asynchronously. It simplifies SMTP configuration, supports advanced email features, and integrates seamlessly with .NET applications.

Features

• Easy SMTP configuration
• Asynchronous email sending
• Customizable sender address
• CC and BCC support
• HTML template support
• Detailed error logging

Installation

Add the NuGet package to your project:

dotnet add package Tolitech.Infrastructure.Mail

Getting Started

1. Configure SMTP Settings

Add your SMTP settings to your application's configuration (e.g., appsettings.json):

{
  "SmtpSettings": {
    "Host": "smtp.your-email-provider.com",
    "Port": 587,
    "From": "your-email@example.com",
    "Username": "your-email@example.com",
    "Password": "your-email-password"
  }
}

2. Register Services

Use the extension method to register mail services:

using Tolitech.Infrastructure.Mail;

var builder = WebApplication.CreateBuilder(args);
builder.Services.ConfigureMail(builder.Configuration);

3. Implement the Email Service

Create a class that inherits from BaseEmailService:

public class EmailService : BaseEmailService
{
    public EmailService(SmtpClient smtpClient, IOptions<SmtpSettings> smtpOptions, ILogger<EmailService> logger)
        : base(smtpClient, smtpOptions, logger)
    {
    }
}

4. Send an Email

Use your service to send an email:

await emailService.SendEmailAsync(
    to: "recipient@example.com",
    subject: "Test Email",
    content: "This is a test email sent using Tolitech.Infrastructure.Mail.",
    from: "your-email@example.com"
);

Advanced Usage

Sending Emails with CC and BCC

await emailService.SendEmailAsync(
    to: "recipient@example.com",
    subject: "Test Email with CC and BCC",
    content: "This email includes CC and BCC recipients.",
    cc: "cc@example.com",
    bcc: "bcc@example.com"
);

Using HTML Templates

string htmlContent = await emailService.GetHtmlTemplateAsync("Templates/EmailTemplate.html");
await emailService.SendEmailAsync(
    to: "recipient@example.com",
    subject: "Email with HTML Template",
    content: htmlContent
);

Error Logging

The library provides detailed logging for email sending errors and template retrieval issues, helping you monitor and debug the process effectively.

Tolitech.Infrastructure.Mail makes email sending in .NET robust, flexible, and easy to integrate.