Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/intelygenz/Kommander-iOS
A lightweight, pure-Swift library for manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand.
https://github.com/intelygenz/Kommander-iOS
block cancel closure command concurrency current dispatcher dispatchqueue error execute execution kommand kommander main operationqueue pattern success swift task thread
Last synced: 3 months ago
JSON representation
A lightweight, pure-Swift library for manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand.
- Host: GitHub
- URL: https://github.com/intelygenz/Kommander-iOS
- Owner: intelygenz
- License: mit
- Archived: true
- Created: 2017-02-23T08:01:57.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-02-13T18:26:28.000Z (over 5 years ago)
- Last Synced: 2024-04-29T07:42:15.261Z (6 months ago)
- Topics: block, cancel, closure, command, concurrency, current, dispatcher, dispatchqueue, error, execute, execution, kommand, kommander, main, operationqueue, pattern, success, swift, task, thread
- Language: Swift
- Homepage: https://intelygenz.github.io/Kommander-iOS/
- Size: 1020 KB
- Stars: 172
- Watchers: 9
- Forks: 17
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-ios - Kommander - Kommander is a Swift library to manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand. (Concurrency / Linter)
- awesome-swift - Kommander - Manage the task execution in different threads through Kommands. (Libs / Concurrency)
- awesome-ios-star - Kommander - Kommander is a Swift library to manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand. (Concurrency / Linter)
- fucking-awesome-ios - Kommander - Kommander is a Swift library to manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand. (Concurrency / Linter)
- fucking-awesome-ios - Kommander - Kommander is a Swift library to manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand. (Concurrency / Linter)
- awesome-swift - Kommander - A lightweight, pure-Swift library for manage the task execution in different threads. Through the definition a simple but powerful concept, Kommand. ` 📝 3 years ago ` (Concurrency [🔝](#readme))
README
[](http://twitter.com/intelygenz)
[](http://cocoapods.org/pods/Kommander)
[](http://cocoapods.org/pods/Kommander)
[](http://cocoapods.org/pods/Kommander)
[](https://swift.org)
[](https://github.com/Carthage/Carthage)
[](https://github.com/apple/swift-package-manager)
[](https://travis-ci.org/intelygenz/Kommander-iOS)
[](https://intelygenz.github.io/Kommander-iOS)
[](http://cocoapods.org/pods/Kommander)
[](https://www.codetriage.com/intelygenz/kommander-ios)
**Kommander** is a Swift library to manage the task execution in different threads. Through the definition a simple but powerful concept, [**Kommand**](https://en.wikipedia.org/wiki/Command_pattern).
Inspired on the Java library [**Kommander**](https://github.com/Wokdsem/Kommander) from [**Wokdsem**](https://github.com/Wokdsem).
## 🌟 Features
- [x] Make kommand or multiple kommands
- [x] Execute kommand or multiple kommands
- [x] Cancel kommand or multiple kommands
- [x] Retry kommand or multiple kommands
- [x] Set kommand success closure
- [x] Set kommand error closure
- [x] Set kommand error closure specifying Error type
- [x] Main thread dispatcher
- [x] Current thread dispatcher
- [x] Custom OperationQueue dispatcher
- [x] Execute single or multiple Operation
- [x] Execute sequential or concurrent closures
- [x] Execute DispatchWorkItem
- [x] Kommand state
- [x] iOS compatible
- [x] watchOS compatible
- [x] tvOS compatible
- [x] macOS compatible
- [x] Swift 4 version
- [x] Swift 3 version
- [x] Swift 2 version
- [x] Objective-C version
## 📲 Installation
Kommander is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'Kommander'
```
For Swift 3 compatibility use:
```ruby
pod 'Kommander', '~> 0.7'
```
For Swift 2 compatibility use:
```ruby
pod 'Kommander', :git => 'https://github.com/intelygenz/Kommander-iOS.git', :tag => '0.3.0-swift2'
```
For Objective-C compatibility use:
```ruby
pod 'Kommander', :git => 'https://github.com/intelygenz/Kommander-iOS.git', :tag => '0.2.3-objc'
```
#### Or you can install it with [Carthage](https://github.com/Carthage/Carthage):
```ogdl
github "intelygenz/Kommander-iOS"
```
#### Or install it with [Swift Package Manager](https://swift.org/package-manager/):
```swift
dependencies: [
.package(url: "https://github.com/intelygenz/Kommander-iOS.git")
]
```
## 🐒 Usage
#### Making, executing, cancelling and retrying Kommands:
```swift
Kommander().make {
// Your code here
}.execute()
```
```swift
Kommander().make {
// Your code here
}.execute(after: .seconds(2))
```
```swift
Kommander().make {
return "Your string"
}.success { yourString in
print(yourString)
}.execute()
```
```swift
Kommander().make {
throw CocoaError(.featureUnsupported)
}.error { error in
print(String(describing: error!))
}.execute()
```
##### Specify Error type:
```swift
Kommander().make {
throw MyError.error
}.error(MyError.self) { error in
// error is MyError type.
}.execute()
```
##### Retry after cancellation:
```swift
let kommand = Kommander().make { () -> Any? in
// Your code here
}.success { result in
// Your success handling here
}.error { error in
// Your error handling here
}.execute()
kommand.cancel()
kommand.retry()
```
##### Retry after failure:
```swift
let kommand = Kommander().make { () -> Any? in
// Your code here
}.error { error in
// Your error handling here
}.retry { error, executionCount in
return executionCount < 2
}.execute()
```
#### Creating Kommanders:
```swift
Kommander(deliverer: Dispatcher = .current, executor: Dispatcher = .default)
Kommander(deliverer: Dispatcher = .current, name: String, qos: QualityOfService = .default, maxConcurrentOperations: Int = .default)
```
##### Shortcuts:
```swift
Kommander.main
Kommander.current
Kommander.default
Kommander.userInteractive
Kommander.userInitiated
Kommander.utility
Kommander.background
```
#### Creating Dispatchers:
```swift
CurrentDispatcher()
MainDispatcher()
Dispatcher(name: String, qos: QualityOfService = .default, maxConcurrentOperations: Int = .default)
```
##### Shortcuts:
```swift
Dispatcher.main
Dispatcher.current
Dispatcher.default
Dispatcher.userInteractive
Dispatcher.userInitiated
Dispatcher.utility
Dispatcher.background
```
## ❤️ Etc.
* Contributions are very welcome.
* Attribution is appreciated (let's spread the word!), but not mandatory.
## 👨💻 Authors
[alexruperez](https://github.com/alexruperez), [email protected]
[juantrias](https://github.com/juantrias), [email protected]
[RobertoEstrada](https://github.com/RobertoEstrada), [email protected]
## 👮♂️ License
Kommander is available under the MIT license. See the LICENSE file for more info.