Merge pull request #212 from techprimate/release/2.1.0

Release/2.1.0

Author: Philip Niedertscheider

.travis.yml

@@ -9,6 +9,7 @@ env:
   - PROJECT="Example.xcodeproj"
   - EXAMPLE_SCHEME="Example"
 
+  - secure: y71ScxtfYr3/DI0XKjGz8Bmia33QF9vO5euPJJbQ6kD5ADhEFkici/YZWxDkYtEZocKaUHIR4KYrKya2kTwJC630s2wLg974gERcUATZkWxeJdKgpfZ2aZtqYNPPDxozMTFtiT4kaw5HiD0usJUgnWKqf/XsTW+3BpTJA58xqXChcXulibs9FJvPz6ZVxW+dNW3F5xtC3GCOWk3Rofrw8GJXdCfie/CaJUvxaQVm9hOwKn0Akpe6rvFKlMtfYOLL9yclaMAM+Um7uFVZwhCPHtAzXvpOhA2U/n7eXy/fNpoXxi9zf+epD1iiFmxJQfc1ZO6jkUJEksLXdO3pEMnoe205Bm70QMO6l9gyuq6Z2cUcCBrd2wDzfLYBoOqapgachpTQifotXX6rapm5pCDhg0pMCRihH5moFnsE7jqz2Lo4n68cvSa9+Irr97HmvH+GdF++VIVGK4/GJOErwGUx0Nh32BIeV3p4D+MNm918mAEO7a66a1RiTKNAr1xnrAtCl0k4XeZPCp0uQQ0TEVOxi/vecIS3k6mNMJw5W9tE0F7fun8kHdv6EKrzKIBkyDxMsh2Z5zVqE3wRcCuD+7FgrcmYDUXyk+t1o2cMNs7iZkKFQAG69+qXviTXnaD9Mq0LGP1sx+OQpQKzde9CAC+tgj+1fqD41jqr6zHJqaEOxvs=
 stages:
   - Tests
   - Examples

CHANGELOG.md

@@ -1,7 +1,7 @@
 # Change Log
 
 ## [Unreleased](https://github.com/techprimate/TPPDF/tree/HEAD) (2020-??-??)
-[Full Changelog](https://github.com/techprimate/TPPDF/compare/2.0.0...HEAD)
+[Full Changelog](https://github.com/techprimate/TPPDF/compare/2.1.0...HEAD)
 
 **Implemented enhancements:**
 
@@ -11,6 +11,35 @@
 
 **Merged pull requests:**
 
+## [2.1.0](https://github.com/techprimate/TPPDF/tree/HEAD) (2020-06-15)
+[Full Changelog](https://github.com/techprimate/TPPDF/compare/2.0.1...2.1.0)
+
+**Implemented enhancements:**
+
+- Added raw representable values to `PDFPageFormat`
+- Added raw representable type to `PDFLineType`
+- Added constant `none` to `PDFTableCellStyle` and `PDFTableCellBorders`
+- Added background color to `PDFSectionColumn` (Issue #122)
+
+**Fixed bugs:**
+
+- Added note to documentation about not reusing `PDFSection` instances (Issue #122)
+- Added missing font and text color reset to generator
+
+**Closed issues:**
+
+- #73
+- #122
+- #204
+- #197
+- #189
+- #186
+- #184
+- #183
+
+**Merged pull requests:**
+
+- #211
 
 ## [2.0.1](https://github.com/techprimate/TPPDF/tree/2.0.1) (2020-05-31)
 [Full Changelog](https://github.com/techprimate/TPPDF/compare/2.0.0...2.0.1)

Documentation/Usage.md

@@ -497,6 +497,8 @@ section.columns[2].addText(.center, text: "center")
 document.add(sectiion: section)
 ```
 
+**Attention:** Do not add a `PDFSection` multiple times, as they hold some internal state, which will lead to collisions and unpredictable framing calculations
+
 #### Column Wrap Sections
 
 A column wrap section allows you to split your page into multiple columns and fill it up starting at the left. All you have to do is enable it, add content, and then disable it. When disabling it you can set the flag `addPageBreak` if you want it to continue on a fresh page (defaults to true).

Shared/Examples/MultiSectionExampleFactory.swift

@@ -15,19 +15,24 @@ class MultiSectionExampleFactory: ExampleFactory {
         let document = PDFDocument(format: .a4)
 
         // Add multi column section
-        let section = PDFSection(columnWidths: [0.33, 0.34, 0.33])
+        let section = PDFSection(columnWidths: [0.30, 0.40, 0.30])
+        section.columns[0].backgroundColor = UIColor.red
         section.columns[0].add(.left, text: "left")
         section.columns[0].add(.center, text: "center")
         section.columns[0].add(.right, text: "right")
         section.columns[0].add(text: "Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.")
         section.columns[0].add(.center, image: PDFImage(image: UIImage(named: "Icon.png")!, size: CGSize(width: 40, height: 40), quality: 0.9))
         section.columns[0].add(text: "At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.")
+
+        section.columns[1].backgroundColor = UIColor.orange
         section.columns[1].add(.left, text: "left")
         section.columns[1].add(.center, text: "center")
         section.columns[1].add(.right, text: "right")
         section.columns[1].add(text: "Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.")
         section.columns[1].add(.center, text: "center")
         section.columns[1].add(.center, image: PDFImage(image: UIImage(named: "Icon.png")!, size: CGSize(width: 40, height: 40), quality: 0.9))
+
+        section.columns[2].backgroundColor = UIColor.yellow
         section.columns[2].add(.center, image: PDFImage(image: UIImage(named: "Icon.png")!, size: CGSize(width: 40, height: 40), quality: 0.9))
         section.columns[2].add(text: "Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.")
         section.columns[2].add(.left, text: "left")

Source/API/Graphics/PDFLineType.swift

@@ -12,26 +12,26 @@
  - dashed: Line consists out of short dashes
  - dotted: Lines consists out of dots
  */
-public enum PDFLineType {
+public enum PDFLineType: String {
 
     /**
      No visible line
      */
-    case none
+    case none = "none"
 
     /**
      Full line
      */
-    case full
+    case full = "full"
 
     /**
      Line is dashed, dash length and spacing is three times the line width
      */
-    case dashed
+    case dashed = "dashed"
 
     /**
      Line is dotted. Dot spacing is twice the line width
      */
-    case dotted
+    case dotted = "dotted"
 
 }

Source/API/PDFGenerator.swift

@@ -102,5 +102,11 @@ public class PDFGenerator: PDFGeneratorProtocol, CustomStringConvertible {
         layout.reset()
         columnState.reset()
         currentPage = 1
+        fonts = fonts.mapValues { _ in
+            UIFont.systemFont(ofSize: UIFont.systemFontSize)
+        }
+        textColor = textColor.mapValues { _ in
+            UIColor.black
+        }
     }
 }

Source/API/Page Format/PDFPageFormat.swift

@@ -11,35 +11,73 @@ import UIKit
  * Source for page sizes: https://www.papersizes.org
  * All sizes are calculated using 72 points/inch
  */
-public enum PDFPageFormat {
+public enum PDFPageFormat: String {
 
     /**
      Page formats mostly used in the USA
      */
-    case usHalfLetter, usLetter, usLegal, usJuniorLegal, usLedger
+    case usHalfLetter = "us.half-letter",
+         usLetter = "us.letter",
+         usLegal = "us.legal",
+         usJuniorLegal = "us.junior-legal",
+         usLedger = "us.ledger"
 
     /**
      Page formats according to the American National Standards Institute
      */
-    case ansiA, ansiB, ansiC, ansiD, ansiE
+    case ansiA = "ansi.a",
+         ansiB = "ansi.b",
+         ansiC = "ansi.c",
+         ansiD = "ansi.d",
+         ansiE = "ansi.e"
 
     /**
      A-Series of paper standard DIN 476
      For more detail: https://en.wikipedia.org/wiki/Paper_size#A_series
      */
-    case a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10
+    case a0 = "a0",
+         a1 = "a1",
+         a2 = "a2",
+         a3 = "a3",
+         a4 = "a4",
+         a5 = "a5",
+         a6 = "a6",
+         a7 = "a7",
+         a8 = "a8",
+         a9 = "a9",
+         a10 = "a10"
 
     /**
      B-Series is the geometric mean of the A-series
      For more detail: https://en.wikipedia.org/wiki/Paper_size#B_series
      */
-    case b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, b10
+    case b0 = "b0",
+         b1 = "b1",
+         b2 = "b2",
+         b3 = "b3",
+         b4 = "b4",
+         b5 = "b5",
+         b6 = "b6",
+         b7 = "b7",
+         b8 = "b8",
+         b9 = "b9",
+         b10 = "b10"
 
     /**
      C-Series is ususally used for envelopes. Definition is written in ISO 269
      For more detail: https://en.wikipedia.org/wiki/Paper_size#C_series
      */
-    case c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, c10
+    case c0 = "c0",
+         c1 = "c1",
+         c2 = "c2",
+         c3 = "c3",
+         c4 = "c4",
+         c5 = "c5",
+         c6 = "c6",
+         c7 = "c7",
+         c8 = "c8",
+         c9 = "c9",
+         c10 = "c10"
 
     /**
      Size defined in constants

Source/API/Section/PDFSectionColumn.swift

@@ -19,6 +19,11 @@ public class PDFSectionColumn: PDFDocumentObject {
 	*/
 	public private(set) var width: CGFloat
 
+    /**
+    Background color of this section
+     */
+    public var backgroundColor: UIColor?
+
 	// MARK: - INTERNAL VARS
 
 	/**

Source/API/Table/Style/PDFTableCellBorders.swift

@@ -43,3 +43,9 @@ public struct PDFTableCellBorders {
         self.bottom = bottom
     }
 }
+
+extension PDFTableCellBorders {
+
+    public static let none = PDFTableCellBorders(left: .none, top: .none, right: .none, bottom: .none)
+    
+}

Source/API/Table/Style/PDFTableCellStyle.swift

@@ -38,3 +38,8 @@ public struct PDFTableCellStyle {
         self.font = font
     }
 }
+
+extension PDFTableCellStyle {
+
+    public static let none = PDFTableCellStyle(colors: (fill: UIColor.clear, text: UIColor.black), borders: .none, font: UIFont.systemFont(ofSize: UIFont.systemFontSize))
+}