Update openTemplate to support file stream (#246)

* Update openTemplate to support file stream
* Adding some unit tests to support full in memory process

src/OpenXMLSDK.Engine/Word/WordManager.cs

@@ -229,8 +229,38 @@ public bool OpenDoc(Stream streamFile, bool isEditable)
         /// <summary>
         /// Ouverture d'un document depuis un template dotx
         /// </summary>
-        /// <param name="streamTemplateFile">Chemin et nom complet du template</param>
-        /// <param name="newFilePath">Chemin et nom complet du fichier qui sera sauvegardé</param>
+        /// <param name="templateFileStream">Chemin et nom complet du template</param>
+        /// <returns>True si le document a bien été ouvert</returns>
+        public bool OpenDocFromTemplate(Stream templateFileStream)
+        {
+            if (templateFileStream is null || templateFileStream == Stream.Null)
+                throw new ArgumentNullException(nameof(templateFileStream), "templateFilePath must not be null");
+
+            streamFile = new MemoryStream();
+            try
+            {
+                // We copy the template file into the memory stream
+                templateFileStream.CopyTo(streamFile);
+
+                // Change the document type to Document
+                wdDoc = WordprocessingDocument.Open(streamFile, true);
+                wdDoc.ChangeDocumentType(DocumentFormat.OpenXml.WordprocessingDocumentType.Document);
+
+                wdMainDocumentPart = wdDoc.MainDocumentPart;
+
+                return true;
+            }
+            catch
+            {
+                wdDoc = null;
+                return false;
+            }
+        }
+
+        /// <summary>
+        /// Ouverture d'un document depuis un template dotx
+        /// </summary>
+        /// <param name="templateFilePath">Chemin et nom complet du template</param>
         /// <returns>True si le document a bien été ouvert</returns>
         public bool OpenDocFromTemplate(string templateFilePath)
         {

src/OpenXMLSDK.UnitTest/OpenXMLSDK.UnitTest.csproj

@@ -26,7 +26,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <None Update="Resources\Test.json">
+    <None Update="Resources\**">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
     </None>
   </ItemGroup>

src/OpenXMLSDK.UnitTest/ReportEngine/ReportEngineUnitTests.cs

@@ -1,4 +1,10 @@
 using Microsoft.VisualStudio.TestTools.UnitTesting;
+using System.Collections.Generic;
+using System;
+using System.IO;
+using System.Globalization;
+using OpenXMLSDK.Engine.Word.ReportEngine;
+using OpenXMLSDK.Engine.Word;
 
 namespace OpenXMLSDK.UnitTest.ReportEngine
 {
@@ -10,5 +16,38 @@ public void Global_Generation()
         {
             ReportEngineTest.ReportEngine(string.Empty, string.Empty, false);
         }
+
+        [TestMethod]
+        public void Global_Generation_Stream()
+        {
+            // Configuration of sample data :
+            var rootFolder = Path.Combine(Environment.CurrentDirectory, "Resources/MdFiles");
+            var templatePath = Path.Combine(Environment.CurrentDirectory, "Resources/Dotx/sample.dotx");
+            var outputPath = Path.Combine(Environment.CurrentDirectory, "Resources/Dotx/sample.docx");
+
+            // Generate Word document :
+            using var templateStream = File.OpenRead(templatePath);
+            var markdownContent = File.ReadAllText(Path.Combine(rootFolder, "0.md"));
+
+            // Launch transformation :
+            var reports = new List<Report>();
+
+            var culture = new CultureInfo("en-US");
+            using var templateDocument = File.OpenRead(templatePath);
+
+            var output = Stream.Null;
+            using (var word = new WordManager())
+            {
+                if (templateDocument != null && templateDocument != Stream.Null)
+                    word.OpenDocFromTemplate(templateDocument);
+
+                // Append documentation :
+                word.AppendSubDocument(reports, true, culture);
+
+                word.SaveDoc();
+
+                output = word.GetMemoryStream();
+            }
+        }
     }
 }

src/OpenXMLSDK.UnitTest/Resources/MdFiles/0.md

@@ -0,0 +1,46 @@
+# Sample title for a random markdown file
+
+## Overview
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed euismod, nisl quis tincidunt aliquam, nunc nisl ultricies nunc, quis aliquam nis
+
+## Function Signature
+
+Here is a random code in python that generate a random value. It takes some parameters like a date and return a value.
+
+```python
+def random_function(date: datetime) -> float:
+    """Generate a random value based on the provided date.
+
+    Args:
+        date (datetime): The date to be used to generate the random value.
+
+    Returns:
+        float: The random value generated based on the provided date.
+    """
+    return random.random()
+```
+
+## Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| date | datetime | The date to be used to generate the random value. |
+
+## Return Value
+
+| Type | Description |
+| ---- | ----------- |
+| float | The random value generated based on the provided date. |
+
+## Usage
+
+```python
+random_function(datetime.now())
+```
+
+## Example Output
+
+```python
+0.123456789
+```

src/OpenXMLSDK.UnitTest/Resources/MdFiles/1.md

@@ -0,0 +1,11 @@
+# Another sample markdown file
+
+## Overview
+
+This file is here only for the purpose of testing the generator.
+
+## Sample with mage
+
+Here is an image generated from Dall-E 2 :
+
+![Dall-E 2](images/sampleimagefromdalle.png)