caius-culerity 0.1.6 → 0.1.7

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :major: 0
 :minor: 1
-:patch: 6
+:patch: 7

data/culerity.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{culerity}
-  s.version = "0.1.6"
+  s.version = "0.1.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Alexander Lang"]

data/lib/culerity/remote_browser_proxy.rb

@@ -8,7 +8,38 @@ module Culerity
         configure_browser browser_options 
         @remote_object_id = nil
       end
-      
+    end
+    
+    # 
+    # Calls the block until it returns true or +time_to_wait+ is reached.
+    # +time_to_wait+ is 30 seconds by default
+    # 
+    # Returns true upon success
+    # Raises Timeout::Error when +time_to_wait+ is reached.
+    # 
+    def wait_until time_to_wait=30, &block
+      Timeout.timeout(time_to_wait) do
+        until block.call
+          sleep 0.1
+        end
+      end
+      true
+    end
+    
+    # 
+    # Calls the block until it doesn't return true or +time_to_wait+ is reached.
+    # +time_to_wait+ is 30 seconds by default
+    # 
+    # Returns true upon success
+    # Raises Timeout::Error when +time_to_wait+ is reached.
+    # 
+    def wait_while time_to_wait=30, &block
+      Timeout.timeout(time_to_wait) do
+        while block.call
+          sleep 0.1
+        end
+      end
+      true
     end
     
     private

data/lib/culerity/remote_object_proxy.rb

@@ -13,8 +13,10 @@ module Culerity
       @io = io
     end
     
+    #
     # Commonly used to get the HTML id attribute
     # Use `object_id` to get the local objects' id.
+    #
     def id
       send_remote(:id)
     end
@@ -23,6 +25,10 @@ module Culerity
       send_remote(name, *args)
     end
     
+    #
+    # Calls the passed method on the remote object with any arguments specified.
+    # Behaves the same as <code>Object#send</code>.
+    #
     def send_remote(name, *args)
       @io << "[#{remote_object_id}, \"#{name}\", #{args.map{|a| a.inspect}.join(', ')}]\n"
       process_result @io.gets.to_s.strip

data/spec/remote_browser_proxy_spec.rb

@@ -20,4 +20,32 @@ describe Culerity::RemoteBrowserProxy do
     proxy = Culerity::RemoteBrowserProxy.new io, {:browser => :firefox}
   end
   
+  it "should timeout if wait_until takes too long" do
+    io = stub 'io', :gets => "[:return, :okay]", :<< => nil
+    proxy = Culerity::RemoteBrowserProxy.new io
+    lambda {
+      proxy.wait_until(1) { false }
+    }.should raise_error(Timeout::Error)
+  end
+  
+  it "should return successfully when wait_until returns true" do
+    io = stub 'io', :gets => "[:return, :okay]", :<< => nil
+    proxy = Culerity::RemoteBrowserProxy.new io
+    proxy.wait_until(1) { true }.should == true
+  end
+  
+  it "should timeout if wait_while takes too long" do
+    io = stub 'io', :gets => "[:return, :okay]", :<< => nil
+    proxy = Culerity::RemoteBrowserProxy.new io
+    lambda {
+      proxy.wait_while(1) { true }
+    }.should raise_error(Timeout::Error)
+  end
+  
+  it "should return successfully when wait_while returns !true" do
+    io = stub 'io', :gets => "[:return, :okay]", :<< => nil
+    proxy = Culerity::RemoteBrowserProxy.new io
+    proxy.wait_while(1) { false }.should == true
+  end
+  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: caius-culerity
 version: !ruby/object:Gem::Version 
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors: 
 - Alexander Lang