Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fmo91/fotask
Object oriented Swift tasks microframework with concurrency and composition 🎉
https://github.com/fmo91/fotask
concurrency object-oriented swift tasks
Last synced: about 2 months ago
JSON representation
Object oriented Swift tasks microframework with concurrency and composition 🎉
- Host: GitHub
- URL: https://github.com/fmo91/fotask
- Owner: fmo91
- License: mit
- Created: 2017-02-08T03:09:40.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-02-24T15:08:40.000Z (almost 8 years ago)
- Last Synced: 2024-10-11T21:45:15.384Z (2 months ago)
- Topics: concurrency, object-oriented, swift, tasks
- Language: Swift
- Size: 32.2 KB
- Stars: 5
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FOTask
[](https://travis-ci.org/fmo91/FOTask)
[](http://cocoapods.org/pods/FOTask)
[](http://cocoapods.org/pods/FOTask)
[](http://cocoapods.org/pods/FOTask)
## Introduction
FOTask is a microframework (less than 100 LOCs), with a single objective in mind: **separation of concerns**.
Every subclass of `Task` executes an action.
`Task`s can be composed in more complex `Task`s, or parallelized without effort.
## Example usage
**Suclassing Task:**
```swift
final class GetUserTask: Task {
override func perform(_ input: Int, onSuccess: @escaping (User) -> Void, onError: @escaping (Error) -> Void) {
ApiClient("https://somecoolapi.com/users/\(input)", .get,
onSuccess: { (json: Any) in
onSuccess(User(json: json))
},
onError: { (error: Error) in
onError(error)
}
)
}
}
```
**Using Task:**
```swift
let getUserTask = GetUserTask()
getUserTask.perform(3,
onSuccess: { (user: User) in
print(user.name)
},
onError: { (error: Error) in
print("An error ocurred.")
}
)
```
**Composing Tasks:**
```swift
let getUserWithIDTask = GetUserTask()
let getPostsFromUserTask = GetPostsFromUserTask()
let getPostsFromUserID = getUserWithIDTask => getPostsFromUserTask
getPostsFromUserID.perform(3,
onSuccess: { (posts: [Post]) in
print(posts.count)
},
onError: { (error: Error) in
print("An error ocurred.")
}
)
```
**Parallelize Tasks**
```swift
let getALotOfUserNames = Task.parallel(
[
GetUserName(),
GetUserName(),
GetUserName(),
GetUserName(),
GetUserName(),
GetUserName(),
GetUserName(),
GetUserName(),
GetUserName()
],
reduce: { (userNames: [String]) -> [String] in
return userNames
}
)
getALotOfUserNames.perform(Void(),
onSuccess: { userNames in
print(userNames)
},
onError: { error in
print("An Error!")
}
)
```
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
* iOS 8.0 or above.
* Swift 3.0 or above.
## Installation
FOTask is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "FOTask"
```
## Coming soon
* An explanatory Medium post
* More documentation
* More examples
* More functional features?
## Author
fmo91, [email protected]
## License
FOTask is available under the MIT license. See the LICENSE file for more info.