Added explicit flag for overwriting result file when applying a template

Author: michelebastione

V2-Upgrade-Notes.md

@@ -11,4 +11,5 @@
 - If the full MiniExcel package is downloaded, the previous namespace will coexist along the new one, containing the original static methods' signatures, which have become a facade for the aferomentioned providers.
 - `IConfiguration` is now `IMiniExcelConfiguration`, but most methods now require the proper implementation (`OpenXmlConfiguration` or `CsvConfiguration`) to be provided rather than the interface
 - MiniExcel now fully supports asynchronous streaming the queries, 
-so the return type for `OpenXmlImporter.QueryAsync` is `IAsyncEnumerable<T>` instead of `Task<IEnumerable<T>>`
+so the return type for `OpenXmlImporter.QueryAsync` is `IAsyncEnumerable<T>` instead of `Task<IEnumerable<T>>`
+- When applying a template, unlike version 1.x, the flag for overwriting an already existing file must be provided explicitly. 

src/MiniExcel.OpenXml/Api/OpenXmlTemplater.cs

@@ -24,18 +24,18 @@ public async Task AddPictureAsync(Stream excelStream, CancellationToken cancella
     }
 
     [CreateSyncVersion]
-    public async Task ApplyTemplateAsync(string path, string templatePath, object value,
+    public async Task ApplyTemplateAsync(string path, string templatePath, object value, bool overwriteFile = false,
         OpenXmlConfiguration? configuration = null, CancellationToken cancellationToken = default)
     {
-        using var stream = File.Create(path);
+        using var stream = overwriteFile ? File.Create(path) : File.Open(path, FileMode.CreateNew);
         await ApplyTemplateAsync(stream, templatePath, value, configuration, cancellationToken).ConfigureAwait(false);
     }
 
     [CreateSyncVersion]
-    public async Task ApplyTemplateAsync(string path, Stream templateStream, object value,
+    public async Task ApplyTemplateAsync(string path, Stream templateStream, object value, bool  overwriteFile = false,
         OpenXmlConfiguration? configuration = null, CancellationToken cancellationToken = default)
     {
-        using var stream = File.Create(path);
+        using var stream = overwriteFile ? File.Create(path) : File.Open(path, FileMode.CreateNew);
         var template = GetOpenXmlTemplate(stream, configuration);
         await template.SaveAsByTemplateAsync(templateStream, value, cancellationToken).ConfigureAwait(false);
     }
@@ -57,10 +57,10 @@ public async Task ApplyTemplateAsync(Stream stream, Stream templateStream, objec
     }
 
     [CreateSyncVersion]
-    public async Task ApplyTemplateAsync(string path, byte[] templateBytes, object value,
+    public async Task ApplyTemplateAsync(string path, byte[] templateBytes, object value, bool overwriteFile = false,
         OpenXmlConfiguration? configuration = null, CancellationToken cancellationToken = default)
     {
-        using var stream = File.Create(path);
+        using var stream = overwriteFile ? File.Create(path) :  File.Open(path, FileMode.CreateNew);
         await ApplyTemplateAsync(stream, templateBytes, value, configuration, cancellationToken).ConfigureAwait(false);
     }
 

src/MiniExcel/MiniExcel.cs

@@ -221,11 +221,11 @@ public static IAsyncEnumerable<dynamic> QueryRangeAsync(this Stream stream, bool
 
     [CreateSyncVersion]
     public static async Task SaveAsByTemplateAsync(string path, string templatePath, object value, IConfiguration? configuration = null, CancellationToken cancellationToken = default) 
-        => await ExcelTemplater.ApplyTemplateAsync(path, templatePath, value, configuration as OpenXmlConfiguration, cancellationToken).ConfigureAwait(false);
+        => await ExcelTemplater.ApplyTemplateAsync(path, templatePath, value, true, configuration as OpenXmlConfiguration, cancellationToken).ConfigureAwait(false);
 
     [CreateSyncVersion]
     public static async Task SaveAsByTemplateAsync(string path, byte[] templateBytes, object value, IConfiguration? configuration = null)
-        => await ExcelTemplater.ApplyTemplateAsync(path, templateBytes, value, configuration as OpenXmlConfiguration).ConfigureAwait(false);
+        => await ExcelTemplater.ApplyTemplateAsync(path, templateBytes, value, true, configuration as OpenXmlConfiguration).ConfigureAwait(false);
 
     [CreateSyncVersion]
     public static async Task SaveAsByTemplateAsync(this Stream stream, string templatePath, object value, IConfiguration? configuration = null)
@@ -237,7 +237,7 @@ public static async Task SaveAsByTemplateAsync(this Stream stream, byte[] templa
 
     [CreateSyncVersion]
     public static async Task SaveAsByTemplateAsync(string path, Stream templateStream, object value, IConfiguration? configuration = null)
-        => await ExcelTemplater.ApplyTemplateAsync(path, templateStream, value, configuration as OpenXmlConfiguration).ConfigureAwait(false);
+        => await ExcelTemplater.ApplyTemplateAsync(path, templateStream, value, true, configuration as OpenXmlConfiguration).ConfigureAwait(false);
 
     [CreateSyncVersion]
     public static async Task SaveAsByTemplateAsync(this Stream stream, Stream templateStream, object value, IConfiguration? configuration = null)