zenrows 0.1.0

data/test/zenrows/js_instructions_test.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class JsInstructionsTest < Minitest::Test
+  def test_build_with_block
+    instructions = Zenrows::JsInstructions.build do
+      click ".button"
+      wait 1000
+    end
+
+    assert_equal 2, instructions.size
+    refute instructions.empty?
+  end
+
+  def test_click
+    instructions = Zenrows::JsInstructions.build { click ".submit" }
+
+    assert_equal [{click: ".submit"}], instructions.to_a
+  end
+
+  def test_wait
+    instructions = Zenrows::JsInstructions.build { wait 2000 }
+
+    assert_equal [{wait: 2000}], instructions.to_a
+  end
+
+  def test_wait_for
+    instructions = Zenrows::JsInstructions.build { wait_for ".content" }
+
+    assert_equal [{wait_for: ".content"}], instructions.to_a
+  end
+
+  def test_wait_event
+    instructions = Zenrows::JsInstructions.build { wait_event :networkidle }
+
+    assert_equal [{wait_event: "networkidle"}], instructions.to_a
+  end
+
+  def test_fill
+    instructions = Zenrows::JsInstructions.build { fill "#email", "test@example.com" }
+
+    assert_equal [{fill: ["#email", "test@example.com"]}], instructions.to_a
+  end
+
+  def test_check_and_uncheck
+    instructions = Zenrows::JsInstructions.build do
+      check "#terms"
+      uncheck "#newsletter"
+    end
+
+    assert_equal [{check: "#terms"}, {uncheck: "#newsletter"}], instructions.to_a
+  end
+
+  def test_select_option
+    instructions = Zenrows::JsInstructions.build { select_option "#country", "US" }
+
+    assert_equal [{select_option: ["#country", "US"]}], instructions.to_a
+  end
+
+  def test_scroll_y
+    instructions = Zenrows::JsInstructions.build { scroll_y 1500 }
+
+    assert_equal [{scroll_y: 1500}], instructions.to_a
+  end
+
+  def test_scroll_x
+    instructions = Zenrows::JsInstructions.build { scroll_x 500 }
+
+    assert_equal [{scroll_x: 500}], instructions.to_a
+  end
+
+  def test_scroll_to
+    instructions = Zenrows::JsInstructions.build { scroll_to :bottom }
+
+    assert_equal [{scroll_to: "bottom"}], instructions.to_a
+  end
+
+  def test_evaluate
+    instructions = Zenrows::JsInstructions.build { evaluate "console.log('test')" }
+
+    assert_equal [{evaluate: "console.log('test')"}], instructions.to_a
+  end
+
+  def test_frame_click
+    instructions = Zenrows::JsInstructions.build { frame_click "#iframe", ".button" }
+
+    assert_equal [{frame_click: ["#iframe", ".button"]}], instructions.to_a
+  end
+
+  def test_frame_wait_for
+    instructions = Zenrows::JsInstructions.build { frame_wait_for "#iframe", ".loaded" }
+
+    assert_equal [{frame_wait_for: ["#iframe", ".loaded"]}], instructions.to_a
+  end
+
+  def test_frame_fill
+    instructions = Zenrows::JsInstructions.build { frame_fill "#iframe", "#input", "value" }
+
+    assert_equal [{frame_fill: ["#iframe", "#input", "value"]}], instructions.to_a
+  end
+
+  def test_frame_evaluate
+    instructions = Zenrows::JsInstructions.build { frame_evaluate "iframe-name", "console.log('hi')" }
+
+    assert_equal [{frame_evaluate: ["iframe-name", "console.log('hi')"]}], instructions.to_a
+  end
+
+  def test_to_json
+    instructions = Zenrows::JsInstructions.build do
+      click ".btn"
+      wait 500
+    end
+
+    json = instructions.to_json
+    assert_equal '[{"click":".btn"},{"wait":500}]', json
+  end
+
+  def test_chaining
+    instructions = Zenrows::JsInstructions.new
+      .click(".btn")
+      .wait(1000)
+      .scroll_to(:bottom)
+
+    assert_equal 3, instructions.size
+  end
+
+  def test_complex_flow
+    instructions = Zenrows::JsInstructions.build do
+      wait_for ".login-form"
+      fill "#email", "user@example.com"
+      fill "#password", "secret123"
+      click "#submit"
+      wait 2000
+      wait_for ".dashboard"
+    end
+
+    assert_equal 6, instructions.size
+  end
+end

data/test/zenrows/proxy_test.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class ProxyTest < Minitest::Test
+  def setup
+    @proxy = Zenrows::Proxy.new(
+      api_key: "test_api_key",
+      host: "superproxy.zenrows.com",
+      port: 1337
+    )
+  end
+
+  def test_build_basic_config
+    config = @proxy.build
+
+    assert_equal "superproxy.zenrows.com", config[:host]
+    assert_equal 1337, config[:port]
+    assert_equal "test_api_key", config[:username]
+    assert_equal "", config[:password]
+  end
+
+  def test_build_with_js_render
+    config = @proxy.build(js_render: true)
+
+    assert_includes config[:password], "js_render=true"
+  end
+
+  def test_build_with_premium_proxy
+    config = @proxy.build(premium_proxy: true)
+
+    assert_includes config[:password], "premium_proxy=true"
+  end
+
+  def test_build_with_proxy_country_enables_premium
+    config = @proxy.build(proxy_country: "us")
+
+    assert_includes config[:password], "proxy_country=us"
+    assert_includes config[:password], "premium_proxy=true"
+  end
+
+  def test_build_with_wait_boolean
+    config = @proxy.build(wait: true)
+
+    assert_includes config[:password], "wait=15000"
+    assert_includes config[:password], "js_render=true"
+  end
+
+  def test_build_with_wait_integer
+    config = @proxy.build(wait: 5000)
+
+    assert_includes config[:password], "wait=5000"
+  end
+
+  def test_build_with_wait_for_selector
+    config = @proxy.build(wait_for: ".content")
+
+    assert_includes config[:password], "wait_for=.content"
+    assert_includes config[:password], "js_render=true"
+  end
+
+  def test_build_with_session_id_true
+    config = @proxy.build(session_id: true)
+
+    assert_match(/session_id=\d+/, config[:password])
+  end
+
+  def test_build_with_session_id_string
+    config = @proxy.build(session_id: "my_session")
+
+    assert_includes config[:password], "session_id=my_session"
+  end
+
+  def test_build_with_screenshot
+    config = @proxy.build(screenshot: true)
+
+    assert_includes config[:password], "screenshot=true"
+    assert_includes config[:password], "js_render=true"
+  end
+
+  def test_build_with_json_response
+    config = @proxy.build(json_response: true)
+
+    assert_includes config[:password], "json_response=true"
+    assert_includes config[:password], "js_render=true"
+  end
+
+  def test_build_with_block_resources
+    config = @proxy.build(block_resources: "image,media,font")
+
+    assert_includes config[:password], "block_resources=image,media,font"
+  end
+
+  def test_build_url
+    url = @proxy.build_url(js_render: true)
+
+    assert_equal "http://test_api_key:js_render=true@superproxy.zenrows.com:1337", url
+  end
+
+  def test_build_array
+    arr = @proxy.build_array(js_render: true)
+
+    assert_equal "superproxy.zenrows.com", arr[0]
+    assert_equal 1337, arr[1]
+    assert_equal "test_api_key", arr[2]
+    assert_includes arr[3], "js_render=true"
+  end
+
+  def test_raises_on_excessive_wait_time
+    assert_raises Zenrows::WaitTimeError do
+      @proxy.build(wait: 200_000)
+    end
+  end
+end

data/test/zenrows_test.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class ZenrowsTest < Minitest::Test
+  def setup
+    Zenrows.reset_configuration!
+  end
+
+  def test_that_it_has_a_version_number
+    refute_nil Zenrows::VERSION
+  end
+
+  def test_configure_with_block
+    Zenrows.configure do |config|
+      config.api_key = "test_key"
+      config.host = "proxy.example.com"
+      config.port = 8080
+    end
+
+    assert_equal "test_key", Zenrows.configuration.api_key
+    assert_equal "proxy.example.com", Zenrows.configuration.host
+    assert_equal 8080, Zenrows.configuration.port
+  end
+
+  def test_default_configuration
+    config = Zenrows.configuration
+
+    assert_nil config.api_key
+    assert_equal "superproxy.zenrows.com", config.host
+    assert_equal 1337, config.port
+    assert_equal 5, config.connect_timeout
+    assert_equal 180, config.read_timeout
+    assert_equal :http_rb, config.backend
+  end
+
+  def test_reset_configuration
+    Zenrows.configure { |c| c.api_key = "test" }
+    Zenrows.reset_configuration!
+
+    assert_nil Zenrows.configuration.api_key
+  end
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: zenrows
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ernest Bursa
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+description: A Ruby gem for ZenRows web scraping proxy with multi-backend support
+  (http.rb primary), JavaScript rendering, premium proxies, and comprehensive browser
+  automation via JS instructions.
+email:
+- ernest.bursa@fourthwall.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".standard.yml"
+- ".yardopts"
+- CHANGELOG.md
+- CLAUDE.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/zenrows.rb
+- lib/zenrows/backends/base.rb
+- lib/zenrows/backends/http_rb.rb
+- lib/zenrows/client.rb
+- lib/zenrows/configuration.rb
+- lib/zenrows/errors.rb
+- lib/zenrows/js_instructions.rb
+- lib/zenrows/proxy.rb
+- lib/zenrows/railtie.rb
+- lib/zenrows/version.rb
+- plan.md
+- sig/zenrows.rbs
+- test/test_helper.rb
+- test/zenrows/client_test.rb
+- test/zenrows/js_instructions_test.rb
+- test/zenrows/proxy_test.rb
+- test/zenrows_test.rb
+homepage: https://github.com/swistaczek/zenrows-rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/swistaczek/zenrows-rb
+  source_code_uri: https://github.com/swistaczek/zenrows-rb
+  changelog_uri: https://github.com/swistaczek/zenrows-rb/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/zenrows
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Ruby client for ZenRows web scraping API via proxy mode
+test_files: []