LupinusHTTP 1.0.1

Maintained by azu, akuraru.

You want to add pod 'LupinusHTTP', '~> 1.0' similar to the following to your Podfile:

target 'MyApp' do
  pod 'LupinusHTTP', '~> 1.0'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try LupinusHTTP

LupinusHTTP 1.0.1

By
azu
azu_re

LupinusHTTP is an HTTP networking library, wrapping NSURLSession.

Feature

Small, Simple
Block-based response methods.

Installation

Usage

LupinusHTTP has very simple step to request.

Create LupinusHTTPRequest through LupinusHTTP's method.
- HTTP Method and URL and Parameters and (post body).
Receive response using responseJSON or responseString methods.

GET Request

Example: Get Request to http://httpbin.org/get?key=value

LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/get" query:@{
    @"key" : @"value"
}];
[httpRequest responseJSON:^(NSURLRequest *request, NSURLResponse *response, id JSON, NSError *error) {
    NSLog(@"JSON = %@", JSON);
}];

Get response as JSON

Always response* complete method involked in matin thread.

LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/get"];
[httpRequest responseJSON:^(NSURLRequest *request, NSURLResponse *response, id JSON, NSError *error) {
    NSLog(@"JSON = %@", JSON);// => JSON Object(NSDictionary or NSArray)
}];

Get response as String

LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/get"];
[httpRequest responseString:^(NSURLRequest *request, NSURLResponse *response, NSString *string, NSError *error) {
    NSLog(@"string = %@", string);// => NSString
}];

Get response as RawData

LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/get"];
[httpRequest responseRawData:^(NSURLRequest *request, NSURLResponse *response, NSData *data, NSError *error) {
    // data
}];

POST Request

Post Request with body

e.g) http://httpbin.org/post?key=value

body
    [1,2,3]

[LupinusHTTP request:LupinusMethodPOST URL:@"http://httpbin.org/post" query:@{
    @"key" : @"value"
} body:@[@1, @2, @3]];
[httpRequest responseJSON:^(NSURLRequest *request, NSURLResponse *response, id JSON, NSError *error) {
    NSLog(@"JSON = %@", JSON);// => JSON Object(NSDictionary or NSArray)
}];

Common behavior - response.statusCode >= 400

When response.statusCode >= 400, recognize request as failed and error is filled by status code of.

LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/status/403"];
// response status code is 403
[httpRequest responseJSON:^(NSURLRequest *request, NSURLResponse *response, id JSON, NSError *error) {
    // error is not nil
    if(error){
        NSLog(@"%@", error);
    }
}];

Use Custom NSURLSession

You can create a new session with a modified session configuration.

// default : [NSURLSessionConfiguration defaultSessionConfiguration]
+ (instancetype)httpWithSessionConfiguration:(NSURLSessionConfiguration *) sessionConfiguration;

Cancel Request

You can cancel the request by LupinusHTTPRequest#cancel.

LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/get"];
[httpRequest responseJSON:^(NSURLRequest *request, NSURLResponse *response, id JSON, NSError *error) {
  // this callback doens't call!
}];
// cancel request
[httpRequest cancel];

LupinusHTTP Request Flow

Request flow design of LupinusHTTP.

// Create NSURLSession and NSURLRequest.
LupinusHTTPRequest *httpRequest = [LupinusHTTP request:LupinusMethodGET URL:@"http://httpbin.org/get"];
// already started HTTP request
// ...
// you can register complete handler
// Lupinus add this handler to `queue`
[httpRequest responseJSON:^(NSURLRequest *request, NSURLResponse *response, id JSON, NSError *error) {
    NSLog(@"JSON = %@", JSON);// => JSON Object(NSDictionary or NSArray)
}];

// ....
// Get HTTP response.
// Lupinus dispatch_resume(self.queue); => callback the complete handlers.

FAQ

Does LupinusHTTP work with Background Fetch?

No.

LupinusHTTP doens't work with Background Fetch.

Multitasking in iOS 7 - iOS 7 - objc.io issue #5
Background Fetch require using NSURLSessionDownloadTask.

But, welcome to your pull request!

Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D

License

LupinusHTTP is available under the MIT license. See the LICENSE file for more info.

Acknowledgment

LupinusHTTP inspired by Alamofire, AFNetworking and TacoShell.

Credit

Photo by Tatu Väyrynen