Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thoughtbot/Perform
Easy dependency injection for storyboard segues
https://github.com/thoughtbot/Perform
Last synced: 3 months ago
JSON representation
Easy dependency injection for storyboard segues
- Host: GitHub
- URL: https://github.com/thoughtbot/Perform
- Owner: thoughtbot
- License: mit
- Created: 2016-08-29T15:28:23.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2021-09-24T16:05:08.000Z (about 3 years ago)
- Last Synced: 2024-05-09T08:01:27.920Z (6 months ago)
- Language: Swift
- Size: 66.4 KB
- Stars: 280
- Watchers: 10
- Forks: 12
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios-star - Perform - Easy dependency injection for storyboard segues. (Dependency Injection / Getting Started)
- awesome-ios - Perform - Easy dependency injection for storyboard segues. (Dependency Injection / Getting Started)
- fucking-awesome-ios - Perform - Easy dependency injection for storyboard segues. (Dependency Injection / Getting Started)
README
# Perform
Easy dependency injection for storyboard segues.
```swift
import Perform
// ...
func tableView(_ tableView: UITableView, didSelectRowAt indexPath: NSIndexPath) {
let task = taskList[indexPath.row]
perform(.showTaskDetails) { taskVC in
taskVC.task = task
}
}
```
## Usage
Configure your segues:
```swift
// Sources/Extensions/Segue.swift
import Perform
extension Segue {
static var showTaskDetails: Segue {
return .init(identifier: "ShowTaskDetails")
}
}
```
And then use `perform(_:prepare:)` instead of `performSegue(withIdentifier:sender:)`.
That's it!
#### Type-safe segues
Perform checks the type of the destination view controller and casts it for you,
raising an error if your destination view controller is an unexpected type.
#### Still works if your view controller is embedded in a container
Ever written code like this?
```swift
guard let nav = segue.destinationViewController as? UINavigationController,
let content = nav.rootViewController as? MyViewController
else { return }
// ... finally! ðŸ˜
```
Perform takes care of this, searching the view controller hierarchy for a view
controller of the matching type!
#### No switch statements in `prepareForSegue(_:sender:)`
Multiple segues from one view controller? No problem, just prepare each
destination view controller right where you perform the segue. No more massive
switch statements.
#### Further reading
For more examples, and a discussion about the motivation and design of Perform,
take a look at the [introductory blog post][perform-blog].
[perform-blog]: https://robots.thoughtbot.com/introducing-perform-easy-dependency-injection-for-storyboard-segues
## Installation
### Compatibility
| Swift Version | Perform Version |
| ------------- | --------------- |
| 3.x | 2.x |
| 2.x | 1.x |
### [Carthage][carthage-home]
Add the following to your Cartfile:
```
github "thoughtbot/Perform" ~> 2.0
```
Then run `carthage update Perform`.
Follow the instructions in [Carthage's README][carthage-readme] for up-to-date
installation instructions.
[carthage-home]: https://github.com/Carthage/Carthage
[carthage-readme]: https://github.com/Carthage/Carthage#adding-frameworks-to-an-application
### [CocoaPods][cocoapods]
Add the following to your Podfile:
```
pod "Perform", "~> 2.0"
```
See the [CocoaPods guide][cocoapods-usage] for up-to-date installation
instructions.
[cocoapods]: https://cocoapods.org
[cocoapods-usage]: https://guides.cocoapods.org/using/using-cocoapods.html
## Contributing
See the [CONTRIBUTING][] document.
[CONTRIBUTING]: CONTRIBUTING.md
## License
Perform is Copyright (c) 2016 thoughtbot, inc.
It is free software, and may be redistributed
under the terms specified in the [LICENSE] file.
[LICENSE]: LICENSE
## About
Perform is maintained and funded by thoughtbot, inc.
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
We love open source software!
See [our other projects][community]
or [hire us][hire] to help build your product.
[community]: https://thoughtbot.com/community?utm_source=github
[hire]: https://thoughtbot.com/hire-us?utm_source=github