Add metadata to the stamped PDF file

Author: VahidN

src/iTextSharp.LGPLv2.Core.FunctionalTests/PDFStampingTests.cs

@@ -10,58 +10,92 @@ namespace iTextSharp.LGPLv2.Core.FunctionalTests;
 public class StampRequestForm
 {
     public IList<string> Lines { get; set; }
+
     public float LowerLeftX { get; set; }
+
     public float LowerLeftY { get; set; }
+
     public float UpperRightX { get; set; }
+
     public float UpperRightY { get; set; }
+
     public int RotationDegree { get; set; }
 }
 
 [TestClass]
 public class PDFStampingTests
 {
+    [TestMethod]
+    public void Verify_Metadata_Can_Be_Added_To_Stamped_File()
+    {
+        var outputFilePath = TestUtils.GetOutputFileName();
+
+        using (var reader = new PdfReader(TestUtils.GetPdfsPath(fileName: "sample.pdf")))
+        {
+            using var outStream = new FileStream(outputFilePath, FileMode.Create);
+            using var stamper = new PdfStamper(reader, outStream);
+            stamper.AddAuthor(author: "Test");
+            stamper.AddKeywords(keywords: "C#");
+            stamper.AddTitle(title: "New doc");
+            stamper.AddSubject(subject: "New doc");
+            stamper.AddCreator(creator: "MyApp");
+
+            stamper.ViewerPreferences = PdfWriter.PageModeUseOutlines;
+            stamper.SetFullCompression();
+        }
+
+        using (var reader = new PdfReader(outputFilePath))
+        {
+            Assert.AreEqual(expected: "Test", reader.Info[key: "Author"]);
+            Assert.AreEqual(expected: "New doc", reader.Info[key: "Title"]);
+        }
+    }
+
     [TestMethod]
     public void Verify_Stamped_File_CanBeCreated()
     {
-        using var inputPdfStream = new FileStream(TestUtils.GetPdfsPath("sample.pdf"), FileMode.Open);
+        using var inputPdfStream = new FileStream(TestUtils.GetPdfsPath(fileName: "sample.pdf"), FileMode.Open);
         using var outStream = new FileStream(TestUtils.GetOutputFileName(), FileMode.Create);
 
         using var reader = new PdfReader(inputPdfStream);
         using var stamper = new PdfStamper(reader, outStream);
-        var dc = stamper.GetOverContent(1);
+        var dc = stamper.GetOverContent(pageNum: 1);
+
         AddWaterMark(dc, new StampRequestForm
-                         {
-                             Lines = new[]
-                                     {
-                                         "This is a sample stamp",
-                                         DateTime.Now.ToShortDateString(),
-                                         "https://github.com/VahidN",
-                                     },
-                             // position the stamp text near the top right. 
-                             LowerLeftX = 402,
-                             LowerLeftY = 600,
-                             UpperRightX = 575,
-                             UpperRightY = 900,
-                         });
+        {
+            Lines = new[]
+            {
+                "This is a sample stamp", DateTime.Now.ToShortDateString(), "https://github.com/VahidN"
+            },
+
+            // position the stamp text near the top right. 
+            LowerLeftX = 402,
+            LowerLeftY = 600,
+            UpperRightX = 575,
+            UpperRightY = 900
+        });
 
         Assert.IsNotNull(outStream);
     }
 
     private void AddWaterMark(PdfContentByte dc, StampRequestForm stampRequest)
     {
         dc.SaveState();
+
         dc.SetGState(new PdfGState
-                     {
-                         FillOpacity = 0.61f,
-                         StrokeOpacity = 0.61f,
-                     });
+        {
+            FillOpacity = 0.61f,
+            StrokeOpacity = 0.61f
+        });
+
         dc.SetColorFill(BaseColor.Red);
         dc.BeginText();
-        dc.SetFontAndSize(BaseFont.CreateFont(), 7);
+        dc.SetFontAndSize(BaseFont.CreateFont(), size: 7);
         var x = (stampRequest.LowerLeftX + stampRequest.UpperRightX) / 2;
         var y = (stampRequest.LowerLeftY + stampRequest.UpperRightY) / 2;
 
         var verticalSpaceBetweenLines = 15;
+
         foreach (var line in stampRequest.Lines)
         {
             dc.ShowTextAligned(Element.ALIGN_CENTER, line, x, y, stampRequest.RotationDegree);

src/iTextSharp.LGPLv2.Core.FunctionalTests/_2-dotnet-test-no-analyzers.bat

@@ -0,0 +1,2 @@
+dotnet test -p:RunAnalyzers=false
+pause

src/iTextSharp.LGPLv2.Core/iTextSharp.LGPLv2.Core.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
         <Description>iTextSharp.LGPLv2.Core is an unofficial port of the last LGPL version of the iTextSharp (V4.1.6) to .NET Core.</Description>
-        <VersionPrefix>3.5.1</VersionPrefix>
+        <VersionPrefix>3.6.0</VersionPrefix>
         <Authors>Vahid Nasiri</Authors>
         <TargetFrameworks>net9.0;net8.0;net7.0;net6.0;netstandard2.0;net462;</TargetFrameworks>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
@@ -57,11 +57,11 @@
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>
-        <PackageReference Include="Meziantou.Analyzer" Version="2.0.184">
+        <PackageReference Include="Meziantou.Analyzer" Version="2.0.186">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>
-        <PackageReference Include="SonarAnalyzer.CSharp" Version="10.4.0.108396">
+        <PackageReference Include="SonarAnalyzer.CSharp" Version="10.5.0.109200">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>

src/iTextSharp.LGPLv2.Core/iTextSharp/text/Document.cs

@@ -520,9 +520,11 @@ public void Dispose()
     ///     Adds the current date and time to a Document.
     /// </summary>
     /// <returns>true if successful, false otherwise</returns>
-    public bool AddCreationDate()
+    public bool AddCreationDate(DateTime? dateTime = null)
         => Add(new Meta(Element.CREATIONDATE,
-            DateTime.Now.ToString(format: "ddd MMM dd HH:mm:ss zzz yyyy", CultureInfo.InvariantCulture)));
+            dateTime.HasValue
+                ? dateTime.Value.ToString(format: "ddd MMM dd HH:mm:ss zzz yyyy", CultureInfo.InvariantCulture)
+                : DateTime.Now.ToString(format: "ddd MMM dd HH:mm:ss zzz yyyy", CultureInfo.InvariantCulture)));
 
     /// <summary>
     ///     Adds the creator to a Document.
@@ -556,7 +558,7 @@ public bool AddCreationDate()
     ///     Adds the producer to a Document.
     /// </summary>
     /// <returns>true if successful, false otherwise</returns>
-    public bool AddProducer() => Add(new Meta(Element.PRODUCER, Version));
+    public bool AddProducer(string producer = null) => Add(new Meta(Element.PRODUCER, producer ?? Version));
 
     /// <summary>
     ///     Adds the subject to a Document.

src/iTextSharp.LGPLv2.Core/iTextSharp/text/ElementTags.cs

@@ -66,6 +66,9 @@ public static class ElementTags
     /// <summary> attribute of the root tag </summary>
     public const string AUTHOR = "author";
 
+    /// <summary> attribute of the root tag </summary>
+    public const string CREATOR = "creator";
+
     /// <summary>
     ///     a possible list attribute
     /// </summary>

src/iTextSharp.LGPLv2.Core/iTextSharp/text/pdf/PdfDocument.cs

@@ -3681,12 +3681,6 @@ internal void AddCreationDate()
         /// </summary>
         internal void Addkey(string key, string value)
         {
-            if (key.Equals(value: "Producer", StringComparison.Ordinal) ||
-                key.Equals(value: "CreationDate", StringComparison.Ordinal))
-            {
-                return;
-            }
-
             Put(new PdfName(key), new PdfString(value, TEXT_UNICODE));
         }