venetian 0.1.0-x86_64-linux

data/lib/tasks/venetian.rake

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+namespace :venetian do
+  desc <<~USAGE
+    Install Playwright browsers. Pass a name to install a specific browser (e.g. venetian:install[chromium]), else installs default browsers.
+  USAGE
+  task :install, [:browser] do |_task, args|
+    require "venetian"
+    Venetian::BrowserInstaller.install(args[:browser])
+  end
+end

data/lib/venetian/browser_installer.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Venetian
+  # # Browser Installer
+  #
+  # Installs browsers using the Playwright executable.
+  class BrowserInstaller
+    # # Install Error
+    #
+    # Raised when the installation fails for some reason.
+    class InstallError < StandardError
+      INSTALL_FAILED_MESSAGE = "Playwright install failed. Run `rake venetian:install` manually."
+
+      def initialize(message = nil)
+        super([INSTALL_FAILED_MESSAGE, *message].join(": "))
+      end
+    end
+
+    # Installs a browser. Raises InstallError if installation fails.
+    def self.install(browser = nil)
+      Executable.system "install", *browser&.to_s, exception: true
+    rescue StandardError => e
+      raise InstallError, e.message
+    end
+  end
+end

data/lib/venetian/browser_runner_extensions.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Venetian
+  module BrowserRunnerExtensions # :nodoc:
+    def initialize(options = {}, *args)
+      @venetian_browser_type = options[:browser_type] || :chromium
+      super
+    end
+
+    def start
+      BrowserInstaller.install(@venetian_browser_type) if Venetian.auto_install_browsers
+      super
+    end
+  end
+end
+
+Capybara::Playwright::BrowserRunner.prepend(Venetian::BrowserRunnerExtensions)

data/lib/venetian/executable.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+module Venetian
+  # # \Executable
+  #
+  # Provides methods for locating the Playwright executable.
+  module Executable
+    DEFAULT_DIR = File.expand_path(File.join(__dir__, "..", "..", "exe")) # :nodoc:
+    INSTALL_DIR_ENV_VAR = "VENETIAN_INSTALL_DIR" # :nodoc:
+
+    # # Unsupported Platform Error
+    #
+    # Raised when no platform targeted by this gem is supported by the Rubygems installation.
+    class UnsupportedPlatformError < StandardError
+      def initialize(platform) # :nodoc:
+        super(unsupported_platform_message(platform))
+      end
+
+      private
+
+      def unsupported_platform_message(platform)
+        <<~MSG
+          Playwright does not support the #{platform} platform.
+          Supported platforms:
+            #{supported_platforms}
+
+          Set #{INSTALL_DIR_ENV_VAR} to the directory containing your playwright executable.
+          See https://github.com/jmalcic/venetian for more details.
+        MSG
+      end
+
+      def supported_platforms
+        Upstream::NATIVE_PLATFORMS.keys
+                                  .collect { |platform| "- #{platform}" }
+                                  .join("\n  ")
+      end
+    end
+
+    # # Executable Not Found Error
+    #
+    # Raised when the Playwright executable cannot be found for the current platform.
+    class ExecutableNotFoundError < StandardError
+      def initialize(reason, **context) # :nodoc:
+        super(case reason
+              in :directory_missing then directory_missing_message(context[:exe_dir])
+              in :executable_missing then executable_missing_message(context[:exe_dir])
+              else unsupported_platform_message(context[:platform], context[:exe_dir])
+              end)
+      end
+
+      private
+
+      def directory_missing_message(exe_dir)
+        "#{INSTALL_DIR_ENV_VAR} is set to #{exe_dir} but that directory does not exist."
+      end
+
+      def executable_missing_message(exe_dir)
+        "#{INSTALL_DIR_ENV_VAR} is set to #{exe_dir} but playwright was not found there."
+      end
+
+      def unsupported_platform_message(platform, exe_dir)
+        <<~MSG
+          Cannot find the Playwright executable for #{platform} in #{exe_dir}.
+
+          Make sure your Gemfile.lock includes this platform:
+            bundle lock --add-platform #{platform}
+            bundle install
+
+          Or set #{INSTALL_DIR_ENV_VAR} to the directory containing your Playwright executable.
+        MSG
+      end
+    end
+
+    class << self
+      # Returns the path to the Node executable. Raises an error if the executable cannot be found.
+      def path
+        ensure_exe_dir_exists!
+        ensure_gem_platform_supported! unless ENV.key?(INSTALL_DIR_ENV_VAR)
+        ensure_executable_exists!
+
+        exe_path
+      end
+
+      # Executes the Playwright executable with the given arguments.
+      def execute(*args, echo: true)
+        [base_command, *args].then do |command|
+          puts command.inspect if echo
+          # due to mysterious Windows behavior; see equivalent in `tailwindcss-ruby`
+          next system(*command, exception: true) if Gem.win_platform?
+
+          exec(*command)
+        end
+      end
+
+      # Runs the Playwright executable with the given arguments.
+      def system(*args, echo: true, **)
+        [*base_command, *args].then do |command|
+          puts command.inspect if echo
+          super(*command, exception: true)
+        end
+      end
+
+      # Returns the base command to execute Playwright.
+      def base_command
+        [path, File.join(File.dirname(path), "package", "cli.js")]
+      end
+
+      private
+
+      def ensure_exe_dir_exists!
+        raise ExecutableNotFoundError.new(:directory_missing, exe_dir: exe_dir) unless exe_dir_exists?
+      end
+
+      def ensure_gem_platform_supported!
+        raise UnsupportedPlatformError, platform if gem_platforms_unsupported?
+      end
+
+      def ensure_executable_exists!
+        return unless exe_path.nil?
+
+        raise ExecutableNotFoundError.new ENV.key?(INSTALL_DIR_ENV_VAR) ? :executable_missing : :missing_platform,
+                                          exe_dir: exe_dir, platform: platform
+      end
+
+      def exe_dir_exists?
+        File.directory?(exe_dir)
+      end
+
+      def exe_dir
+        ENV[INSTALL_DIR_ENV_VAR] || DEFAULT_DIR
+      end
+
+      def exe_path
+        return custom_exe_path if ENV.key?(INSTALL_DIR_ENV_VAR)
+
+        Upstream::NATIVE_PLATFORMS.select { |platform, _| Gem::Platform.match_gem?(Gem::Platform.new(platform), GEMSPEC.name) }
+                                  .collect { |platform, _info| File.join(exe_dir, platform, "node") }
+                                  .detect { |candidate| File.exist?(candidate) }
+      end
+
+      def custom_exe_path
+        File.join(exe_dir, "node").then { |path| path if File.exist?(path) }
+      end
+
+      def gem_platforms_unsupported?
+        Upstream::NATIVE_PLATFORMS.keys.none? { |platform| Gem::Platform.match_gem?(Gem::Platform.new(platform), GEMSPEC.name) }
+      end
+
+      def platform
+        Gem::Platform.local.to_s
+      end
+    end
+  end
+end

data/lib/venetian/gemspec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Venetian
+  GEMSPEC = Gem.loaded_specs.values.reverse.find do |spec|
+    spec.gem_dir == Pathname.new(__dir__).join("..", "..").expand_path.to_path
+  end
+end

data/lib/venetian/playwright_create_extensions.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Venetian
+  module PlaywrightCreateExtensions # :nodoc:
+    def initialize(options = {}, *)
+      super({ playwright_cli_executable_path: Executable.base_command.shelljoin }.merge(options), *)
+    end
+  end
+end
+
+Capybara::Playwright::BrowserRunner::PlaywrightCreate.prepend(Venetian::PlaywrightCreateExtensions)

data/lib/venetian/railtie.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Venetian
+  class Railtie < Rails::Railtie # :nodoc:
+    rake_tasks do
+      load "tasks/venetian.rake"
+    end
+  end
+end

data/lib/venetian/tasks.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+load "tasks/venetian.rake"

data/lib/venetian/upstream.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "playwright"
+
+module Venetian
+  # # \Upstream
+  #
+  # Provides platform mappings and URLs for Playwright.
+  module Upstream
+    # map of gem platform strings to Playwright CDN platform strings and executable names inside the driver zip
+    NATIVE_PLATFORMS = {
+      "x86_64-linux" => "linux",
+      "aarch64-linux" => "linux-arm64",
+      "x86_64-darwin" => "mac",
+      "arm64-darwin" => "mac-arm64",
+      "x64-mingw-ucrt" => "win32_x64"
+    }.freeze
+
+    # base for driver download URLs
+    BASE_URL = "https://playwright.azureedge.net/builds/driver"
+
+    # Returns the URL to download the driver for the given platform.
+    def self.driver_download_url(playwright_platform)
+      "#{BASE_URL}/playwright-#{Playwright::COMPATIBLE_PLAYWRIGHT_VERSION}-#{playwright_platform}.zip"
+    end
+
+    # Returns a hash that maps platforms to download URLs.
+    def self.download_urls
+      NATIVE_PLATFORMS.transform_values { |value| driver_download_url(value) }
+    end
+
+    # Returns the gemspec files for the base gem.
+    def self.base_files
+      GEMSPEC.files
+    end
+
+    # Builds a gemspec for the given platform, adding the files currently in the native platform directory.
+    def self.build_gemspec_for(platform)
+      GEMSPEC.dup.tap do |s|
+        s.platform = platform
+        s.files += Dir["exe/#{platform}/**/*"]
+      end
+    end
+  end
+end

data/lib/venetian/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Venetian
+  VERSION = "0.1.0"
+end

data/lib/venetian.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "capybara/playwright"
+
+require "venetian/version"
+require "venetian/upstream"
+require "venetian/executable"
+require "venetian/playwright_create_extensions"
+require "venetian/browser_installer"
+require "venetian/browser_runner_extensions"
+require "venetian/gemspec"
+require "venetian/railtie" if defined? Rails
+
+# # Venetian
+#
+# Native Playwright driver for Capybara.
+module Venetian
+  class << self
+    attr_accessor :auto_install_browsers
+  end
+
+  class Error < StandardError; end
+
+  self.auto_install_browsers = true
+
+  def self.execute(*, echo: true)
+    Executable.execute(*, echo: echo)
+  end
+end

metadata

@@ -0,0 +1,185 @@
+--- !ruby/object:Gem::Specification
+name: venetian
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: x86_64-linux
+authors:
+- Justin Malčić
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capybara-playwright-driver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+description: Bundles the Playwright driver binary in platform-specific gem variants
+  and integrates with `capybara-playwright-driver`.
+email:
+- j.malcic@me.com
+executables:
+- playwright
+extensions: []
+extra_rdoc_files: []
+files:
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/playwright
+- exe/x86_64-linux/LICENSE
+- exe/x86_64-linux/node
+- exe/x86_64-linux/package/LICENSE
+- exe/x86_64-linux/package/NOTICE
+- exe/x86_64-linux/package/README.md
+- exe/x86_64-linux/package/ThirdPartyNotices.txt
+- exe/x86_64-linux/package/api.json
+- exe/x86_64-linux/package/bin/install_media_pack.ps1
+- exe/x86_64-linux/package/bin/install_webkit_wsl.ps1
+- exe/x86_64-linux/package/bin/reinstall_chrome_beta_linux.sh
+- exe/x86_64-linux/package/bin/reinstall_chrome_beta_mac.sh
+- exe/x86_64-linux/package/bin/reinstall_chrome_beta_win.ps1
+- exe/x86_64-linux/package/bin/reinstall_chrome_stable_linux.sh
+- exe/x86_64-linux/package/bin/reinstall_chrome_stable_mac.sh
+- exe/x86_64-linux/package/bin/reinstall_chrome_stable_win.ps1
+- exe/x86_64-linux/package/bin/reinstall_msedge_beta_linux.sh
+- exe/x86_64-linux/package/bin/reinstall_msedge_beta_mac.sh
+- exe/x86_64-linux/package/bin/reinstall_msedge_beta_win.ps1
+- exe/x86_64-linux/package/bin/reinstall_msedge_dev_linux.sh
+- exe/x86_64-linux/package/bin/reinstall_msedge_dev_mac.sh
+- exe/x86_64-linux/package/bin/reinstall_msedge_dev_win.ps1
+- exe/x86_64-linux/package/bin/reinstall_msedge_stable_linux.sh
+- exe/x86_64-linux/package/bin/reinstall_msedge_stable_mac.sh
+- exe/x86_64-linux/package/bin/reinstall_msedge_stable_win.ps1
+- exe/x86_64-linux/package/browsers.json
+- exe/x86_64-linux/package/cli.js
+- exe/x86_64-linux/package/index.d.ts
+- exe/x86_64-linux/package/index.js
+- exe/x86_64-linux/package/index.mjs
+- exe/x86_64-linux/package/lib/bootstrap.js
+- exe/x86_64-linux/package/lib/coreBundle.js
+- exe/x86_64-linux/package/lib/entry/cliDaemon.js
+- exe/x86_64-linux/package/lib/entry/dashboardApp.js
+- exe/x86_64-linux/package/lib/entry/mcp.js
+- exe/x86_64-linux/package/lib/entry/oopBrowserDownload.js
+- exe/x86_64-linux/package/lib/package.js
+- exe/x86_64-linux/package/lib/server/chromium/appIcon.png
+- exe/x86_64-linux/package/lib/server/deviceDescriptorsSource.json
+- exe/x86_64-linux/package/lib/server/electron/loader.js
+- exe/x86_64-linux/package/lib/serverRegistry.js
+- exe/x86_64-linux/package/lib/serverRegistry.js.LICENSE
+- exe/x86_64-linux/package/lib/tools/cli-client/channelSessions.js
+- exe/x86_64-linux/package/lib/tools/cli-client/cli.js
+- exe/x86_64-linux/package/lib/tools/cli-client/help.json
+- exe/x86_64-linux/package/lib/tools/cli-client/minimist.js
+- exe/x86_64-linux/package/lib/tools/cli-client/output.js
+- exe/x86_64-linux/package/lib/tools/cli-client/program.js
+- exe/x86_64-linux/package/lib/tools/cli-client/registry.js
+- exe/x86_64-linux/package/lib/tools/cli-client/session.js
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/SKILL.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/element-attributes.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/playwright-tests.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/request-mocking.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/running-code.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/session-management.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/spec-driven-testing.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/storage-state.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/test-generation.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/tracing.md
+- exe/x86_64-linux/package/lib/tools/cli-client/skill/references/video-recording.md
+- exe/x86_64-linux/package/lib/tools/dashboard/appIcon.png
+- exe/x86_64-linux/package/lib/tools/trace/SKILL.md
+- exe/x86_64-linux/package/lib/tools/utils/extension.js
+- exe/x86_64-linux/package/lib/tools/utils/socketConnection.js
+- exe/x86_64-linux/package/lib/utilsBundle.js
+- exe/x86_64-linux/package/lib/utilsBundle.js.LICENSE
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/codicon-DCmgc-ay.ttf
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/firefox-1bWoP6pv.svg
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/firefox-beta-k3eOH_eK.svg
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/firefox-nightly-Cp5nfeDT.svg
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/index-BY2S1tHT.css
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/index-DpEq2p62.js
+- exe/x86_64-linux/package/lib/vite/dashboard/assets/safari-na3_-uQk.svg
+- exe/x86_64-linux/package/lib/vite/dashboard/index.html
+- exe/x86_64-linux/package/lib/vite/dashboard/playwright-logo.svg
+- exe/x86_64-linux/package/lib/vite/htmlReport/index.html
+- exe/x86_64-linux/package/lib/vite/htmlReport/report.css
+- exe/x86_64-linux/package/lib/vite/htmlReport/report.js
+- exe/x86_64-linux/package/lib/vite/recorder/assets/codeMirrorModule-BHYmBp6h.js
+- exe/x86_64-linux/package/lib/vite/recorder/assets/codeMirrorModule-DYBRYzYX.css
+- exe/x86_64-linux/package/lib/vite/recorder/assets/codicon-DCmgc-ay.ttf
+- exe/x86_64-linux/package/lib/vite/recorder/assets/index-4ZiSSCmn.css
+- exe/x86_64-linux/package/lib/vite/recorder/assets/index-DA10QRaq.js
+- exe/x86_64-linux/package/lib/vite/recorder/index.html
+- exe/x86_64-linux/package/lib/vite/recorder/playwright-logo.svg
+- exe/x86_64-linux/package/lib/vite/traceViewer/assets/codeMirrorModule-Ds_H_9Yq.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/assets/defaultSettingsView-D31xz8zv.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/assets/urlMatch-BYQrIQwR.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/assets/xtermModule-CsJ4vdCR.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/codeMirrorModule.DYBRYzYX.css
+- exe/x86_64-linux/package/lib/vite/traceViewer/codicon.DCmgc-ay.ttf
+- exe/x86_64-linux/package/lib/vite/traceViewer/defaultSettingsView.BDKsFU3c.css
+- exe/x86_64-linux/package/lib/vite/traceViewer/index.BCnMPevh.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/index.CzXZzn5A.css
+- exe/x86_64-linux/package/lib/vite/traceViewer/index.html
+- exe/x86_64-linux/package/lib/vite/traceViewer/manifest.webmanifest
+- exe/x86_64-linux/package/lib/vite/traceViewer/playwright-logo.svg
+- exe/x86_64-linux/package/lib/vite/traceViewer/snapshot.html
+- exe/x86_64-linux/package/lib/vite/traceViewer/snapshot.v8KI4P3m.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/sw.bundle.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/uiMode.Btcz36p_.css
+- exe/x86_64-linux/package/lib/vite/traceViewer/uiMode.C2Efnu2P.js
+- exe/x86_64-linux/package/lib/vite/traceViewer/uiMode.html
+- exe/x86_64-linux/package/lib/vite/traceViewer/xtermModule.DYP7pi_n.css
+- exe/x86_64-linux/package/lib/xdg-open
+- exe/x86_64-linux/package/package.json
+- exe/x86_64-linux/package/protocol.yml
+- exe/x86_64-linux/package/types/protocol.d.ts
+- exe/x86_64-linux/package/types/structs.d.ts
+- exe/x86_64-linux/package/types/types.d.ts
+- lib/tasks/venetian.rake
+- lib/venetian.rb
+- lib/venetian/browser_installer.rb
+- lib/venetian/browser_runner_extensions.rb
+- lib/venetian/executable.rb
+- lib/venetian/gemspec.rb
+- lib/venetian/playwright_create_extensions.rb
+- lib/venetian/railtie.rb
+- lib/venetian/tasks.rb
+- lib/venetian/upstream.rb
+- lib/venetian/version.rb
+homepage: https://github.com/jmalcic/venetian
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://malcic.codes/software/venetian
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/jmalcic/venetian
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Playwright executables for Ruby
+test_files: []