nanoFramework.Logging 1.1.157

Prefix Reserved
dotnet add package nanoFramework.Logging --version 1.1.157
                    
NuGet\Install-Package nanoFramework.Logging -Version 1.1.157
                    
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="nanoFramework.Logging" Version="1.1.157" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="nanoFramework.Logging" Version="1.1.157" />
                    
Directory.Packages.props
<PackageReference Include="nanoFramework.Logging" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add nanoFramework.Logging --version 1.1.157
                    
#r "nuget: nanoFramework.Logging, 1.1.157"
                    
#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.
#addin nuget:?package=nanoFramework.Logging&version=1.1.157
                    
Install as a Cake Addin
#tool nuget:?package=nanoFramework.Logging&version=1.1.157
                    
Install as a Cake Tool

Quality Gate Status Reliability Rating License NuGet #yourfirstpr Discord

nanoFramework logo


Welcome to the .NET nanoFramework nanoFramework.Logging Library repository

Build status

Component Build Status NuGet Package
nanoFramework.Logging Build Status NuGet
nanoFramework.Logging.Serial Build Status NuGet
nanoFramework.Logging.Stream Build Status NuGet
nanoFramework.Logging.Syslog Build Status NuGet

Feedback and documentation

For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.

Join our Discord community here.

Credits

The list of contributors to this project can be found at CONTRIBUTORS.

License

The nanoFramework Class Libraries are licensed under the MIT license.

Usage

In your class, make sure you have a global ILogger declared and in your constructor that you call _logger = this.GetCurrentClassLogger();

using Microsoft.Extensions.Logging;
using nanoFramework.Logging;
using System;

namespace UnitTestDebugLogging
{
    internal class MyTestComponent
    {
        private ILogger _logger;

        public MyTestComponent()
        {
            _logger = this.GetCurrentClassLogger();
        }

        public void DoSomeLogging()
        {
            _logger.LogInformation("An informative message");
            _logger.LogError("An error situation");
            _logger.LogWarning(new Exception("Something is not supported"), "With exception context");
        }
    }
}

In your main code, you'll need to create a logger:

LogDispatcher.LoggerFactory = new DebugLoggerFactory();
// Then you can create your object and the logging will happen
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

You can have 3 different types of logger: Debug, Serial and Stream.

Debug logger

As presented previously, you can use the Factory pattern:

LogDispatcher.LoggerFactory = new DebugLoggerFactory();
// Then you can create your object and the logging will happen
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

You can as well directly create a DebugLogger:

DebugLogger _logger;
_logger = new DebugLogger("test");
_logger.MinLogLevel = LogLevel.Trace; 
_logger.LogTrace("This is a trace");

Serial logger

You can use the Factory pattern:

LogDispatcher.LoggerFactory = new SerialLoggerFactory("COM6");
// Then you can create your object and the logging will happen
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

Note that you can adjust the baud speed and all other elements.

Or directly using a SerialLogger:

SerialPort _serial;
_serial = new SerialPort("COM6", 115200);
SerialLogger _logger = new SerialLogger(ref _serial);
_logger.MinLogLevel = LogLevel.Trace; 
_logger.LogTrace("This is a trace");

Important: make sure to refer to the documentation of your board to understand how to properly setup the serial port. The tests include an example with an ESP32.

Stream logger

Similar as for the others, you can either use a FileStream or a Stream in the LoggerFactory:

MemoryStream memoryStream = new MemoryStream();
LogDispatcher.LoggerFactory = new StreamLoggerFactory(memoryStream);
MyTestComponent test = new MyTestComponent();
test.DoSomeLogging();

And you can as well use it directly:

var _stream = new FileStream("D:\\mylog.txt", FileMode.Open, FileAccess.ReadWrite);
StreamLogger _logger = new StreamLogger(_stream);
_logger.MinLogLevel = LogLevel.Trace; 
_logger.LogTrace("This is a trace");

Important: please refer to the documentation for USB and SD Card reader to make sure they are properly setup before trying to setup the logger.

Create your own logger

You can create your own logger using the ILogger and ILoggerFactory interfaces. The DebugLogger is the simplest one.

The Log extensions

Different Log extensions are at your disposal to help you log the way you like. You can simply log a string or having parameters as well as exception and EventId:

_logger.LogTrace("TRACE {0} {1}", new object[] { "param 1", 42 });
_logger.LogDebug("DEBUG {0} {1}", new object[] { "param 1", 42 });
_logger.LogInformation("INFORMATION and nothing else");
_logger.LogWarning("WARNING {0} {1}", new object[] { "param 1", 42 });
_logger.LogError(new Exception("Big problem"), "ERROR {0} {1}", new object[] { "param 1", 42 });
_logger.LogCritical(42, new Exception("Insane problem"), "CRITICAL {0} {1}", new object[] { "param 1", 42 });

Note that all log level extensions have a minimum of string logging upo to EventId, string, parameters and exception. You are responsible to format properly the string when there are parameters.

Log level

You can adjust the log level in all the predefined logger. For example:

DebugLogger _logger;
_logger = new DebugLogger("test");
_logger.MinLogLevel = LogLevel.Trace;
_logger.LogTrace("This will be displayed");
_logger.LogCritical("Critical message will be displayed");
_logger.MinLogLevel = LogLevel.Critical;
_logger.LogTrace("This won't be displayed, only critical will be");
_logger.LogCritical("Critical message will be displayed");

Create your own formatting

You can use a custom formatter which will give you the name of the logger, the log level, the event ID, the message itself and a potential exception. The function definition should follow the following pattern:

public interface IMessageFormatter
{     
    string MessageFormatter(string className, LogLevel logLevel, EventId eventId, string state, Exception exception);
}

Important: this function will be called directly, without instantiating the class it is part of. So make sure either this function is a static, either it's part of the class using the logger. The static option always works. The interface is given for convenience and to give the format.

To setup the formatting, just use the following line. The type of the class containing the function and the exact name of the function are required.

LoggerExtensions.MessageFormatter = typeof(MyFormatter).GetType().GetMethod("MessageFormatterStatic");

public class MyFormatter
{        
    public string MessageFormatterStatic(string className, LogLevel logLevel, EventId eventId, string state, Exception exception)
    {
        string logstr = string.Empty;
        switch (logLevel)
        {
            case LogLevel.Trace:
                logstr = "TRACE: ";
                break;
            case LogLevel.Debug:
                logstr = "I love debug: ";
                break;
            case LogLevel.Warning:
                logstr = "WARNING: ";
                break;
            case LogLevel.Error:
                logstr = "ERROR: ";
                break;
            case LogLevel.Critical:
                logstr = "CRITICAL:";
                break;
            case LogLevel.None:
            case LogLevel.Information:
            default:
                break;
        }

        string eventstr = eventId.Id != 0 ? $" Event ID: {eventId}, " : string.Empty;
        string msg = $"[{className}] {eventstr}{logstr} {state}";
        if (exception != null)
        {
            msg += $" {exception}";
        }

        return msg;
    }
}

You are free to use anything you'd like and format as you like the message.

Note: It is not necessary to add a \r\n at the end, this is done by each logger.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behaviour in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (18)

Showing the top 5 NuGet packages that depend on nanoFramework.Logging:

Package Downloads
nanoFramework.Logging.Stream

This package includes the nanoFramework.Logging.Stream assembly (Stream Logging only) for .NET nanoFramework C# projects. There is also a package with the Serial Logger only and another with the basic Debug Logger.

nanoFramework.Logging.Serial

This package includes the nanoFramework.Logging.Serial assembly (Serial Logging only) for .NET nanoFramework C# projects. There is also a package with the Stream Logging only and another with the basic Debug Logging.

nanoFramework.Iot.Device.Mfrc522

This package includes the .NET IoT Core binding Iot.Device.Mfrc522 for .NET nanoFramework C# projects.

nanoFramework.Iot.Device.Pn532

This package includes the .NET IoT Core binding Iot.Device.Pn532 for .NET nanoFramework C# projects.

CCSWE.nanoFramework.Configuration

Manage configuration data for your application.

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on nanoFramework.Logging:

Repository Stars
nanoframework/Samples
🍬 Code samples from the nanoFramework team used in testing, proof of concepts and other explorational endeavours
nanoframework/nanoFramework.IoT.Device
📦 This repo includes .NET nanoFramework implementations for various sensors, chips, displays, hats and drivers
Version Downloads Last Updated
1.1.157 1,359 2 months ago
1.1.156 1,517 3 months ago
1.1.155 324 3 months ago
1.1.154 232 3 months ago
1.1.153 231 3 months ago
1.1.151 1,665 4 months ago
1.1.150 317 4 months ago
1.1.149 253 4 months ago
1.1.148 265 4 months ago
1.1.147 823 4 months ago
1.1.146 590 4 months ago
1.1.145 196 4 months ago
1.1.144 606 4 months ago
1.1.142 874 4 months ago
1.1.140 3,153 5 months ago
1.1.139 209 5 months ago
1.1.138 208 5 months ago
1.1.137 189 5 months ago
1.1.136 204 5 months ago
1.1.135 492 5 months ago
1.1.134 932 5 months ago
1.1.133 258 5 months ago
1.1.131 1,652 5 months ago
1.1.127 281 5 months ago
1.1.125 1,840 6 months ago
1.1.124 929 6 months ago
1.1.123 205 6 months ago
1.1.120 1,697 7 months ago
1.1.113 2,943 9 months ago
1.1.108 5,778 8/1/2024
1.1.107 955 7/23/2024
1.1.100 5,400 5/15/2024
1.1.98 555 5/13/2024
1.1.96 809 5/10/2024
1.1.94 2,656 4/10/2024
1.1.92 471 4/9/2024
1.1.90 261 4/8/2024
1.1.88 935 4/4/2024
1.1.86 472 4/3/2024
1.1.84 292 4/3/2024
1.1.81 4,287 2/1/2024
1.1.79 1,134 1/26/2024
1.1.76 6,023 11/16/2023
1.1.74 2,618 11/10/2023
1.1.63 19,577 1/4/2023
1.1.60 2,062 12/28/2022
1.1.58 1,072 12/28/2022
1.1.47 4,070 10/28/2022
1.1.45 1,497 10/26/2022
1.1.43 1,175 10/26/2022
1.1.41 2,373 10/25/2022
1.1.39 1,216 10/25/2022
1.1.37 1,519 10/24/2022
1.1.35 1,249 10/24/2022
1.1.33 1,291 10/24/2022
1.1.31 1,508 10/23/2022
1.1.29 1,250 10/23/2022
1.1.27 2,067 10/22/2022
1.1.25 3,473 10/10/2022
1.1.23 2,735 10/7/2022
1.1.19 2,790 9/22/2022
1.1.17 2,435 9/16/2022
1.1.15 1,353 9/15/2022
1.1.13 1,368 9/15/2022
1.1.9 1,406 9/15/2022
1.1.7 1,353 9/15/2022
1.1.2 5,546 8/5/2022
1.0.1.29 6,515 6/17/2022
1.0.1.27 2,264 6/16/2022
1.0.1.25 2,208 6/14/2022
1.0.1.23 2,161 6/13/2022
1.0.1.21 1,360 6/9/2022
1.0.1.19 1,354 6/8/2022
1.0.1.15 2,390 5/27/2022
1.0.1.13 2,837 5/19/2022
1.0.1.12 2,301 5/4/2022
1.0.1 5,893 3/28/2022
1.0.1-preview.32 184 3/28/2022
1.0.1-preview.31 171 3/28/2022
1.0.1-preview.30 174 3/28/2022
1.0.1-preview.28 252 3/18/2022
1.0.1-preview.27 182 3/17/2022
1.0.1-preview.26 191 3/15/2022
1.0.1-preview.25 198 3/14/2022
1.0.1-preview.24 194 3/11/2022
1.0.1-preview.23 258 2/25/2022
1.0.1-preview.21 255 2/17/2022
1.0.1-preview.19 220 2/11/2022
1.0.1-preview.18 212 2/8/2022
1.0.1-preview.17 206 2/4/2022
1.0.1-preview.16 231 1/28/2022
1.0.1-preview.15 222 1/28/2022
1.0.1-preview.14 222 1/28/2022
1.0.1-preview.13 224 1/27/2022
1.0.1-preview.12 193 1/26/2022
1.0.1-preview.11 195 1/25/2022
1.0.1-preview.10 204 1/25/2022
1.0.1-preview.9 218 1/21/2022
1.0.1-preview.8 200 1/21/2022
1.0.1-preview.6 238 1/14/2022
1.0.1-preview.4 255 1/4/2022
1.0.1-preview.3 206 12/29/2021
1.0.0 1,685 12/5/2021
1.0.0-preview.142 214 12/5/2021
1.0.0-preview.141 205 12/5/2021
1.0.0-preview.137 341 10/19/2021
1.0.0-preview.135 253 10/18/2021
1.0.0-preview.133 406 10/15/2021
1.0.0-preview.131 348 9/30/2021
1.0.0-preview.129 241 9/27/2021
1.0.0-preview.127 321 9/26/2021
1.0.0-preview.122 970 7/18/2021
1.0.0-preview.120 308 7/17/2021
1.0.0-preview.118 617 7/16/2021
1.0.0-preview.116 229 7/15/2021
1.0.0-preview.114 250 7/14/2021
1.0.0-preview.110 313 6/29/2021
1.0.0-preview.108 319 6/27/2021
1.0.0-preview.106 219 6/21/2021
1.0.0-preview.104 251 6/20/2021
1.0.0-preview.102 207 6/19/2021
1.0.0-preview.100 214 6/19/2021
1.0.0-preview.98 270 6/9/2021
1.0.0-preview.96 234 6/8/2021
1.0.0-preview.94 223 6/7/2021
1.0.0-preview.92 251 6/7/2021
1.0.0-preview.90 230 6/6/2021
1.0.0-preview.88 323 6/5/2021
1.0.0-preview.86 218 6/4/2021
1.0.0-preview.84 195 6/3/2021
1.0.0-preview.82 242 6/3/2021
1.0.0-preview.80 223 6/2/2021
1.0.0-preview.78 248 6/1/2021
1.0.0-preview.76 242 5/31/2021
1.0.0-preview.74 255 5/31/2021
1.0.0-preview.72 243 5/31/2021
1.0.0-preview.70 277 5/30/2021
1.0.0-preview.68 248 5/30/2021
1.0.0-preview.66 219 5/29/2021
1.0.0-preview.64 220 5/27/2021
1.0.0-preview.62 224 5/26/2021
1.0.0-preview.60 361 5/25/2021
1.0.0-preview.58 349 5/23/2021
1.0.0-preview.56 242 5/22/2021
1.0.0-preview.54 271 5/21/2021
1.0.0-preview.52 279 5/20/2021
1.0.0-preview.50 207 5/19/2021
1.0.0-preview.48 239 5/19/2021
1.0.0-preview.46 327 5/16/2021
1.0.0-preview.44 229 5/15/2021
1.0.0-preview.42 226 5/14/2021
1.0.0-preview.40 223 5/13/2021
1.0.0-preview.38 216 5/12/2021
1.0.0-preview.36 279 5/7/2021
1.0.0-preview.34 275 5/6/2021
1.0.0-preview.32 223 5/5/2021
1.0.0-preview.30 234 5/4/2021
1.0.0-preview.28 215 5/4/2021
1.0.0-preview.26 237 4/23/2021
1.0.0-preview.25 229 4/12/2021
1.0.0-preview.24 231 4/10/2021
1.0.0-preview.21 739 4/9/2021
1.0.0-preview.19 234 4/9/2021
1.0.0-preview.17 250 4/8/2021
1.0.0-preview.14 248 4/8/2021
1.0.0-preview.13 246 4/8/2021