feat: Add watermark to generated policy documents (#21)

Author: Mielek

src/Compiling/Compiling.csproj

@@ -3,6 +3,9 @@
     <PropertyGroup>
         <PackageId>Azure.ApiManagement.PolicyToolkit.Compiling</PackageId>
         <PackageVersion>0.0.1</PackageVersion>
+        <FileVersion>0.0.1</FileVersion>
+        <AssemblyVersion>0.0.1</AssemblyVersion>
+        <InformationalVersion>0.0.1</InformationalVersion>
         <Authors>Microsoft</Authors>
         <PackageLicenseExpression>MIT</PackageLicenseExpression>
         <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>

src/Compiling/Program.cs

@@ -1,10 +1,11 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
+using System.Reflection;
 using System.Text;
 using System.Text.RegularExpressions;
+using System.Xml.Linq;
 
-using Azure.ApiManagement.PolicyToolkit.Compiling;
 using Azure.ApiManagement.PolicyToolkit.Compiling;
 using Azure.ApiManagement.PolicyToolkit.Serialization;
 
@@ -41,6 +42,8 @@
         var codeBuilder = new StringBuilder();
         using (var writer = CustomXmlWriter.Create(codeBuilder, options.XmlWriterSettings))
         {
+            writer.Write(new XComment(" This file is generated by the Azure API Management Policy Toolkit "));
+            writer.Write(new XComment($" Version: {Assembly.GetExecutingAssembly().GetName().Version} "));
             writer.Write(result.Document);
         }
 

src/Core/Serialization/CustomXmlWriter.cs

@@ -23,6 +23,8 @@ public sealed class CustomXmlWriter : IDisposable
 
     public void Dispose() => _xmlWriter.Dispose();
 
+    public void Write(XComment comment) => comment.WriteTo(_xmlWriter);
+    
     public void Write(XElement element)
     {
         _xmlWriter.WriteStartElement(element.Name.LocalName);