scrap_kit 0.1.4 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06df78782e4cc3aa25ed9f90c1536d935c3fcd08bae82b33e4d79e68e805a09d
-  data.tar.gz: ddee1afb1a30778818f1b688d8880b5c383f804e8fc8660be89461c98730f869
+  metadata.gz: ab218fee7bbf85145afd031bbe59a0820b93eb1e57ee27d50163aa25dbcb8e46
+  data.tar.gz: 4d304049b137f2750b3843c80ff925d872576459627bebac443e395d5e897749
 SHA512:
-  metadata.gz: 90097dfa2f36f4379117d8487046acdeef98d257f89ca6041064e5d0a3305b52e034a6cacb4d29f1cf1d909afb302dfdd2cd2c6ab7b01755786585dbb217a554
-  data.tar.gz: f0b8e7a588ac8d195d078af941a335913d547aac7232a3fa473f5b43b55f898e4ed12d28da3ea3488f3d390e43ac561500c585fc030d31ecf1779b9006869227
+  metadata.gz: 5e2dd47d6b77ac3983efeb99e351a5e26b2737c1aa0c77972213a744ce44c6033dc2ae3498aca40f68471010b33b6fc3aeb1bf03f922ffa6e95aa0d715493722
+  data.tar.gz: bc92e505d8ffca95d621ad8756350ae174bc316efbd015724d87478364c9d500682a4da765595c9158bc56ed3fd855e9827dc4f357fbea64901fdb53665c32b1

data/.github/workflows/run_tests.yml

@@ -0,0 +1,20 @@
+name: Run tests
+
+on: [push]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v1
+      - name: Setup Ruby
+        uses: actions/setup-ruby@v1
+        with:
+          ruby-version: '2.7.1'
+      - name: Build and run tests
+        run: |
+          gem install bundler
+          bundle update --conservative --jobs 4 --retry 3
+          bundle exec rake spec

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.1.9] 2020-08-31
+
+### Changed/Added
+- Set arguments for Chrome driver
+
+## [0.1.8] 2020-08-29
+
+### Changed/Added
+- Add new ways to declare selectors
+- Add steps
+
+## [0.1.7] 2020-08-28
+
+### Changed/Added
+- Match selector condition by regexp or exact value
+
+## [0.1.6] 2020-08-28
+
+### Changed/Added
+- Update activesupport requirement from = 6.0.2.1 to ~> 6.0
+- Fix bug when matching selector condition
+
+## [0.1.5] 2020-08-08
+
+### Changed/Added
+- Add `webdrivers` as dependency
+
 ## [0.1.4] 2020-07-12
 
 ### Changed/Added

data/Gemfile.lock

@@ -1,25 +1,29 @@
 PATH
   remote: .
   specs:
-    scrap_kit (0.1.4)
-      activesupport (= 6.0.3.1)
+    scrap_kit (0.1.9)
+      activesupport (~> 6.0)
       watir (~> 6.16.5)
+      webdrivers (~> 4.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3.1)
+    activesupport (6.0.3.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
       zeitwerk (~> 2.2, >= 2.2.2)
     childprocess (3.0.0)
-    concurrent-ruby (1.1.6)
+    concurrent-ruby (1.1.7)
     diff-lcs (1.3)
-    i18n (1.8.3)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
+    mini_portile2 (2.4.0)
     minitest (5.14.1)
+    nokogiri (1.10.10)
+      mini_portile2 (~> 2.4.0)
     rake (13.0.1)
     regexp_parser (1.7.1)
     rspec (3.9.0)
@@ -45,7 +49,11 @@ GEM
     watir (6.16.5)
       regexp_parser (~> 1.2)
       selenium-webdriver (~> 3.6)
-    zeitwerk (2.3.1)
+    webdrivers (4.4.1)
+      nokogiri (~> 1.6)
+      rubyzip (>= 1.3.0)
+      selenium-webdriver (>= 3.0, < 4.0)
+    zeitwerk (2.4.0)
 
 PLATFORMS
   ruby

data/README.md

@@ -81,6 +81,66 @@ output = recipe.run
 #=> {:posts=>[{:title=>"APIs de Internacionalización en JavaScript"}, {:title=>"Ejecutando comandos desde Ruby"}, {:title=>"Usando Higher-Order Components"}]}
 ```
 
+### Working with selectors
+
+Each attribute can be mapped to a selector, which can be any of the following types:
+
+* A string, which represents a CSS selector.
+
+```ruby
+".subnav__inner .ember-view:nth-child(1) > .status-summary__description"
+```
+
+* A hash, which can have any of the following options:
+  * `xpath: [String]`
+  * `css: [String]`
+  * `index: [Integer]`
+  * `tag_name: [String]`
+  * `text: [String]`
+
+```ruby
+{ text: "View Archive" }
+```
+
+* An array, which represents a path of selectors, where its last item must be a hash that matches a selector with an expected value.
+
+```ruby
+[".up-time-chart", { ".region-header .u-margin-Tm": "REGION" }]
+```
+
+Use any of them as it suits you best.
+
+### Writing steps
+
+Recipes can have a `steps` entry. This entry defines previous actions the scraper have to follow before extract the attributes. The following steps are supported:
+
+* **`goto`**: It instructs the scraper to go to a link inside the current page. Its value can be a hash or array selector, or a URL:
+
+```ruby
+{
+  goto: { text: "View Archive" }
+}
+```
+
+* **`click`**: It instructs the scraper to click on an element inside the current page. Its value can be a hash or array selector:
+
+```ruby
+{
+  click: { css: "[type=submit]" }
+}
+```
+
+* **`fill_form`**: It instructs the scraper to fill a form or any form field inside the current page. Its value is a hash where the keys are either a input's name or a CSS selector, and the values are the values to be entered into those fields:
+
+```ruby
+{
+  fill_form: {
+    gem_name: "ScrapKit",
+    author: "hpneo",
+  }
+}
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/scrap_kit/recipe.rb

@@ -1,8 +1,23 @@
 require "active_support/core_ext/hash"
+require "webdrivers/chromedriver"
 require "watir"
 
 module ScrapKit
   class Recipe
+    class << self
+      def load(source)
+        input = if source.is_a?(Hash)
+          source
+        elsif source.is_a?(IO)
+          JSON.parse(source.read)
+        else
+          JSON.parse(File.read(source))
+        end
+
+        new(input.deep_symbolize_keys)
+      end
+    end
+
     def initialize(url: nil, steps: [], attributes: {})
       @url = url
       @steps = steps
@@ -12,42 +27,63 @@ module ScrapKit
     def run
       output = {}
 
-      browser = Watir::Browser.new(:chrome, headless: true)
-      browser.goto @url
+      @browser = create_browser
+      @browser.goto @url
 
       @steps.each do |step|
-        run_step(browser, step)
+        run_step(step)
       end
 
       @attributes.each do |attribute_name, selector|
-        output[attribute_name] = extract_attribute(browser, selector)
+        output[attribute_name] = extract_attribute(@browser, selector)
       end
 
-      browser.close
-      browser = nil
+      @browser.close
+      @browser = nil
 
       output
     end
 
-    def run_step(browser, step)
+    def run_step(step)
+      return goto(step[:goto]) if step[:goto]
+      return click(step[:click]) if step[:click]
+      return fill_form(step[:fill_form]) if step[:fill_form]
+
+      nil
+    end
+
+    def find_element_by_name_or_selector(browser_or_element, name_or_selector)
+      element = browser_or_element.element(name: name_or_selector.to_s)
+      return element if element.exists?
+
+      element = browser_or_element.element(css: name_or_selector.to_s)
+      return element if element.exists?
+
+      nil
     end
 
     def elements_from_selector(browser_or_element, selector)
       if selector.is_a?(String)
         browser_or_element.elements(css: selector)
+      elsif selector.is_a?(Hash)
+        browser_or_element.elements(selector)
       elsif selector.is_a?(Array)
         *remainder, condition = selector
+        condition_key, condition_value = condition.first
         elements = browser_or_element
 
-        remainder.each do |item|
-          elements = elements.elements(css: item)
+        if remainder.empty?
+          elements = elements.elements(css: condition_key.to_s)
+        else
+          remainder.each do |item|
+            elements = elements.elements(css: item)
+          end
         end
 
         elements.filter do |element|
-          condition_key = condition.keys[0].to_s
-          condition_value = condition.values[0]
-          found_element = element.element(css: condition_key)
-          extract_value_from_element(found_element)&.match(condition_value)
+          found_element = element.element(css: condition_key.to_s)
+          extracted_value = extract_value_from_element(found_element)
+          extracted_value.match(condition_value) || extracted_value == condition_value
         end
       end
     end
@@ -62,37 +98,114 @@ module ScrapKit
       element&.text_content
     end
 
-    def extract_attribute(browser_or_element, selector_or_hash)
-      if selector_or_hash.is_a?(String)
-        extract_value_from_element(browser_or_element.element(css: selector_or_hash))
-      elsif selector_or_hash.is_a?(Hash)
-        selector = selector_or_hash[:selector]
-        selector_for_children_attributes = selector_or_hash[:children_attributes]
+    def extract_attribute(browser_or_element, selector_or_object)
+      if selector_or_object.is_a?(String)
+        extract_value_from_element(browser_or_element.element(css: selector_or_object))
+      elsif selector_or_object.is_a?(Array)
+        found_elements = elements_from_selector(browser_or_element, selector_or_object)
 
-        elements_from_selector(browser_or_element, selector).map do |element|
-          output = {}
+        if found_elements.size === 1
+          extract_value_from_element(found_elements.first)
+        else
+          found_elements.map do |element|
+            extract_value_from_element(element)
+          end
+        end
+      elsif selector_or_object.is_a?(Hash)
+        if selector_or_object[:selector] && selector_or_object[:children_attributes]
+          selector = selector_or_object[:selector]
+          selector_for_children_attributes = selector_or_object[:children_attributes]
+
+          elements_from_selector(browser_or_element, selector).map do |element|
+            output = {}
 
-          selector_for_children_attributes.each do |child_attribute_name, child_selector|
-            output[child_attribute_name] = extract_attribute(element, child_selector)
+            selector_for_children_attributes.each do |child_attribute_name, child_selector|
+              output[child_attribute_name] = extract_attribute(element, child_selector)
+            end
+
+            output
           end
+        else
+          found_elements = elements_from_selector(browser_or_element, selector_or_object)
+
+          if found_elements.size === 1
+            extract_value_from_element(found_elements.first)
+          else
+            found_elements.map do |element|
+              extract_value_from_element(element)
+            end
+          end
+        end
+      end
+    end
+
+    private
 
-          output
+    def goto(link_or_selector)
+      if link_or_selector.is_a?(String)
+        @browser.goto(link_or_selector)
+      elsif link_or_selector.is_a?(Array) || link_or_selector.is_a?(Hash)
+        if found_element = elements_from_selector(@browser, link_or_selector).first
+          found_element.click
         end
       end
+
+      sleep 0.5
+      @browser.wait_until do
+        @browser.ready_state == "complete"
+      end
+    rescue
+      nil
     end
 
-    class << self
-      def load(source)
-        input = if source.is_a?(Hash)
-          source
-        elsif source.is_a?(IO)
-          JSON.parse(source.read)
-        else
-          JSON.parse(File.read(source))
+    def click(selector)
+      if selector.is_a?(Array) || selector.is_a?(Hash)
+        if found_element = elements_from_selector(@browser, selector).first
+          found_element.click
         end
+      end
 
-        new(input.deep_symbolize_keys)
+      sleep 1
+      @browser.wait_until do
+        @browser.ready_state == "complete"
       end
+
+    rescue
+      nil
+    end
+
+    def fill_form(form_data)
+      form_data.each do |name, value|
+        if element = find_element_by_name_or_selector(@browser.body, name.to_s)
+          element = element.to_subtype
+
+          if element.respond_to?(:set)
+            element.set(value)
+          elsif element.respond_to?(:select)
+            element.select(value)
+          end
+        end
+      end
+
+      sleep 0.25
+      @browser.wait_until do
+        @browser.ready_state == "complete"
+      end
+    end
+
+    def create_browser
+      options = Selenium::WebDriver::Chrome::Options.new
+
+      options.add_argument "--headless"
+      options.add_argument "--window-size=1080x720"
+      options.add_argument "--hide-scrollbars"
+
+      if chrome_bin = ENV["GOOGLE_CHROME_SHIM"]
+        options.add_argument "--no-sandbox"
+        options.binary = chrome_bin
+      end
+
+      Watir::Browser.new(:chrome, options: options)
     end
   end
 end

data/lib/scrap_kit/version.rb

@@ -1,3 +1,3 @@
 module ScrapKit
-  VERSION = "0.1.4"
+  VERSION = "0.1.9"
 end

data/scrap_kit.gemspec

@@ -32,5 +32,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_dependency "watir", "~> 6.16.5"
-  spec.add_dependency "activesupport", "6.0.3.1"
+  spec.add_dependency "webdrivers", "~> 4.0"
+  spec.add_dependency "activesupport", "~> 6.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrap_kit
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.9
 platform: ruby
 authors:
 - Gustavo Leon
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-12 00:00:00.000000000 Z
+date: 2020-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,20 +66,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 6.16.5
+- !ruby/object:Gem::Dependency
+  name: webdrivers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 6.0.3.1
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 6.0.3.1
+        version: '6.0'
 description: Run JSON-based recipes to scrap web sites.
 email:
 - hpneo@hotmail.com
@@ -87,7 +101,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/publish_gem.yml"
+- ".github/workflows/run_tests.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"

data/.github/workflows/publish_gem.yml

@@ -1,17 +0,0 @@
-name: Publish gem
-
-on:
-  push:
-    tags:
-      - '*'
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Publish gem
-        uses: dawidd6/action-publish-gem@v1.0.0
-        with:
-          api_key: ${{secrets.RUBYGEMS_API_KEY}}