The Remember the Milk (RTM) API provide a simple protocol for access user information form the Remember the Milk web application. This framework is an implementation of the Remember the Milk (RTM) API in Objective-C for Mac OS X.

The framework is compatible with MacOS 10.5 and Up

The framework implements the authentication system and all the API methods, the guide for the usage of the framework can be find in the documentation.

The project also include a Test Application that show the main functionality of the framework.

To get started with this framework you need an RTM api key. You can ask on at this link: http://www.rememberthemilk.com/services/api/keys.rtm.

Credits

This program uses the Excelsior! class library created by Jim Rankin. For more information about Excelsior, email: jimbokun@mac.com. You can find more info on this framework on the developer page: http://homepage.mac.com/jimbokun/Excelsior.html

At the moment English is the only language supported. I'm working on the internationalization, if some can provide some support will be very appreciated.

User Authentication

The User authentication is a process that you need to make at most once. The user have to grant access to your application. The RTM2Cocoa Framework implements a simple process for this protocol. You can follow a little tutorial on the Authentication System here. At last a token is stored in the User preferences of your application an the framework automatically will retrieve it. The framework come also with a method that verify if the actual authentication is still valid.

Error Management

RTM Error Delegation (RTMDelegationProtocol)

The RTM2Cocoa framework implements a delegate protocol for exportins some functionality.

-(void)manageRTMError:(NSRTMError )error;

With this method you can manage the error return from the RTM2Cococa Framework

You can find an example project that show the framework features at this link.

To-DO

Authentication delegation (RTMAuthProtocol) Unit Test Integration of Period and Criteria System Internationalization

LICENSE

The project is released under the GPL2 Licence (a copy of the license is included in the project or you can find all the disclaimer at this link: http://www.gnu.org/licenses/gpl-2.0.html).

A copy of this license is also included in the Documentation folder of this project, in the file license.txt.

In summary, this license stipulates that anyone who distributes this work or a derivative of this work must credit the original author (kkillian), in a reasonable fashion. One way to satisfy this requirement would be to include the following in a text or HTML file distributed with the derivative work.

REQUIREMENTS

This project was developed and tested on a Intel MacBook Unibody with 2000MB RAM running Mac OS X version 10.6. I would like to hear about issues with other hardware/software combinations.