/*
* QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals.
* Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
using System;
using System.Globalization;
using System.IO;
namespace QuantConnect.Logging
{
///
/// Provides an implementation of that writes all log messages to a file on disk.
///
public class FileLogHandler : ILogHandler
{
private bool _disposed;
// we need to control synchronization to our stream writer since it's not inherently thread-safe
private readonly object _lock = new object();
private readonly Lazy _writer;
private readonly bool _useTimestampPrefix;
///
/// Initializes a new instance of the class to write messages to the specified file path.
/// The file will be opened using
///
/// The file path use to save the log messages
/// True to prefix each line in the log which the UTC timestamp, false otherwise
public FileLogHandler(string filepath, bool useTimestampPrefix = true)
{
_useTimestampPrefix = useTimestampPrefix;
_writer = new Lazy(
() => new StreamWriter(File.Open(filepath, FileMode.Append, FileAccess.Write, FileShare.Read))
);
}
///
/// Initializes a new instance of the class using 'log.txt' for the filepath.
///
public FileLogHandler()
: this(Log.FilePath)
{
}
///
/// Write error message to log
///
/// The error text to log
public void Error(string text)
{
WriteMessage(text, "ERROR");
}
///
/// Write debug message to log
///
/// The debug text to log
public void Debug(string text)
{
WriteMessage(text, "DEBUG");
}
///
/// Write debug message to log
///
/// The trace text to log
public void Trace(string text)
{
WriteMessage(text, "TRACE");
}
///
/// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
///
/// 2
public void Dispose()
{
lock (_lock)
{
if (_writer.IsValueCreated)
{
_disposed = true;
_writer.Value.Dispose();
}
}
}
///
/// Creates the message to be logged
///
/// The text to be logged
/// The logging leel
///
protected virtual string CreateMessage(string text, string level)
{
if (_useTimestampPrefix)
{
return $"{DateTime.UtcNow.ToString("o", CultureInfo.InvariantCulture)} {level}:: {text}";
}
return $"{level}:: {text}";
}
///
/// Writes the message to the writer
///
private void WriteMessage(string text, string level)
{
var message = CreateMessage(text, level);
lock (_lock)
{
if (_disposed) return;
_writer.Value.WriteLine(message);
_writer.Value.Flush();
}
}
}
}