BepInEx/BepInEx.Core/Logging/ManualLogSource.cs

using System;

namespace BepInEx.Logging
{
    /// <summary>
    ///     A generic, multi-purpose log source. Exposes simple API to manually emit logs.
    /// </summary>
    public class ManualLogSource : ILogSource
    {
        /// <summary>
        ///     Creates a manual log source.
        /// </summary>
        /// <param name="sourceName">Name of the log source.</param>
        public ManualLogSource(string sourceName)
        {
            SourceName = sourceName;
        }

        /// <inheritdoc />
        public string SourceName { get; }

        /// <inheritdoc />
        public event EventHandler<LogEventArgs> LogEvent;

        /// <inheritdoc />
        public void Dispose() { }

        /// <summary>
        ///     Logs a message with the specified log level.
        /// </summary>
        /// <param name="level">Log levels to attach to the message. Multiple can be used with bitwise ORing.</param>
        /// <param name="data">Data to log.</param>
        public void Log(LogLevel level, object data) => LogEvent?.Invoke(this, new LogEventArgs(data, level, this));

        /// <summary>
        ///     Logs a message with <see cref="LogLevel.Fatal" /> level.
        /// </summary>
        /// <param name="data">Data to log.</param>
        public void LogFatal(object data) => Log(LogLevel.Fatal, data);

        /// <summary>
        ///     Logs a message with <see cref="LogLevel.Error" /> level.
        /// </summary>
        /// <param name="data">Data to log.</param>
        public void LogError(object data) => Log(LogLevel.Error, data);

        /// <summary>
        ///     Logs a message with <see cref="LogLevel.Warning" /> level.
        /// </summary>
        /// <param name="data">Data to log.</param>
        public void LogWarning(object data) => Log(LogLevel.Warning, data);

        /// <summary>
        ///     Logs a message with <see cref="LogLevel.Message" /> level.
        /// </summary>
        /// <param name="data">Data to log.</param>
        public void LogMessage(object data) => Log(LogLevel.Message, data);

        /// <summary>
        ///     Logs a message with <see cref="LogLevel.Info" /> level.
        /// </summary>
        /// <param name="data">Data to log.</param>
        public void LogInfo(object data) => Log(LogLevel.Info, data);

        /// <summary>
        ///     Logs a message with <see cref="LogLevel.Debug" /> level.
        /// </summary>
        /// <param name="data">Data to log.</param>
        public void LogDebug(object data) => Log(LogLevel.Debug, data);
    }
}