Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mitchtreece/Threader
Pretty GCD calls and easier code execution.
https://github.com/mitchtreece/Threader
Last synced: about 1 month ago
JSON representation
Pretty GCD calls and easier code execution.
- Host: GitHub
- URL: https://github.com/mitchtreece/Threader
- Owner: mitchtreece
- License: mit
- Created: 2016-04-27T16:39:16.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-10-11T17:48:12.000Z (almost 8 years ago)
- Last Synced: 2024-08-02T13:48:40.333Z (about 2 months ago)
- Language: Swift
- Size: 65.4 KB
- Stars: 35
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Threader - Pretty GCD calls and easier code execution. (GCD / Getting Started)
- awesome-ios-star - Threader - Pretty GCD calls and easier code execution. (GCD / Getting Started)
README
# Threader
Pretty GCD calls and easier code execution.
[](http://cocoapods.org/pods/Threader)
[](http://cocoapods.org/pods/Threader)
[](http://cocoapods.org/pods/Threader)
## Overview
Threader makes GCD calls easy to read & write. It also provides a simple way to execute code where and when you want.
## Installation
### CocoaPods
Threader is integrated with CocoaPods!
1. Add the following to your `Podfile`:
```
use_frameworks!
pod 'Threader'
```
2. In your project directory, run `pod install`
3. Import the `Threader` module wherever you need it
4. Profit
### Manually
You can also manually add the source files to your project.
1. Clone this git repo
2. Add all the Swift files in the `Threader/` subdirectory to your project
3. Profit
## Threader
Using `Threader` you can fine-tune where and how code get executed.
```swift
Threader.DispatchAsyncMain.execute {
/* Important main-thread code */
}
```
The above simply executes the code within the block on the main-thread. Naturally, `Threader` also provides other execution options:
- **Immediate** - executes the code block immediately on the current thread.
- **DispatchAsync** - executes the code block asynchronously on a given `DispatchQueue`.
- **DispatchAsyncMain** - executes code block asynchronously on the main thread.
- **DispatchAsyncGlobal** - executes the code block asynchronously on the global-queue.
- **DispatchAsyncAfter** - executes the code block asynchronously at a specified `DispatchTime`, on a `DispatchQueue`.
- **DispatchAsyncBarrier** - executes the code block asynchronously blocking on a given `DispatchQueue`.
- **DispatchSync** - executes the code block synchronously on a given `DispatchQueue`.
- **DispatchSyncBarrier** - executes the code block synchronously blocking on a given `DispatchQueue`.
- **Operation** - executes the code block on a given `OperationQueue`.
- **Block** - executes code from a closure.
- **Default** - executes code on the current thread, _or_ on a global `DispatchQueue` depending on the block of code's current position in the thread.
Dispatching code to a given queue is as easy as:
```swift
let queue = DispatchQueue.global()
Threader.DispatchAsync(queue).execute {
/* Important background-thread code */
}
```
It can even be simplified further:
```swift
Threader.DispatchAsync(.global()).execute {
/* Important background-thread code */
}
```
## DispatchQueue
In previous versions of Threader, `DispatchQueue` was a small wrapper around C-based GCD calls. However, as of __Swift 3__,
Apple decided to provide their own solution. Not surprisingly, the also named their wrapper `DispatchQueue`.
Moving forward, Threader will use Apple's native implementation of `DispatchQueue` for all GCD related calls.