acouchi 0.0.1 → 0.0.2

data/README.md

@@ -1,12 +1,36 @@
 Acouchi
 =======
 
+WARNING
+-------
+
+This gem was initially a spike, and has since then become rather useful. It is very much not unit tested. For this I apologise, and offer up this picture of an [Acouchi](http://en.wikipedia.org/wiki/Acouchi):
+
+![acouchi](https://github.com/AndrewVos/acouchi/raw/master/acouchi.jpg)
+
 Requirements
 ------------
 
 * [Android SDK](http://developer.android.com/sdk/installing/index.html) (Make sure to add SDK/tools and SDK/platform-tools to your PATH)
 * [apktool](http://code.google.com/p/android-apktool/)
 
+The Build Process
+-----------------
+
+Acouchi needs to make some tweaks to your APK to allow functional testing. This is roughly the process:
+
+* Temporarily add some source files, and the Robotium jar file to your project
+* Build your project in debug mode with ant
+* Hack the APK file and inject some need elements in your AndroidManifest.xml
+
+Please note that the build only has to happen again if your java code for the application under test changes.
+
+How It Works
+------------
+
+Acouchi builds Robotium and a HTTP server into your Android application. Robotium is an API that has some amazing functionality for functional testing on Android.
+In the Ruby API we post method calls via HTTP to the server on your device, which in turn returns meaningful data.
+
 Cucumber
 --------
 

data/acouchi.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |gem|
   gem.email         = ["andrew.vos@gmail.com"]
   gem.description   = %q{}
   gem.summary       = %q{}
-  gem.homepage      = ""
+  gem.homepage      = "https://github.com/AndrewVos/acouchi"
 
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/lib/acouchi.rb

@@ -3,3 +3,5 @@ require "acouchi/project_builder"
 require "acouchi/solo"
 require "acouchi/test_runner"
 require "acouchi/configuration"
+require "acouchi/apk_modifier"
+require "acouchi/process_launcher"

data/lib/acouchi/process_launcher.rb

@@ -0,0 +1,21 @@
+module Acouchi
+  class ProcessLauncher
+    def initialize(*arguments)
+      @arguments = arguments
+      @process = ChildProcess.build(*@arguments)
+      @process.io.inherit!
+    end
+
+    def start
+      @process.start
+      @process.wait
+    end
+
+    def start_and_crash_if_process_fails
+      start
+      if @process.crashed?
+        raise "A process exited with a non-zero exit code.\nThe command executed was \"#{@arguments.join(" ")}\""
+      end
+    end
+  end
+end

data/lib/acouchi/project_builder.rb

@@ -1,5 +1,5 @@
-require "acouchi/apk_modifier"
 require "fileutils"
+require "childprocess"
 
 module Acouchi
   JARS_PATH = File.expand_path(File.join(File.dirname(__FILE__), "../../jars"))
@@ -78,14 +78,13 @@ module Acouchi
 
     def build_apk
       Dir.chdir configuration.project_path do
-        system "ant clean"
-        system "ant debug"
+        ProcessLauncher.new("ant", "clean", "debug").start_and_crash_if_process_fails
       end
     end
 
     def install_apk apk_path
-      system "adb uninstall #{configuration.target_package}"
-      system "adb install #{apk_path}"
+      ProcessLauncher.new("adb", "uninstall", configuration.target_package).start
+      ProcessLauncher.new("adb", "install", apk_path).start_and_crash_if_process_fails
     end
   end
 end

data/lib/acouchi/version.rb

@@ -1,3 +1,3 @@
 module Acouchi
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: acouchi
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-03 00:00:00.000000000 Z
+date: 2012-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -56,6 +56,7 @@ files:
 - README.md
 - Rakefile
 - acouchi.gemspec
+- acouchi.jpg
 - examples/AcouchiSample/AndroidManifest.xml
 - examples/AcouchiSample/Rakefile
 - examples/AcouchiSample/acouchi_configuration.json
@@ -77,6 +78,7 @@ files:
 - lib/acouchi/apk_modifier.rb
 - lib/acouchi/configuration.rb
 - lib/acouchi/cucumber.rb
+- lib/acouchi/process_launcher.rb
 - lib/acouchi/project_builder.rb
 - lib/acouchi/solo.rb
 - lib/acouchi/test_runner.rb
@@ -85,7 +87,7 @@ files:
 - src/com/acouchi/Acouchi.java
 - src/com/acouchi/NanoHTTPD.java
 - src/com/acouchi/TestCase.java
-homepage: ''
+homepage: https://github.com/AndrewVos/acouchi
 licenses: []
 post_install_message: 
 rdoc_options: []