Forge

Simple Task handler for iOS

• Features
• Requirements
• Installation
• Example
• Architecture
• Credits
• License

Features

• Task persistence across app restarts
• Start tasks with delay (simulating undo)
• Have tasks retriable
• Task viewer for debugging
• extensive logging support

Requirements

• Swift 4.2+
• iOS 11+

Installation

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate Forge into your Xcode project using CocoaPods, specify it in your Podfile:

pod'FlockForge',

Example

1. Create Forge and optionally listen to changes

letforge=Forge(with:"test")letchangeManager=TestChangeManager() // An object following `ChangeManager` protocol.
forge.changeManager = changeManager

2. Add an executor to handle tasks for a particular type

letexecutor=TestExecutor() // An object following `Executor` protocol.
try! forge.register(executor: executor, for:"t") // Register executor for tasks with type "t"

3. Create a task and submit to forge

letparams=["params":"params"]lettask=try!Task(id:"id", type:"t", params: params) // Create task
forge.submit(task: task)

4. [Optional] Presenting the Forge Tasks View Controller

   1. Create the View controller

   letstoryBoard=UIStoryboard(name:"ForgeTask", bundle:Bundle(for:Forge.self))guardlet forgeTasksVC = storyBoard.instantiateViewController(withIdentifier:"ForgeTasksViewController")as?ForgeTasksViewControllerelse{fatalError("Could not instantiate TroubleshootController")}

   2. Present the created ViewController in your view heirarchy.

Note: To give it a spin, you can use the Tests project in Tests folder. Run pod install before opening the workspace.

Architecture

Please read architecture doc for more details.

Credits

• Ayush Goel
• Aditya Ghosh
• Dinesh Kumar

License

Forge is available under the BSD 3-Clause license. See the LICENSE file for more info.