Added more description for using cardio via use_framworks! in swift

CardIO/CardIO.h

@@ -13,3 +13,48 @@
 #import "CardIOPaymentViewController.h"
 #import "CardIOPaymentViewControllerDelegate.h"
 #import "CardIOUtilities.h"
+#import "CardIOCVVTextFieldDelegate.h"
+#import "CardIONumbersTextFieldDelegate.h"
+#import "CardIOAnalytics.h"
+#import "CardIOAnimation.h"
+#import "CardIOBundle.h"
+#import "CardIOCGGeometry.h"
+#import "CardIOCameraView.h"
+#import "CardIOCardOverlay.h"
+#import "CardIOCardScanner.h"
+#import "CardIOConfig.h"
+#import "CardIOConfigurableTextFieldDelegate.h"
+#import "CardIOContext.h"
+#import "CardIOCreditCardExpiryFormatter.h"
+#import "CardIOCreditCardNumber.h"
+#import "CardIOCreditCardNumberFormatter.h"
+#import "CardIODataEntryViewController.h"
+#import "CardIODevice.h"
+#import "CardIOExpiryTextFieldDelegate.h"
+#import "CardIOGPUFilter.h"
+#import "CardIOGPURenderer.h"
+#import "CardIOGPUShaders.h"
+#import "CardIOGPUTransformFilter.h"
+#import "CardIOGuideLayer.h"
+#import "CardIOIccVersion.h"
+#import "CardIOLocalizer.h"
+#import "CardIOMacros.h"
+#import "CardIOMultipleFieldTableViewCell.h"
+#import "CardIOOrientation.h"
+#import "CardIOPaymentViewControllerContinuation.h"
+#import "CardIOPostalCodeTextFieldDelegate.h"
+#import "CardIOReadCardInfo.h"
+#import "CardIOResource.h"
+#import "CardIORowBasedTableViewSection.h"
+#import "CardIOSectionBasedTableViewDelegate.h"
+#import "CardIOShutterView.h"
+#import "CardIOStyles.h"
+#import "CardIOTableViewCell.h"
+#import "CardIOTransitionView.h"
+#import "CardIOVideoFrame.h"
+#import "CardIOVideoStream.h"
+#import "CardIOVideoStreamDelegate.h"
+#import "CardIOViewContinuation.h"
+#import "CardIOViewController.h"
+#import "RootViewController.h"
+#import "UIImage+ImageEffects.h"

CardIO/CardIOAnalytics.h

@@ -0,0 +1,26 @@
+//
+//  CardIOAnalytics.h
+//  See the file "LICENSE.md" for the full license governing this code.
+//
+
+#import <Foundation/Foundation.h>
+
+@class CardIOContext;
+@class CardIOCardScanner;
+
+@interface CardIOAnalytics : NSObject
+
+- (id)initWithContext:(CardIOContext *)aContext;
+
+#if USE_CAMERA || SIMULATE_CAMERA
+
+// Trigger the reporting of current scan analytics
+- (void)reportEventWithLabel:(NSString *)reportLabel withScanner:(CardIOCardScanner *)cardScanner;
+
+#endif // USE_CAMERA || SIMULATE_CAMERA
+
+@property(nonatomic, weak, readwrite) CardIOContext *context; // danger of retain cycles here, since context has a ref to us
+@property(nonatomic, strong, readwrite) NSString *sessionID;
+
+@end
+

CardIO/CardIOAnimation.h

@@ -0,0 +1,14 @@
+//
+//  CardIOAnimation.h
+//  See the file "LICENSE.md" for the full license governing this code.
+//
+
+#import <Foundation/Foundation.h>
+
+typedef void (^BareBlock)(void);
+
+void SuppressCAAnimation(BareBlock block);
+
+//@interface CardIOAnimation : NSObject
+//
+//@end

CardIO/CardIOBundle.h

@@ -0,0 +1,31 @@
+//
+// CardIOBundle.h
+//
+// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT DIRECTLY.
+//
+// To make changes, please either regenerate the file
+// or update the generator (and submit a pull request
+// with your fix!), as appropriate.
+//
+// Generated by command: `python baler.py assets/ Classes/ --overwrite-delay 0 -z -c CardIOBundle`
+//
+
+#import <UIKit/UIKit.h>
+
+@interface CardIOBundle : NSObject
+
+/// Get the CardIOBundle instance.
+/// Expands and saves the bundle to the filesystem on first invocation.
++ (CardIOBundle *)sharedInstance;
+
+/// Analogous to UIImage's +imageNamed:
+- (UIImage *)imageNamed:(NSString *)name;
+
+/// Use as you would any NSBundle
+- (NSBundle *)NSBundle;
+
+#if BALER_DEBUG
+- (BOOL)passesSelfTest:(NSError **)error;
+#endif
+
+@end

CardIO/CardIOCGGeometry.h

@@ -0,0 +1,246 @@
+//
+//  CardIOCGGeometry.h
+//  See the file "LICENSE.md" for the full license governing this code.
+//
+
+// Note: These don't really need namespacing, since they are inlined.
+
+// Note: need to use `#ifdef __LP64__` logic, rather than depending on <tgmath.h>,
+// because this header is sometimes included in .mm files (where <tgmath.h> doesn't apply).
+
+#import <Foundation/Foundation.h>
+
+static inline CGRect CGRectZeroWithSize(CGSize size) {
+  return CGRectMake(0.0f, 0.0f, size.width, size.height);
+}
+
+static inline CGRect CGRectZeroWithSquareSize(CGFloat size) {
+  return CGRectMake(0.0f, 0.0f, size, size);
+}
+
+static inline CGRect CGRectZeroWithWidthAndHeight(CGFloat width, CGFloat height) {
+  return CGRectMake(0.0f, 0.0f, width, height);
+}
+
+static inline CGRect CGRectWithOriginAndSize(CGPoint origin, CGSize size) {
+  return CGRectMake(origin.x, origin.y, size.width, size.height);
+}
+
+static inline CGRect CGRectWithOriginWidthAndHeight(CGPoint origin, CGFloat width, CGFloat height) {
+  return CGRectMake(origin.x, origin.y, width, height);
+}
+
+static inline CGRect CGRectWithOriginAndSquareSize(CGPoint origin, CGFloat size) {
+  return CGRectMake(origin.x, origin.y, size, size);
+}
+
+static inline CGRect CGRectWithXYAndSize(CGFloat xOrigin, CGFloat yOrigin, CGSize size) {
+  return CGRectMake(xOrigin, yOrigin, size.width, size.height);
+}
+
+static inline CGRect CGRectWithXYAndSquareSize(CGFloat xOrigin, CGFloat yOrigin, CGFloat size) {
+  return CGRectMake(xOrigin, yOrigin, size, size);
+}
+
+static inline CGRect CGRectWithCenterAndSize(CGPoint center, CGSize size) {
+  return CGRectMake(center.x - size.width / 2.0f, center.y - size.height / 2.0f, size.width, size.height);
+}
+
+static inline CGRect CGRectWithCenterAndSquareSize(CGPoint center, CGFloat size) {
+  return CGRectMake(center.x - size / 2.0f, center.y - size / 2.0f, size, size);
+}
+
+static inline CGRect CGRectWithRotatedRect(CGRect rect) {
+  return CGRectMake(rect.origin.y, rect.origin.x, rect.size.height, rect.size.width);
+}
+
+static inline CGSize CGSizeMakeSquare(CGFloat widthAndHeight) {
+  return CGSizeMake(widthAndHeight, widthAndHeight);
+}
+
+static inline CGRect CGRectByAddingXOffset(CGRect originalRect, CGFloat xOffset) {
+  return CGRectWithXYAndSize(originalRect.origin.x + xOffset, originalRect.origin.y, originalRect.size);
+}
+
+static inline CGRect CGRectByAddingYOffset(CGRect originalRect, CGFloat yOffset) {
+  return CGRectWithXYAndSize(originalRect.origin.x, originalRect.origin.y + yOffset, originalRect.size);
+}
+
+static inline CGRect CGRectByAddingXAndYOffset(CGRect originalRect, CGFloat xOffset, CGFloat yOffset) {
+  return CGRectWithXYAndSize(originalRect.origin.x + xOffset, originalRect.origin.y + yOffset, originalRect.size);
+}
+
+static inline CGRect CGRectByAddingWidth(CGRect originalRect, CGFloat additionalWidth) {
+  return CGRectMake(originalRect.origin.x, originalRect.origin.y, originalRect.size.width + additionalWidth, originalRect.size.height);
+}
+
+static inline CGRect CGRectByAddingHeight(CGRect originalRect, CGFloat additionalHeight) {
+  return CGRectMake(originalRect.origin.x, originalRect.origin.y, originalRect.size.width, originalRect.size.height + additionalHeight);
+}
+
+static inline CGRect CGRectBySettingWidth(CGRect originalRect, CGFloat newWidth) {
+  return CGRectMake(originalRect.origin.x, originalRect.origin.y, newWidth, originalRect.size.height);
+}
+
+static inline CGRect CGRectBySettingHeight(CGRect originalRect, CGFloat newHeight) {
+  return CGRectMake(originalRect.origin.x, originalRect.origin.y, originalRect.size.width, newHeight);
+}
+
+static inline CGRect CGRectByAddingWidthAndHeight(CGRect originalRect, CGFloat additionalWidth, CGFloat additionalHeight) {
+  return CGRectMake(originalRect.origin.x, originalRect.origin.y, originalRect.size.width + additionalWidth, originalRect.size.height + additionalHeight);
+}
+
+static inline CGSize CGSizeByAddingHeight(CGSize originalSize, CGFloat extraHeight) {
+  return CGSizeMake(originalSize.width, originalSize.height + extraHeight);
+}
+
+static inline CGSize CGSizeByAddingWidth(CGSize originalSize, CGFloat extraWidth) {
+  return CGSizeMake(originalSize.width + extraWidth, originalSize.height);
+}
+
+static inline CGSize CGSizeByAddingWidthAndHeight(CGSize originalSize, CGFloat extraWidth, CGFloat extraHeight) {
+  return CGSizeMake(originalSize.width + extraWidth, originalSize.height + extraHeight);
+}
+
+static inline CGSize CGSizeByScaling(CGSize originalSize, CGFloat scale) {
+  return CGSizeMake(originalSize.width * scale, originalSize.height * scale);
+}
+
+static inline CGPoint CGPointByAddingXOffset(CGPoint originalPoint, CGFloat xOffset) {
+  return CGPointMake(originalPoint.x + xOffset, originalPoint.y);
+}
+
+static inline CGPoint CGPointByAddingYOffset(CGPoint originalPoint, CGFloat yOffset) {
+  return CGPointMake(originalPoint.x, originalPoint.y + yOffset);
+}
+
+static inline CGFloat SquaredDistanceBetweenPoints(CGPoint p1, CGPoint p2) {
+  CGFloat deltaX = p1.x - p2.x;
+  CGFloat deltaY = p1.y - p2.y;
+  return (deltaX * deltaX) + (deltaY * deltaY);
+}
+
+static inline CGFloat DistanceBetweenPoints(CGPoint p1, CGPoint p2) {
+#ifdef __LP64__
+  return sqrt(SquaredDistanceBetweenPoints(p1, p2));
+#else
+  return sqrtf(SquaredDistanceBetweenPoints(p1, p2));
+#endif
+}
+
+static inline CGPoint CenterOfRect(CGRect rect) {
+  return CGPointMake(CGRectGetMidX(rect), CGRectGetMidY(rect));
+}
+
+static inline double AngleBetweenPoints(CGPoint p, CGPoint q) {
+  CGPoint deltaVector = CGPointMake(p.x - q.x, p.y - q.y);
+  double angle = atan(deltaVector.y / deltaVector.x) + (deltaVector.x < 0 ? M_PI : 0);
+  return angle;
+}
+
+static inline CGPoint MidpointBetweenPoints(CGPoint p, CGPoint q) {
+  return CGPointMake((p.x + q.x) / 2.0f, (p.y + q.y) / 2.0f);
+}
+
+static inline CGPoint PointMinusPoint(CGPoint p, CGPoint q) {
+  return CGPointMake(p.x - q.x, p.y - q.y);
+}
+
+static inline CGPoint PointPlusPoint(CGPoint p, CGPoint q) {
+  return CGPointMake(p.x + q.x, p.y + q.y);
+}
+
+static inline CGFloat OffsetToCenterFloatInFloat(CGFloat smallerValue, CGFloat largerValue) {
+  return (largerValue - smallerValue) / 2.0f;
+}
+
+static inline CGRect CenteredRectInRectWithSize(CGRect rectToCenterIn, CGSize sizeOfCenteredRect) {
+  return CGRectWithXYAndSize(rectToCenterIn.origin.x + OffsetToCenterFloatInFloat(sizeOfCenteredRect.width, rectToCenterIn.size.width),
+                             rectToCenterIn.origin.y + OffsetToCenterFloatInFloat(sizeOfCenteredRect.height, rectToCenterIn.size.height),
+                             sizeOfCenteredRect);
+}
+
+static inline CGSize ScaledSize(CGSize originalSize, CGFloat scalingFactor) {
+  return CGSizeMake(originalSize.width * scalingFactor, originalSize.height * scalingFactor);
+}
+
+static inline CGRect CGRectRoundedToNearestPixel(CGRect rect) {
+#ifdef __LP64__
+  return CGRectMake(round(rect.origin.x),
+                    round(rect.origin.y),
+                    round(rect.size.width),
+                    round(rect.size.height));
+#else
+  return CGRectMake(roundf(rect.origin.x),
+                    roundf(rect.origin.y),
+                    roundf(rect.size.width),
+                    roundf(rect.size.height));
+#endif
+}
+
+static inline CGRect CGRectFlooredToNearestPixel(CGRect rect) {
+#ifdef __LP64__
+  return CGRectMake(floor(rect.origin.x),
+                    floor(rect.origin.y),
+                    floor(rect.size.width),
+                    floor(rect.size.height));
+#else
+  return CGRectMake(floorf(rect.origin.x),
+                    floorf(rect.origin.y),
+                    floorf(rect.size.width),
+                    floorf(rect.size.height));
+#endif
+}
+
+static inline CGFloat CGFloatMean(CGFloat a, CGFloat b) {
+  return (a + b) / 2.0f;
+}
+
+static inline CGFloat orientationToRotation(UIInterfaceOrientation orientation) {
+  CGFloat rotation = 0.0f;
+  switch(orientation) {
+    case UIInterfaceOrientationPortrait: {
+      rotation = 0.0f;
+      break;
+    }
+    case UIInterfaceOrientationLandscapeRight: {
+      rotation = (CGFloat)M_PI_2;
+      break;
+    }
+    case UIInterfaceOrientationPortraitUpsideDown: {
+      rotation = (CGFloat)M_PI;
+      break;
+    }
+    case UIInterfaceOrientationLandscapeLeft: {
+      rotation = (CGFloat)(3.0 * M_PI_2);
+      break;
+    }
+    default:
+      break;
+  }
+  return rotation;
+}
+
+static inline CGRect aspectFit(CGSize contents, CGSize container) {
+  // Aspect fit is not well defined when contents or container is degenerate. Rather than crashing,
+  // return a zero-ish value.
+  if(contents.height == 0 || contents.width == 0 || container.width == 0 || container.height == 0) {
+    return CGRectZero;
+  }
+
+  CGFloat contentsAspectRatio = contents.width / contents.height;
+
+  CGSize contained;
+  if (contentsAspectRatio * container.height < container.width) {
+    contained = CGSizeMake(contentsAspectRatio * container.height, container.height);
+  } else if (contentsAspectRatio * container.height > container.width) {
+    contained = CGSizeMake(container.width, container.width / contentsAspectRatio);
+  } else {
+    contained = container;
+  }
+
+  CGPoint origin = CGPointMake((container.width - contained.width) / 2.0f, (container.height - contained.height) / 2.0f);
+
+  return CGRectWithOriginAndSize(origin, contained);
+}
+

CardIO/CardIOCVVTextFieldDelegate.h

@@ -0,0 +1,13 @@
+//
+//  CardIOCVVTextFieldDelegate.h
+//  See the file "LICENSE.md" for the full license governing this code.
+//
+
+#import <Foundation/Foundation.h>
+#import "CardIOConfigurableTextFieldDelegate.h"
+
+@interface CardIOCVVTextFieldDelegate : CardIOConfigurableTextFieldDelegate
+
++ (BOOL)isValidCVV:(NSString *)cvv forNumber:(NSString *)number;
+
+@end