crash_monkey 0.1.5

data/lib/crash_monkey/templates/result_view.coffee

@@ -0,0 +1,160 @@
+MonkeyResult = ->
+  that = {}
+  options = null
+
+  that.configure = (opts) ->
+    options = opts
+    options.image_size_rate = opts.image_size_rate || 1
+    that
+
+  that.draw = ->
+    ir = options.image_size_rate
+    for log, i in options.log_list
+      do (log, i) ->
+        text_div = $('#'+options.text_prefix+'-'+i)
+        text_div.html(log.message + "<hr>"+log.timestamp)
+        img = new Image()
+        img.addEventListener "load", ->
+          element = $('#'+options.view_prefix+'-'+i)
+          canvas = element[0]
+          canvas.width = img.width * ir
+          canvas.height = img.height * ir
+          context = canvas.getContext('2d')
+          context.scale(1,1)
+          context.clearRect(0,0,canvas.width, canvas.height)
+          context.drawImage(img, 0, 0, canvas.width, canvas.height)
+          target = DrawTarget(canvas: canvas, context: context, image_size_rate: ir, index: i)
+          eval(log.message)
+        img.src = log.screen_image + '.png'
+
+  return that
+
+DrawTarget = (opts) ->
+  that = {}
+  options = opts
+  canvas = options.canvas
+  context = options.context
+  ir = options.image_size_rate
+  context.strokeStyle = "#f00"
+  context.lineWidth = 2
+  arc_radius = 20
+
+  that.tapWithOptions = (p1, info) ->
+    console.log(opts.index, p1, info)
+    pos_to_number(p1)
+
+    tc = 1*info.touchCount
+    for num in [0..(tc-1)]
+      o = x: (context.lineWidth + 2)*(num - (tc-1)/2), y: 0
+      draw_arc({x: (p1.x*ir + o.x)/ir, y: (p1.y*ir + o.y)/ir}, r: 0.1)
+
+    for num in [0..(1*info.tapCount-1)]
+      draw_arc(p1, r: (arc_radius*ir + (1+context.lineWidth)*num)/ir)
+
+  that.pinchCloseFromToForDuration = (p1, p2, info) ->
+    pos_to_number(p) for p in [p1, p2]
+    draw_arc(p1)
+    draw_arc(p2)
+    #
+    center = x: (p1.x+p2.x)/2, y: (p1.y+p2.y)/2
+    draw_arrow(p1, center)
+    draw_arrow(p2, center)
+
+  that.pinchOpenFromToForDuration = (p1, p2, info) ->
+    pos_to_number(p) for p in [p1, p2]
+    draw_arc(p1)
+    draw_arc(p2)
+    #
+    center = x: (p1.x+p2.x)/2, y: (p1.y+p2.y)/2
+    draw_arrow(center, p1)
+    draw_arrow(center, p2)
+
+  that.dragFromToForDuration = (p1, p2, info) ->
+    pos_to_number(p) for p in [p1, p2]
+    console.log(opts.index, p1, p2, info)
+    draw_arc(p1)
+    draw_arc(p2)
+    draw_arrow(p1, p2)
+
+  that.flickFromTo = (p1, p2, info) ->
+    pos_to_number(p) for p in [p1, p2]
+    console.log(opts.index, p1, p2, info)
+    draw_arc(p1)
+    draw_arrow(p1, p2)
+
+  that.lockForDuration = (duration) ->
+    draw_text("Lock Screen #{Math.floor(duration * 100)/100} Secs.")
+
+  that.deactivateAppForDuration = (duration) ->
+    draw_text("Deactivate #{Math.floor(duration * 100)/100} Secs.")
+
+  that.setDeviceOrientation = (orientation) ->
+    draw_text("Orientation to #{orientation_name(orientation)}")
+
+  that.shake = ->
+    draw_text("Shake!")
+
+  that.clickVolumeUp = ->
+    draw_text("clickVolumeUp!")
+
+  that.clickVolumeDown = ->
+    draw_text("clickVolumeDown!")
+
+  draw_text = (text, opts={}) ->
+    context.font = "10px 'ＭＳ Ｐゴシック'"
+    context.lineWidth = 1
+    context.strokeStyle = "green"
+    context.beginPath()
+    context.fillRect(canvas.width*0.1, 20, canvas.width*0.8, 40)
+    context.stroke()
+    context.strokeText(text, canvas.width*0.13, 42)
+
+
+  orientation_name = (orientation) ->
+    # http://www.testmachine.ch/javadoc/constant-values.html#ch.sukha.testmachine.client.IosDebuggingInterface.UIA_DEVICE_ORIENTATION_FACEDOWN
+    switch 1 * orientation
+      when 0 then "UNKNOWN"
+      when 1 then "PORTRAIT"
+      when 2 then "PORTRAIT_UPSIDEDOWN"
+      when 3 then "LANDSCAPELEFT"
+      when 4 then "LANDSCAPERIGHT"
+      when 5 then "FACEUP"
+      when 6 then "FACEDOWN"
+      else "UNDEF"
+
+  pos_to_number = (p) ->
+    p.x = 1 * p.x
+    p.y = 1 * p.y
+    p
+
+  draw_arc = (p, opts={}) ->
+    radius = opts.r || arc_radius
+    context.beginPath()
+    context.arc(p.x * ir, p.y * ir, radius * ir, 0, Math.PI*2)
+    context.stroke()
+
+  draw_arrow = (p1, p2, opts={}) ->
+    vx = p2.x - p1.x
+    vy = p2.y - p1.y
+    v = Math.sqrt(vx*vx + vy*vy)
+    ux = vx/v
+    uy = vy/v
+    opts.w ||= 8
+    opts.h ||= 12
+    opts.h2 ||= 5
+    lp = {x: p2.x - uy * opts.w - ux * opts.h, y: p2.y + ux * opts.w - uy * opts.h}
+    rp = {x: p2.x + uy * opts.w - ux * opts.h, y: p2.y - ux * opts.w - uy * opts.h}
+    mp = {x: p2.x - ux * opts.h2, y: p2.y - uy * opts.h2}
+    context.beginPath()
+    context.moveTo(p1.x * ir, p1.y * ir)
+    context.lineTo(mp.x * ir, mp.y * ir)
+    context.lineTo(lp.x * ir, lp.y * ir)
+    context.lineTo(p2.x * ir, p2.y * ir)
+    context.lineTo(rp.x * ir, rp.y * ir)
+    context.lineTo(mp.x * ir, mp.y * ir)
+    context.stroke()
+
+  return that
+
+window.MonkeyResult = MonkeyResult
+

data/lib/crash_monkey/templates/result_view.js

@@ -0,0 +1,246 @@
+// Generated by CoffeeScript 1.6.3
+(function() {
+  var DrawTarget, MonkeyResult;
+
+  MonkeyResult = function() {
+    var options, that;
+    that = {};
+    options = null;
+    that.configure = function(opts) {
+      options = opts;
+      options.image_size_rate = opts.image_size_rate || 1;
+      return that;
+    };
+    that.draw = function() {
+      var i, ir, log, _i, _len, _ref, _results;
+      ir = options.image_size_rate;
+      _ref = options.log_list;
+      _results = [];
+      for (i = _i = 0, _len = _ref.length; _i < _len; i = ++_i) {
+        log = _ref[i];
+        _results.push((function(log, i) {
+          var img, text_div;
+          text_div = $('#' + options.text_prefix + '-' + i);
+          text_div.html(log.message + "<hr>" + log.timestamp);
+          img = new Image();
+          img.addEventListener("load", function() {
+            var canvas, context, element, target;
+            element = $('#' + options.view_prefix + '-' + i);
+            canvas = element[0];
+            canvas.width = img.width * ir;
+            canvas.height = img.height * ir;
+            context = canvas.getContext('2d');
+            context.scale(1, 1);
+            context.clearRect(0, 0, canvas.width, canvas.height);
+            context.drawImage(img, 0, 0, canvas.width, canvas.height);
+            target = DrawTarget({
+              canvas: canvas,
+              context: context,
+              image_size_rate: ir,
+              index: i
+            });
+            return eval(log.message);
+          });
+          return img.src = log.screen_image + '.png';
+        })(log, i));
+      }
+      return _results;
+    };
+    return that;
+  };
+
+  DrawTarget = function(opts) {
+    var arc_radius, canvas, context, draw_arc, draw_arrow, draw_text, ir, options, orientation_name, pos_to_number, that;
+    that = {};
+    options = opts;
+    canvas = options.canvas;
+    context = options.context;
+    ir = options.image_size_rate;
+    context.strokeStyle = "#f00";
+    context.lineWidth = 2;
+    arc_radius = 20;
+    that.tapWithOptions = function(p1, info) {
+      var num, o, tc, _i, _j, _ref, _ref1, _results;
+      console.log(opts.index, p1, info);
+      pos_to_number(p1);
+      tc = 1 * info.touchCount;
+      for (num = _i = 0, _ref = tc - 1; 0 <= _ref ? _i <= _ref : _i >= _ref; num = 0 <= _ref ? ++_i : --_i) {
+        o = {
+          x: (context.lineWidth + 2) * (num - (tc - 1) / 2),
+          y: 0
+        };
+        draw_arc({
+          x: (p1.x * ir + o.x) / ir,
+          y: (p1.y * ir + o.y) / ir
+        }, {
+          r: 0.1
+        });
+      }
+      _results = [];
+      for (num = _j = 0, _ref1 = 1 * info.tapCount - 1; 0 <= _ref1 ? _j <= _ref1 : _j >= _ref1; num = 0 <= _ref1 ? ++_j : --_j) {
+        _results.push(draw_arc(p1, {
+          r: (arc_radius * ir + (1 + context.lineWidth) * num) / ir
+        }));
+      }
+      return _results;
+    };
+    that.pinchCloseFromToForDuration = function(p1, p2, info) {
+      var center, p, _i, _len, _ref;
+      _ref = [p1, p2];
+      for (_i = 0, _len = _ref.length; _i < _len; _i++) {
+        p = _ref[_i];
+        pos_to_number(p);
+      }
+      draw_arc(p1);
+      draw_arc(p2);
+      center = {
+        x: (p1.x + p2.x) / 2,
+        y: (p1.y + p2.y) / 2
+      };
+      draw_arrow(p1, center);
+      return draw_arrow(p2, center);
+    };
+    that.pinchOpenFromToForDuration = function(p1, p2, info) {
+      var center, p, _i, _len, _ref;
+      _ref = [p1, p2];
+      for (_i = 0, _len = _ref.length; _i < _len; _i++) {
+        p = _ref[_i];
+        pos_to_number(p);
+      }
+      draw_arc(p1);
+      draw_arc(p2);
+      center = {
+        x: (p1.x + p2.x) / 2,
+        y: (p1.y + p2.y) / 2
+      };
+      draw_arrow(center, p1);
+      return draw_arrow(center, p2);
+    };
+    that.dragFromToForDuration = function(p1, p2, info) {
+      var p, _i, _len, _ref;
+      _ref = [p1, p2];
+      for (_i = 0, _len = _ref.length; _i < _len; _i++) {
+        p = _ref[_i];
+        pos_to_number(p);
+      }
+      console.log(opts.index, p1, p2, info);
+      draw_arc(p1);
+      draw_arc(p2);
+      return draw_arrow(p1, p2);
+    };
+    that.flickFromTo = function(p1, p2, info) {
+      var p, _i, _len, _ref;
+      _ref = [p1, p2];
+      for (_i = 0, _len = _ref.length; _i < _len; _i++) {
+        p = _ref[_i];
+        pos_to_number(p);
+      }
+      console.log(opts.index, p1, p2, info);
+      draw_arc(p1);
+      return draw_arrow(p1, p2);
+    };
+    that.lockForDuration = function(duration) {
+      return draw_text("Lock Screen " + (Math.floor(duration * 100) / 100) + " Secs.");
+    };
+    that.deactivateAppForDuration = function(duration) {
+      return draw_text("Deactivate " + (Math.floor(duration * 100) / 100) + " Secs.");
+    };
+    that.setDeviceOrientation = function(orientation) {
+      return draw_text("Orientation to " + (orientation_name(orientation)));
+    };
+    that.shake = function() {
+      return draw_text("Shake!");
+    };
+    that.clickVolumeUp = function() {
+      return draw_text("clickVolumeUp!");
+    };
+    that.clickVolumeDown = function() {
+      return draw_text("clickVolumeDown!");
+    };
+    draw_text = function(text, opts) {
+      if (opts == null) {
+        opts = {};
+      }
+      context.font = "10px 'ＭＳ Ｐゴシック'";
+      context.lineWidth = 1;
+      context.strokeStyle = "green";
+      context.beginPath();
+      context.fillRect(canvas.width * 0.1, 20, canvas.width * 0.8, 40);
+      context.stroke();
+      return context.strokeText(text, canvas.width * 0.13, 42);
+    };
+    orientation_name = function(orientation) {
+      switch (1 * orientation) {
+        case 0:
+          return "UNKNOWN";
+        case 1:
+          return "PORTRAIT";
+        case 2:
+          return "PORTRAIT_UPSIDEDOWN";
+        case 3:
+          return "LANDSCAPELEFT";
+        case 4:
+          return "LANDSCAPERIGHT";
+        case 5:
+          return "FACEUP";
+        case 6:
+          return "FACEDOWN";
+        default:
+          return "UNDEF";
+      }
+    };
+    pos_to_number = function(p) {
+      p.x = 1 * p.x;
+      p.y = 1 * p.y;
+      return p;
+    };
+    draw_arc = function(p, opts) {
+      var radius;
+      if (opts == null) {
+        opts = {};
+      }
+      radius = opts.r || arc_radius;
+      context.beginPath();
+      context.arc(p.x * ir, p.y * ir, radius * ir, 0, Math.PI * 2);
+      return context.stroke();
+    };
+    draw_arrow = function(p1, p2, opts) {
+      var lp, mp, rp, ux, uy, v, vx, vy;
+      if (opts == null) {
+        opts = {};
+      }
+      vx = p2.x - p1.x;
+      vy = p2.y - p1.y;
+      v = Math.sqrt(vx * vx + vy * vy);
+      ux = vx / v;
+      uy = vy / v;
+      opts.w || (opts.w = 8);
+      opts.h || (opts.h = 12);
+      opts.h2 || (opts.h2 = 5);
+      lp = {
+        x: p2.x - uy * opts.w - ux * opts.h,
+        y: p2.y + ux * opts.w - uy * opts.h
+      };
+      rp = {
+        x: p2.x + uy * opts.w - ux * opts.h,
+        y: p2.y - ux * opts.w - uy * opts.h
+      };
+      mp = {
+        x: p2.x - ux * opts.h2,
+        y: p2.y - uy * opts.h2
+      };
+      context.beginPath();
+      context.moveTo(p1.x * ir, p1.y * ir);
+      context.lineTo(mp.x * ir, mp.y * ir);
+      context.lineTo(lp.x * ir, lp.y * ir);
+      context.lineTo(p2.x * ir, p2.y * ir);
+      context.lineTo(rp.x * ir, rp.y * ir);
+      context.lineTo(mp.x * ir, mp.y * ir);
+      return context.stroke();
+    };
+    return that;
+  };
+
+  window.MonkeyResult = MonkeyResult;
+
+}).call(this);

data/lib/ui-auto-monkey/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2013 Jonathan Penn (http://cocoamanifest.net/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/lib/ui-auto-monkey/UIAutoMonkey.js

@@ -0,0 +1,333 @@
+/////////////////////////////////////////////////////////////////////////////////////
+//                         ORIGINAL Copyright
+/////////////////////////////////////////////////////////////////////////////////////
+
+// Copyright (c) 2013 Jonathan Penn (http://cocoamanifest.net/)
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+/////////////////////////////////////////////////////////////////////////////////////
+//
+/////////////////////////////////////////////////////////////////////////////////////
+
+
+"use strict";
+
+var UIAutoMonkey = {
+///////////////////////// __UIAutoMonkey Configuration Begin__  ///////////////////////////////
+	config: {
+		numberOfEvents: 1000,
+		delayBetweenEvents: 0.05,    // In seconds
+        result_detail_event_num: 20,
+
+		// Events are triggered based on the relative weights here. The event
+		// with this highest number gets triggered the most.
+		//
+		// If you want to add your own "events", check out the event method
+		// definitions below.
+		eventWeights: {
+			tap: 500,
+			drag: 100,
+			flick: 100,
+			orientation: 1,
+			clickVolumeUp: 1,
+			clickVolumeDown: 1,
+			lock: 3,
+			pinchClose: 50,
+			pinchOpen: 50,
+			shake: 1,
+			deactivate: 3
+		},
+
+		// Probability that touch events will have these different properties
+		touchProbability: {
+			multipleTaps: 0.05,
+			multipleTouches: 0.05,
+			longPress: 0.05
+		},
+
+		// Uncomment the following to restrict events to a rectangluar area of
+		// the screen
+		/*
+		frame: {
+			origin: {x: 0, y: 0},
+			size: {width: 100, height: 50}
+		}
+		*/
+	},
+///////////////////////// __UIAutoMonkey Configuration End__  ///////////////////////////////
+
+	// --- --- --- ---
+	// Event Methods
+	//
+	// Any event probability in the hash above corresponds to a related event
+	// method below. So, a "tap" probability will trigger a "tapEvent" method.
+	//
+	// If you want to add your own events, just add a probability to the hash
+	// above and then add a corresponding method below. Boom!
+	//
+	// Each event method can call any other method on this UIAutoMonkey object.
+	// All the methods at the end are helpers at your disposal and feel free to
+	// add your own.
+
+	tapEvent: function() {
+        var p1 = { x: this.randomX(), y: this.randomY() };
+		this.target().tapWithOptions(p1,
+			{
+				tapCount: this.randomTapCount(),
+				touchCount: this.randomTouchCount(),
+				duration: this.randomTapDuration()
+			}
+		);
+	},
+
+	dragEvent: function() {
+        var p1 = { x: this.randomX(), y: this.randomY() };
+        var p2 = { x: this.randomX(), y: this.randomY() };
+		this.target().dragFromToForDuration(p1, p2, 0.5);
+	},
+
+	flickEvent: function() {
+        var p1 = { x: this.randomX(), y: this.randomY() };
+        var p2 = { x: this.randomX(), y: this.randomY() };
+		this.target().flickFromTo(p1, p2);
+	},
+
+	orientationEvent: function() {
+		var orientations = [
+			UIA_DEVICE_ORIENTATION_PORTRAIT,
+			UIA_DEVICE_ORIENTATION_PORTRAIT_UPSIDEDOWN,
+			UIA_DEVICE_ORIENTATION_LANDSCAPELEFT,
+			UIA_DEVICE_ORIENTATION_LANDSCAPERIGHT
+		];
+
+		var i = Math.floor(Math.random() * 10) % orientations.length;
+		var newOrientation = orientations[i];
+		this.target().setDeviceOrientation(newOrientation);
+		this.delay(0.9);
+	},
+
+	clickVolumeUpEvent: function() {
+		this.target().clickVolumeUp();
+	},
+
+	clickVolumeDownEvent: function() {
+		this.target().clickVolumeDown();
+	},
+
+	lockEvent: function() {
+		this.target().lockForDuration(Math.random() * 3);
+	},
+
+	pinchCloseEvent: function () {
+        var p1 = { x: this.randomX(), y: this.randomY() };
+        var p2 = { x: this.randomX(), y: this.randomY() };
+		this.target().pinchCloseFromToForDuration(p1, p2, 0.5);
+	},
+
+	pinchOpenEvent: function () {
+        var p1 = { x: this.randomX(), y: this.randomY() };
+        var p2 = { x: this.randomX(), y: this.randomY() };
+		this.target().pinchOpenFromToForDuration(p1, p2, 0.5);
+	},
+
+	shakeEvent: function() {
+		this.target().shake();
+	},
+	
+	deactivateEvent: function() {
+		this.target().deactivateAppForDuration(5 + Math.random() * 10);
+	},
+
+	// --- --- --- ---
+	// Helper methods
+	//
+
+    results_path: function() {
+        var host = this.target().host();
+        var results = host.performTaskWithPathArgumentsTimeout("/bin/bash", ["-c", "echo -n $UIARESULTSPATH"], 5);
+        var ret = results.stdout;
+        UIALogger.logDebug("results_path: '" + ret+"'");
+        return ret;
+    },
+
+    deleteImage: function(dir, from, to) {
+        var host = this.target().host();
+        var files = [];
+        for (var i=from; i < to; i++) {
+            files.push(dir + "/screen-"+i + ".png");
+            // files.push(dir + "/action-"+i + ".png");
+        }
+        host.performTaskWithPathArgumentsTimeout("/bin/rm", files, 5);
+    },
+
+	RELEASE_THE_MONKEY: function() {
+		// Called at the bottom of this ui-auto-monkey to, you know...
+		//
+		// RELEASE THE MONKEY!
+        var target = this.target();
+		var initBundleID = target.frontMostApp().bundleID();
+        var results_path = this.results_path();
+        var result_num = this.config.result_detail_event_num;
+
+		for(var i = 0; i < this.config.numberOfEvents; i++) {
+            // Delete old images
+            if (i % 10 == 0 && i > result_num) {
+                this.deleteImage(results_path, i-result_num-10, i-result_num);
+            }
+            // Capture Screen Image
+            target.captureScreenWithName("screen-" + i);
+            // if another application become frontMost, exit.
+            var bundleID = target.frontMostApp().bundleID();
+            if (bundleID != initBundleID) {
+                UIALogger.logDebug("************************ Different Application **************: " + bundleID);
+                break;
+            }
+
+            // Send Random Event
+            this.triggerRandomEvent();
+
+            // Wait
+			this.delay();
+		}
+	},
+
+	triggerRandomEvent: function() {
+		var name = this.chooseEventName();
+		// Find the event method based on the name of the event
+		var event = this[name + "Event"];
+		return event.apply(this);
+	},
+
+	target: function() {
+		// Return the local target.
+		return UIATarget.localTarget();
+	},
+
+	delay: function(seconds) {
+		// Delay the target by `seconds` (can be a fraction)
+		// Defaults to setting in configuration
+		seconds = seconds || this.config.delayBetweenEvents;
+		this.target().delay(seconds);
+	},
+
+	chooseEventName: function() {
+		// Randomly chooses an event name from the `eventsWeight` dictionary
+		// based on the given weights.
+		var calculatedEventWeights = [];
+		var totalWeight = 0;
+		var events = this.config.eventWeights;
+		for (var event in events) {
+			if (events.hasOwnProperty(event)) {
+				calculatedEventWeights.push({
+					weight: events[event]+totalWeight,
+					event: event
+				});
+				totalWeight += events[event];
+			}
+		}
+
+		var chosenWeight = Math.random() * 1000 % totalWeight;
+
+		for (var i = 0; i < calculatedEventWeights.length; i++) {
+			if (chosenWeight < calculatedEventWeights[i].weight) {
+				return calculatedEventWeights[i].event;
+			}
+		}
+
+		throw "No even was chosen!";
+	},
+
+	screenWidth: function() {
+		// Need to adjust by one to stay within rectangle
+		return this.target().rect().size.width - 1;
+	},
+
+	screenHeight: function() {
+		// Need to adjust by one to stay within rectangle
+		return this.target().rect().size.height - 1;
+	},
+
+	randomX: function() {
+		var min, max;
+
+		if (this.config.frame){
+			// Limits coordinates to given frame if set in config
+			min = this.config.frame.origin.x;
+			max = this.config.frame.size.width + min;
+		} else {
+			// Returns a random X coordinate within the screen rectangle
+			min = 0;
+			max = this.screenWidth();
+		}
+
+		return Math.floor(Math.random() * (max - min) + min) + 1;
+	},
+
+	randomY: function() {
+		var min, max;
+
+		if (this.config.frame){
+			// Limits coordinates to given frame if set in config
+			min = this.config.frame.origin.y;
+			max = this.config.frame.size.height + min;
+		} else {
+			// Returns a random Y coordinate within the screen rectangle
+			min = 0;
+			max = this.screenHeight();
+		}
+
+		return Math.floor(Math.random() * (max - min) + min) + 1;
+	},
+
+	randomTapCount: function() {
+		// Calculates a tap count for tap events based on touch probabilities
+		if (this.config.touchProbability.multipleTaps > Math.random()) {
+			return Math.floor(Math.random() * 10) % 3 + 1;
+		}
+		else return 1;
+	},
+
+	randomTouchCount: function() {
+		// Calculates a touch count for tap events based on touch probabilities
+		if (this.config.touchProbability.multipleTouches > Math.random()) {
+			return Math.floor(Math.random() * 10) % 3 + 1;
+		}
+		else return 1;
+	},
+
+	randomTapDuration: function() {
+		// Calculates whether or not a tap should be a long press based on
+		// touch probabilities
+		if (this.config.touchProbability.longPress > Math.random()) {
+			return 0.5;
+		}
+		else return 0;
+	},
+
+	randomRadians: function() {
+		// Returns a random radian value
+		return Math.random() * 10 % (3.14159 * 2);
+	}
+};
+
+UIAutoMonkey.RELEASE_THE_MONKEY();
+
+/* Instruments uses 4-wide tab stops. */
+/* vim: set tabstop=4 shiftwidth=4 softtabstop=4 copyindent noexpandtab: */