Outlets
Utility functions for validating IBOutlet and IBAction connections.
About
Outlets provides a set of functions which validate that IBOutlets are correctly connected between your Storyboard/XIB file and view controller properties. It can also validate that IBAction methods are connected correctly as well.
This micro-library is based on the following post: Testing IBOutlets and IBActions With Curried Functions in Swift
Requirements
- Xcode 7.3+
- Swift 2.2+
- iOS 8.0+
Installation
CocoaPods (recommended)
target 'AppTests' do
use_frameworks!
pod 'Outlets'
end
Carthage
github "phatblat/Outlets"
Example
To run the example project, clone the repo, and run pod install from the Example directory first.
Or run pod try Outlets from the command line.
Getting Started
Here is an example of using Outlets with Quick and Nimble:
class ViewControllerSpec: QuickSpec {
override func spec() {
setupFailHandler { message in
if let message = message {
fail(message)
} else {
fail()
}
}
var viewController: UIViewController!
var hasBarButtonItemOutlet: BarButtonItemOutletAssertion!
var hasSegmentedControlOutlet: SegmentedControlOutletAssertion!
var receivesAction: ActionAssertion!
describe("view controller") {
beforeEach {
viewController = UIStoryboard(name: "Main", bundle: nil).instantiateViewControllerWithIdentifier("ViewController")
viewController.loadView()
expect(viewController.view).toNot(beNil())
setupActionValidator { target, action, expectedAction in
expect(target) === viewController
expect(action).toNot(beNil())
if let action = action {
expect(action) == expectedAction
}
}
// Capture the new viewController instance for each test
hasBarButtonItemOutlet = outlet(viewController)
hasSegmentedControlOutlet = outlet(viewController)
receivesAction = action(viewController)
}
// MARK: - Outlets
it("has a leftButton outlet") {
hasBarButtonItemOutlet("leftButton")
}
it("has a rightButton outlet") {
hasBarButtonItemOutlet("rightButton")
}
it("has a segmentedControl outlet") {
hasSegmentedControlOutlet("segmentedControl")
}
// MARK: - Actions
it("receives a didTapLeftButton: action from leftButton") {
receivesAction("didTapLeftButton:", from: "leftButton")
}
it("receives a didTapRightButton: action from rightButton") {
receivesAction("didTapRightButton:", from: "rightButton")
}
it("receives a segmentedControlValueDidChange: action from segmentedControl") {
receivesAction("segmentedControlValueDidChange:", from: "segmentedControl")
}
}
}
}
Author
Ben Chatelain, @phatblat
License
Outlets is released under the MIT License. See the LICENSE file for details.
876 Jan 5, 2023
2 Sep 28, 2021
2 Mar 13, 2022
11 Aug 26, 2022
0 Dec 14, 2021
921 Nov 20, 2022
113 Sep 9, 2022
2 Dec 3, 2022
2.3k Jan 3, 2023
0 Dec 13, 2021
60 Sep 9, 2022
850 Oct 25, 2022
825 Dec 7, 2022
69 Dec 30, 2022
5 Jun 10, 2022
261 Dec 15, 2022
289 Dec 12, 2022
312 Dec 22, 2022
29 Nov 14, 2022