imperiusgem 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6a53a602fbae833352a7407e23500ec942b5e89a
+  data.tar.gz: 644179a412ac57038805331ff9ef009bd80d31af
+SHA512:
+  metadata.gz: c1caef414b943ce3ddba07a8a895045a3c3ef5027a12eac9be81c70f0a91154d312c3c89082ee8c131eab60fd7495c3801ea9cc709c29c9ad8463103d2844cc1
+  data.tar.gz: 4868aea33948b88487eb9e6fc877d7daa5b2efb95dbd5737d4be1bf5ebeedcfd4373cc3d7ab3dc84735021e19a3ed64472b48fa5abdb8cc4727897b7baddd160

data/README.md

@@ -0,0 +1,39 @@
+![funny george image](https://github.com/lookout/ImperiusGeorge/raw/master/libs/george.jpg)
+### ImperiusGem
+#####Remote-control/execute Java on Android phones via Ruby
+
+1. Add this gem to your project (add this to your Gemfile): `gem 'imperiusgem', :git => 'git@github.com:lookout/ImperiusGem.git', :branch => 'master'`
+2. Use `require 'imperiusgem'` in your ruby code.
+3. Connect your android device using adb
+4. Run `adb forward tcp:#1337 tcp:#1337`
+5. Compile [ImperiusGeorge](https://github.com/lookout/ImperiusGeorge) and push the .jar file to `/data/local/tmp/test.jar`
+6. Run `adb shell uiautomator runtest test.jar -c imperiusgeorge.TestServer`
+7. That's it! Try some sample code!
+
+###Simple example
+```
+d = ImperiusGem::Device.new("http://localhost:7120")
+uihelp = ImperiusGem::Thing.new(d,"imperiusgeorge.UIHelp")
+uihelp.click("hello world")
+```
+
+###Fancy unit test example
+```
+class TestTests < Test::Unit::TestCase
+  def test_something
+    UiDevice.getInstance.pressHome
+	`adb shell am start -n com.android.settings/.Settings`
+    UIHelp.find("Sound").click if UIHelp.find("Sound").exists
+    UIHelp.clickIfExactExists("Volumes")
+    UIHelp.clickIfExactExists("OK")
+    UiDevice.getInstance.pressHome
+    @d.clean
+  end
+
+  def self.const_missing(name)
+    @d = ImperiusGem::Device.new("http://localhost:7120") if !@d
+    @d.setPackages(["imperiusgeorge", "com.android.uiautomator.core"])
+    ImperiusGem::Thing.new(@d,name.to_s)
+  end
+end
+```

data/lib/device.rb

@@ -0,0 +1,71 @@
+require 'rubygems'
+require 'typhoeus'
+require 'json'
+require "#{File.dirname(__FILE__)}/thing.rb"
+
+module ImperiusGem
+  class Device
+
+    def initialize(url)
+      @url = url
+    end
+
+    def run(on,method,args=[])
+      res = Device.http(:get,"#{@url}/execute",{:on => on, :method => method, :args => "#{[*args].to_json}"})
+      raise "Error #{res.response_code} (url was #{res.effective_url}).\n#{res.response_body}" if (res.response_code != 200)
+      res = JSON.parse("[#{res.response_body}]").first
+      return (res.to_s.start_with?("hash:")) ? ImperiusGem::Thing.new(self,res) : res
+    end
+
+    def find(name)
+      ImperiusGem::Thing.new(self,name)
+    end
+
+    def version
+      res = Device.http(:get,"#{@url}/version",{})
+      raise "Error #{res.response_code} (url was #{res.effective_url}).\n#{res.response_body}" if (res.response_code != 200)
+      res.response_body
+    end
+
+    def clean
+      res = Device.http(:get,"#{@url}/clean",{})
+      raise "Error #{res.response_code} (url was #{res.effective_url}).\n#{res.response_body}" if (res.response_code != 200)
+    end
+
+    def terminate
+      res = Device.http(:get,"#{@url}/terminate",{})
+      raise "Error #{res.response_code} (url was #{res.effective_url}).\n#{res.response_body}" if (res.response_code != 200)
+    end
+
+    def setPackages(packages={})
+      res = Device.http(:post,"#{@url}/packages",{:packages => packages.to_json})
+      raise "Error #{res.response_code} (url was #{res.effective_url}).\n#{res.response_body}" if (res.response_code != 200)
+    end
+
+    def self.http(method,url,params,body="",headers={})
+      headers.merge!({ :Accept => "application/json" })
+      request = Typhoeus::Request.new( url,
+        :method => method,
+        :body => body,
+        :headers => headers,
+        :params => params #:verbose => Context.verbose
+      )
+      res = request.run
+    end
+
+  end #class
+
+  def self.connect(device_id="")
+    devices=`adb devices`.split( /\r?\n/ )[1..-1].map!{|d| d.split("\t")[0]}
+    device_id = devices[0] if (device_id.to_s == '')
+    port = ((rand()*10000)+1000).to_i
+    puts "using port #{port} with device #{device_id}".green.on_white
+
+    `adb -s #{device_id} forward tcp:#{port} tcp:#{port}`
+    Thread.new { `adb -s #{device_id} shell uiautomator runtest UiAutoServer.jar -c TestServer -e port #{port}` }
+
+    d = Device.new("http://localhost:#{port}")
+    d.setPackages(["com.android.uiautomator.core"])
+    at_exit { d.terminate }
+  end
+end #module

data/lib/imperiusgem.rb

@@ -0,0 +1 @@
+require 'device'

data/lib/thing.rb

@@ -0,0 +1,22 @@
+
+module ImperiusGem
+  class Thing
+
+    def initialize(d,on)
+      @d = d
+      @on = on
+    end
+
+    def on; @on; end;
+
+    def method_missing(meth, *args, &block)
+      method = meth.to_s
+      super if method == "initialize"
+      @d.run(@on,method,fix_args(args))
+    end
+
+    def fix_args(args)
+      args.map { |arg| (arg.is_a? Thing) ? arg.on : arg }
+    end
+  end
+end #module

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: imperiusgem
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tim O'Brien
+- Rustin Manafian
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-20 00:00:00.000000000 Z
+dependencies: []
+description: Control all of java and UI-Automator from ruby. See github homepage for
+  more info!
+email:
+- timo@t413.com
+- rmanafian@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/imperiusgem.rb
+- lib/device.rb
+- lib/thing.rb
+- README.md
+homepage: https://github.com/lookout/ImperiusGem
+licenses:
+- AGPL
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0.rc.2
+signing_key: 
+specification_version: 4
+summary: Control all of java and UI-Automator from ruby
+test_files: []