/* * 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(); } } } }