puppeteer-ruby 0.31.0 → 0.31.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d7c0b6410629e9119a7f298cc3cecdd6e5640a18fdb944dc53e1b47b4c940b0
-  data.tar.gz: 4f9bf8f3e4a21a22cb89fcff1927e420bff86cbdec4a3084dbec32669530f03e
+  metadata.gz: 4c703eeb4952a1a5102ce3616daee3333747f37d790ad65efb8c1f95ac603f8b
+  data.tar.gz: 355cf71106ffce2576aea66680ff5fbb7f35b263da8abce5dd7056ff8fdca019
 SHA512:
-  metadata.gz: a13874bd8b09ea00a33516f1237e3a91fcfa6b18795af251f3568dc421f026821325c2e89d2e2ee8e8211b03ed1700d8ba15c3a2d01e733ffaa378a1f97b02bc
-  data.tar.gz: 3920af1f121788b36e68ee85194da1fe92335abed949610f726d90bd368d492502da10d935087bbadb386eab13f41f259263dd7777eb42d8988fecc3e1fa83da
+  metadata.gz: bb2f9d778d6f99c510d78025dba4f39a22ce2cdc8bdb278b6a8911e3498ee94268237fe929a6a0473a7d94a6f8f3839ad43e76a2c2825a54eb9cbc824078a980
+  data.tar.gz: 4d40e88f6ec1476854673a3a49c8598e24c5a0bd1de65c4ee09e87ef85773d96b12b415e1f28352b096d3e0fa95ae1267c81fa8ca34f30deaa3fe4308bbd45e0

data/CHANGELOG.md

@@ -1,7 +1,13 @@
-### master [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.0...master)]
+### master [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.1...master)]
 
 * xxx
 
+### 0.31.1 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.31.0...0.31.1)]
+
+Bugfix:
+
+* Fix `Page#pdf` to work on Windows.
+
 ### 0.31.0 [[diff](https://github.com/YusukeIwaki/puppeteer-ruby/compare/0.30.0...0.31.0)]
 
 New features:

data/README.md

@@ -6,7 +6,7 @@ A Ruby port of [puppeteer](https://pptr.dev/).
 
 ![logo](puppeteer-ruby.png)
 
-REMARK: This Gem covers just a part of Puppeteer APIs. Feedbacks and feature requests are welcome :)
+REMARK: This Gem covers just a part of Puppeteer APIs. See [API Coverage list](./docs/api_coverage.md) for detail. Feedbacks and feature requests are welcome :)
 
 ## Getting Started
 
@@ -29,6 +29,8 @@ Or install it yourself as:
 ### Capture a site
 
 ```ruby
+require 'puppeteer'
+
 Puppeteer.launch(headless: false) do |browser|
   page = browser.pages.first || browser.new_page
   page.goto("https://github.com/YusukeIwaki")
@@ -66,6 +68,8 @@ end
 ### Evaluate JavaScript
 
 ```ruby
+require 'puppeteer'
+
 Puppeteer.launch do |browser|
   page = browser.pages.last || browser.new_page
   page.goto 'https://github.com/YusukeIwaki'

data/docs/api_coverage.md

@@ -0,0 +1,359 @@
+# API coverages
+- Puppeteer version: v8.0.0
+- puppeteer-ruby version: 0.31.1
+
+## Puppeteer
+
+* ~~clearCustomQueryHandlers~~
+* connect
+* ~~createBrowserFetcher~~
+* ~~customQueryHandlerNames~~
+* defaultArgs => `#default_args`
+* devices
+* ~~errors~~
+* executablePath => `#executable_path`
+* launch
+* ~~networkConditions~~
+* product
+* ~~registerCustomQueryHandler~~
+* ~~unregisterCustomQueryHandler~~
+
+## ~~BrowserFetcher~~
+
+* ~~canDownload~~
+* ~~download~~
+* ~~host~~
+* ~~localRevisions~~
+* ~~platform~~
+* ~~product~~
+* ~~remove~~
+* ~~revisionInfo~~
+
+## Browser
+
+* browserContexts => `#browser_contexts`
+* close
+* createIncognitoBrowserContext => `#create_incognito_browser_context`
+* defaultBrowserContext => `#default_browser_context`
+* disconnect
+* isConnected => `#connected?`
+* newPage => `#new_page`
+* pages
+* process
+* target
+* targets
+* userAgent => `#user_agent`
+* version
+* waitForTarget => `#wait_for_target`
+* wsEndpoint => `#ws_endpoint`
+
+## BrowserContext
+
+* browser
+* clearPermissionOverrides => `#clear_permission_overrides`
+* close
+* isIncognito => `#incognito?`
+* newPage => `#new_page`
+* overridePermissions => `#override_permissions`
+* pages
+* targets
+* waitForTarget => `#wait_for_target`
+
+## Page
+
+* $ => `#query_selector`
+* $$ => `#query_selector_all`
+* $$eval => `#eval_on_selector_all`
+* $eval => `#eval_on_selector`
+* $x => `#Sx`
+* accessibility
+* addScriptTag => `#add_script_tag`
+* addStyleTag => `#add_style_tag`
+* authenticate
+* ~~bringToFront~~
+* browser
+* browserContext => `#browser_context`
+* click
+* close
+* content
+* cookies
+* coverage
+* deleteCookie => `#delete_cookie`
+* emulate
+* emulateIdleState => `#emulate_idle_state`
+* ~~emulateMediaFeatures~~
+* emulateMediaType => `#emulate_media_type`
+* ~~emulateNetworkConditions~~
+* emulateTimezone => `#emulate_timezone`
+* ~~emulateVisionDeficiency~~
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* evaluateOnNewDocument => `#evaluate_on_new_document`
+* ~~exposeFunction~~
+* focus
+* frames
+* goBack => `#go_back`
+* goForward => `#go_forward`
+* goto
+* hover
+* isClosed => `#closed?`
+* isJavaScriptEnabled => `#javascript_enabled?`
+* keyboard
+* mainFrame => `#main_frame`
+* ~~metrics~~
+* mouse
+* pdf
+* queryObjects => `#query_objects`
+* reload
+* screenshot
+* select
+* setBypassCSP => `#bypass_csp=`
+* setCacheEnabled => `#cache_enabled=`
+* setContent => `#content=`
+* setCookie => `#set_cookie`
+* setDefaultNavigationTimeout => `#default_navigation_timeout=`
+* setDefaultTimeout => `#default_timeout=`
+* setExtraHTTPHeaders => `#extra_http_headers=`
+* setGeolocation => `#geolocation=`
+* setJavaScriptEnabled => `#javascript_enabled=`
+* setOfflineMode => `#offline_mode=`
+* setRequestInterception => `#request_interception=`
+* setUserAgent => `#user_agent=`
+* setViewport => `#viewport=`
+* tap
+* target
+* title
+* ~~touchscreen~~
+* ~~tracing~~
+* type => `#type_text`
+* url
+* viewport
+* ~~waitFor~~
+* waitForFileChooser => `#wait_for_file_chooser`
+* waitForFunction => `#wait_for_function`
+* waitForNavigation => `#async_wait_for_navigation`
+* waitForRequest => `#async_wait_for_request`
+* waitForResponse => `#async_wait_for_response`
+* waitForSelector => `#wait_for_selector`
+* waitForTimeout => `#wait_for_timeout`
+* waitForXPath => `#wait_for_xpath`
+* workers
+
+## ~~WebWorker~~
+
+* ~~evaluate~~
+* ~~evaluateHandle~~
+* ~~executionContext~~
+* ~~url~~
+
+## ~~Accessibility~~
+
+* ~~snapshot~~
+
+## Keyboard
+
+* down
+* press
+* sendCharacter => `#send_character`
+* type => `#type_text`
+* up
+
+## Mouse
+
+* click
+* down
+* move
+* up
+* wheel
+
+## ~~Touchscreen~~
+
+* ~~tap~~
+
+## ~~Tracing~~
+
+* ~~start~~
+* ~~stop~~
+
+## FileChooser
+
+* accept
+* cancel
+* isMultiple => `#multiple?`
+
+## Dialog
+
+* accept
+* defaultValue => `#default_value`
+* dismiss
+* message
+* type
+
+## ConsoleMessage
+
+* args
+* location
+* ~~stackTrace~~
+* text
+* ~~type~~
+
+## Frame
+
+* $ => `#query_selector`
+* $$ => `#query_selector_all`
+* $$eval => `#eval_on_selector_all`
+* $eval => `#eval_on_selector`
+* $x => `#Sx`
+* addScriptTag => `#add_script_tag`
+* addStyleTag => `#add_style_tag`
+* childFrames => `#child_frames`
+* click
+* content
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* executionContext => `#execution_context`
+* focus
+* goto
+* hover
+* isDetached => `#detached?`
+* name
+* parentFrame => `#parent_frame`
+* select
+* setContent => `#set_content`
+* tap
+* title
+* type => `#type_text`
+* url
+* ~~waitFor~~
+* waitForFunction => `#wait_for_function`
+* waitForNavigation => `#async_wait_for_navigation`
+* waitForSelector => `#wait_for_selector`
+* waitForTimeout => `#wait_for_timeout`
+* waitForXPath => `#wait_for_xpath`
+
+## ExecutionContext
+
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* frame
+* ~~queryObjects~~
+
+## JSHandle
+
+* asElement => `#as_element`
+* dispose
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* executionContext => `#execution_context`
+* getProperties => `#properties`
+* getProperty => `#[]`
+* jsonValue => `#json_value`
+
+## ElementHandle
+
+* $ => `#query_selector`
+* $$ => `#query_selector_all`
+* $$eval => `#eval_on_selector_all`
+* $eval => `#eval_on_selector`
+* $x => `#Sx`
+* asElement => `#as_element`
+* boundingBox => `#bounding_box`
+* boxModel => `#box_model`
+* click
+* contentFrame => `#content_frame`
+* dispose
+* evaluate
+* evaluateHandle => `#evaluate_handle`
+* executionContext => `#execution_context`
+* focus
+* getProperties => `#properties`
+* getProperty => `#[]`
+* hover
+* isIntersectingViewport => `#intersecting_viewport?`
+* jsonValue => `#json_value`
+* press
+* screenshot
+* select
+* tap
+* ~~toString~~
+* type => `#type_text`
+* uploadFile => `#upload_file`
+
+## ~~HTTPRequest~~
+
+* ~~abort~~
+* ~~continue~~
+* ~~failure~~
+* ~~frame~~
+* ~~headers~~
+* ~~isNavigationRequest~~
+* ~~method~~
+* ~~postData~~
+* ~~redirectChain~~
+* ~~resourceType~~
+* ~~respond~~
+* ~~response~~
+* ~~url~~
+
+## ~~HTTPResponse~~
+
+* ~~buffer~~
+* ~~frame~~
+* ~~fromCache~~
+* ~~fromServiceWorker~~
+* ~~headers~~
+* ~~json~~
+* ~~ok~~
+* ~~remoteAddress~~
+* ~~request~~
+* ~~securityDetails~~
+* ~~status~~
+* ~~statusText~~
+* ~~text~~
+* ~~url~~
+
+## ~~SecurityDetails~~
+
+* ~~issuer~~
+* ~~protocol~~
+* ~~subjectAlternativeNames~~
+* ~~subjectName~~
+* ~~validFrom~~
+* ~~validTo~~
+
+## Target
+
+* browser
+* browserContext => `#browser_context`
+* createCDPSession => `#create_cdp_session`
+* opener
+* page
+* type
+* url
+* ~~worker~~
+
+## CDPSession
+
+* detach
+* send
+
+## ~~Coverage~~
+
+* ~~startCSSCoverage~~
+* ~~startJSCoverage~~
+* ~~stopCSSCoverage~~
+* ~~stopJSCoverage~~
+
+## TimeoutError
+
+
+## ~~EventEmitter~~
+
+* ~~addListener~~
+* ~~emit~~
+* ~~listenerCount~~
+* ~~off~~
+* ~~on~~
+* ~~once~~
+* ~~removeAllListeners~~
+* ~~removeListener~~

data/lib/puppeteer.rb

@@ -1,6 +1,6 @@
 require 'concurrent'
 
-class Puppeteer; end
+module Puppeteer; end
 
 require 'puppeteer/env'
 
@@ -43,6 +43,7 @@ require 'puppeteer/lifecycle_watcher'
 require 'puppeteer/mouse'
 require 'puppeteer/network_manager'
 require 'puppeteer/page'
+require 'puppeteer/puppeteer'
 require 'puppeteer/query_handler_manager'
 require 'puppeteer/remote_object'
 require 'puppeteer/request'
@@ -59,9 +60,9 @@ require 'puppeteer/web_socket_transport'
 require 'puppeteer/element_handle'
 
 # ref: https://github.com/puppeteer/puppeteer/blob/master/lib/Puppeteer.js
-class Puppeteer
-  def self.method_missing(method, *args, **kwargs, &block)
-    @puppeteer ||= Puppeteer.new(
+module Puppeteer
+  module_function def method_missing(method, *args, **kwargs, &block)
+    @puppeteer ||= ::Puppeteer::Puppeteer.new(
       project_root: __dir__,
       preferred_revision: '706915',
       is_puppeteer_core: true,
@@ -73,167 +74,4 @@ class Puppeteer
       @puppeteer.public_send(method, *args, **kwargs, &block)
     end
   end
-
-  # @param project_root [String]
-  # @param prefereed_revision [String]
-  # @param is_puppeteer_core [String]
-  def initialize(project_root:, preferred_revision:, is_puppeteer_core:)
-    @project_root = project_root
-    @preferred_revision = preferred_revision
-    @is_puppeteer_core = is_puppeteer_core
-  end
-
-  # @param product [String]
-  # @param executable_path [String]
-  # @param ignore_default_args [Array<String>|nil]
-  # @param handle_SIGINT [Boolean]
-  # @param handle_SIGTERM [Boolean]
-  # @param handle_SIGHUP [Boolean]
-  # @param timeout [Integer]
-  # @param dumpio [Boolean]
-  # @param env [Hash]
-  # @param pipe [Boolean]
-  # @param args [Array<String>]
-  # @param user_data_dir [String]
-  # @param devtools [Boolean]
-  # @param headless [Boolean]
-  # @param ignore_https_errors [Boolean]
-  # @param default_viewport [Puppeteer::Viewport|nil]
-  # @param slow_mo [Integer]
-  # @return [Puppeteer::Browser]
-  def launch(
-    product: nil,
-    executable_path: nil,
-    ignore_default_args: nil,
-    handle_SIGINT: nil,
-    handle_SIGTERM: nil,
-    handle_SIGHUP: nil,
-    timeout: nil,
-    dumpio: nil,
-    env: nil,
-    pipe: nil,
-    args: nil,
-    user_data_dir: nil,
-    devtools: nil,
-    headless: nil,
-    ignore_https_errors: nil,
-    default_viewport: nil,
-    slow_mo: nil
-  )
-    options = {
-      executable_path: executable_path,
-      ignore_default_args: ignore_default_args,
-      handle_SIGINT: handle_SIGINT,
-      handle_SIGTERM: handle_SIGTERM,
-      handle_SIGHUP: handle_SIGHUP,
-      timeout: timeout,
-      dumpio: dumpio,
-      env: env,
-      pipe: pipe,
-      args: args,
-      user_data_dir: user_data_dir,
-      devtools: devtools,
-      headless: headless,
-      ignore_https_errors: ignore_https_errors,
-      default_viewport: default_viewport,
-      slow_mo: slow_mo,
-    }
-
-    @product_name ||= product
-    browser = launcher.launch(options)
-    if block_given?
-      begin
-        yield(browser)
-      ensure
-        browser.close
-      end
-    else
-      browser
-    end
-  end
-
-  # @param browser_ws_endpoint [String]
-  # @param browser_url [String]
-  # @param transport [Puppeteer::WebSocketTransport]
-  # @param ignore_https_errors [Boolean]
-  # @param default_viewport [Puppeteer::Viewport|nil]
-  # @param slow_mo [Integer]
-  # @return [Puppeteer::Browser]
-  def connect(
-    browser_ws_endpoint: nil,
-    browser_url: nil,
-    transport: nil,
-    ignore_https_errors: nil,
-    default_viewport: nil,
-    slow_mo: nil
-  )
-    options = {
-      browser_ws_endpoint: browser_ws_endpoint,
-      browser_url: browser_url,
-      transport: transport,
-      ignore_https_errors: ignore_https_errors,
-      default_viewport: default_viewport,
-      slow_mo: slow_mo,
-    }.compact
-    browser = launcher.connect(options)
-    if block_given?
-      begin
-        yield(browser)
-      ensure
-        browser.disconnect
-      end
-    else
-      browser
-    end
-  end
-
-  # @return [String]
-  def executable_path
-    launcher.executable_path
-  end
-
-  private def launcher
-    @launcher ||= Puppeteer::Launcher.new(
-      project_root: @project_root,
-      preferred_revision: @preferred_revision,
-      is_puppeteer_core: @is_puppeteer_core,
-      product: @product_name,
-    )
-  end
-
-  # @return [String]
-  def product
-    launcher.product
-  end
-
-  # @return [Puppeteer::Devices]
-  def devices
-    Puppeteer::Devices
-  end
-
-  # # @return {Object}
-  # def errors
-  #   # ???
-  # end
-
-  # @param args [Array<String>]
-  # @param user_data_dir [String]
-  # @param devtools [Boolean]
-  # @param headless [Boolean]
-  # @return [Array<String>]
-  def default_args(args: nil, user_data_dir: nil, devtools: nil, headless: nil)
-    options = {
-      args: args,
-      user_data_dir: user_data_dir,
-      devtools: devtools,
-      headless: headless,
-    }.compact
-    launcher.default_args(options)
-  end
-
-  # @param {!BrowserFetcher.Options=} options
-  # @return {!BrowserFetcher}
-  def createBrowserFetcher(options = {})
-    BrowserFetcher.new(@project_root, options)
-  end
 end

data/lib/puppeteer/connection.rb

@@ -273,6 +273,16 @@ class Puppeteer::Connection
   def create_session(target_info)
     result = send_message('Target.attachToTarget', targetId: target_info.target_id, flatten: true)
     session_id = result['sessionId']
-    @sessions[session_id]
+
+    # Target.attachedToTarget is often notified after the result of Target.attachToTarget.
+    # D, [2020-04-04T23:04:30.736311 #91875] DEBUG -- : RECV << {"id"=>2, "result"=>{"sessionId"=>"DA002F8A95B04710502CB40D8430B95A"}}
+    # D, [2020-04-04T23:04:30.736649 #91875] DEBUG -- : RECV << {"method"=>"Target.attachedToTarget", "params"=>{"sessionId"=>"DA002F8A95B04710502CB40D8430B95A", "targetInfo"=>{"targetId"=>"EBAB949A7DE63F12CB94268AD3A9976B", "type"=>"page", "title"=>"about:blank", "url"=>"about:blank", "attached"=>true, "browserContextId"=>"46D23767E9B79DD9E589101121F6DADD"}, "waitingForDebugger"=>false}}
+    # So we have to wait for "Target.attachedToTarget" a bit.
+    20.times do
+      if @sessions[session_id]
+        return @sessions[session_id]
+      end
+      sleep 0.1
+    end
   end
 end

data/lib/puppeteer/env.rb

@@ -20,8 +20,8 @@ class Puppeteer::Env
   end
 end
 
-class Puppeteer
-  def self.env
-    Puppeteer::Env.new
+module Puppeteer
+  module_function def env
+    ::Puppeteer::Env.new
   end
 end

data/lib/puppeteer/page.rb

@@ -202,6 +202,7 @@ class Puppeteer::Page
   end
 
   attr_reader :javascript_enabled, :target
+  alias_method :javascript_enabled?, :javascript_enabled
 
   def browser
     @target.browser
@@ -988,7 +989,7 @@ class Puppeteer::Page
 
     def read
       out = StringIO.new
-      File.open(@path, 'w') do |file|
+      File.open(@path, 'wb') do |file|
         eof = false
         until eof
           response = @client.send_message('IO.read', handle: @handle)

data/lib/puppeteer/puppeteer.rb

@@ -0,0 +1,164 @@
+class Puppeteer::Puppeteer
+  # @param project_root [String]
+  # @param prefereed_revision [String]
+  # @param is_puppeteer_core [String]
+  def initialize(project_root:, preferred_revision:, is_puppeteer_core:)
+    @project_root = project_root
+    @preferred_revision = preferred_revision
+    @is_puppeteer_core = is_puppeteer_core
+  end
+
+  # @param product [String]
+  # @param executable_path [String]
+  # @param ignore_default_args [Array<String>|nil]
+  # @param handle_SIGINT [Boolean]
+  # @param handle_SIGTERM [Boolean]
+  # @param handle_SIGHUP [Boolean]
+  # @param timeout [Integer]
+  # @param dumpio [Boolean]
+  # @param env [Hash]
+  # @param pipe [Boolean]
+  # @param args [Array<String>]
+  # @param user_data_dir [String]
+  # @param devtools [Boolean]
+  # @param headless [Boolean]
+  # @param ignore_https_errors [Boolean]
+  # @param default_viewport [Puppeteer::Viewport|nil]
+  # @param slow_mo [Integer]
+  # @return [Puppeteer::Browser]
+  def launch(
+    product: nil,
+    executable_path: nil,
+    ignore_default_args: nil,
+    handle_SIGINT: nil,
+    handle_SIGTERM: nil,
+    handle_SIGHUP: nil,
+    timeout: nil,
+    dumpio: nil,
+    env: nil,
+    pipe: nil,
+    args: nil,
+    user_data_dir: nil,
+    devtools: nil,
+    headless: nil,
+    ignore_https_errors: nil,
+    default_viewport: nil,
+    slow_mo: nil
+  )
+    options = {
+      executable_path: executable_path,
+      ignore_default_args: ignore_default_args,
+      handle_SIGINT: handle_SIGINT,
+      handle_SIGTERM: handle_SIGTERM,
+      handle_SIGHUP: handle_SIGHUP,
+      timeout: timeout,
+      dumpio: dumpio,
+      env: env,
+      pipe: pipe,
+      args: args,
+      user_data_dir: user_data_dir,
+      devtools: devtools,
+      headless: headless,
+      ignore_https_errors: ignore_https_errors,
+      default_viewport: default_viewport,
+      slow_mo: slow_mo,
+    }
+
+    @product_name ||= product
+    browser = launcher.launch(options)
+    if block_given?
+      begin
+        yield(browser)
+      ensure
+        browser.close
+      end
+    else
+      browser
+    end
+  end
+
+  # @param browser_ws_endpoint [String]
+  # @param browser_url [String]
+  # @param transport [Puppeteer::WebSocketTransport]
+  # @param ignore_https_errors [Boolean]
+  # @param default_viewport [Puppeteer::Viewport|nil]
+  # @param slow_mo [Integer]
+  # @return [Puppeteer::Browser]
+  def connect(
+    browser_ws_endpoint: nil,
+    browser_url: nil,
+    transport: nil,
+    ignore_https_errors: nil,
+    default_viewport: nil,
+    slow_mo: nil
+  )
+    options = {
+      browser_ws_endpoint: browser_ws_endpoint,
+      browser_url: browser_url,
+      transport: transport,
+      ignore_https_errors: ignore_https_errors,
+      default_viewport: default_viewport,
+      slow_mo: slow_mo,
+    }.compact
+    browser = launcher.connect(options)
+    if block_given?
+      begin
+        yield(browser)
+      ensure
+        browser.disconnect
+      end
+    else
+      browser
+    end
+  end
+
+  # @return [String]
+  def executable_path
+    launcher.executable_path
+  end
+
+  private def launcher
+    @launcher ||= Puppeteer::Launcher.new(
+      project_root: @project_root,
+      preferred_revision: @preferred_revision,
+      is_puppeteer_core: @is_puppeteer_core,
+      product: @product_name,
+    )
+  end
+
+  # @return [String]
+  def product
+    launcher.product
+  end
+
+  # @return [Puppeteer::Devices]
+  def devices
+    Puppeteer::Devices
+  end
+
+  # # @return {Object}
+  # def errors
+  #   # ???
+  # end
+
+  # @param args [Array<String>]
+  # @param user_data_dir [String]
+  # @param devtools [Boolean]
+  # @param headless [Boolean]
+  # @return [Array<String>]
+  def default_args(args: nil, user_data_dir: nil, devtools: nil, headless: nil)
+    options = {
+      args: args,
+      user_data_dir: user_data_dir,
+      devtools: devtools,
+      headless: headless,
+    }.compact
+    launcher.default_args(options)
+  end
+
+  # @param {!BrowserFetcher.Options=} options
+  # @return {!BrowserFetcher}
+  def createBrowserFetcher(options = {})
+    BrowserFetcher.new(@project_root, options)
+  end
+end

data/lib/puppeteer/version.rb

@@ -1,3 +1,3 @@
-class Puppeteer
-  VERSION = '0.31.0'
+module Puppeteer
+  VERSION = '0.31.1'
 end

data/puppeteer-ruby.gemspec

@@ -12,7 +12,9 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/YusukeIwaki/puppeteer-ruby'
 
   spec.files         = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{^(test|spec|features)/}) || f.include?(".git") || f.include?(".circleci") || f.start_with?("development/")
+    end
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
@@ -23,6 +25,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'mime-types', '>= 3.0'
   spec.add_development_dependency 'bundler', '~> 2.2.3'
   spec.add_development_dependency 'chunky_png'
+  spec.add_development_dependency 'dry-inflector'
   spec.add_development_dependency 'pry-byebug'
   spec.add_development_dependency 'rake', '~> 13.0.3'
   spec.add_development_dependency 'rspec', '~> 3.10.0 '

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puppeteer-ruby
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.31.1
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-03-18 00:00:00.000000000 Z
+date: 2021-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -80,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-inflector
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -213,17 +227,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".circleci/config.yml"
-- ".github/ISSUE_TEMPLATE/bug_report.md"
-- ".github/ISSUE_TEMPLATE/feature_request.md"
-- ".github/stale.yml"
-- ".github/workflows/docs.yml"
-- ".github/workflows/reviewdog.yml"
-- ".github/workflows/windows_check.yml"
-- ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - Dockerfile
 - Gemfile
@@ -232,6 +237,7 @@ files:
 - bin/console
 - bin/setup
 - docker-compose.yml
+- docs/api_coverage.md
 - lib/puppeteer.rb
 - lib/puppeteer/aria_query_handler.rb
 - lib/puppeteer/browser.rb
@@ -283,6 +289,7 @@ files:
 - lib/puppeteer/page/pdf_options.rb
 - lib/puppeteer/page/screenshot_options.rb
 - lib/puppeteer/page/screenshot_task_queue.rb
+- lib/puppeteer/puppeteer.rb
 - lib/puppeteer/query_handler_manager.rb
 - lib/puppeteer/remote_object.rb
 - lib/puppeteer/request.rb

data/.circleci/config.yml

@@ -1,92 +0,0 @@
-version: 2.1
-
-rspec_chrome_job: &rspec_chrome_job
-  steps:
-    - checkout
-    - run:
-        command: gem install bundler:2.2.3 && bundle install
-    - run:
-        name: rspec
-        command: |
-          DEBUG=1 bundle exec rspec --profile 10 \
-            --format RspecJunitFormatter \
-            --out test_results/rspec.xml \
-            --format documentation
-
-jobs:
-  rspec_chrome_ruby2_6:
-    docker:
-      - image: circleci/ruby:2.6.6-buster-node-browsers
-    <<: *rspec_chrome_job
-
-  rspec_chrome_ruby2_7:
-    docker:
-      - image: circleci/ruby:2.7.2-buster-node-browsers
-    <<: *rspec_chrome_job
-
-  rspec_chrome_ruby3_0:
-    docker:
-      - image: circleci/ruby:3.0.0-buster-node-browsers
-    <<: *rspec_chrome_job
-
-  rspec_firefox:
-    docker:
-      - image: circleci/ruby:2.7.2-buster-node-browsers
-    steps:
-      - checkout
-      - run:
-          command: gem install bundler:2.2.3 && bundle install
-      - run:
-          name: install firefox-nightly
-          command: |
-            wget -O nightly.tar.bz2 "https://download.mozilla.org/?product=firefox-nightly-latest-ssl&os=linux64&lang=en-US"
-            tar xf nightly.tar.bz2
-      - run:
-          name: rspec
-          command: |
-            DEBUG=1 PUPPETEER_PRODUCT_RSPEC=firefox \
-            PUPPETEER_EXECUTABLE_PATH_RSPEC=${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/firefox/firefox \
-            bundle exec rspec --profile 10 \
-              --format RspecJunitFormatter \
-              --out test_results/rspec.xml \
-              --format documentation spec/integration/
-
-  deploy:
-    docker:
-      - image: circleci/ruby:2.6.3-stretch-node
-    steps:
-      - checkout
-      - run:
-          command: gem install bundler:2.2.3 && bundle install
-      - run:
-          name: rake build
-          command: rake build
-      - run:
-          name: setup API key
-          command: |
-            mkdir -p ~/.gem/
-            echo "---" > ~/.gem/credentials
-            echo ":rubygems_api_key: $RUBYGEMS_API_KEY" >> ~/.gem/credentials
-            chmod 600 ~/.gem/credentials
-      - run:
-          name: Check Puppeteer::version
-          command: bundle exec ruby -e 'raise "invalid Puppeteer::VERSION" unless Puppeteer::VERSION == ENV["CIRCLE_TAG"]'
-      - run:
-          name: gem push
-          command: gem push pkg/puppeteer-ruby-$CIRCLE_TAG.gem
-
-workflows:
-  ci:
-    jobs:
-      - rspec_chrome_ruby2_6
-      - rspec_chrome_ruby2_7
-      - rspec_chrome_ruby3_0
-      - rspec_firefox
-  rubygems-deploy:
-    jobs:
-      - deploy:
-          filters:
-            tags:
-              only: /^[0-9]\.[0-9]+\.[0-9].*/
-            branches:
-              ignore: /.*/

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,17 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-### Step To Reproduce / Observed behavior
-
-
-### Expected behavior
-
-### Environment
-
-Paste the output of `ruby --version`

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,15 +0,0 @@
----
-name: Feature request
-about: Request a new feature for playwright-ruby-client
-title: ''
-labels: ''
-assignees: ''
-
----
-
-### Simple description about the feature
-
-
-### Usecase / Motivation
-
-<!-- Describe why the feature helps. -->

data/.github/stale.yml

@@ -1,16 +0,0 @@
-# Number of days of inactivity before an issue becomes stale
-daysUntilStale: 14
-# Number of days of inactivity before a stale issue is closed
-daysUntilClose: 7
-# Issues with these labels will never be considered stale
-exemptLabels:
-  - security
-# Label to use when marking an issue as stale
-staleLabel: inactive
-# Comment to post when marking an issue as stale. Set to `false` to disable
-markComment: >
-  This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
-  for your contributions.
-# Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false

data/.github/workflows/docs.yml

@@ -1,45 +0,0 @@
-name: update docs
-on:
-  push:
-    branches:
-      - master
-
-jobs:
-  update-docs:
-    name: update docs
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 2.7
-
-      - name: Install dependencies
-        run: |
-          gem uninstall bundler
-          gem install bundler -v 2.2.3
-          bundle install
-
-      - name: Deploy Configuration
-        run: |
-          mkdir ~/.ssh
-          ssh-keyscan -t rsa github.com >> ~/.ssh/known_hosts
-          echo "${{ secrets.DOCS_DEPLOY_SSH_RSA }}" | base64 -d > ~/.ssh/id_rsa
-          chmod 400 ~/.ssh/id_rsa
-
-      - name: Build and Push
-        run: |
-          git clone git@github.com:YusukeIwaki/puppeteer-ruby-docs.git docs
-          rm -rf docs/*
-          bundle exec yardoc -o docs
-          cp puppeteer-ruby.png docs/
-          cd docs/
-          git add -A
-          git config user.name github
-          git config user.email github@example.com
-          git commit -m ${{ github.sha }}
-          git push origin master

data/.github/workflows/reviewdog.yml

@@ -1,18 +0,0 @@
-name: reviewdog
-on: [pull_request]
-jobs:
-  rubocop:
-    name: runner / rubocop
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v2
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.0.0
-      - name: rubocop
-        uses: reviewdog/action-rubocop@v1
-        with:
-          github_token: ${{ secrets.github_token }}
-          reporter: github-pr-review
-          rubocop_version: 1.11.0

data/.github/workflows/windows_check.yml

@@ -1,40 +0,0 @@
-name: Windows check
-on: [pull_request]
-jobs:
-  windows_edge_rspec:
-    name: RSpec on Windows / Edge
-    runs-on: windows-latest
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v2
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.0.0
-      - name: Install dependencies
-        run: |
-          gem uninstall bundler
-          gem install bundler -v 2.2.3
-          bundle install
-      - uses: browser-actions/setup-edge@latest
-      - name: Check example
-        run: bundle exec rspec spec/integration/example_spec.rb
-        env:
-          PUPPETEER_EXECUTABLE_PATH_RSPEC: 'C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe'
-
-  windows_chrome_rspec:
-    name: RSpec on Windows / Chrome
-    runs-on: windows-latest
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v2
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.0.0
-      - name: Install dependencies
-        run: |
-          gem uninstall bundler
-          gem install bundler -v 2.2.3
-          bundle install
-      - uses: browser-actions/setup-chrome@latest
-      - name: Check example
-        run: bundle exec rspec spec/integration/example_spec.rb

data/.gitignore

@@ -1,21 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-/.vscode
-/Gemfile.lock
-/vendor/bundle
-
-# rspec failure tracking
-.rspec_status
-
-# RubyMine
-/.idea/
-/.rakeTasks
-
-diff-*.png

data/.travis.yml

@@ -1,7 +0,0 @@
----
-sudo: false
-language: ruby
-cache: bundler
-rvm:
-  - 2.6.3
-before_install: gem install bundler -v 1.17.2