Merge pull request #11 from mgopsill/add-long-press-support

Add Support for UILongPressGestureRecognizer

Author: rafiki270

Example/SpecTools/ViewController.swift

@@ -19,6 +19,7 @@ class ViewController: UIViewController {
     let label3 = UILabel()
 
     let button1 = UIButton()
+    let longPressButton = UIButton()
 
 
     // MARK: Test properties
@@ -86,6 +87,21 @@ class ViewController: UIViewController {
             make.right.equalTo(-20)
             make.height.equalTo(36)
         }
+        
+        longPressButton.setTitle("Long press button", for: .normal)
+        let longPressGesture = UILongPressGestureRecognizer(target: self, action: #selector(longTap(_:)))
+        longPressButton.addGestureRecognizer(longPressGesture)
+        longPressButton.layer.borderColor = UIColor.lightGray.cgColor
+        longPressButton.layer.borderWidth = 1
+        longPressButton.layer.cornerRadius = 5
+        longPressButton.setTitleColor(.gray, for: .normal)
+        scrollView.addSubview(longPressButton)
+        longPressButton.snp.makeConstraints { (make) in
+            make.top.equalTo(button1.snp.bottom).offset(20)
+            make.left.equalTo(20)
+            make.right.equalTo(-20)
+            make.height.equalTo(36)
+        }
     }
 
     override func viewWillAppear(_ animated: Bool) {
@@ -114,4 +130,9 @@ class ViewController: UIViewController {
         navigationController?.pushViewController(c, animated: true)
     }
 
+    var didLongTap: Bool  = false
+    
+    @objc func longTap(_ sender: UIGestureRecognizer) {
+        didLongTap = true
+    }
 }

Example/SpecToolsExampleTests/ViewControllerSpec.swift

@@ -22,6 +22,7 @@ class ViewControllerSpec: QuickSpec {
         var subject: ViewController!
 
         var button1: UIButton!
+        var longPressButton: UIButton!
 
         describe("ViewController") {
             beforeEach {
@@ -38,6 +39,9 @@ class ViewControllerSpec: QuickSpec {
 
                 // Get a button that equals "Launch table view controller" and print how we get to it in the console including all frames and any text if present
                 button1 = subject.view.spec.find.first(buttonWithText: "Launch table view controller", visualize: .all)!
+                
+                // Get a button that equals "Long press button"
+                longPressButton = subject.view.spec.find.first(buttonWithText: "Long press button")!
             }
 
             it("should have gone through the whole initial lifecycle procedure") {
@@ -104,6 +108,18 @@ class ViewControllerSpec: QuickSpec {
                     expect(subject.navigationController?.spec.check.contains(viewControllerClass: TableViewController.self)).to(beTrue())
                 }
             }
+            
+            describe("when we long press on long press button") {
+                beforeEach {
+                    // Simulate long press on button
+                    longPressButton.spec.action.triggerLongPress()
+                }
+                
+                it("should have pushed a new view controller") {
+                    // Check longTap function was called
+                    expect(subject.didLongTap).toEventually(beTrue())
+                }
+            }
         }
     }
 }

README.md

@@ -183,13 +183,23 @@ collectionView.spec.action.tap(item: 3)
 // or
 collectionView.spec.action.tap(item: 2, section: 1)
 ```
-
+------
 #### Simulating swipes
 
 Simulate swipe on a view with UISwipeGestureRecognizer(s)
 ```Swift
 view.spec.action.triggerSwipe(direction: .up)
 ```
+
+------
+#### Simulating long presses
+
+Simulate swipe on a view with UILongPressGestureRecognizer(s)
+```Swift
+button.spec.action.triggerLongPress()
+// or
+button.spec.action.triggerLongPress(minimumPressDuration: 1.0, taps: 3, touches: 2)
+```
 ------
 
 #### Executing gesture recognizers (not available on tvOS)

SpecTools/Classes/Action/Action+UIGestureRecognizer.swift

@@ -47,7 +47,25 @@ public typealias TargetActionInfo = [(target: AnyObject, action: Selector)]
 
             return self
         }
-
+        
+        /// Simulate long press on a gesture recognizer
+        /// - Parameter minimumPressDuration: Minimum period of time before gesture recognized
+        /// - Parameter taps: Number of taps
+        /// - Parameter touches: Number of touches
+        @discardableResult public func triggerLongPress(minimumPressDuration: TimeInterval = 0.5, taps: Int = 1, touches: Int = 1) -> Action {
+            guard element.isUserInteractionEnabled else {
+                fatalError("User interactions are disabled. Gesture recognizer can't be used.")
+            }
+            let recognizers = element.spec.find.all(gestureRecognizersOfType: UILongPressGestureRecognizer.self)
+            for recognizer in recognizers {
+                if recognizer.minimumPressDuration <= minimumPressDuration &&
+                    recognizer.numberOfTapsRequired == taps &&
+                    recognizer.numberOfTouchesRequired == touches {
+                    recognizer.spec.action.execute()
+                }
+            }
+            return self
+        }
     }