fstudy817
diff --git a/‎Flickr4Java/BUILDING.md‎
Lines changed: 40 additions & 0 deletions b/‎Flickr4Java/BUILDING.md‎
Lines changed: 40 additions & 0 deletions
diff --git a/‎Flickr4Java/BUILDING.txt‎
Lines changed: 0 additions & 17 deletions b/‎Flickr4Java/BUILDING.txt‎
Lines changed: 0 additions & 17 deletions
diff --git a/‎Flickr4Java/build.gradle‎
Lines changed: 7 additions & 0 deletions b/‎Flickr4Java/build.gradle‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎Flickr4Java/src/test/java/com/flickr4java/flickr/test/Setup.java‎
Lines changed: 68 additions & 0 deletions b/‎Flickr4Java/src/test/java/com/flickr4java/flickr/test/Setup.java‎
Lines changed: 68 additions & 0 deletions
@@ -0,0 +1,40 @@
+# Building and Testing Flickr4Java
+
+## Building
+
+Flickr4Java uses [Gradle](http://www.gradle.org).
+Run gradle tasks from the directory that contains the `build.gradle` file.
+
+The following tasks are available:
+
+* Clean up:                        `gradle clean`
+* Compile (inc examples):          `gradle compileJava`
+* Compile & test:                  `gradle build`
+* Create docs:                     `gradle javadoc`
+* Create docs jar:                 `gradle javadocJar`
+* Create src jar:                  `gradle sourcesJar`
+* Generate Eclipse project files:  `gradle cleanEclipse eclipse`
+* Generate Idea project files:     `gradle cleanIdea idea`
+* Show dependencies (libs etc):    `gradle dependencies`
+
+## Testing
+
+Most of the tests are integration tests, and require hitting the actual Flickr
+API service with DELETE permissions. The safest and easiest way to do this is to
+set up a test user account, the following photos etc.:
+
+1. At least one photo in one album
+2. At least one collection with title and description, containing at least one album
+   (the ID of the collection can be retrieved manually via the
+   [API explorer](https://www.flickr.com/services/api/explore/flickr.collections.getTree)
+   and be added as `collectionid` in `src/test/resources/setup.properties`)
+3. *[List is incomplete]*
+
+To test:
+
+1. Copy `src/test/resources/setup.properties.example` to `src/test/resources/setup.properties`
+2. Run `gradle compiletestjava -q` — compile all sources
+3. Run `gradle setuptests -q` — this will prompt for authorisation and update the above `setup.properties` file
+4. Run `gradle test`
+
+(The `-q` above just hides some of the more verbose output; it can be left out.)
@@ -2,6 +2,7 @@ apply plugin: 'java'
 apply plugin: 'eclipse'
 apply plugin: 'idea'
 apply plugin: 'maven'
+apply plugin: 'application'
 
 version = '2.6'
 group = 'com.flickr4java.flickr'
@@ -32,6 +33,12 @@ dependencies {
     testCompile group: 'junit', name: 'junit', version: '4.11'
 }
 
+task setupTests(type:JavaExec, dependsOn:classes) {
+    standardInput = System.in
+    main = 'com.flickr4java.flickr.test.Setup'
+    classpath = sourceSets.test.runtimeClasspath
+}
+
 //create a javadoc jar for maven repo
 task javadocJar(type: Jar, dependsOn: javadoc) {
     classifier = 'javadoc'
 
@@ -0,0 +1,68 @@
+package com.flickr4java.flickr.test;
+
+import com.flickr4java.flickr.Flickr;
+import com.flickr4java.flickr.FlickrException;
+import com.flickr4java.flickr.REST;
+import com.flickr4java.flickr.auth.Auth;
+import com.flickr4java.flickr.auth.AuthInterface;
+import com.flickr4java.flickr.auth.Permission;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.util.Properties;
+import java.util.Scanner;
+import org.scribe.model.Token;
+import org.scribe.model.Verifier;
+
+public class Setup {
+
+    public static void main(String[] args) {
+        System.out.println("Flickr4Java: Set up integration test environment");
+        try {
+            new Setup();
+        } catch (IOException e) {
+            e.printStackTrace();
+        } catch (FlickrException e) {
+            e.printStackTrace();
+        }
+    }
+
+    public Setup() throws IOException, FlickrException {
+        String propertiesFile = "src/test/resources/setup.properties";
+        Properties properties = new Properties();
+        properties.load(new FileInputStream(propertiesFile));
+
+        Flickr flickr = new Flickr(properties.getProperty("apiKey"), properties.getProperty("secret"), new REST());
+        Flickr.debugStream = false;
+        AuthInterface authInterface = flickr.getAuthInterface();
+
+        Scanner scanner = new Scanner(System.in);
+
+        Token requestToken = authInterface.getRequestToken();
+
+        String url = authInterface.getAuthorizationUrl(requestToken, Permission.DELETE);
+        System.out.println("Follow this URL to authorise yourself on Flickr");
+        System.out.println(url);
+        System.out.println("Paste in the token it gives you:");
+        System.out.print(">> ");
+
+        String tokenKey = scanner.nextLine().trim();
+
+        Token accessToken = authInterface.getAccessToken(requestToken, new Verifier(tokenKey));
+        System.out.println("Authentication success");
+
+        Auth auth = authInterface.checkToken(accessToken);
+
+        properties.setProperty("token", accessToken.getToken());
+        properties.setProperty("tokensecret", accessToken.getSecret());
+        properties.store(new FileOutputStream(propertiesFile), "");
+
+        // This token can be used until the user revokes it.
+        System.out.println("Access token - token  = " + accessToken.getToken());
+        System.out.println("             - secret = " + accessToken.getSecret());
+        System.out.println("(These have been saved to the properties file.)");
+        System.out.println("Realname: " + auth.getUser().getRealName());
+        System.out.println("Username: " + auth.getUser().getUsername());
+        System.out.println("Permission: " + auth.getPermission().getType());
+    }
+}