chrome_remote 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d0252fdb7d96afe43850928ba57f69cdc66e373
-  data.tar.gz: 2500d1a4b85a0e77ee4b50db79011273b4e338dc
+  metadata.gz: c2aa46eb656817f1c7cef04b5b604bbd7da4aaaa
+  data.tar.gz: fbad3f461b01b9bde4f6b90dcf46bc23fa18aa6b
 SHA512:
-  metadata.gz: 86d013ba0f962afb6cf79847bd135f9ed72b1017ee0995bff299aa575f15d600d3c74f1070a5f7ad7fa99a38d051860da2cceede9813c795fb721b268b2a82b0
-  data.tar.gz: 20355a53f1b7dcf3f08a84fd3e111a3dc6015e3e5657dbe74f24c813cb6ca248785a40e7c053bc0848543e86f4c7606cbc1358bb3a512cf96a664e43d93add27
+  metadata.gz: 5bce9f49de0bb134ff2cb0ed38a36bf1d4e2241a73682e1cf082aee2437e7c2d1842cbb7be3c66471e1bec6efa0dd23f32f1c1a0edd7fd2ddd6063c710200144
+  data.tar.gz: ce718db0bb534d36a1cc6377ae56150d70ce55f001c50114a1885e1dc4a5f0b16a792dd9e44e061f9726d634b519f6f015fece1f200d84315d789826020a35e0

data/README.md

@@ -1,6 +1,6 @@
 # ChromeRemote
 
-ChromeRemote is a client implementation of the [Chrome DevTools Protocol][1] in Ruby. It lets you instrument, inspect, debug and profile instances of Chrome/Chromium based browsers from your Ruby code.
+ChromeRemote is a client implementation of the [Chrome DevTools Protocol][1] in Ruby. It lets you remotely control, instrument, inspect, debug and profile instances of Chrome/Chromium based browsers from your Ruby code.
 
 [1]: https://chromedevtools.github.io/devtools-protocol/
 
@@ -90,7 +90,7 @@ To start with, you need an instance of the `ChromeRemote` class.
 
 ```ruby
 chrome = ChromeRemote.client host: 'localhost', # optional, default: localhost
-                             port: 9992         # optional, default: 9992
+                             port: 9222         # optional, default: 9222
 ```
 
 Now, to send commands, ChromeRemote provides the `ChromeRemote#send_cmd` method. For example, this is how you make Chrome navigate to a url by sending the [Page.navigate][7] command:
@@ -129,6 +129,17 @@ chrome.wait_for "Page.loadEventFired"
 # => {:timestamp=>34}
 ```
 
+You can also use `wait_for` with a block to implement a custom matcher on the event names and params you're waiting for:
+
+```ruby
+chrome = ChromeRemote.client
+chrome.send_cmd "Page.navigate", url: "https://github.com"
+
+client.wait_for do |event_name, event_params|
+  event_name == "Page.lifecycleEvent" && event_params["name"] == "load"
+end
+```
+
 In certain occasions, after you have subscribed to one or several events, you may just want to process messages indefinitely, and let the event handlers process any event that may happen until you kill your script. For those cases, ChromeRemote provides the `ChromeRemote#listen` method:
 
 ```ruby

data/lib/chrome_remote/client.rb

@@ -6,14 +6,14 @@ module ChromeRemote
 
     def initialize(ws_url)
       @ws = WebSocketClient.new(ws_url)
-      @handlers = Hash.new {|hash, key| hash[key] = [] }
+      @handlers = Hash.new { |hash, key| hash[key] = [] }
     end
-  
-    def send_cmd(command, params = {})  
+
+    def send_cmd(command, params = {})
       msg_id = generate_unique_id
-      
+
       ws.send_msg({method: command, params: params, id: msg_id}.to_json)
-      
+
       msg = read_until { |msg| msg["id"] == msg_id }
       msg["result"]
     end
@@ -30,13 +30,17 @@ module ChromeRemote
       read_until { false }
     end
 
-    def wait_for(event_name)
-      msg = read_until { |msg| msg["method"] == event_name }
+    def wait_for(event_name=nil)
+      if event_name
+        msg = read_until { |msg| msg["method"] == event_name }
+      elsif block_given?
+        msg = read_until { |msg| yield(msg["method"], msg["params"]) }
+      end
       msg["params"]
     end
-  
+
     private
-  
+
     def generate_unique_id
       @last_id ||= 0
       @last_id += 1
@@ -62,4 +66,4 @@ module ChromeRemote
       end
     end
   end
-end
+end

data/lib/chrome_remote/version.rb

@@ -1,3 +1,3 @@
 module ChromeRemote
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chrome_remote
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Luismi Cavalle
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-14 00:00:00.000000000 Z
+date: 2018-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: websocket-driver