Add docstrings and move the enums to their own file.

Braintree.xcodeproj/project.pbxproj

@@ -36,6 +36,8 @@
 		428F976626727333001042E1 /* BTMockOpenURLContext.m in Sources */ = {isa = PBXBuildFile; fileRef = 428F976526727333001042E1 /* BTMockOpenURLContext.m */; };
 		42FC218B25CDE0290047C49A /* BTPayPalRequest_Tests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 42FC218A25CDE0290047C49A /* BTPayPalRequest_Tests.swift */; };
 		42FC237125CE0E110047C49A /* BTPayPalCheckoutRequest_Tests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 42FC237025CE0E110047C49A /* BTPayPalCheckoutRequest_Tests.swift */; };
+		451508362D400C050071E385 /* BTPayPalPaymentType.swift in Sources */ = {isa = PBXBuildFile; fileRef = 451508352D400C050071E385 /* BTPayPalPaymentType.swift */; };
+		451508382D400C400071E385 /* BTPayPalRequestLandingPageType.swift in Sources */ = {isa = PBXBuildFile; fileRef = 451508372D400C400071E385 /* BTPayPalRequestLandingPageType.swift */; };
 		45227FC52C330FDE00A15018 /* MockURLSessionTask.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45227FC32C330FDE00A15018 /* MockURLSessionTask.swift */; };
 		45227FC72C33104100A15018 /* MockBTHTTPNetworkTiming.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45227FC62C33104100A15018 /* MockBTHTTPNetworkTiming.swift */; };
 		454722B02CF0DA34000DCF4E /* LocalPaymentPOSTBody.swift in Sources */ = {isa = PBXBuildFile; fileRef = 454722AF2CF0DA27000DCF4E /* LocalPaymentPOSTBody.swift */; };
@@ -719,6 +721,8 @@
 		42F75E5A24D48138007DC5E7 /* BTThreeDSecureClient_Tests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BTThreeDSecureClient_Tests.swift; sourceTree = "<group>"; };
 		42FC218A25CDE0290047C49A /* BTPayPalRequest_Tests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BTPayPalRequest_Tests.swift; sourceTree = "<group>"; };
 		42FC237025CE0E110047C49A /* BTPayPalCheckoutRequest_Tests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BTPayPalCheckoutRequest_Tests.swift; sourceTree = "<group>"; };
+		451508352D400C050071E385 /* BTPayPalPaymentType.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BTPayPalPaymentType.swift; sourceTree = "<group>"; };
+		451508372D400C400071E385 /* BTPayPalRequestLandingPageType.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BTPayPalRequestLandingPageType.swift; sourceTree = "<group>"; };
 		45227FC32C330FDE00A15018 /* MockURLSessionTask.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MockURLSessionTask.swift; sourceTree = "<group>"; };
 		45227FC62C33104100A15018 /* MockBTHTTPNetworkTiming.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MockBTHTTPNetworkTiming.swift; sourceTree = "<group>"; };
 		454722AF2CF0DA27000DCF4E /* LocalPaymentPOSTBody.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LocalPaymentPOSTBody.swift; sourceTree = "<group>"; };
@@ -1299,13 +1303,15 @@
 				57544F5D295258AC00DEB7B0 /* BTPayPalError.swift */,
 				BEF5D2E5294A18B300FFD56D /* BTPayPalLineItem.swift */,
 				57D9436D2968A8080079EAB1 /* BTPayPalLocaleCode.swift */,
+				451508352D400C050071E385 /* BTPayPalPaymentType.swift */,
+				62B811872CC002470024A688 /* BTPayPalPhoneNumber.swift */,
 				BE349112294B798300D2CF68 /* BTPayPalRequest.swift */,
+				451508372D400C400071E385 /* BTPayPalRequestLandingPageType.swift */,
 				BE6BC22D2BA9CFFC00C3E321 /* BTPayPalReturnURL.swift */,
 				BE349110294B77E100D2CF68 /* BTPayPalVaultRequest.swift */,
 				45E8CE4A2D1F291400D7A2DC /* Models */,
 				62A659A32B98CB23008DFD67 /* PrivacyInfo.xcprivacy */,
 				807D22F32C29ADA8009FFEA4 /* RecurringBillingMetadata */,
-				62B811872CC002470024A688 /* BTPayPalPhoneNumber.swift */,
 			);
 			path = BraintreePayPal;
 			sourceTree = "<group>";
@@ -3119,12 +3125,14 @@
 				BE549F112BF5445F00B6F441 /* BTPayPalReturnURL.swift in Sources */,
 				57544F5C295254A500DEB7B0 /* BTJSON+PayPal.swift in Sources */,
 				3B7A261129C0CAA40087059D /* BTPayPalAnalytics.swift in Sources */,
+				451508382D400C400071E385 /* BTPayPalRequestLandingPageType.swift in Sources */,
 				BE8E5CEF294B6937001BF017 /* BTPayPalCheckoutRequest.swift in Sources */,
 				807D22F02C29A93A009FFEA4 /* BTPayPalBillingCycle.swift in Sources */,
 				5754481E294A2A1D00DEB7B0 /* BTPayPalCreditFinancingAmount.swift in Sources */,
 				57D9436E2968A8080079EAB1 /* BTPayPalLocaleCode.swift in Sources */,
 				45E8CE4C2D1F29BA00D7A2DC /* PayPalCheckoutPOSTBody.swift in Sources */,
 				57544F582952298900DEB7B0 /* BTPayPalAccountNonce.swift in Sources */,
+				451508362D400C050071E385 /* BTPayPalPaymentType.swift in Sources */,
 				8014221C2BAE935B009F9999 /* BTPayPalApprovalURLParser.swift in Sources */,
 				BE349111294B77E100D2CF68 /* BTPayPalVaultRequest.swift in Sources */,
 				62B811882CC002470024A688 /* BTPayPalPhoneNumber.swift in Sources */,

Sources/BraintreePayPal/BTPayPalPaymentType.swift

@@ -0,0 +1,19 @@
+import Foundation
+
+@objc public enum BTPayPalPaymentType: Int {
+
+    /// Checkout
+    case checkout
+
+    /// Vault
+    case vault
+
+    var stringValue: String {
+        switch self {
+        case .vault:
+            return "paypal-ba"
+        case .checkout:
+            return "paypal-single-payment"
+        }
+    }
+}

Sources/BraintreePayPal/BTPayPalRequest.swift

@@ -4,50 +4,7 @@ import UIKit
 import BraintreeCore
 #endif
 
-@objc public enum BTPayPalPaymentType: Int {
-
-    /// Checkout
-    case checkout
-
-    /// Vault
-    case vault
-
-    var stringValue: String {
-        switch self {
-        case .vault:
-            return "paypal-ba"
-        case .checkout:
-            return "paypal-single-payment"
-        }
-    }
-}
-
-/// Use this option to specify the PayPal page to display when a user lands on the PayPal site to complete the payment.
-@objc public enum BTPayPalRequestLandingPageType: Int {
-
-    /// Default
-    case none // Obj-C enums cannot be nil; this default option is used to make `landingPageType` optional for merchants
-
-    /// Login
-    case login
-
-    /// Billing
-    case billing
-
-    var stringValue: String? {
-        switch self {
-        case .login:
-            return "login"
-
-        case .billing:
-            return "billing"
-
-        default:
-            return nil
-        }
-    }
-}
-
+/// Defines the structure and requirements for PayPal Checkout and PayPal Vault flows.
 protocol PayPalRequest {
     var hermesPath: String { get }
     var paymentType: BTPayPalPaymentType { get }

Sources/BraintreePayPal/BTPayPalRequestLandingPageType.swift

@@ -0,0 +1,27 @@
+import Foundation
+
+/// Use this option to specify the PayPal page to display when a user lands on the PayPal site to complete the payment.
+@objc public enum BTPayPalRequestLandingPageType: Int {
+
+    /// Default
+    case none // Obj-C enums cannot be nil; this default option is used to make `landingPageType` optional for merchants
+
+    /// Login
+    case login
+
+    /// Billing
+    case billing
+
+    var stringValue: String? {
+        switch self {
+        case .login:
+            return "login"
+
+        case .billing:
+            return "billing"
+
+        default:
+            return nil
+        }
+    }
+}