quanvo87/GroupWork

GroupWork is an easy to use Swift framework that helps you orchestrate your concurrent, asynchronous functions in a clean and organized way. This helps make large functions with multiple asynchronous tasks more clear and easy to follow.

1. Requirements
2. Installation
   • CocoaPods
   • Carthage
   • Swift Package Manager
   • Manually
3. Documentation
4. Example Usage
5. Working Example
6. License
7. Authors

Swift 4

For CocoaPods, add to Podfile:

pod 'GroupWork', '~> 0.0'

For Carthage, add to Cartfile:

github "quanvo87/GroupWork"

For SPM, add to your package dependencies:

.package(url: "https://github.com/quanvo87/GroupWork.git", .upToNextMinor(from: "0.0.0"))

• for projects, drag GroupWork.swift to the project tree
• for workspaces, include the whole GroupWork.xcodeproj

Here

import GroupWork

...

func complexFunc(completion: @escaping (Bool) -> Void) {
  let work = GroupWork()

  work.asyncFuncA()
  work.asyncFuncB()
  work.asyncFuncC()

  work.allDone() {
    completion(work.result)
  }
}

...

complexFunc is a function that returns the result of three asynchronous functions asyncFuncA(), asyncFuncB(), and asyncFuncC(), running concurrently. The completion handler is called only when all these functions have completed. Usage of this library has enabled the above clean interface. This can be scaled to much higher than three asynchronous functions.

notes:

• the asynchronous functions should be able to run concurrently without affecting each other
• work.result is only a simple Bool
• this is not an answer to callback hell

There is some set up required in order to create complexFunc() from above:

import GroupWork

extension GroupWork {
  func asyncFuncA() {
    start()
    networkCallA() { (result) in
      self.finish(withResult: result)
    }
  }

  func asyncFuncB() {
    start()
    networkCallB() { (result) in
      self.finish(withResult: result)
    }
  }

  func asyncFuncC() {
    start()
    networkCallC() { (result) in
      self.finish(withResult: result)
    }
  }
}

Now you can create a GroupWork, and call work.simpleFuncA() on it like in the example.

notes:

• start() must be called before an asynchronous task
• finish() must be called in the completion handler of an asynchronous task
• start() and finish() calls must be balanced

The tests have a working example.

MIT LICENSE

• Quan Vo
• Wilson Ding
• Banner: Michelle Law

Please provide attribution, it is greatly appreciated.