ADB 0.1 → 0.2

data/ChangeLog

@@ -1,4 +1,10 @@
-=== 0.1 / 2012-8-10
+=== Release 0.2 / 2012-8-18
+* Enhancements
+  * Added forward method
+  * Added shell method
+  * Added helper method to format dates for Android
+
+=== Release 0.1 / 2012-8-10
 Initial release of the gem.  It has support for the following commands
 * start-server => start_server
 * kill-server => stop_server

data/features/ADB.feature

@@ -22,3 +22,14 @@ Feature: Using the ADB module
     Given the adb server is started
     And I am connected to the local device
     Then I should be able to uninstall the sample application
+
+  Scenario: Use shell to update the system date
+    Given the adb server is started
+    And I am connected to the local device
+    When I change the devices date and time to 08/10/2012 11:25
+    Then the device time should be Aug 10 11:25:00 EDT 2012
+
+  Scenario: Forwarding ports
+    Given the adb server is started
+    And I am connected to the local device
+    Then I should be able to forward "tcp:7777" to "tcp:5555"

data/features/step_definitions/adb_steps.rb

@@ -32,3 +32,18 @@ Then /^I should be able to uninstall the sample application$/ do
   uninstall 'com.example.android.apis', {:serial => sn}
   last_stdout.should include 'Success'
 end
+
+When /^I change the devices date and time to (.*?)$/ do |date_arg|
+  sn = devices[0]
+  date = DateTime.strptime(date_arg, '%m/%d/%C%y %I:%M')
+  shell("date -s #{format_date_for_adb(date)}", {:serial => sn}, 60)
+end
+
+Then /^the device time should be Aug (.*?)$/ do |date_str|
+  last_stdout.should include date_str
+end
+
+Then /^I should be able to forward "(.*?)" to "(.*?)"$/ do |source, target|
+  sn = devices[0]
+  forward(source, target, {:serial => sn})
+end

data/lib/ADB.rb

@@ -110,6 +110,42 @@ module ADB
     raise ADBError, "Could not uninstall #{package}" unless stdout_contains "Success"
   end
 
+  #
+  # execute shell command
+  #
+  # @param [String] command to be passed to the shell command
+  # @param [Hash] which device to wait for.  Valid keys are :device,
+  # :emulator, and :serial.
+  # @param timeout value for the command to complete.  Defaults to 30
+  # seconds.
+  #
+  def shell(command, target={}, timeout=30)
+    execute_adb_with(timeout, "#{which_one(target)} wait-for-device shell #{command}")
+  end
+
+  #
+  # format a date for adb shell date command
+  #
+  # @param date to format.  Defaults current date
+  #
+  def format_date_for_adb(date=Date.new) 
+    date.strftime("%C%y%m%d.%H%M00")
+  end
+
+  #
+  # setup port forwarding
+  #
+  # @param the source protocol:port
+  # @param the destination protocol:port
+  # @param [Hash] which device to wait for.  Valid keys are :device,
+  # :emulator, and :serial.
+  # @param timeout value for the command to complete.  Defaults to 30
+  # seconds.
+  #
+  def forward(source, destination, target={}, timeout=30)
+    execute_adb_with(timeout, "#{which_one(target)} forward #{source} #{destination}")
+  end
+
   private
 
   def execute_adb_with(timeout, arguments)

data/lib/ADB/version.rb

@@ -1,3 +1,3 @@
 module ADB
-  VERSION = "0.1"
+  VERSION = "0.2"
 end

data/spec/lib/ADB_spec.rb

@@ -29,6 +29,23 @@ describe ADB do
     ADB.devices
   end
 
+  context "when executing a shell command" do
+    it "should be able to check the device date and time" do
+      should_call_adb_with('wait-for-device', 'shell', 'date')
+      ADB.shell('date')
+    end
+  end
+
+  it "should be able to build an date formatted for adb shell date command" do
+    date = DateTime.strptime('04/23/2012  13:24', '%m/%d/%C%y %H:%M')
+    ADB.format_date_for_adb(date).should eq "20120423.132400"
+  end
+
+  it "should setup port forwarding" do
+    should_call_adb_with('forward', 'src', 'dest')
+    ADB.forward('src', 'dest')
+  end
+  
   context "when connecting to a device" do
     before(:each) do
       ADB.should_receive(:last_stdout).and_return("connected to localhost")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ADB
 version: !ruby/object:Gem::Version
-  version: '0.1'
+  version: '0.2'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-11 00:00:00.000000000 Z
+date: 2012-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: childprocess
@@ -100,7 +100,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1303897695555104367
+      hash: -1607274235838869715
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -109,7 +109,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1303897695555104367
+      hash: -1607274235838869715
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24