dozuki 0.0.1 → 0.0.3

data/CI

@@ -0,0 +1,13 @@
+#!/bin/bash -lxe
+[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
+rvm use 1.9.2@dozuki
+
+if [ `type -P bundle` ]
+then
+  echo "BUNDLER DETECTED"
+else 
+  gem install bundler
+fi
+
+bundle install
+rake

data/Gemfile.lock

@@ -7,34 +7,35 @@ PATH
 GEM
   remote: http://rubygems.org/
   specs:
-    ZenTest (4.4.2)
+    ZenTest (4.5.0)
     archive-tar-minitar (0.5.2)
     autotest (4.4.6)
       ZenTest (>= 4.4.1)
     builder (3.0.0)
     columnize (0.3.2)
-    cucumber (0.10.0)
+    cucumber (0.10.2)
       builder (>= 2.1.2)
-      diff-lcs (~> 1.1.2)
-      gherkin (~> 2.3.2)
-      json (~> 1.4.6)
-      term-ansicolor (~> 1.0.5)
+      diff-lcs (>= 1.1.2)
+      gherkin (>= 2.3.5)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.5)
     diff-lcs (1.1.2)
-    gherkin (2.3.3)
-      json (~> 1.4.6)
-    json (1.4.6)
-    linecache19 (0.5.11)
+    gherkin (2.3.6)
+      json (>= 1.4.6)
+    json (1.5.1)
+    linecache19 (0.5.12)
       ruby_core_source (>= 0.1.4)
     nokogiri (1.4.4)
-    rspec (2.3.0)
-      rspec-core (~> 2.3.0)
-      rspec-expectations (~> 2.3.0)
-      rspec-mocks (~> 2.3.0)
-    rspec-core (2.3.1)
-    rspec-expectations (2.3.0)
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
       diff-lcs (~> 1.1.2)
-    rspec-mocks (2.3.0)
-    ruby-debug-base19 (0.11.24)
+    rspec-mocks (2.5.0)
+    ruby-debug-base19 (0.11.25)
       columnize (>= 0.3.1)
       linecache19 (>= 0.5.11)
       ruby_core_source (>= 0.1.4)
@@ -42,7 +43,7 @@ GEM
       columnize (>= 0.3.1)
       linecache19 (>= 0.5.11)
       ruby-debug-base19 (>= 0.11.19)
-    ruby_core_source (0.1.4)
+    ruby_core_source (0.1.5)
       archive-tar-minitar (>= 0.5.2)
     term-ansicolor (1.0.5)
 
@@ -53,6 +54,6 @@ DEPENDENCIES
   autotest
   cucumber
   dozuki!
-  nokogiri
+  rake
   rspec
   ruby-debug19

data/{README.rdoc → README.markdown}

@@ -1,8 +1,10 @@
-= Dozuki
+# Dozuki
 
 A Nokogiri wrapper that simplifies commonly occurring tasks.
 
-== What does it do?
+[![Build Status](http://travis-ci.org/JamesAlmond/dozuki.png)](http://travis-ci.org/JamesAlmond/dozuki)
+
+## What does it do?
 
 Dozuki removes the repetitive tasks from parsing XML documents with XPaths such as:
 
@@ -14,73 +16,82 @@ Dozuki removes the repetitive tasks from parsing XML documents with XPaths such
 
 It's mainly sugar for reducing the amount of chaining on calls like:
 
-  doc.xpath('/my/xpath').first.to_i
+    doc.xpath('/my/xpath').first.to_i
+
+to:
 
-== How do I use it?
+    doc.int('/my/xpath')
 
-Parsing XML (currently only supports strings):
+## How do I use it?
 
-  doc = Dozuki::XML.parse(xml_string)
+The parse method supports all input parameters supported by [Nokogiri's
+parse method](http://nokogiri.org/Nokogiri/XML/Document.html#parse):
+
+    # simple usage
+    doc = Dozuki::XML.parse(string_or_io)
+    
+    # or the full parameter list
+    doc = Dozuki::XML.parse(string_or_io, url = nil, encoding = nil, options = ParseOptions::DEFAULT_XML)
 
 This documents supports the Dozuki extensions for:
 
-=== Extracting a single node
+### Extracting a single node
 
 The get methods takes an xpath and returns the first node that matches the xpath:
 
-  doc.get('/my/xpath')
+    doc.get('/my/xpath')
 
 If the node can't be found then an exception is raised.
 
-=== Extracting a single node of a certain type
+### Extracting a single node of a certain type
 
 The following methods take the first node that matches the xpath and returns the formatted result:
 
-  doc.string('/my/xpath') # surrounding whitespace stripped
-  doc.float('/my/xpath')
-  doc.int('/my/xpath')
+    doc.string('/my/xpath') # surrounding whitespace stripped
+    doc.float('/my/xpath')
+    doc.int('/my/xpath')
 
 These functions are to replace calls using plain Nokogiri such as:
 
   doc.xpath('/my/xpath').first.to_i
 
-=== Checking whether an element exists
+### Checking whether an element exists
 
-  doc.exists?('/my/xpath')
+    doc.exists?('/my/xpath')
 
-=== Iterating through nodes
+### Iterating through nodes
 
 Dozuki also provides a slightly more succinct way to 'each' an xpath:
 
-  doc.each('/my/xpath') do |node|
-    # do something
-  end
+    doc.each('/my/xpath') do |node|
+      # do something
+    end
 
-=== Iterating through node text and parsing
+## Iterating through node text and parsing
 
 There are also simple ways to extract formatted text of a series of nodes with an each
 
-  doc.each('/my/xpath').as_string do |node|
-    # string with surrounding whitespace stripped
-  end
-  
-  doc.each('/my/xpath').as_int do |node|
-    # int
-  end
-  
-  doc.each('/my/xpath').as_float do |node|
-    # float
-  end
+    doc.each('/my/xpath').as_string do |node|
+      # string with surrounding whitespace stripped
+    end
+
+    doc.each('/my/xpath').as_int do |node|
+      # int
+    end
+
+    doc.each('/my/xpath').as_float do |node|
+      # float
+    end
 
-== Playing nicely with Nokogiri
+## Playing nicely with Nokogiri
 
 Dozuki will proxy any calls not recognised onto the underlying Nokogiri structure, including responds_to?, allowing you to treat it like any other Nokogiri document.
 
-== More documentation
+## More documentation
 
-More features are described in the.. {features}[https://github.com/jamesalmond/dozuki/tree/master/features]
+More features are described in the.. [features](https://github.com/jamesalmond/dozuki/tree/master/features)
 
-== Contributing to Dozuki
+## Contributing to Dozuki
  
 * Fork the project.
 * Add tests that cover the new feature or bug fix.
@@ -88,13 +99,13 @@ More features are described in the.. {features}[https://github.com/jamesalmond/d
 * Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself in another branch so I can ignore when I pull)
 * Send me a pull request. Bonus points for topic branches.
 
-== LICENSE:
+## LICENSE:
 
 (The MIT License)
 
 Copyright (c) 2010:
 
-* {James Almond}[http://jamesalmond.com]
+* [James Almond](http://jamesalmond.com)
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -113,4 +124,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.
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -1,2 +1,19 @@
 require 'bundler'
 Bundler::GemHelper.install_tasks
+
+require 'rspec'
+require 'rspec/core/rake_task'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+
+
+desc "Run specs"
+RSpec::Core::RakeTask.new :spec
+
+desc "Run integrations"
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty"
+end
+task :default => [:spec, :features]
+

data/dozuki.gemspec

@@ -18,12 +18,13 @@ Gem::Specification.new do |s|
   s.test_files    = `git ls-files -- {spec,features}/* .autotest`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
-  
+
   s.add_dependency("nokogiri")
-  
+
   s.add_development_dependency("rspec")
   s.add_development_dependency("cucumber")
   s.add_development_dependency("ruby-debug19")
   s.add_development_dependency("autotest")
-  
+  s.add_development_dependency("rake")
+
 end

data/features/each_accessor.feature

@@ -2,71 +2,43 @@ Feature: Iterating through nodes
   In order to provide simpler way of accessing groups of nods
   As a traverser
   I want to access nodes using the each method and an xpath
-  
-  Scenario: using each to traverse a document
-    When I parse the XML:
+
+  Background:
+    Given I have parsed the XML:
       """
         <root>
           <name>St. George's Arms</name>
-          <average_price>20.32</average_price>
-          <number_of_beers>2</number_of_beers>
           <rooms>
             <room>SINGLE</room>
             <room>Double</room>
           </rooms>
+          <room_numbers>
+            <number>5</number>
+            <number>7</number>
+          </room_numbers>
+          <prices>
+            <price>53.50</price>
+            <price>799.78</price>
+          </prices>
         </root>
       """
-    And I call "each('/root/rooms/room')" on the document and collect the results
+
+  Scenario: using each to traverse a document
+    When I call "each('/root/rooms/room')" on the document and collect the results
     Then the results should contain a node with the text "SINGLE"
     And the results should contain a node with the text "Double"
-  
+
   Scenario: using each to traverse a document and getting the string elements
-    When I parse the XML:
-      """
-        <root>
-          <name>St. George's Arms</name>
-          <average_price>20.32</average_price>
-          <number_of_beers>2</number_of_beers>
-          <rooms>
-            <room>SINGLE</room>
-            <room>Double</room>
-          </rooms>
-        </root>
-      """
-    And I call "each('/root/rooms/room').as_string" on the document and collect the results
+    When I call "each('/root/rooms/room').as_string" on the document and collect the results
     Then the results should contain "SINGLE"
     And the results should contain "Double"
-  
+
   Scenario: using each to traverse a document and getting the integer elements
-    When I parse the XML:
-      """
-        <root>
-          <name>St. George's Arms</name>
-          <average_price>20.32</average_price>
-          <number_of_beers>2</number_of_beers>
-          <rooms>
-            <room>5</room>
-            <room>7</room>
-          </rooms>
-        </root>
-      """
-    And I call "each('/root/rooms/room').as_int" on the document and collect the results
+    When I call "each('/root/room_numbers/number').as_int" on the document and collect the results
     Then the results should contain 5
-    And the results should contain 5
-  
+    And the results should contain 7
+
   Scenario: using each to traverse a document and getting the float elements
-    When I parse the XML:
-      """
-        <root>
-          <name>St. George's Arms</name>
-          <average_price>20.32</average_price>
-          <number_of_beers>2</number_of_beers>
-          <rooms>
-            <room>53.50</room>
-            <room>799.78</room>
-          </rooms>
-        </root>
-      """
-    And I call "each('/root/rooms/room').as_float" on the document and collect the results
+    When I call "each('/root/prices/price').as_float" on the document and collect the results
     Then the results should contain 53.50
-    And the results should contain 799.78
+    And the results should contain 799.78

data/features/exists_accessor.feature

@@ -2,8 +2,7 @@ Feature: Exists accessor
   In order to easily determine whether a node exists in a document
   As a traverser
   I want to check whether a node exists
-  
-  
+
   Scenario: the node exists
     When I parse the XML:
       """
@@ -15,7 +14,7 @@ Feature: Exists accessor
       """
     And I call "exists?('/root/number_of_beers')" on the document
     Then the result should be true
-    
+
   Scenario: the node doesn't exist
     When I parse the XML:
       """
@@ -26,4 +25,4 @@ Feature: Exists accessor
         </root>
       """
     And I call "exists?('/root/food')" on the document
-    Then the result should be false
+    Then the result should be false

data/features/float_accessor.feature

@@ -2,43 +2,37 @@ Feature: Getting floats from the document
   In order to provide simpler way of getting floats from a node
   As a traverser
   I want to access nodes using the float method and an xpath
-  
-  Scenario: getting the float of a single node
-    When I parse the XML:
+
+  Background:
+    Given I have parsed the XML:
       """
         <root>
           <name>St. George's Arms</name>
           <average_price>20.32</average_price>
+          <highest_price>
+            30.33
+          </highest_price>
           <number_of_beers>2</number_of_beers>
         </root>
       """
-    And I call "float('/root/average_price')" on the document
+
+  Scenario: getting the float of a single node
+    When I call "float('/root/average_price')" on the document
     Then the result should be 20.32
-    
+
   Scenario: getting the float of a single node with whitespace
-    When I parse the XML:
-      """
-        <root>
-          <name>St. George's Arms</name>
-          <average_price>
-            20.32
-          </average_price>
-          <number_of_beers>2</number_of_beers>
-        </root>
-      """
-    And I call "float('/root/average_price')" on the document
-    Then the result should be 20.32
-    
+    When I call "float('/root/highest_price')" on the document
+    Then the result should be 30.33
+
+  Scenario: getting the int of a node that doesn't contain a float
+    When I call "float('/root/name')" on the document
+    Then it should raise an "InvalidFormat" error
+    And the error should have the value "St. George's Arms"
+    And the error should have the format "float"
+
   Scenario: getting a non-existent node
-    When I parse the XML:
-      """
-        <root>
-          <name>St. George's Arms</name>
-          <average_price>20.32</average_price>
-          <number_of_beers>2</number_of_beers>
-        </root>
-      """
-    Then calling "float('//something/missing')" on the document should raise a "NotFound" error
+    When I call "float('//something/missing')" on the document
+    Then it should raise a "NotFound" error
     And the error should have the xpath "//something/missing"
     And the error should have a stored node
-    
+