testautoa 0.4.0.pre16

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/helpers/InspectCurrentDialog.java

@@ -0,0 +1,76 @@
+package sh.calaba.instrumentationbackend.actions.helpers;
+
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.FrameLayout;
+import android.widget.LinearLayout;
+import android.widget.RelativeLayout;
+import android.widget.ScrollView;
+import android.widget.Spinner;
+import android.widget.TextView;
+
+import com.jayway.android.robotium.solo.Solo;
+
+/**
+ * Command is inspecting the current dialog and returns a list of details about the current
+ * displayed UI items.
+ * 
+ * @author Dominik Dary
+ * 
+ */
+public class InspectCurrentDialog implements Action {
+
+  @Override
+  public Result execute(String... args) {
+    Solo solo = InstrumentationBackend.solo;
+    StringBuffer viewInfo = new StringBuffer();
+    viewInfo.append("<views activity='" + solo.getCurrentActivity().getComponentName() + "'>");
+    for (View view : solo.getViews()) {
+      if ((view instanceof RelativeLayout) || (view instanceof LinearLayout)
+          || (view instanceof ScrollView) || (view instanceof FrameLayout)) {
+        // for automation are this ui elements normally not so interesting
+        continue;
+      }
+      viewInfo.append("<view>");
+      viewInfo.append("<type>" + view.getClass().getSimpleName() + "</type>");
+
+      try {
+        viewInfo.append("<name>"
+            + InstrumentationBackend.solo.getCurrentActivity().getResources()
+                .getResourceName(view.getId()) + "</name>");
+
+      } catch (Exception e) {
+        // in case the resource name cannot be identified
+        viewInfo.append("<name></name>");
+      }
+
+      if (view instanceof TextView) {
+        viewInfo.append("<textViewText>" + ((TextView) view).getText() + "</textViewText>");
+      } else if (view instanceof Button) {
+        viewInfo.append("<buttonText>" + ((Button) view).getText() + "</buttonText>");
+      } else if (view instanceof Spinner) {
+        viewInfo.append("<spinnerText>" + ((Spinner) view).getSelectedItem() + "</spinnerText>");
+      } else if (view instanceof EditText) {
+        viewInfo.append("<editText>" + ((EditText) view).getText() + "</editText>");
+      }
+
+      viewInfo.append("</view>");
+    }
+
+    viewInfo.append("</views>");
+    Result result = new Result(true);
+    result.addBonusInformation(viewInfo.toString());
+    return result;
+  }
+
+  @Override
+  public String key() {
+    return "inspect_current_dialog";
+  }
+
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/helpers/ListActions.java

@@ -0,0 +1,26 @@
+package sh.calaba.instrumentationbackend.actions.helpers;
+
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+
+
+public class ListActions implements Action {
+
+    @Override
+    public Result execute(String... args) {
+        Result result = new Result(true, "Available actions");
+        for(String key: InstrumentationBackend.actions.getActions().keySet()) {
+            result.addBonusInformation(key);
+        }
+        
+        return result;
+    }
+
+    @Override
+    public String key() {
+        return "list_actions";
+    }
+
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/l10n/L10nHelper.java

@@ -0,0 +1,31 @@
+package sh.calaba.instrumentationbackend.actions.l10n;
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+
+/**
+ * Helper to access Android L10n files.
+ * 
+ * @author Dominik Dary
+ * 
+ */
+public class L10nHelper {
+  /**
+   * get the translated value based on the current active locale.
+   * 
+   * @param l10nKey The l10n key to use
+   * @return The translated value.
+   */
+  public static String getValue(String l10nKey) {
+    int resourceId =
+        InstrumentationBackend.solo
+            .getCurrentActivity()
+            .getResources()
+            .getIdentifier(l10nKey, "string",
+                InstrumentationBackend.solo.getCurrentActivity().getPackageName());
+
+    String localizedString =
+        InstrumentationBackend.solo.getCurrentActivity().getResources().getString(resourceId);
+
+    return localizedString;
+  }
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/l10n/PressElement.java

@@ -0,0 +1,48 @@
+
+package sh.calaba.instrumentationbackend.actions.l10n;
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+
+/**
+ * Action is getting the translated value of the provided #l10nKey and is
+ * searching for the text and then clicking on it.
+ * 
+ * @author Dominik Dary
+ * @see L10nHelper
+ */
+public class PressElement implements Action {
+	public static final String BUTTON = "button";
+	public static final String TOGGLE_BUTTON = "toggle_button";
+	public static final String MENU_ITEM = "menu_item";
+
+	@Override
+	public Result execute(String... args) {
+		String l10nKey = args[0];
+		String elementType = args.length > 1 ? args[1] : null;
+		String myLocalizedString = L10nHelper.getValue(l10nKey);
+		InstrumentationBackend.solo.searchText(myLocalizedString);
+		if (elementType == null) {
+			InstrumentationBackend.solo.clickOnText(myLocalizedString);
+		} else if (BUTTON.equalsIgnoreCase(elementType)) {
+			InstrumentationBackend.solo.clickOnButton(myLocalizedString);
+		} else if (MENU_ITEM.equalsIgnoreCase(elementType)) {
+			InstrumentationBackend.solo.clickOnMenuItem(myLocalizedString);
+		} else if (TOGGLE_BUTTON.equalsIgnoreCase(elementType)) {
+			InstrumentationBackend.solo.clickOnToggleButton(myLocalizedString);
+		} else {
+			return Result.fromThrowable(new Throwable(
+					"specified element type: '" + elementType
+							+ " ' is not supported."));
+		}
+
+		return Result.successResult();
+	}
+
+	@Override
+	public String key() {
+		return "press_l10n_element";
+	}
+
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/l10n/WaitForElement.java

@@ -0,0 +1,47 @@
+/*
+ * Copyright 2012 calabash-driver committers.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package sh.calaba.instrumentationbackend.actions.l10n;
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+
+/**
+ * Action is waiting until the text of the given #l10nKey is displayed.
+ * 
+ * @author Dominik Dary
+ * @see L10nHelper
+ */
+public class WaitForElement implements Action {
+
+	@Override
+	public Result execute(String... args) {
+		String l10nKey = args[0];
+		
+		String myLocalizedString = L10nHelper.getValue(l10nKey);
+		boolean timedOut = !InstrumentationBackend.solo.waitForText(
+				myLocalizedString, 1, 90000);
+		if (timedOut) {
+			return new Result(false, "Time out while waiting for text:"
+					+ args[0]);
+		} else {
+			return Result.successResult();
+		}
+	}
+
+	@Override
+	public String key() {
+		return "wait_for_l10n_element";
+	}
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/list/GetListData.java

@@ -0,0 +1,85 @@
+package sh.calaba.instrumentationbackend.actions.list;
+
+import java.util.ArrayList;
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+import android.widget.ListView;
+
+/**
+ * Provides access to a list through its adapter.
+ * 
+ * args: 
+ * <ul> 
+ *   <li>1-based list index (first list is used if not specified)</li>
+ * </ul>
+ * 
+ * eg: (all items of the 1st list) <code>performAction( 'get_list_data' )</code>
+ * eg: (all items of the 2nd list) <code>performAction( 'get_list_data', 2 )</code>
+ * 
+ * @return <code>bonusInformation</code>: a JSON-formatted Array<String> that is an
+ * Array of objects with a single property "value". The value of this property is generated by calling
+ * <code>list.getAdapter().getItem().toString()</code>, so make sure you implement the toString() method 
+ * on the objects that go to the adapter AND that it returns a value valid for JSON.
+ * 
+ * In ruby we can then parse the response:
+ * <pre>
+ * 		result = performAction('get_list_data')
+ * 		bonusInfo = result['bonusInformation'][0]
+ * 		JSON.parse(bonusInfo).each do |item|
+ * 			puts "#{item["value"]}"
+ * 		end
+ * </pre>
+ * 
+ * @author Juan Delgado (juan@ustwo.co.uk)
+ */
+
+public class GetListData implements Action {
+
+	@Override
+	public Result execute(String... args) {
+		
+		int listIndex;
+
+		if( args.length == 0 ) {
+			listIndex = 0;
+		} else {
+			listIndex = (Integer.parseInt(args[0]) - 1);
+		}
+		
+		ArrayList<ListView> listViews = InstrumentationBackend.solo.getCurrentListViews();
+		
+		if( listViews == null || listViews.size() <= listIndex ) {
+			return new Result(false, "Could not find list #" + (listIndex + 1));
+		}
+		
+		ListView list = listViews.get(listIndex);
+		Result result = new Result(true);
+		
+		StringBuilder json = new StringBuilder("[");
+		
+		int count = list.getAdapter().getCount();
+		for( int i = 0; i < count; i++ ) {
+			json.append("{\"value\": \"");
+			json.append(list.getAdapter().getItem(i).toString());
+			json.append("\"},");
+		}
+		
+		if(count > 0)
+		{
+			json.deleteCharAt( json.length() - 1 ); // remove the last comma
+		}
+		
+		json.append("]");
+		
+		result.addBonusInformation(json.toString());
+		
+		return result;
+	}
+
+	@Override
+	public String key() {
+		return "get_list_data";
+	}
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/list/GetListItemProperties.java

@@ -0,0 +1,194 @@
+package sh.calaba.instrumentationbackend.actions.list;
+
+import java.lang.reflect.Method;
+import java.util.ArrayList;
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+import android.graphics.drawable.ColorDrawable;
+import android.graphics.drawable.Drawable;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ListView;
+import android.widget.TableRow;
+import android.widget.TextView;
+
+/**
+ * args: 
+ * <ul> 
+ *   <li>1-based list index (first list is used if not specified)</li>
+ *   <li>1-based row index (returns all rows if &lt;=0 or not specified)</li>
+ * </ul>
+ * 
+ * eg: (all items of 1st list) <code>performAction( 'get_list_item_properties' )</code>
+ * eg: (all items of 2nd list) <code>performAction( 'get_list_item_properties', '2' )</code>
+ * eg: (1st item of 2nd list) <code>performAction( 'get_list_item_properties', '2' , '1' )</code>
+ * 
+ * @return <code>bonusInformation</code> contain an array of Strings, one for each row in the list (or only for the specified row):
+ *   eg: {[{"id":"title", "text":"My Title", "compoundDrawables":["left"]}, {"id":"subtitle", "text":"Another text field for the same list item"}]}
+ *   
+ *   
+ * In ruby, we can then parse the response:
+ * <pre>
+ *   response_table = result['bonusInformation']
+ *   response_table.each_with_index do | row_data, index |
+ *     row_data = JSON.parse( row_data )
+ *     response_table[index] = row_data
+ *   end
+ * </pre>
+ * 
+ * @author Nicholas Albion
+ */
+public class GetListItemProperties implements Action {
+
+	@Override
+	public Result execute(String... args) {
+		int listIndex;
+		int rowIndex = -1;
+
+		if( args.length == 0 ) {
+			listIndex = 0;
+		} else {
+			if( args.length > 1 ) {
+				rowIndex = (Integer.parseInt(args[1]) - 1);
+			}
+			listIndex = (Integer.parseInt(args[0]) - 1);
+		}
+
+
+		ArrayList<ListView> listViews = InstrumentationBackend.solo.getCurrentListViews();
+		if( listViews == null || listViews.size() <= listIndex ) {
+			return new Result(false, "Could not find list #" + (listIndex + 1));
+		}
+
+		ListView list = listViews.get(listIndex);
+		Result result = new Result(true);
+
+		if( rowIndex < 0 ) {
+			int count = list.getChildCount();
+			for( int i = 0; i < count; i++ ) {
+				result.addBonusInformation( getListItemString( list.getChildAt(i) ) );
+			}
+		} else {
+			result.addBonusInformation( getListItemString( list.getChildAt(rowIndex) ) );
+		}
+
+		return result;
+	}
+
+	/**
+	 * @return <code>bonusInformation</code> contain an array of Strings, one for each row in the list (or only for the specified row):
+	 *   eg: {[{"id":"title", "text":"My Title", "compoundDrawables":{"left":"drawable_id"}}, {"id":"subtitle", "text":"Another text field for the same list item"}]}
+	 */
+	private String getListItemString( View row ) {
+		StringBuilder json = new StringBuilder("{");
+
+		if( row instanceof TextView ) {
+			addViewInfo( json, (TextView)row );
+		} else if( row instanceof ViewGroup ) {
+			addViewInfo( json, (ViewGroup)row );
+		}
+
+		json.append('}');
+		return json.toString();
+	}
+
+	private void addViewInfo( StringBuilder json, TextView view ) {
+		int resId = view.getId();
+		String resIdName = view.getResources().getResourceEntryName(resId);
+
+		json.append("\"id\":\"").append(resIdName).append("\", \"text\":\"").append( ((TextView)view).getText() ).append("\"");
+		
+		json.append(", \"color\":").append( view.getCurrentTextColor() );
+		Drawable background = view.getBackground();
+		if( background instanceof ColorDrawable ) {
+			try {
+				// As pointed out by kbielenberg, ColorDrawable.getColor() was only added in level 11/Android 3/Honeycomb
+				Method getColor = ColorDrawable.class.getMethod("getColor");
+				Integer color = (Integer)getColor.invoke(background);
+				json.append(", \"background\":").append( color );
+			} catch (Exception e) {}
+		}
+
+		StringBuilder compoundStr = new StringBuilder();
+		Drawable[] compoundDrawables = view.getCompoundDrawables();	//  left, top, right, and bottom
+		if( compoundDrawables[0] != null ) {
+			compoundStr.append("\"left\"");
+		}
+		if( compoundDrawables[1] != null ) {
+			if( compoundStr.length() != 0 ) {
+				compoundStr.append(',');
+			}
+			compoundStr.append("\"top\"");
+		}
+		if( compoundDrawables[2] != null ) {
+			if( compoundStr.length() != 0 ) {
+				compoundStr.append(',');
+			}
+			compoundStr.append("\"right\"");
+		}
+		if( compoundDrawables[3] != null ) {
+			if( compoundStr.length() != 0 ) {
+				compoundStr.append(',');
+			}
+			compoundStr.append("\"bottom\"");
+		}
+		if( compoundStr.length() != 0 ) {
+			json.append(", \"compoundDrawables\":[").append(compoundStr).append(']');
+		}
+	}
+
+	private void addViewInfo( StringBuilder json, TableRow tableRow ) {
+		json.append("\"cells\":[");
+
+		int count = tableRow.getVirtualChildCount();
+		for( int i = 0; i < count; i++ ) {
+			if( i != 0 ) {
+				json.append(", ");
+			}
+			json.append("{\"column\":").append(i).append(", ");
+
+			View view = tableRow.getVirtualChildAt(i);
+			if( view instanceof TextView ) {
+				addViewInfo( json, (TextView)view );
+			} else if( view instanceof ViewGroup ) {
+				addViewInfo( json, (ViewGroup)view );
+			}
+
+			json.append('}');
+		}
+
+		json.append(']');
+	}
+
+	private void addViewInfo( StringBuilder json, ViewGroup viewGroup ) {
+		json.append("\"children\":[");
+
+		int count = viewGroup.getChildCount();
+		for( int i = 0; i < count; i++ ) {
+			if( i != 0 ) {
+				json.append(", ");
+			}
+			json.append('{');
+
+			View view = viewGroup.getChildAt(i);
+			if( view instanceof TextView ) {
+				addViewInfo( json, (TextView)view );
+			} else if( view instanceof TableRow ) {
+				addViewInfo( json, (TableRow)view );
+			} else if( view instanceof ViewGroup ) {
+				addViewInfo( json, (ViewGroup)view );
+			}
+
+			json.append('}');
+		}
+
+		json.append(']');
+	}
+
+	@Override
+	public String key() {
+		return "get_list_item_properties";
+	}
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/list/GetListItemText.java

@@ -0,0 +1,136 @@
+package sh.calaba.instrumentationbackend.actions.list;
+
+import java.util.ArrayList;
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+import android.util.Log;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ListView;
+import android.widget.TableRow;
+import android.widget.TextView;
+
+/**
+ * args: 
+ * <ul> 
+ *   <li>1-based list index (first list is used if not specified)</li>
+ *   <li>1-based row index (returns all rows if &lt;=0 or not specified)</li>
+ * </ul>
+ * 
+ * eg: (all items of 1st list) <code>performAction( 'get_list_item_text' )</code>
+ * eg: (all items of 2nd list) <code>performAction( 'get_list_item_text', '2' )</code>
+ * eg: (1st item of 2nd list) <code>performAction( 'get_list_item_text', '2' , '1' )</code>
+ * 
+ * @return <code>bonusInformation</code> contain an array of Strings, one for each row in the list (or only for the specified row):
+ *   eg: {"title":"My Title", "subtitle":"Another text field for the same list item"}
+ *   
+ *   
+ * In ruby, we can then parse the response:
+ * <pre>
+ *   response_table = result['bonusInformation']
+ *   response_table.each_with_index do | row_data, index |
+ *     row_data = JSON.parse( row_data )
+ *     response_table[index] = row_data
+ *   end
+ * </pre>
+ * 
+ * @author Nicholas Albion
+ */
+public class GetListItemText implements Action {
+
+	@Override
+	public Result execute(String... args) {
+		int listIndex;
+		int rowIndex = -1;
+
+		if( args.length == 0 ) {
+			listIndex = 0;
+		} else {
+			if( args.length > 1 ) {
+				rowIndex = (Integer.parseInt(args[1]) - 1);
+			}
+			listIndex = (Integer.parseInt(args[0]) - 1);
+		}
+
+
+		ArrayList<ListView> listViews = InstrumentationBackend.solo.getCurrentListViews();
+		Log.d("GetListItemText", "Found " + listViews.size() + " list views");
+		if( listViews == null || listViews.size() <= listIndex ) {
+			return new Result(false, "Could not find list #" + (listIndex + 1));
+		}
+
+		ListView list = listViews.get(listIndex);
+		Result result = new Result(true);
+
+		if( rowIndex < 0 ) {
+			int count = list.getChildCount();
+			Log.d("GetListItemText", "Found " + count + " list items");
+			for( int i = 0; i < count; i++ ) {
+				result.addBonusInformation( getListItemString( list.getChildAt(i) ) );
+			}
+		} else {
+			result.addBonusInformation( getListItemString( list.getChildAt(rowIndex) ) );
+		}
+
+		return result;
+	}
+
+	/**
+	 * @return <code>bonusInformation</code> contain an array of Strings, one for each row in the list (or only for the specified row):
+	 *   eg: {"title":"My Title", "subtitle":"Another text field for the same list item"}
+	 */
+	private String getListItemString( View row ) {
+		StringBuilder json = new StringBuilder("{");
+
+		if( row instanceof TextView ) {
+			addViewInfo( json, (TextView)row );
+		} else if( row instanceof ViewGroup ) {
+			addViewInfo( json, (ViewGroup)row );
+		}
+
+		json.deleteCharAt( json.length() - 1 );		// remove the last comma
+		json.append('}');
+		return json.toString();
+	}
+
+	private void addViewInfo( StringBuilder json, TextView view ) {
+		int resId = view.getId();
+		String resIdName = view.getResources().getResourceEntryName(resId);
+
+		//json.append("\"id\":\"").append(resIdName).append("\", \"text:\"").append( ((TextView)row).getText() ).append("\"");
+		json.append('"').append(resIdName).append("\":\"").append( ((TextView)view).getText() ).append("\",");
+	}
+
+	private void addViewInfo( StringBuilder json, TableRow tableRow ) {
+		int count = tableRow.getVirtualChildCount();
+		for( int i = 0; i < count; i++ ) {
+			View view = tableRow.getVirtualChildAt(i);
+			if( view instanceof TextView ) {
+				addViewInfo( json, (TextView)view );
+			} else if( view instanceof ViewGroup ) {
+				addViewInfo( json, (ViewGroup)view );
+			}
+		}
+	}
+
+	private void addViewInfo( StringBuilder json, ViewGroup viewGroup ) {
+		int count = viewGroup.getChildCount();
+		for( int i = 0; i < count; i++ ) {
+			View view = viewGroup.getChildAt(i);
+			if( view instanceof TextView ) {
+				addViewInfo( json, (TextView)view );
+			} else if( view instanceof TableRow ) {
+				addViewInfo( json, (TableRow)view );
+			} else if( view instanceof ViewGroup ) {
+				addViewInfo( json, (ViewGroup)view );
+			}
+		}
+	}
+
+	@Override
+	public String key() {
+		return "get_list_item_text";
+	}
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/list/LongPressListItems.java

@@ -0,0 +1,22 @@
+package sh.calaba.instrumentationbackend.actions.list;
+
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+
+
+public class LongPressListItems implements Action {
+
+    @Override
+    public Result execute(String... args) {
+        InstrumentationBackend.solo.clickLongInList(Integer.parseInt(args[0]) - 1, Integer.parseInt(args[1]));
+        return Result.successResult();
+    }
+
+    @Override
+    public String key() {
+        return "long_press_list_item";
+    }
+
+}

data/test-server/instrumentation-backend/src/sh/calaba/instrumentationbackend/actions/list/PressListItems.java

@@ -0,0 +1,22 @@
+package sh.calaba.instrumentationbackend.actions.list;
+
+
+import sh.calaba.instrumentationbackend.InstrumentationBackend;
+import sh.calaba.instrumentationbackend.Result;
+import sh.calaba.instrumentationbackend.actions.Action;
+
+
+public class PressListItems implements Action {
+
+    @Override
+    public Result execute(String... args) {
+        InstrumentationBackend.solo.clickInList(Integer.parseInt(args[0]) - 1, Integer.parseInt(args[1]));
+        return Result.successResult();
+    }
+
+    @Override
+    public String key() {
+        return "press_list_item";
+    }
+
+}