ARCHIVED PROJECT

An iOS (Objective-C) API Wrapper for Trello

Trello is a free, collaborative task management web tool that can be used for anything. Really! Check it out here. This project contains sources to enable you to build Trello into your native iOS projects. It is basically an API wrapper that makes it easy for your app to login and send GET, PUT, POST and DELETE HTTP signals to your available and authorized Trello boards.

Load up the included iPad demo/test project in your simulator, and take ios4trello for a spin. (See Client Source Configuration below to obtain keys!).

The Trello API Reference is here.

The demo is based on the Trello API, AFNetworking (for transport) and ytoolkit/NSMutableURLRequest (for basic OAuth). You can use any OAuth library you want, but ios-trello is closely tied to AFNetworking through a few Macros.

Here is the pattern to get a list of boards (with a name that starts with a variant of "MyProject") from Trello. It is up to you how you parse, handle and display the JSON that is returned. This examples stores the names into an NSArray model called boardList, and the ids into an NSArray called boardIDs.

- (void)loadFeedStream {
    if (self.accesstoken && self.tokensecret) {
    
        [[VMTrelloApiClient sharedSession] getMemberMyBoardsWithSuccess:^(id JSON) {
             [self parseJSONforMyProjectBoards:JSON];
             [self.tableView reloadSections:[NSIndexSet indexSetWithIndex:0] withRowAnimation:UITableViewRowAnimationAutomatic];
         }
         failure:^(NSError *error) {
             [VMTrelloApiClient operationDidFailWithError:error title:@"Trello" message:Network_Authorization_Error_Please_login]; 
             NSLog(@"Authorization Error: %@", error.description);
         }];
    }
}

- (void)parseJSONforMyProjectBoards:(id)JSON
{
    NSLog(@"Name: %@ %@", [JSON valueForKeyPath:@"name"], [JSON valueForKeyPath:@"memberships"]);
    NSLog(@"JSON: %@", JSON);
     
    if (YIS_INSTANCE_OF(JSON, NSArray)) {
        [self.boardList removeAllObjects];
        for (id item in JSON) {
            if (YIS_INSTANCE_OF(item, NSDictionary)) {
                NSString * boardName = [item objectForKey:@"name"];
                if (YIS_INSTANCE_OF(boardName, NSString)) {
                    if (   [boardName rangeOfString:@"[MyProject]"].location == 0
                        || [boardName rangeOfString:@"MyProject:"].location  == 0) {
                        [self.boardList addObject:boardName];
                        [self.boardIDs addObject:[item objectForKey:@"id"]];
                        NSLog(@"boardName: %@, id = %@", boardName, [self.boardIDs lastObject]);
                    }
                }
            }
        }
    }
}

Assuming you have those listed in a tableView, here is how to access one board and list the cards on that board.

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    NSLog(@"Board = %@", [self.boardList objectAtIndex:indexPath.row]);
    
    [[VMTrelloApiClient sharedSession] 
     get1Boards:[self.boardIDs objectAtIndex:indexPath.row]
     success:^(id JSON) {
         NSLog(@"Board:JSON = %@", JSON);
     } failure:^(NSError *error) {
         NSLog(@"Board JSON Error: %@", error.description);
     }];
    
    [[VMTrelloApiClient sharedSession] 
     get1BoardsCards:[self.boardIDs objectAtIndex:indexPath.row]
     success:^(id JSON) {
         NSLog(@"BoardCards:JSON = %@", JSON);
     } failure:^(NSError *error) {
         NSLog(@"BoardCards JSON Error: %@", error.description);
     }];
}

• Reachability (Apple)
• AFNetworking (http://github.com/AFNetworking/AFNetworking)

• ytoolkit (OAuthv1) (http://github.com/sprhawk/ytoolkit)
• (Note: for expendiency, delete all test directories, SenTesting Framework and ASIHTTPRequest files from ytoolkit)
• (If you are not linking against the static library, you may also need to fix some fix some imports: i.e. change <ytoolkit/ydefines.h> to "ydefines.h" ... etc. Let the compiler be your guide ;)

The included Xcode Project is an iPad app that exercises the Trello API.

1. Under Project > ios-trello > Linking > Other Linker Flags, Double-Click then click + to set flags

-ObjC
-all_load

2. Under Targets > ios4trello > Build Phases > Target Dependencies, Click + and Choose items to add:

• (ytoolkit > ytoolkit)

3. Under Targets > ios4trello > Build Settings > Search Paths > Header Search Paths, enter:

{BUILT_PRODUCTS_DIR}/usr/local/include

4. Under Targets > ios4trello > Build Phases > Compile Sources, Double-click the following source files, and add the flag:

-fno-objc-arc

• All AFNetworking .m Sources (10 files)
• All ytoolkit .m library Sources (11 files)
• Reachability.m

Under Targets > ios-trello > Build Phases > Link Binary with Libraries:

• IOS 5.1
• SystemConfiguration
• Security

0. If you haven't already, create a Trello account.

1. Go to Trello Docs and generate an Application Key

2. Edit/Create the file TrelloClientCredentials.m and substitute your keys.

3. (See Demo): In TrelloLoginViewController.m, globally substitute Your_App_Name for ios4Trello. (This will let your users know that your app is seeking authorization to access thier Trello account.)

Here's our Trello Board which tracks development and features of ios-trello.

This library is not complete (see status below), so if you do find anything missing or not functioning as you would expect, please let us know.

And by all means, pitch in. What would you like to add to the project? Feature requests, pull-requests, tests, docs, examples are all welcome.

Peace!

The Trello API (Beta) is functional with on-going development and is fairly complete (as far as I know). This is the map/status for ios-trello.

• 0.1 - Basic read-only API, create board, edit board description, create list, create card
• 0.2 - support additional read-only methods (i.e. all GET methods)
• 0.3 - support additional, create, update and delete

ios-trello and ios4trello were developed by Vince Mansel (http://github.com/vincemansel)

Additional sources are attributed to the following projects.

• AFNetworking
• ytoolkit
• Roadmap Table Layout (thanks trello4j)

Thanks, Vince