Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/phatblat/Outlets
Utility functions for validating IBOutlet and IBAction connections
https://github.com/phatblat/Outlets
Last synced: 3 months ago
JSON representation
Utility functions for validating IBOutlet and IBAction connections
- Host: GitHub
- URL: https://github.com/phatblat/Outlets
- Owner: phatblat
- License: mit
- Created: 2016-05-01T18:09:58.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-21T22:09:29.000Z (over 2 years ago)
- Last Synced: 2024-08-09T04:43:15.457Z (3 months ago)
- Language: Swift
- Size: 76.2 KB
- Stars: 129
- Watchers: 7
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-ios - Outlets - Utility functions for validating IBOutlet and IBAction connections. (Utility / Web View)
- awesome-ios-star - Outlets - Utility functions for validating IBOutlet and IBAction connections. (Utility / Web View)
README
# Outlets
_Utility functions for validating `IBOutlet` and `IBAction` connections._
[](http://cocoapods.org/pods/Outlets)
[](http://cocoapods.org/pods/Outlets)
[](https://developer.apple.com/swift)
[](http://cocoapods.org/pods/Outlets)
[](https://github.com/Carthage/Carthage)
[](https://travis-ci.org/phatblat/Outlets)
[](https://codecov.io/gh/phatblat/Outlets)
# 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](http://phatbl.at/2016/04/29/testing-iboutlets-and-ibactions-with-curried-functions-in-swift.html)
## Requirements
- Xcode 7.3+
- Swift 2.2+
- iOS 8.0+
## Installation
### [CocoaPods](http://cocoapods.org) (recommended)
```ruby
target 'AppTests' do
use_frameworks!
pod 'Outlets'
end
```
### [Carthage](https://github.com/Carthage/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:
```swift
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](https://twitter.com/phatblat)
## License
Outlets is released under the [MIT License](http://opensource.org/licenses/MIT). See the [LICENSE](LICENSE.md) file for details.