HUMANiT.Azure 1.0.2

HUMANiT Azure

This package provides logic that we miss in .NET for Azure, but that find valuable for our own daily software development. -- the people of HUMANiT

This package is covered by 80+ automated tests and offers an API that is documented extensively inline.

Features

• Logging: Simplified logging that is always available and can be enabled/disabled during runtime.

This package contains features which we require for our own software; therefore, some features are highly custom. If you require a fix, an enhancement, or a more configurable solution, please contact us.

Contact

• Twitter -- stay in touch (@HUMANiTnz)
• Facebook -- message with us (@HUMANiTnz)
• support@humanit.nz -- contact us via email

License

MIT -- free software, hell yeah 🤩

Quickstart

Classes that inherit from AzureBase can use this package's features:

public class YourClass : AzureBase<YourClass> { .. }

Logging

Simplified logging that is always available and can be enabled/disabled during runtime.

To use logging features, you must call one of the provided constructors:

// call this constructor if you have a logger handy
public YourClass(ILogger logger) : base(logger) { .. }

// call this constructor if you have a logger factory handy
public YourClass(ILoggerFactory loggerFactory) : base(loggerFactory) { .. }

Logging is enabled by default. You can control the default by defining its state during contruction. All constructors have an optional parameter enableLogging:

public YourClass(ILogger logger, bool enableLogging) : base(logger, enableLogging) { .. }

Logging can be enabled and disabled during runtime using the methods EnableLogging() and DisableLogging().

You can check the logging status during runtime by calling IsLoggingEnabled and IsLoggingDisabled.

You can log a message or exception anywhere in your class using 6 log levels. For all log levels, there are multiple overloaded named methods available: LogDebug(), LogTrace(), LogInformation(), LogWarning(), LogError(), and LogCritical().

You can log entering a method by calling LogMethodCall():

public void YourMethod() {
    LogMethodCall(nameof(YourClass), nameof(YourMethod));
    ..
}