RWPromiseKit
Desiciption
A light-weighted Promise library for Objective-C
About Promise
The Promise object is used for deferred and asynchronous computations. A Promise represents an operation that hasn't completed yet, but is expected in the future. Ref
In JavaScript, Promise handles asynchronising call beatifully:
getJSON("/posts.json").then(function(posts) {
// ...
consume(posts);
}).catch(function(error) {
console.log('something wrong！', error);
});
Usage of RWPromiseKit
Here is a basic example:
RWPromise* p1 = [RWPromise promise:^(ResolveHandler resolve, RejectHandler reject) {
resolve(@"result");
}];
p1.then(^id(NSString* value){
NSLog(@"%@",value); //result
return @"resultOfThen";
}).then(^id(NSString* value){
NSLog(@"%@",value); //resultOfThen
NSException *e = [NSException exceptionWithName:@"name"
reason:@"reason"
userInfo:@{}];
@throw e;
return nil;
}).catch(^(NSError* error){
NSLog(@"%@",[error description]); //error contains exception
});
Using RWPromise is exactly same as using promise in js. resolve and reject are provided in initial block as input parameters, these two methods are used to change the state of a promise. Block passed in then will be invoked when a promise is set to resolved while one in catch will be invoked when rejected.
For more infomation about the API of promise in js, please reference here
Suppoted API
0.1.0
thencatchfinallyafterretrytimeoutmapfilterreduceraceallresolvereject
0.2.0
progress
Installation
- Cocoapods
pod 'RWPromiseKit', '0.2.0'
- Source code
Copy all source files from directory Class to your project
Issues and Todo list
-
I simplify the usage of
thencompared with js. Just pass only one handler block to handle when last promise is resolved. To reject, you can raise an expection or return a new promise. -
some other API:map,filter,reduce -
Integrate with 3rd party lib
-
Unit test are not finished -
Complicated test cases.
-
Doc with more detail
License
Licensed under MIT. Full license here »
336 Nov 26, 2022
1.9k Dec 27, 2022
41 Jul 11, 2022
3.8k Jan 4, 2023
11.4k Jan 1, 2023
139 Dec 19, 2022
2.3k Dec 20, 2022
327 Nov 8, 2022
10 Nov 19, 2022
246 Jan 4, 2023
2 Jul 3, 2022
1.5k Dec 28, 2022
454 Sep 14, 2022
29 Aug 6, 2022
10 Nov 23, 2022
184 Dec 27, 2022
982 Nov 16, 2022
45 Oct 27, 2022
1.9k Dec 27, 2022
41 Jul 11, 2022
3.7k Dec 24, 2022
39 Jun 3, 2021
759 Dec 2, 2022
2k Dec 31, 2022
17 Apr 5, 2019
68 Aug 31, 2022
3 Aug 27, 2022
622 Nov 23, 2022