[Ruby初心者] Capybara(gem)の使い方について

Question

以下のサイトを見て、Capybaraというgemを利用したスクレイピングについて勉強しています。
Capybara+PhantomJS+Nokogiriを利用してスクレイピング
そして、以下のソースコードを読んでいましたが、わからない点があります。

require 'capybara'
require 'capybara/dsl'
require 'capybara/poltergeist'

class Scrape
  #DSLのスコープを別けないと警告がでます
  include Capybara::DSL

  def initialize()
    Capybara.register_driver :poltergeist_debug do |app|
      Capybara::Poltergeist::Driver.new(app, :inspector => true)
    end

    Capybara.default_driver = :poltergeist
    Capybara.javascript_driver = :poltergeist
  end

  def visit_site
    page.driver.headers # => {}
    #ユーザエージェントの設定（必要に応じて）
    page.driver.headers = { "User-Agent" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/27.0.1453.116 Safari/537.36" }
    #リファラーの偽装（特に不要）
    #page.driver.add_headers("Referer" => "http://yahoo.co.jp")
    page.driver.headers
    visit('http://www.yahoo.co.jp')
    #スクリーンショットで保存
    page.save_screenshot('screenshot.png', :full => true)
    #within(:xpath, "//*[@id='toipcsfb']/div[1]/ul[1]") do
    #Nokogirオブジェクトの作成
    doc = Nokogiri::HTML.parse(page.html)
    puts doc.title
  end
end

scrape = Scrape.new
scrape.visit_site

以上のソースコードの後半部分でpageという物が突然出てきたので、これはどこから出てきたのか、何なのかわからず止まっています。該当部分は以下のとおりです。

  def visit_site
    page.driver.headers # => {}
    #ユーザエージェントの設定（必要に応じて）
    page.driver.headers = { "User-Agent" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/27.0.1453.116 Safari/537.36" }
    #リファラーの偽装（特に不要）
    #page.driver.add_headers("Referer" => "http://yahoo.co.jp")
    page.driver.headers
    visit('http://www.yahoo.co.jp')
    #スクリーンショットで保存
    page.save_screenshot('screenshot.png', :full => true)
    #within(:xpath, "//*[@id='toipcsfb']/div[1]/ul[1]") do
    #Nokogirオブジェクトの作成
    doc = Nokogiri::HTML.parse(page.html)
    puts doc.title
  end

自分で調べた所、以下のサイトでこれかな？という物は見つかったのですが、「これはどこから出てきたのか？」という疑問と「これは何なのか？」という疑問は解けないままです。おそらく、CapybaraというgemにDSLと言うものがあり、DSLが持っているメソッドかな、と思っております。
Method: Capybara::DSL#page
0. pageは、どこから出てきたのか？

1. pageは何なのか？

この２つの疑問についてご回答頂ければ嬉しいです。どちらか片方だけでも結構です。よろしくお願いします。

Answer 1

class Scrape
#DSLのスコープを別けないと警告がでます
include Capybara::DSL

includeメソッドで指定モジュールの定義を引き継いでいるため
Capybara::DSLのpageメソッドが使えます。

instance method Module#include
https://docs.ruby-lang.org/ja/latest/method/Module/i/include.html

Comments

[anvinon]

ご回答ありがとうございます。
なるほど！全くそこまで気が付きませんでした。ありがとうございます。

Answer 2

require 'capybara/poltergeist'
require 'nokogiri'


class Scrape
  def initialize
    Capybara.register_driver :poltergeist do |app|
      Capybara::Poltergeist::Driver.new(app, { js_errors:false, timeout:1000})
    end

    Capybara.default_driver = :poltergeist
    Capybara.javascript_driver = :poltergeist
  end

  def visit_site
    page = Capybara::Session.new(:poltergeist)
    page.driver.headers = { 'User-Agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/27.0.1453.116 Safari/537.36' }
    page.visit 'http://www.yahoo.co.jp'
    page.save_screenshot('screenshot.png', full:true)
    doc = Nokogiri::HTML.parse(page.html)
    puts doc.title
  end
end

scrape = Scrape.new
scrape.visit_site

1. Capybara::Session.new()に相当するもの?（予想）
2. 質問者様が挙げられているリンクのCapybara::Sessionを

　 押すとSessionについての説明を見ることができる。

参考：Rubyでスクレイピングしてみました。

Comments

[anvinon]

ご回答ありがとうございます。
既に退会済みになってしまっていますが、参考リンクも含めて拝見します。

ありがとうございました。