bryant1410 / jltmdbclient

JLTMDbClient is an iOS wrapper on top of AFNetworking to interact with www.themoviedb.org API.

JLTMDbClient

• JLTMDbClient is an iOS wrapper on top of AFNetworking to interact with themoviedb.org API.

Installation:

• The best way to get JLTMDbClient is by using CocoaPods.
• How to install CocoaPods

Demo App:

1. Clone the repository:

$ git clone [email protected]:JaviLorbada/JLTMDbClient.git

2. Open the .xcworkspace file to see the example:

$ open JLTMDbClient.xcworkspace

3. Run JLTMDbClient target to see a simple visual example.
4. Run JLTMDbClientTests target to see different cases on how to use the API.

Usage:

1. Get your API KEY from themoviedb.org

"A TMDb user account is required to request an API key. Commercial users are approved on a per application basis. As always, you must attribute TMDb as the source of your data. Please be sure to read the API FAQ"

2. Add JLTMDbClient to your application, and set up your API KEY.

#import <JLTMDbClient.h>

[[JLTMDbClient sharedAPIInstance] setAPIKey:@"API_KEY"];

3. Call a service to get the response from the server *, i.e:

[[JLTMDbClient sharedAPIInstance] GET:kJLTMDbMoviePopular withParameters:nil andResponseBlock:^(id response, NSError *error) {
    if(!error){
        fetchedData = response;
        NSLog(@"Popular Movies: %@",fetchedData);
    }
}];

• Table of contents

Unit Tests:

• JLTMDbClient includes unit tests. In order to run the unit tests, you need to add your API_KEY. Then you can execute the tests using JLTMDbClientTests scheme within Xcode.

Using xctool

• Tests can also be run from the command line or within a continuous integration environment with xctool, which can be installed with Homebrew:

$ brew update
$ brew install xctool --HEAD

"JLTMDBClientTests requires xctool 0.1.14 or above"

• Once xctool is installed, you can execute the tests via rake test.

Using XCPretty

• Tests can also be run from the command line or within a continuous integration environment with XCPretty, which can be installed:

$ gem install xcpretty

"XCPretty requires Ruby 1.8.7 or above."

• Once XCPretty is installed, you can execute the tests via make test or make ci.

Compatibility:

• Compatible with iOS 7.0.
• Does require ARC.

Dependencies:

• AFNetworking 3.0.0 or superior.

License:

• JLTMDbClient is released under a MIT-License. See License file for more info.

Contact:

• Javi Lorbada
• Follow @javi_lorbada on twitter
• http://javilorbada.me/