Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Groovy API for Remember The Milk (DEPRECATED)

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 config
Octocat-spinner-32 gradle
Octocat-spinner-32 src
Octocat-spinner-32 .gitignore
Octocat-spinner-32 DEPRECATED.md
Octocat-spinner-32 LICENSE.txt
Octocat-spinner-32 README.md
Octocat-spinner-32 build.gradle
Octocat-spinner-32 clover.gradle
Octocat-spinner-32 gradlew
Octocat-spinner-32 gradlew.bat
README.md

Groovy Remember The Milk! Build Status

GroovyRTM allows you to easily take advantage of the Remember The Milk REST API using any language on the JVM. In short, you can now write apps for Remember The Milk without having to worry about all the HTTP transaction stuff, error handling, etc. As its name implies, it's written in Groovy, which made it much easier to write and test.

Getting Started:

You need 2 things to create a app using GroovyRTM:

Gradle/Grails build config

compile 'com.eriwen:groovyrtm:2.1.2'

Maven config

<dependency>
    <groupId>com.eriwen</groupId>
    <artifactId>groovyrtm</artifactId>
    <version>2.1.2</version>
</dependency>

Simple Example Java Application:

import org.eriwen.rtm.*;
class MyGroovyRtmTest {
    public static void main(String[] args) {
        GroovyRtm groovyrtm = new GroovyRtm("<api key>","<shared secret>");
        groovyrtm.testEcho();
    }
}

Authentication Example:

package groovyrtmauth;
import java.awt.Desktop;
import java.io.IOException;
import java.net.*;
import org.eriwen.rtm.*;
public class MyGroovyRtmTest {
   public static void main(String[] args) {
       GroovyRtm rtm = new GroovyRtm("myapikey", "mysharedsecret");
       try {
           if (!rtm.isAuthenticated()) {
               // Start login process by getting the authorization URL
               try {
                   String authUrl = rtm.getAuthUrl();
                   if (Desktop.isDesktopSupported()) {
                       // Open the auth web page
                       Desktop desktop = Desktop.getDesktop();
                       desktop.browse(new URI(authUrl));
                       System.out.println("I've just opened a web page so you can authorize Groovy RTM");
                   } else {
                       System.out.println("Please open " + authUrl + " in a web browser to authorize Groovy RTM");
                   }
                   System.out.println("Press any key when done...");
                   //TODO: Put your application logic or button here so users can click a button when done
                   System.in.read();
                   // GroovyRTM automatically stores the auth token
                   String authToken = rtm.authGetToken();
                   if (authToken != null) {
                       // We're golden!
                       System.out.println("Groovy RTM successfully authorized!!");
                   }
               } catch (URISyntaxException ue) {
                   ue.printStackTrace();
               } catch (IOException ioe) {
                   ioe.printStackTrace();
               }
           } else {
               System.out.println("Groovy RTM already authorized!");
           }
       } catch (GroovyRtmException rse) {
           rse.printStackTrace();
       }
   }
}

Quick-start Project:

Download a NetBeans project setup with the latest GroovyRTM JAR and optimal project structure here. Project also includes RTM authorization code to help you start even faster!

Contributing

When submitting patches, please include comments when code is not obvious and include thorough tests.

Statistics, note the avg. complexity: [[http://static.eriwen.com/images/groovyrtm_stats.png]]

Clover code coverage: [[http://static.eriwen.com/images/groovyrtm_coverage.png]]

Something went wrong with that request. Please try again.