Added overload for exporting by path instead of stream

Author: michelebastione

README-V2.md

@@ -1327,7 +1327,7 @@ registry.Configure<Person>(cfg =>
 });
 
 var exporter = MiniExcel.Exporters.GetMappingExporter(registry);
-await exporter.SaveAsAsync(stream, people);
+await exporter.ExportAsync(stream, people);
 ```
 
 #### 2. Reading with Fluent Mappings
@@ -1411,8 +1411,8 @@ var data = new TestEntity
     Points = 123
 };
 
-var exporter = MiniExcel.Exporters.GetMappingExporter(registry);
-await exporter.ApplyTemplateAsync(outputPath, templatePath, new[] { data });
+var termplater = MiniExcel.Templaters.GetMappingExporter(registry);
+await termplater.ApplyTemplateAsync(outputPath, templatePath, new[] { data });
 ```
 
 #### 6. Advanced: Nested Collections with Item Mapping

src/MiniExcel.Core/Api/OpenXmlExporter.cs

@@ -10,7 +10,7 @@ internal OpenXmlExporter() { }
     public async Task<int> InsertSheetAsync(string path, object value, string? sheetName = "Sheet1", bool printHeader = true, bool overwriteSheet = false, OpenXmlConfiguration? configuration = null, CancellationToken cancellationToken = default)
     {
         if (Path.GetExtension(path).Equals(".xlsm", StringComparison.InvariantCultureIgnoreCase))
-            throw new NotSupportedException("MiniExcel's InsertExcelSheet does not support the .xlsm format");
+            throw new NotSupportedException("MiniExcel's InsertSheet does not support the .xlsm format");
 
         if (!File.Exists(path))
         {
@@ -43,7 +43,7 @@ public async Task<int[]> ExportAsync(string path, object value, bool printHeader
         CancellationToken cancellationToken = default)
     {
         if (Path.GetExtension(path).Equals(".xlsm", StringComparison.InvariantCultureIgnoreCase))
-            throw new NotSupportedException("MiniExcel's ExportExcel does not support the .xlsm format");
+            throw new NotSupportedException("MiniExcel's Export does not support the .xlsm format");
 
         var filePath = path.EndsWith(".xlsx",  StringComparison.InvariantCultureIgnoreCase) ? path : $"{path}.xlsx" ;
 

src/MiniExcel.Core/Mapping/MappingExporter.cs

@@ -1,14 +1,28 @@
 namespace MiniExcelLib.Core.Mapping;
 
-public sealed partial class MappingExporter()
+public sealed partial class MappingExporter
 {
-    private readonly MappingRegistry _registry = new();
+    private readonly MappingRegistry _registry;
 
-    public MappingExporter(MappingRegistry registry) : this()
+    public MappingExporter()
+    {
+        _registry = new MappingRegistry();
+    }
+    
+    public MappingExporter(MappingRegistry registry)
     {
         _registry = registry ?? throw new ArgumentNullException(nameof(registry));
     }
 
+    [CreateSyncVersion]
+    public async Task ExportAsync<T>(string path, IEnumerable<T>? values, bool overwriteFile = false, CancellationToken cancellationToken = default) where T : class
+    {
+        var filePath = path.EndsWith(".xlsx",  StringComparison.InvariantCultureIgnoreCase) ? path : $"{path}.xlsx" ;
+        
+        using var stream = overwriteFile ? File.Create(filePath) : new FileStream(filePath, FileMode.CreateNew);
+        await ExportAsync(stream, values, cancellationToken).ConfigureAwait(false);
+    }
+    
     [CreateSyncVersion]
     public async Task ExportAsync<T>(Stream? stream, IEnumerable<T>? values, CancellationToken cancellationToken = default) where T : class
     {