SimpLog.Email 0.0.2-alpha.1

Prefix Reserved
This is a prerelease version of SimpLog.Email.
There is a newer version of this package available.
See the version list below for details.
dotnet add package SimpLog.Email --version 0.0.2-alpha.1                
NuGet\Install-Package SimpLog.Email -Version 0.0.2-alpha.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SimpLog.Email" Version="0.0.2-alpha.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SimpLog.Email --version 0.0.2-alpha.1                
#r "nuget: SimpLog.Email, 0.0.2-alpha.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install SimpLog.Email as a Cake Addin
#addin nuget:?package=SimpLog.Email&version=0.0.2-alpha.1&prerelease

// Install SimpLog.Email as a Cake Tool
#tool nuget:?package=SimpLog.Email&version=0.0.2-alpha.1&prerelease                

What is SimpLog

Simple and very flexible tool for development with .NET Core. Saves logs to a file, or a database where you want. Also gives opportunity to receive logs via email with the proper configuration. SimpLog.Email is for those who want to use only the functionality of sending through email the log.

Log Types in SimpLog

Type Description
Trace This should be used during development to track bugs, but never committed to your VCS.
Debug Log at this level about anything that happens in the program. This is mostly used during debugging, and I’d advocate trimming down the number of debug statement before entering the production stage, so that only the most meaningful entries are left, and can be activated during troubleshooting.
Info Log at this level all actions that are user-driven, or system specific (ie regularly scheduled operations…)
Notice This will certainly be the level at which the program will run when in production. Log at this level all the notable events that are not considered an error.
Warn Log at this level all events that could potentially become an error. For instance if one database call took more than a predefined time, or if an in-memory cache is near capacity. This will allow proper automated alerting, and during troubleshooting will allow to better understand how the system was behaving before the failure.
Error Log every error condition at this level. That can be API calls that return errors or internal error conditions.
Fatal Too bad, it’s doomsday. Use this very scarcely, this shouldn’t happen a lot in a real program. Usually logging at this level signifies the end of the program. For instance, if a network daemon can’t bind a network socket, log at this level and exit is the only sensible thing to do.

Features of SimpLog.Email

Features Description
📧 Email notifications With SimpLog.Email you can also send emails with the logs.

Configuration

In Program.cs

Nothing needed

In Controller

private SimpLog.Email.Services.SimpLogServices.SimpLog _simpLog = new SimpLog.Email.Services.SimpLogServices.SimpLog();

and call the log like

_simpLog.Trace("place your message here");

options are as follows

_simpLog.Info({1}, {2}, {3}); 

and only {1} is required

Option Short Description Full Description
{1} Message The message you want to log.
{2} Log Type Type of the log
{3} Send Email If it is set to false the email notifications will be disabled only for this instance. If null or true, depending on the appsettings.json file EmailConfiguration section.

In simplog.json

Create simplog.json file in the root folder of your startup project. On the same level where is appsettings.json. Please have in mind that every configuration in simplog.json is optional ☺️

{
    "Email_Configuration": {                -> Email configuration.
      "SendEmail_Globally": bool,           -> Field to disable sending emails globally. Default value is true.
      "Email_From": string,                 -> Who will be the sender of your emails.
      "Email_To": string,                   -> Who will be the recipient of the emails.
      "Email_BCC": string,                  -> If you want, you can add blind copy.
      "Email_Connection": {                 -> Email configuration to the email service provider.
        "Host": string,
        "Port": string,
        "API_Key": string,
        "API_Value": string
      }
    },
    "LogType": {
      "Trace": {                            -> TYPE OF LOG == Trace.
        "SendEmail": true,                  -> For the TYPE OF LOG, should be enabled or disabled sending emails. Default value is true.
      },
      "Debug": {                            -> Analogically TYPE OF LOG here is Debug 
        "SendEmail": true,
      },
      "Info": {                             -> Analogically TYPE OF LOG here is Info
        "SendEmail": true,
      },
      "Notice": {                           -> Analogically TYPE OF LOG here is Notice
        "SendEmail": true,
      },
      "Warn": {                             -> Analogically TYPE OF LOG here is Warn
        "SendEmail": true,
      },
      "Error": {                            -> Analogically TYPE OF LOG here is Error
        "SendEmail": true,
      },
      "Fatal": {                            -> Analogically TYPE OF LOG here is Fatal
        "SendEmail": true,
      }
  }

Hope you enjoy the NuGet Package! 😉

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net5.0

    • No dependencies.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on SimpLog.Email:

Package Downloads
SimpLog

A simple way of logging event in a log files. Can be set up to save into a file, send logs to an email or to save them in a database. Works for NetCore versions

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 100 9/17/2024
1.0.0 163 4/20/2024
0.0.2-alpha.1 140 11/30/2023
0.0.1-alpha.1 70 11/30/2023

- separated version for sending email