Lefty.Email 0.1.2

lemail

.NET tool to send emails through SMTP, or Resend.

Installing

To install the tool as a repository tool, run the following command in the root of your repository:

> dotnet tool install --local Lefty.Email --create-manifest-if-needed

If you'd rather have the tool installed globally in your machine, run the following command:

> dotnet tool install --global Lefty.Email

Senders

When using smtp sender (default):

When using resend sender:

> set EMAIL_SENDER=resend
> set RESEND_APITOKEN=<api>

Example

The tool accepts a single argument, which is the name of a Json file.

> cat email.json
{
   "from": "Master Yoda <yoda@dagobah.sw>",
   "to": "Luke Skywalker <lskywalker19@tatooine.sw>",
   "subject": "Reminder",
   "htmlBody": "<h1>Use the force</h1>"
}
> dotnet lemail email.json

It is also possible to pipe JSON to the command:

> cat email.json | dotnet lemail --stdin

Usage patterns

The tool supports all of the following usage patterns to construct the email message to send:

• JSON (file, or piped in)
• Environment variables, only if --env is provided)
• CLI options

Json format

The format of the file is as follows:

An Email can be expressed as follows:

• lskywalker19@tatooine.sw - Just the e-email address
• Luke Skywalker <lskywalker19@tatooine.sw> - With display name

Environment variables

The following variables will be evaluated, but only if --env option is provided in the command line.

CLI options

> dotnet lemail --help
Email sender

Usage: lemail [options] <InputFile>

Arguments:
  InputFile       Input JSON file

Options:
  --version       Show version information.
  -f|--from       Sender email address
  -t|--to         Recipient email address
  -s|--subject    Subject
  -h|--html-file  HTML file
  -x|--text-file  Text file
  -X|--text       Text content
  --stdin         Read JSON from stdin
  -e|--env        Load sender/recipient from environment variables
  -?|--help       Show help information