craft 0.1.0 → 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0d73f28ad0726d5645b313a8692748e7513f0b8e
+  data.tar.gz: 63a7eda56f737e4e52e281390117f5dda143a0b4
+SHA512:
+  metadata.gz: 336a3002c19325e9079b56be7dd69d60cd02e332c1004592fe7aafd7d2b2b74385cf5bef45d3c221f6e12fde68b0798ff04f1fc5962057e47af2f408a5c6905a
+  data.tar.gz: 7070a01973af959e33fe286d9b68e4f36c89d930c65774916e4eca99136520f50311b0e4b618ccf96dc2e299d3f674c4ce6056f7bc70dd7f54b1c4678575131d

data/Gemfile

@@ -1,13 +1,2 @@
 source 'https://rubygems.org'
-
-# Specify your gem's dependencies in craft.gemspec
 gemspec
-
-group :ci do
-  gem 'rake'
-end
-
-platforms :jruby do
-  gem 'minitest'
-end
-gem 'pry'

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Hakan Ensari
+Copyright (c) 2013 Hakan Ensari
 
 MIT License
 
@@ -19,4 +19,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,42 +1,6 @@
-# Craft [![Build Status](https://secure.travis-ci.org/papercavalier/craft.png)](http://travis-ci.org/papercavalier/craft)
+# Craft
 
-Craft XML and HTML into objects.
+Build [page objects][po] in [Capybara][ca].
 
-## Examples
-```ruby
-require 'craft'
-require 'open-uri'
-
-class Page < Craft
-  # Use CSS selectors
-  one   :title,   'title'
-
-  # Use XPath
-  many  :links,   'a/@href'
-
-  # Perform transforms on returned nodes
-  many  :images,  'img', lambda { |img| img.attr('src').upcase }
-
-  # Stub attributes that don't need to be parsed
-  stub :spidered_at, lambda { Time.now }
-end
-
-page = Page.parse open('http://www.google.com')
-
-page.title #=> 'Google'
-page.links #=> ['http://www.google.com/imghp?hl=en&tab=wi', ...]
-page.images #=> ['/LOGOS/2012/MOBY_DICK12-HP.JPG']
-
-page.attributes #=> { :title => 'Google', :links => ... }
-
-class Script < Craft
-  one :body, 'text()'
-end
-
-class Page < Craft
-  many :scripts, 'script', Script
-end
-
-page = Page.parse open('http://www.google.com')
-page.scripts[0].body #=> 'window.google=...'
-```
+[po]: https://code.google.com/p/selenium/wiki/PageObjects
+[ca]: https://github.com/jnicklas/capybara

data/Rakefile

@@ -2,7 +2,5 @@ require 'bundler/gem_tasks'
 require 'rake/testtask'
 
 Rake::TestTask.new do |t|
-    t.pattern = "spec/*_spec.rb"
+  t.pattern = 'test/*_test.rb'
 end
-
-task :default => :test

data/craft.gemspec

@@ -6,17 +6,17 @@ require 'craft/version'
 Gem::Specification.new do |gem|
   gem.name          = 'craft'
   gem.version       = Craft::VERSION
-  gem.authors       = ['Ezekiel Templin', 'Hakan Ensari']
-  gem.email         = ['code@papercavalier.com']
-  gem.description   = %q{Craft XML into objects}
-  gem.summary       = %q{Craft is a data extraction tool that crafts objects
-                         out of HTML and XML.}
-  gem.homepage      = 'http://papercavalier.com/craft/'
+  gem.authors       = ['Hakan Ensari']
+  gem.email         = ['hakan.ensari@papercavalier.com']
+  gem.summary       = 'Build page objects in Capybara'
+  gem.homepage      = 'https://github.com/hakanensari/craft'
 
   gem.files         = `git ls-files`.split($/)
-  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
-  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.test_files    = gem.files.grep(%r{^test/})
   gem.require_paths = ['lib']
 
-  gem.add_dependency 'nokogiri', '~> 1.5'
+  gem.add_dependency 'capybara', '~> 2.1'
+  gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'poltergeist'
+  gem.add_development_dependency 'rake'
 end

data/lib/craft.rb

@@ -1,127 +1,17 @@
-require 'craft/version'
-require 'nokogiri'
+require 'capybara'
 
-# Craft objects out of HTML and XML.
-#
-# Examples
-#
-#   module Transformations
-#     IntegerTransform = lambda { |n| Integer n.text }
-#     Timestamp        = lambda { Time.now }
-#   end
-#
-#   class Person < Craft
-#     include Transformations
-#
-#     one :name, 'div.name'
-#     one :age, 'div.age', IntegerTransform
-#     many :friends, 'li.friend', Person
-#     stub :created_at, Timestamp
-#   end
-#
-class Craft
-  class << self
-    # Returns an Array of names for the attributes defined in the class.
-    attr :attribute_names
-
-    # Define an attribute that extracts a collection of values from a parsed
-    # document.
-    #
-    # name  - The Symbol name of the attribute.
-    # paths - One or more String XPath of CSS queries. An optional Proc
-    #         transformation on the extracted value may be appended. If none is
-    #         appended, the default transformation returns the stripped String
-    #         value of the node.
-    #
-    # Returns nothing.
-    def many(name, *paths)
-      transform = pop_transform_from_paths paths
-      @attribute_names << name
-
-      define_method name do
-        @node.search(*paths).map { |node| instance_exec node, &transform }
-      end
-    end
-
-    # Define an attribute that extracts a single value from a parsed document.
-    #
-    # name  - The Symbol name of the attribute.
-    # paths - One or more String XPath of CSS queries. An optional Proc
-    #         transformation on the extracted value may be appended. If none is
-    #         appended, the default transformation returns the stripped String
-    #         value of the node.
-    #
-    # Returns nothing.
-    def one(name, *paths)
-      transform = pop_transform_from_paths paths
-      @attribute_names << name
-
-      define_method name do
-        instance_exec @node.at(*paths), &transform
-      end
-    end
-
-    # Parse a document.
-    #
-    # body - A String HTML or XML document.
-    #
-    # Returns an instance of its self.
-    def parse(body)
-      new Nokogiri body
-    end
-
-    # Define an attribute that returns a value without parsing the document.
-    #
-    # name  - The Symbol name of the attribute.
-    # value - Some value the attribute should return. If given a Proc, the
-    #         value will be generated dynamically (default: nil).
-    #
-    # Returns nothing.
-    def stub(name, value = nil)
-      @attribute_names << name
-
-      define_method name do
-        value.respond_to?(:call) ? instance_exec(&value) : value
-      end
-    end
-
-    def to_proc
-      klass = self
-      ->(node) { klass.new node, self }
-    end
+module Craft
+  include Capybara::DSL
 
-    private
-
-    def inherited(subclass)
-      subclass.instance_variable_set :@attribute_names, []
-    end
+  class << self
+    attr_accessor :driver
 
-    def pop_transform_from_paths(array)
-      if array.last.respond_to? :to_proc
-        array.pop
-      else
-        ->(node) { node.text.strip if node }
-      end
+    def session
+      Thread.current[:session] ||= Capybara::Session.new(driver)
     end
   end
 
-  attr :parent
-
-  # Craft a new object.
-  #
-  # node - A Nokogiri::XML::Node.
-  def initialize(node, parent = nil)
-    @node = node
-    @parent = parent
-  end
-
-  # Returns the Hash attributes.
-  def attributes
-    Hash[attribute_names.map { |key| [key, self.send(key)] }]
-  end
-
-  # Returns an Array of names for the attributes on this object.
-  def attribute_names
-    self.class.attribute_names
+  def page
+    Craft.session
   end
 end

data/lib/craft/version.rb

@@ -1,3 +1,3 @@
-class Craft
-  VERSION = '0.1.0'
+module Craft
+  VERSION = '0.2.0'
 end

data/test/craft_test.rb

@@ -0,0 +1,50 @@
+require 'minitest/autorun'
+require 'capybara/poltergeist'
+require 'craft'
+
+Craft.driver = :poltergeist
+
+class Home
+  include Craft
+
+  def initialize
+    visit('http://www.duckduckgo.com')
+  end
+
+  def search(query)
+    fill_in('q', with: query)
+    click_on('search_button_homepage')
+
+    Search.new
+  end
+end
+
+class Search
+  include Craft
+
+  def results
+    all('.results_links_deep')
+  end
+end
+
+class TestCraft < Minitest::Test
+  def test_browser
+    duck = Home.new
+    search = duck.search('ruby')
+
+    refute_empty search.results
+  end
+
+  def test_session
+    thrs = %w(ruby python)
+      .map { |query|
+        Thread.new {
+          Thread.current[:current_url] = Home.new.search(query).current_url
+        }
+      }
+      .map(&:join)
+
+    refute_equal thrs.first[:current_url], thrs.last[:current_url]
+  end
+end
+

metadata

@@ -1,43 +1,80 @@
 --- !ruby/object:Gem::Specification
 name: craft
 version: !ruby/object:Gem::Version
-  version: 0.1.0
-  prerelease: 
+  version: 0.2.0
 platform: ruby
 authors:
-- Ezekiel Templin
 - Hakan Ensari
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-25 00:00:00.000000000 Z
+date: 2013-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: nokogiri
+  name: capybara
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.5'
-description: Craft XML into objects
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  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: poltergeist
+  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: rake
+  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'
+description: 
 email:
-- code@papercavalier.com
+- hakan.ensari@papercavalier.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
 - .travis.yml
-- CHANGES.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -45,36 +82,30 @@ files:
 - craft.gemspec
 - lib/craft.rb
 - lib/craft/version.rb
-- spec/craft_spec.rb
-homepage: http://papercavalier.com/craft/
+- test/craft_test.rb
+homepage: https://github.com/hakanensari/craft
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 2821744877133646519
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 2821744877133646519
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.0.5
 signing_key: 
-specification_version: 3
-summary: Craft is a data extraction tool that crafts objects out of HTML and XML.
+specification_version: 4
+summary: Build page objects in Capybara
 test_files:
-- spec/craft_spec.rb
+- test/craft_test.rb
+has_rdoc: 

data/CHANGES.md

@@ -1,8 +0,0 @@
-v0.1.0
------------
-
-- When nesting, make parent accessible to child.
-- Craft#attributes returns the attributes.
-- Craft.stub stubs a static or dynamic value that doesn't need to be parsed in
-  the document.
-- Transforms are executed in the context of the crafted object.

data/spec/craft_spec.rb

@@ -1,131 +0,0 @@
-require 'bundler/setup'
-require 'minitest/autorun'
-require 'craft'
-
-describe Craft do
-  let(:html) { '<html><ul><li>1</li><li>2</li>' }
-  let(:klass) { Class.new Craft }
-  let(:instance) { klass.parse html }
-
-  describe '.attribute_names' do
-    it 'is empty by default' do
-      klass.attribute_names.must_equal []
-    end
-
-    it 'does not reference other attribute names' do
-      klass.stub :foo
-      other = Class.new(Craft) { stub :bar }
-      klass.attribute_names.wont_equal other.attribute_names
-    end
-  end
-
-  describe '.many' do
-    it 'extracts nodes' do
-      klass.many :foo, 'li'
-      instance.foo.must_equal %w(1 2)
-    end
-
-    it 'transforms' do
-      klass.many :foo, 'li', ->(node) { node.text.to_i }
-      instance.foo.must_equal [1, 2]
-    end
-
-    it 'transforms in scope' do
-      klass.many :foo, 'li', ->(node) { bar }
-      klass.send(:define_method, :bar) { 'bar' }
-      instance.foo.must_equal ['bar', 'bar']
-    end
-
-    it 'stores attribute name' do
-      klass.many :foo, 'li'
-      klass.attribute_names.must_include :foo
-    end
-
-    it 'nests' do
-      klass.many :foo, 'ul', Class.new(Craft)
-      instance.foo.each { |attr| attr.must_be_kind_of Craft }
-    end
-
-    it 'has a parent when nested' do
-      klass.many :foo, 'li', Class.new(Craft)
-      instance.foo.each { |attr| attr.parent.must_equal instance }
-    end
-  end
-
-  describe '.one' do
-    it 'extracts a node' do
-      klass.one :foo, 'li'
-      instance.foo.must_equal '1'
-    end
-
-    it 'transforms' do
-      klass.one :foo, 'li', ->(node) { node.text.to_i }
-      instance.foo.must_equal 1
-    end
-
-    it 'transforms in scope' do
-      klass.one :foo, 'li', ->(node) { bar }
-      klass.send(:define_method, :bar) { 'bar' }
-      instance.foo.must_equal 'bar'
-    end
-
-    it 'stores attribute name' do
-      klass.one :foo, 'li'
-      klass.attribute_names.must_include :foo
-    end
-
-    it 'nests' do
-      klass.one :foo, 'ul', Class.new(Craft)
-      instance.foo.must_be_kind_of Craft
-    end
-
-    it 'has a parent when nested' do
-      klass.one :foo, 'li', Class.new(Craft)
-      instance.foo.parent.must_equal instance
-    end
-
-    describe 'given no matches' do
-      before { klass.one :foo, 'bar' }
-
-      it 'returns nil' do
-        instance.foo.must_be_nil
-      end
-    end
-  end
-
-  describe '.stub' do
-    it 'returns nil by default' do
-      klass.stub :foo
-      instance.foo.must_be_nil
-    end
-
-    it 'returns a static value' do
-      klass.stub :foo, 1
-      instance.foo.must_equal 1
-    end
-
-    it 'returns a dynamic value' do
-      klass.stub :foo, -> { Time.now }
-      instance.foo.must_be_instance_of Time
-    end
-
-    it 'transforms in scope' do
-      klass.stub :foo, -> { bar }
-      klass.send(:define_method, :bar) { 'bar' }
-      instance.foo.must_equal 'bar'
-    end
-
-    it 'stores attribute name' do
-      klass.stub :foo
-      klass.attribute_names.must_include :foo
-    end
-  end
-
-  describe '#attributes' do
-    it 'returns attributes' do
-      klass.stub :foo
-      klass.one  :bar, 'li'
-      instance.attributes.must_equal({ foo: nil, bar: '1' })
-    end
-  end
-end