mirror of https://github.com/lidarr/Lidarr
98 lines
3.4 KiB
C#
98 lines
3.4 KiB
C#
![]() |
using System;
|
||
|
using System.Collections.Generic;
|
||
|
|
||
|
namespace Migrator.Framework
|
||
|
{
|
||
|
public interface ILogger
|
||
|
{
|
||
|
/// <summary>
|
||
|
/// Log that we have started a migration
|
||
|
/// </summary>
|
||
|
/// <param name="currentVersion">Start list of versions</param>
|
||
|
/// <param name="finalVersion">Final Version</param>
|
||
|
void Started(List<long> currentVersion, long finalVersion);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log that we are migrating up
|
||
|
/// </summary>
|
||
|
/// <param name="version">Version we are migrating to</param>
|
||
|
/// <param name="migrationName">Migration name</param>
|
||
|
void MigrateUp(long version, string migrationName);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log that we are migrating down
|
||
|
/// </summary>
|
||
|
/// <param name="version">Version we are migrating to</param>
|
||
|
/// <param name="migrationName">Migration name</param>
|
||
|
void MigrateDown(long version, string migrationName);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Inform that a migration corresponding to the number of
|
||
|
/// version is untraceable (not found?) and will be ignored.
|
||
|
/// </summary>
|
||
|
/// <param name="version">Version we couldnt find</param>
|
||
|
void Skipping(long version);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log that we are rolling back to version
|
||
|
/// </summary>
|
||
|
/// <param name="originalVersion">
|
||
|
/// version
|
||
|
/// </param>
|
||
|
void RollingBack(long originalVersion);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log a Sql statement that changes the schema or content of the database as part of a migration
|
||
|
/// </summary>
|
||
|
/// <remarks>
|
||
|
/// SELECT statements should not be logged using this method as they do not alter the data or schema of the
|
||
|
/// database.
|
||
|
/// </remarks>
|
||
|
/// <param name="sql">The Sql statement to log</param>
|
||
|
void ApplyingDBChange(string sql);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log that we had an exception on a migration
|
||
|
/// </summary>
|
||
|
/// <param name="version">The version of the migration that caused the exception.</param>
|
||
|
/// <param name="migrationName">The name of the migration that caused the exception.</param>
|
||
|
/// <param name="ex">The exception itself</param>
|
||
|
void Exception(long version, string migrationName, Exception ex);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log that we had an exception on a migration
|
||
|
/// </summary>
|
||
|
/// <param name="message">An informative message to show to the user.</param>
|
||
|
/// <param name="ex">The exception itself</param>
|
||
|
void Exception(string message, Exception ex);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log that we have finished a migration
|
||
|
/// </summary>
|
||
|
/// <param name="currentVersion">List of versions with which we started</param>
|
||
|
/// <param name="finalVersion">Final Version</param>
|
||
|
void Finished(List<long> currentVersion, long finalVersion);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log a message
|
||
|
/// </summary>
|
||
|
/// <param name="format">The format string ("{0}, blabla {1}").</param>
|
||
|
/// <param name="args">Parameters to apply to the format string.</param>
|
||
|
void Log(string format, params object[] args);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log a Warning
|
||
|
/// </summary>
|
||
|
/// <param name="format">The format string ("{0}, blabla {1}").</param>
|
||
|
/// <param name="args">Parameters to apply to the format string.</param>
|
||
|
void Warn(string format, params object[] args);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Log a Trace Message
|
||
|
/// </summary>
|
||
|
/// <param name="format">The format string ("{0}, blabla {1}").</param>
|
||
|
/// <param name="args">Parameters to apply to the format string.</param>
|
||
|
void Trace(string format, params object[] args);
|
||
|
}
|
||
|
}
|