SweetREST 1.0.0

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

target 'MyApp' do
  pod 'SweetREST', '~> 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 SweetREST

SweetREST 1.0.0

By
Sergey Popov

SweetREST is a tiny lib for creating http request service of cocoa applications. The lib allows to send common http requests such as GET, POST, PUT, PATCH, HEAD and DELETE. Is a lightweight version of amazing AFNetworking, with a couple of additional features like nice error handling.

Example

To start sending requests you just need to init sweetRest with NSURLSession and baseURL of your backend.

NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];
self.sweetRest = [[SPSweetRest alloc] initWithSession:session baseURL:[NSURL URLWithString:@"http://example.com/json/api/"]];

Sending a simple GET request.

NSDictionary *params = @{@"name" : @"serj"};

[self.sweetRest GET:@"person" params:params completion:^(id responseObject, NSError *error) {

    if(! error) {
        //Success
    }
    else {
        //Failure
    }

}];

Error handling

Error handling is a main feature of the lib. Unlike AFNetworking SweetREST is creating NSError's where codes coresponds http status codes. For example your backend is responsing 401 Unauthorized, you may handle it and expire auth token:

...

if (error.code == 401) {
    [self.sweetRest removeValueForHTTPHeaderField:@"XX-MY-SWEET-AUTH-TOKEN"];
}

One of the features is SPSeweetRestDelegate protocol. The protocol allows listen every valid (with status code 2xx and JSON content type) response form the server:

- (void)sweetRest:(SPSweetRest *)sweetRest didReceiveResponse:(NSHTTPURLResponse *)response
{
    // Ckeck for token
    NSString *token = response.allHeaderFields[@"AUTH-TOKEN"];

    //Status code
    NSInteger code = response.statusCode;

    // Do somthing here..
}

Or every failure response:

- (void)sweetRest:(SPSweetRest *)sweetRest didFailResponse:(NSHTTPURLResponse *)response error:(NSError *)error
{
    // Do somthing here
}

Moreover you may provide some custom error and accept every response:

- (BOOL)sweetRest:(SPSweetRest *)sweetRest shouldAcceptResponse:(NSHTTPURLResponse *)response forObject:(id)responseObject provideError:(NSError **)error
{
    NSInteger code = response.statusCode;   
    if (code == 201) {
        // Provide some custom error
        NSDictionary *userInfo = @{NSLocalizedDescriptionKey : @"I do not like 201 status code!"};
        *error = [NSError errorWithDomain:SPSeweetRestErrorDomain code:777 userInfo:userInfo];
        return NO;
    }
    return YES;
}

License

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