Experimentally support practical size specification such as A4, B0, introducing PdfSize.

.github/workflows/command.yml

@@ -12,7 +12,7 @@ on:
 jobs:
   test:
     name: "Build Csv2ImgCmd"
-    runs-on: macos-12
+    runs-on: macos-13
     steps:
       - uses: actions/checkout@v3
       - uses: maxim-lobanov/setup-xcode@v1

.swiftpm/xcode/xcshareddata/xcschemes/Csv2ImgCmd.xcscheme

@@ -80,7 +80,7 @@
             isEnabled = "YES">
          </CommandLineArgument>
          <CommandLineArgument
-            argument = "-n https://raw.githubusercontent.com/fummicc1/csv2img/main/Fixtures/sample_1.csv"
+            argument = "-n https://raw.githubusercontent.com/fummicc1/csv2img/main/Fixtures/yolov5x6.csv"
             isEnabled = "YES">
          </CommandLineArgument>
          <CommandLineArgument

Sources/Csv2Img/Csv.swift

@@ -33,26 +33,32 @@ public actor Csv {
     ///
     /// `separator` is applied to each row and generate items per row.
     /// `columns` is array of column whose type is ``Column``.
-    /// `Row` is array of row whose type is ``Row``    
+    /// `rows` is array of row whose type is ``Row``
+    /// `exportType` is value of ``ExportType`` with default value `png`.
+    /// `pdfMetadata` is value of ``PDFMetadata`` with default value `nil`.
     public init(
         separator: String=",",
         rawString: String? = nil,
         encoding: String.Encoding = .utf8,
         columns: [Csv.Column] = [],
         rows: [Csv.Row] = [],
-        exportType: ExportType = .png
+        exportType: ExportType = .png,
+        pdfMetadata: PDFMetadata? = nil
     ) {
         self.imageMarker = ImageMaker(
             maximumRowCount: maximumRowCount,
             fontSize: 12
         )
+        self.pdfMetadata = pdfMetadata ?? PDFMetadata(
+            author: "Author",
+            title: "Title",
+            size: .a4,
+            orientation: .portrait
+        )
         self.pdfMarker = PdfMaker(
             maximumRowCount: maximumRowCount,
             fontSize: 12,
-            metadata: PDFMetadata(
-                author: "Author",
-                title: "Title"
-            )
+            metadata: self.pdfMetadata
         )
         self.encoding = encoding
         self.separator = separator
@@ -130,7 +136,14 @@ public actor Csv {
 
     /// `exportType` determines export type. Please choose ``ExportType.png`` or ``ExportType.pdf``.
     public var exportType: ExportType
-
+
+    /// `pdfMetadata` stores pdf metadata which is used when ``Csv2Img.Csv.ExportType`` is `.png`
+    private var pdfMetadata: PDFMetadata {
+        didSet {
+            pdfMarker.set(metadata: pdfMetadata)
+        }
+    }
+
     /// ``maximumRowCount`` is the max number of Rows. this is fixed due to performance issue.
     private let maximumRowCount: Int? = nil
 
@@ -627,4 +640,11 @@ extension Csv {
             return nil
         }
     }
+
+    /**
+     - set ``PdfMetadata``
+     */
+    public func update(pdfMetadata: PDFMetadata) {
+        self.pdfMetadata = pdfMetadata
+    }
 }

Sources/Csv2Img/PDFMetadata.swift

@@ -2,16 +2,27 @@ import Foundation
 
 /// ``PDFMetadata`` is a struct which stores Metadata about output-pdf.
 public struct PDFMetadata {
+
+    /// `author`. author of document.
+    public var author: String?
+    /// `title`. title of document.
+    public var title: String?
+
+    /**
+     - specify output pdf size with ``PdfSize``.
+     */
+    public var size: PdfSize?
+    public var orientation: PdfSize.Orientation?
+
     public init(
-        author: String,
-        title: String
+        author: String? = nil,
+        title: String? = nil,
+        size: PdfSize? = nil,
+        orientation: PdfSize.Orientation? = nil
     ) {
         self.author = author
         self.title = title
+        self.size = size
+        self.orientation = orientation
     }
-
-    /// `author`. author of document.
-    public var author: String
-    /// `title`. title of document.
-    public var title: String
 }