Oakrey.Log 1.0.0

dotnet add package Oakrey.Log --version 1.0.0
                    
NuGet\Install-Package Oakrey.Log -Version 1.0.0
                    
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="Oakrey.Log" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Oakrey.Log" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Oakrey.Log" />
                    
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 Oakrey.Log --version 1.0.0
                    
#r "nuget: Oakrey.Log, 1.0.0"
                    
#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=Oakrey.Log&version=1.0.0
                    
Install Oakrey.Log as a Cake Addin
#tool nuget:?package=Oakrey.Log&version=1.0.0
                    
Install Oakrey.Log as a Cake Tool

Oakrey.Log

Overview

The "Log" project provides a comprehensive logging framework for .NET applications. It supports multiple logging mechanisms, including console, file, debug, and custom loggers, with a focus on flexibility, extensibility, and performance.

Features

Logging Levels:

  • Supports standard logging levels: Trace, Debug, Information, Warning, Error, and Critical (Level enum).

Logger Implementations:

  • ConsoleLogger: Logs messages to the console with color-coded levels.
  • FileLogger: Logs messages to a file with thread-safe operations.
  • DebugLogger: Logs messages to the debug output.
  • CriticalEventLogger: Triggers events for critical log levels.
  • QueueLogger: Maintains a queue of log entries with a fixed capacity.
  • TypeMatchLogger: Handles events based on argument type matching.

Logger Management:

  • LoggerFactory: Manages logger instances, global thresholds, and module-specific filters.
  • LoggerProxy: Provides a proxy for logging with module-specific context.

Log Entry Representation:

  • LogEntry: Represents a single log entry with level, module, message, and timestamp.

Utilities:

  • LoggerHelper: Provides helper methods for formatting log levels and messages.
  • ExceptionsHandling: Flattens exception messages for better readability.

Extensibility:

  • LoggerBase: Abstract base class for custom logger implementations.
  • ILoggerEngine: Interface for logger engines.

Installation

You can install the package via NuGet Package Manager, Package Manager Console or the .NET CLI.

NuGet Package Manager

  1. Open your project in Visual Studio.
  2. Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution....
  3. Search for Oakrey.Log and click Install.

.NET CLI

Run the following command in your terminal:

dotnet add package Oakrey.Log

Package Manager Console

Run the following command in your Package Manager Console:

Install-Package Oakrey.Log

Requirements

  • .NET 8 or higher

Project Information

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve the package.

License

This project is licensed under the MIT License. See the LICENSE file for details.

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

    • No dependencies.

NuGet packages (14)

Showing the top 5 NuGet packages that depend on Oakrey.Log:

Package Downloads
Oakrey.Log.Windows

A Windows-specific extension for the Oakrey logging framework, featuring integration with the Windows Event Log, WPF-based log visualization, and message box-based logging for enhanced desktop application logging.

Oakrey.Applications.ChangeTracking

A .NET library for managing and tracking changes within an application, with support for logging and efficient change application.

Oakrey.Msi

A framework for managing MSI-based application deployments and updates, including automated update checks, silent installations, and deployment configuration for Windows applications

Oakrey.Applications.Git

A .NET library for managing Git repositories programmatically, supporting operations like cloning, committing, and branching, with integrated logging and telemetry.

Oakrey.Applications.Terminals

A .NET library for building terminal-like interfaces, featuring command history, message handling, file export, and integration with logging and telemetry.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 251 4/16/2025