/// <summary>
/// Convert the specified file. Throws an exception if the file does not exist
/// If encoding is not specified, .NET attempts to auto-detect the encoding
/// </summary>
public static string Convert(ConversionSettings conversionSettings, string fileName, Encoding encoding = null)
{
if (string.IsNullOrWhiteSpace(fileName) || !File.Exists(fileName))
{
throw new FileNotFoundException($"File \"{fileName}\" does not exist!");
}
return(Convert(conversionSettings, encoding == null ? File.ReadAllLines(fileName) : File.ReadAllLines(fileName, encoding)));
}
/// <inheritdoc />
internal Conversion(ConversionSettings settings)
{
_settings = settings;
_sb = new StringBuilder();
_sb.AppendLine("<!DOCTYPE html>\r\n<html>\r\n<head>\r\n<meta charset = \"UTF-8\">");
_fixParagraphs = _settings.MinimumLineLength.HasValue;
if (_settings.CreateEntities)
{
PrepareEntities();
}
}
/// <summary>
/// Converts the text in the specified stream reader.
/// It is up to the caller to set the proper position in the base stream
/// Neither StreamReader nor base stream is disposed.
/// </summary>
public static async Task <string> ConvertAsync(ConversionSettings conversionSettings, StreamReader reader)
{
if (reader == null)
{
throw new NullReferenceException("Reader cannot be null!");
}
var lines = new List <string>(256);
while (!reader.EndOfStream)
{
lines.Add(await reader.ReadLineAsync().ConfigureAwait(false));
}
return(Convert(conversionSettings, lines));
}
/// <summary>
/// Converts the text in the specified stream reader.
/// It is up to the caller to set the proper position in the base stream
/// Neither StreamReader nor base stream is disposed.
/// </summary>
public static string Convert(ConversionSettings conversionSettings, StreamReader reader)
{
if (reader == null)
{
throw new NullReferenceException("Reader cannot be null!");
}
var lines = new List <string>(256);
while (!reader.EndOfStream)
{
lines.Add(reader.ReadLine());
}
return(Convert(conversionSettings, lines));
}
/// <summary>
/// Convert the specified file opened in stream, optionally specifying encoding (UTF-8 is assumed if not set)
/// It is up to the caller to set the proper start position in the stream.
/// FileStream is not disposed.
/// </summary>
public static async Task <string> ConvertAsync(ConversionSettings conversionSettings, FileStream fileStream, Encoding encoding = null)
{
if (fileStream == null)
{
throw new NullReferenceException("Filestream cannot be null!");
}
if (!fileStream.CanRead)
{
throw new FileLoadException($"Filestream \"{fileStream.Name}\" is not readable!");
}
encoding = encoding ?? Encoding.UTF8;
using (var reader = new StreamReader(fileStream, encoding))
{
return(await ConvertAsync(conversionSettings, reader).ConfigureAwait(false));
}
}
/// <summary>
/// Convert the specified text
/// </summary>
public static string Convert(ConversionSettings conversionSettings, IEnumerable <string> fileContent)
{
if (conversionSettings == null)
{
throw new ArgumentNullException(nameof(conversionSettings));
}
if (fileContent == null)
{
throw new ArgumentNullException(nameof(fileContent));
}
//think about this. Bad for speed & memory use, but easier iteration etc for paragraph merging
var contentArray = fileContent.ToList();
if (contentArray.Count == 0)
{
throw new ArgumentException("Value cannot be an empty collection.", nameof(fileContent));
}
return(new Conversion(conversionSettings).Convert(contentArray));
}
