nom-xml 0.0.1

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+
+gemspec
+
+gem 'simplecov', :platform => :ruby_19
+gem 'rcov', :platform => :ruby_18

data/LICENSE

@@ -0,0 +1,11 @@
+Copyright © 2012 by The Board of Trustees of the Leland Stanford Junior University. All rights reserved.
+
+Redistribution and use of this distribution in source and binary forms, with or without modification, are permitted provided that:
+
+The above copyright notice and this permission notice appear in all copies and supporting documentation.
+
+The name, identifiers, and trademarks of The Board of Trustees of the Leland Stanford Junior University are not used in advertising or publicity without the express prior written permission of The Board of Trustees of the Leland Stanford Junior University.
+
+Recipients acknowledge that this distribution is made available as a research courtesy, “as is”, potentially with defects, without any obligation on the part of The Board of Trustees of the Leland Stanford Junior University to provide support, services, or repair.
+
+THE BOARD OF TRUSTEES OF THE LELAND STANFORD JUNIOR UNIVERSITY DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN NO EVENT SHALL THE BOARD OF TRUSTEES OF THE LELAND STANFORD JUNIOR UNIVERSITY BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,71 @@
+# NOM
+
+[![Build Status](https://secure.travis-ci.org/cbeer/nom.png)](http://travis-ci.org/cbeer/nom)
+
+A library to help you tame sprawling XML schemas
+
+NOM allows you to define a “terminology” to ease translation between XML and ruby objects – you can query the xml for Nodes or node values without ever writing a line of XPath.
+
+
+Some Handy Links
+----------------
+[API](http://rubydoc.info/github/cbeer/nom) - A reference to NOM's classes
+[#projecthydra](http://webchat.freenode.net/?channels=#projecthydra) on irc.freenode.net
+[Project Hydra Google Group](http://groups.google.com/group/hydra-tech) - community mailing list and forum
+
+An Example
+---------------
+
+```xml
+<?xml version="1.0"?>
+<!-- from http://www.alistapart.com/d/usingxml/xml_uses_a.html -->
+<nutrition>
+<food>
+	<name>Avocado Dip</name>
+	<mfr>Sunnydale</mfr>
+	<serving units="g">29</serving>
+	<calories total="110" fat="100"/>
+	<total-fat>11</total-fat>
+	<saturated-fat>3</saturated-fat>
+	<cholesterol>5</cholesterol>
+	<sodium>210</sodium>
+	<carb>2</carb>
+	<fiber>0</fiber>
+	<protein>1</protein>
+	<vitamins>
+		<a>0</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>0</ca>
+		<fe>0</fe>
+	</minerals>
+</food>
+</nutrition>
+```
+
+```ruby
+doc = Nokogiri::XML my_source_document
+
+doc.set_terminology do |t|
+  t.name
+
+  t.vitamins do |v|
+    v.a
+    v.c
+  end
+
+  t.minerals do |m|
+    m.calcium :path => 'ca'
+    m.iron :path => 'fe'
+  end
+end
+
+doc.nom!
+
+doc.name.text == 'Avocado Dip'
+doc.minerals.calcium.text == '0'
+```
+
+
+

data/Rakefile

@@ -0,0 +1,34 @@
+require 'rubygems'
+require 'bundler'
+require 'bundler/gem_tasks'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+task :default => :ci
+
+require 'rspec/core/rake_task'
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+
+  if ENV['COVERAGE'] and RUBY_VERSION =~ /^1.8/
+    t.rcov = true
+    t.rcov_opts = %w{--exclude spec\/*,gems\/*,ruby\/* --aggregate coverage.data}
+  end
+end
+
+require 'yard'
+YARD::Rake::YardocTask.new do |t|
+  t.options = ["--readme", "README.md"]
+end
+
+desc "Continuous Integration build"
+task :ci do
+  Rake::Task['spec'].invoke
+  Rake::Task['yard'].invoke
+end

data/lib/nom.rb

@@ -0,0 +1 @@
+require 'nom/xml'

data/lib/nom/xml.rb

@@ -0,0 +1,14 @@
+require 'nokogiri'
+
+module Nom
+  module XML
+    require 'nom/xml/version'
+    require 'nom/xml/terminology'
+    require 'nom/xml/decorators'
+
+    require 'nom/xml/nokogiri_extension'
+
+    Nokogiri::XML::Document.send(:include, NokogiriExtension)
+  end
+end
+

data/lib/nom/xml/decorators.rb

@@ -0,0 +1,6 @@
+module Nom::XML
+  module Decorators
+    require 'nom/xml/decorators/terminology'
+    require 'nom/xml/decorators/nodeset'
+  end
+end

data/lib/nom/xml/decorators/nodeset.rb

@@ -0,0 +1,10 @@
+module Nom::XML::Decorators::NodeSet
+	def method_missing sym, *args, &block
+		if self.all? { |node| node.respond_to? sym }
+			result = self.collect { |node| node.send(sym, *args, &block) }.flatten
+			self.class.new(self.document, result) rescue result
+		else
+			super
+		end
+	end
+end

data/lib/nom/xml/decorators/terminology.rb

@@ -0,0 +1,18 @@
+module Nom::XML::Decorators::Terminology
+  def self.extended klass
+
+    klass.add_terminology_methods!
+  end
+
+  def terms
+    @terms ||= []
+  end
+
+  def terms= terms
+    @terms = terms
+  end
+
+  def add_terminology_methods!
+    document.add_terminology_methods(self)
+  end
+end

data/lib/nom/xml/nokogiri_extension.rb

@@ -0,0 +1,84 @@
+module Nom::XML
+  module NokogiriExtension
+
+    def nom!
+      unless decorators(Nokogiri::XML::Node).include? Nom::XML::Decorators::Terminology
+        decorators(Nokogiri::XML::Node) << Nom::XML::Decorators::Terminology
+        decorate!
+      end
+
+      unless decorators(Nokogiri::XML::NodeSet).include? Nom::XML::Decorators::NodeSet
+        decorators(Nokogiri::XML::NodeSet) << Nom::XML::Decorators::NodeSet
+        decorate!
+      end
+
+      self
+    end
+
+    def set_terminology &block
+      @terminology = Nom::XML::Terminology.new &block
+    end
+
+    def terminology
+      @terminology ||= Nom::XML::Terminology.new
+    end
+
+    ##
+    # Add terminology accessors for querying child terms
+    # @param [Nokogiri::XML::Node] node
+    def add_terminology_methods node
+      if node == node.document.root or node.is_a? Nokogiri::XML::Document
+        node.terms = root_terms(node)
+      elsif not node.parent.terms.empty?
+        node.terms = child_terms(node)
+      end
+
+      node.terms.each do |k, t|
+        (class << node; self; end).send(:define_method, k.to_sym) do
+          if self.is_a? Nokogiri::XML::Document
+            result = self.root.xpath(t.local_xpath)
+          else
+            result = self.xpath(t.local_xpath)
+          end
+          m = t.options[:accessor]
+          case
+          when m.nil?
+            result
+          when m.is_a?(Symbol)
+            result.collect { |r| r.send(m) }
+          when m.is_a?(Proc)
+            result.collect { |r| m.call(r) }
+          else
+            raise "Unknown accessor class: #{m.class}"
+          end
+        end
+      end
+    end
+
+    private
+
+    def root_terms node
+      node.document.terminology.terms
+    end
+
+    def child_terms node
+      h = {}
+
+      terms_for_node(node).each do |k,v|
+        v.terms.each do |k1, v1|
+          h[k1] = v1
+        end
+      end
+
+      h
+    end
+
+    ##
+    #find this node in the terminology
+    def terms_for_node node
+      node.parent.terms.select do |k,term|
+        node.parent.xpath(term.local_xpath).include? node
+      end
+    end
+  end
+end

data/lib/nom/xml/terminology.rb

@@ -0,0 +1,129 @@
+module Nom::XML
+  class Term
+    attr_reader :name
+    attr_reader :terms
+    attr_reader :parent
+    attr_writer :parent
+    attr_reader :options
+
+    def initialize parent, name, options = {}, *args, &block
+      @name = name
+      @terms = {}
+      @parent = parent
+      @options = options || {}
+
+      in_edit_context do
+        yield(self) if block_given?
+      end
+    end
+
+    def in_edit_context &block
+      @edit_context = true
+      yield
+      @edit_context = false
+    end
+
+    def terms_from_node node
+      terms.select do |k, term|
+        node.parent.xpath(term.xpath).include? node
+      end.flatten
+    end
+
+    def in_edit_context?
+      @edit_context
+    end
+
+    def parent_xpath
+      @parent_xpath ||= self.parent.xpath
+    end
+
+    def clear_parent_cache
+      @parent_xpath = nil
+    end
+
+    def xpath
+      [parent_xpath, local_xpath].flatten.compact.join("/")
+    end
+
+    def local_xpath
+      (options[:path] || name).to_s
+    end
+    
+    def method_missing method, *args, &block 
+      if in_edit_context?
+        add_term(method, *args, &block)
+      elsif key?(method)
+        term(method)
+    #  else if options[:ref]
+    #    resolve_ref_and_return_term(method, *args, &block)
+      else
+        super
+      end
+      #terms[method]
+    end
+
+    def key? term
+      terms.key? term
+    end
+
+    def substitute_parent p
+      obj = self.dup
+
+      obj.parent = p
+      obj.clear_parent_cache
+
+      obj
+    end
+
+    protected
+    def add_term method, options = {}, *args, &block
+      terms[method] = if options[:ref]
+        TermRef.new(self, method, options, *args, &block)
+      else
+        Term.new(self, method, options, *args, &block)
+      end
+    end
+
+    def term method, *args, &block
+      terms[method]
+    end
+  end
+
+  class TermRef < Term
+    def ref
+      elements = Array(options[:ref])
+
+      elements.inject(parent) { |memo, mtd| memo.send(mtd) }
+    end
+
+    def key? term
+      ref.key? term
+    end
+
+    def local_xpath
+      (options[:path] || ref.local_xpath).to_s
+    end
+
+    def method_missing *args, &block
+      if in_edit_context?
+        super
+      else
+        ref.method_missing(*args, &block).substitute_parent(self)
+      end
+    end
+  end
+
+  class Terminology < Term
+    def initialize *args, &block
+      @terms = {}
+      in_edit_context do
+        yield(self) if block_given?
+      end
+    end
+
+
+    def xpath
+      nil
+    end
+  end
+end

data/lib/nom/xml/version.rb

@@ -0,0 +1,5 @@
+module Nom
+  module XML
+    VERSION = '0.0.1'
+  end
+end

data/nom.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "nom/xml/version"
+
+Gem::Specification.new do |s|
+  s.name = "nom-xml"
+  s.version = Nom::XML::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.authors = ["Chris Beer"]
+  s.email = %q{cabeer@stanford.edu}
+  s.homepage = %q{http://github.com/cbeer/nom}
+  s.summary = %q{ asdf }
+  s.description = %q{ asdfgh }
+
+  s.add_dependency 'nokogiri'
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "yard"
+  s.add_development_dependency "redcarpet"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.require_paths = ["lib"]
+end

data/spec/examples/nutrition_example_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe "Nutrition" do
+  let(:file) { File.open(File.join(File.dirname(__FILE__), '..', 'fixtures', 'nutrition.xml'), 'r') }
+  let(:xml) { Nokogiri::XML(file) }
+
+  subject {
+     xml.set_terminology do |t|
+       t.daily_values :path => 'daily-values' do |dv|
+         dv.total_fat :path => 'total-fat' do |tf|
+           tf.value :path => '.', :accessor => lambda { |node| node.text.to_i }
+           tf.units :path => '@units'
+         end
+       end
+
+       t.foods :path => 'food' do |food|
+         food._name :path => 'name'
+         food.mfr
+
+         food.total_fat :path => 'total-fat' do |tf|
+           tf.value :path => '.', :accessor => lambda { |node| node.text.to_i }
+         end
+       end
+     end
+
+     xml.nom!
+
+     xml
+  }
+
+  it "should have total fat information" do
+    subject.daily_values.total_fat.text.should == "65"
+    subject.daily_values.total_fat.value.should include(65)
+    subject.daily_values.total_fat.units.text.should =='g'
+
+    subject.foods.total_fat.value.inject(:+).should == 117
+  end
+
+  it "should have food names" do
+    subject.foods._name.text.should include("Avocado Dip")
+  end
+end

data/spec/fixtures/nutrition.xml

@@ -0,0 +1,236 @@
+<?xml version="1.0"?>
+<?xml-stylesheet type="text/css" href="nutrition.css"?>
+<nutrition>
+  <!-- sample from http://www.alistapart.com/d/usingxml/xml_uses_a.html -->
+
+<daily-values>
+	<total-fat units="g">65</total-fat>
+	<saturated-fat units="g">20</saturated-fat>
+	<cholesterol units="mg">300</cholesterol>
+	<sodium units="mg">2400</sodium>
+	<carb units="g">300</carb>
+	<fiber units="g">25</fiber>
+	<protein units="g">50</protein>
+</daily-values>
+
+<food>
+	<name>Avocado Dip</name>
+	<mfr>Sunnydale</mfr>
+	<serving units="g">29</serving>
+	<calories total="110" fat="100"/>
+	<total-fat>11</total-fat>
+	<saturated-fat>3</saturated-fat>
+	<cholesterol>5</cholesterol>
+	<sodium>210</sodium>
+	<carb>2</carb>
+	<fiber>0</fiber>
+	<protein>1</protein>
+	<vitamins>
+		<a>0</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>0</ca>
+		<fe>0</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Bagels, New York Style </name>
+	<mfr>Thompson</mfr>
+	<serving units="g">104</serving>
+	<calories total="300" fat="35"/>
+	<total-fat>4</total-fat>
+	<saturated-fat>1</saturated-fat>
+	<cholesterol>0</cholesterol>
+	<sodium>510</sodium>
+	<carb>54</carb>
+	<fiber>3</fiber>
+	<protein>11</protein>
+	<vitamins>
+		<a>0</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>8</ca>
+		<fe>20</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Beef Frankfurter, Quarter Pound </name>
+	<mfr>Armitage</mfr>
+	<serving units="g">115</serving>
+	<calories total="370" fat="290"/>
+	<total-fat>32</total-fat>
+	<saturated-fat>15</saturated-fat>
+	<cholesterol>65</cholesterol>
+	<sodium>1100</sodium>
+	<carb>8</carb>
+	<fiber>0</fiber>
+	<protein>13</protein>
+	<vitamins>
+		<a>0</a>
+		<c>2</c>
+	</vitamins>
+	<minerals>
+		<ca>1</ca>
+		<fe>6</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Chicken Pot Pie</name>
+	<mfr>Lakeson</mfr>
+	<serving units="g">198</serving>
+	<calories total="410" fat="200"/>
+	<total-fat>22</total-fat>
+	<saturated-fat>9</saturated-fat>
+	<cholesterol>25</cholesterol>
+	<sodium>810</sodium>
+	<carb>42</carb>
+	<fiber>2</fiber>
+	<protein>10</protein>
+	<vitamins>
+		<a>20</a>
+		<c>2</c>
+	</vitamins>
+	<minerals>
+		<ca>2</ca>
+		<fe>10</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Cole Slaw</name>
+	<mfr>Fresh Quick</mfr>
+	<serving units=" cup">1.5</serving>
+	<calories total="20" fat="0"/>
+	<total-fat>0</total-fat>
+	<saturated-fat>0</saturated-fat>
+	<cholesterol>0</cholesterol>
+	<sodium>15</sodium>
+	<carb>5</carb>
+	<fiber>2</fiber>
+	<protein>1</protein>
+	<vitamins>
+		<a>30</a>
+		<c>45</c>
+	</vitamins>
+	<minerals>
+		<ca>4</ca>
+		<fe>2</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Eggs</name>
+	<mfr>Goodpath</mfr>
+	<serving units="g">50</serving>
+	<calories total="70" fat="40"/>
+	<total-fat>4.5</total-fat>
+	<saturated-fat>1.5</saturated-fat>
+	<cholesterol>215</cholesterol>
+	<sodium>65</sodium>
+	<carb>1</carb>
+	<fiber>0</fiber>
+	<protein>6</protein>
+	<vitamins>
+		<a>6</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>2</ca>
+		<fe>4</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Hazelnut Spread</name>
+	<mfr>Ferreira</mfr>
+	<serving units="tbsp">2</serving>
+	<calories total="200" fat="90"/>
+	<total-fat>10</total-fat>
+	<saturated-fat>2</saturated-fat>
+	<cholesterol>0</cholesterol>
+	<sodium>20</sodium>
+	<carb>23</carb>
+	<fiber>2</fiber>
+	<protein>3</protein>
+	<vitamins>
+		<a>0</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>6</ca>
+		<fe>4</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Potato Chips</name>
+	<mfr>Lees</mfr>
+	<serving units="g">28</serving>
+	<calories total="150" fat="90"/>
+	<total-fat>10</total-fat>
+	<saturated-fat>3</saturated-fat>
+	<cholesterol>0</cholesterol>
+	<sodium>180</sodium>
+	<carb>15</carb>
+	<fiber>1</fiber>
+	<protein>2</protein>
+	<vitamins>
+		<a>0</a>
+		<c>10</c>
+	</vitamins>
+	<minerals>
+		<ca>0</ca>
+		<fe>0</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Soy Patties, Grilled</name>
+	<mfr>Gardenproducts</mfr>
+	<serving units="g">96</serving>
+	<calories total="160" fat="45"/>
+	<total-fat>5</total-fat>
+	<saturated-fat>0</saturated-fat>
+	<cholesterol>0</cholesterol>
+	<sodium>420</sodium>
+	<carb>10</carb>
+	<fiber>4</fiber>
+	<protein>9</protein>
+	<vitamins>
+		<a>0</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>0</ca>
+		<fe>0</fe>
+	</minerals>
+</food>
+
+<food>
+	<name>Truffles, Dark Chocolate</name>
+	<mfr>Lyndon's</mfr>
+	<serving units="g">39</serving>
+	<calories total="220" fat="170"/>
+	<total-fat>19</total-fat>
+	<saturated-fat>14</saturated-fat>
+	<cholesterol>25</cholesterol>
+	<sodium>10</sodium>
+	<carb>16</carb>
+	<fiber>1</fiber>
+	<protein>1</protein>
+	<vitamins>
+		<a>0</a>
+		<c>0</c>
+	</vitamins>
+	<minerals>
+		<ca>0</ca>
+		<fe>0</fe>
+	</minerals>
+</food>
+
+</nutrition>

data/spec/lib/nokogiri_extension_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Nom::XML::NokogiriExtension do
+  let(:doc) {
+    Nokogiri::XML(<<-eoxml)
+      <item>
+        <title>foo</title>
+        <description>this is the foo thing</description>
+        <nested>
+          <second_level>value</second_level>
+
+          <further_nesting>
+            <third_level>3rd</third_level>
+          </further_nesting>
+        </nested>
+      </item>
+    eoxml
+  }
+  describe "#add_terminology_methods" do
+    context "root node" do
+      it "should add terminology methods to the root node" do
+
+      end
+    end
+  end
+end

data/spec/lib/terminology_decorator_spec.rb

@@ -0,0 +1,6 @@
+require "spec_helper"
+
+describe Nom::XML::Decorators::Terminology do
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+if ENV['COVERAGE'] and RUBY_VERSION =~ /^1.9/
+  require 'simplecov'
+  SimpleCov.start
+end
+
+require 'rspec/autorun'
+require 'nom'
+
+RSpec.configure do |config|
+
+end
+

data/spec/test_spec.rb

@@ -0,0 +1,80 @@
+require 'spec_helper'
+
+describe Nom::XML do
+
+  it "should do stuff with terminologies" do
+    doc = Nokogiri::XML <<-eos
+  <root>
+  <element_a>a value</element_a>
+  <element_b>
+    <element_c>c value</element_c>
+  </element_b>
+  <element_d>
+    <element_e>
+      <element_f foo="bar">f value</element_f>
+    </element_e>
+  </element_d>
+  <element_g>
+    <element_h>h value 1</element_h>
+    <element_h>h value 2</element_h>
+  </element_g>
+  <element_g>
+    <element_h>h value 3</element_h>
+  </element_g>
+  </root>
+    eos
+
+    doc.set_terminology do |t|
+      t.element_a
+      t.element_b do |n|
+        n.element_c
+      end
+      t.element_d do |n|
+        n.element_e do |e|
+          e.element_f
+          e.foo :path => 'element_f/@foo'
+          e.foo_text :path => 'element_f/@foo', :accessor => :text
+        end
+      end
+      t.element_g do |n|
+        n.element_h :accessor => :text
+        n.whatever :path => "*", :accessor => lambda { |node| [node.name,node.text].join(':') }
+      end
+    end
+
+    doc.nom!
+
+    doc.root.element_a.text.should == 'a value'
+    doc.root.element_b.element_c.text.should == 'c value'
+    doc.root.element_d.element_e.element_f.text.strip.should == 'f value'
+    doc.root.element_d.element_e.foo.collect(&:text).should == ['bar']
+    doc.root.element_d.element_e.foo_text.should == ['bar']
+    doc.root.element_g.first.element_h.should == ['h value 1','h value 2']
+    doc.root.element_g.element_h.should == ['h value 1','h value 2','h value 3']
+    doc.root.element_g.whatever.should == ['element_h:h value 1','element_h:h value 2','element_h:h value 3']
+  end
+end
+
+describe Nom do
+  ### High level goals
+  #Given a tree like:
+  # <level1> 
+  #   <level2 id="parent1">
+  #     <level3 id="target1"/>
+  #     <level3 id="target1"/>
+  #   </level2>
+  #   <level2 id="parent2">
+  #     <level3 id="target3"/>
+  #   </level2>
+  # </level1>
+
+  it "Should be able to query for all the 'level3' nodes (leafs with different parents)" 
+  it "Should be able to query for all the 'level3' nodes that are children of parent1 (leafs with same parent)" 
+  it "Should be able to query for the nth child of a specific node"
+  it "Should be able to update the inner text of a specific target node"
+  it "Should be able to update the inner texts of a bunch of nodes????? (e.g. find('level2 > level3').innerText=['one', 'two', 'three']"
+  it "Should be able to add a subtree at a specific point in the graph"
+  it "Should be able to remove a subtree from the graph"
+  it "should be able to set the text content of a node to nil"
+ 
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: nom-xml
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Chris Beer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! ' asdfgh '
+email: cabeer@stanford.edu
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/nom.rb
+- lib/nom/xml.rb
+- lib/nom/xml/decorators.rb
+- lib/nom/xml/decorators/nodeset.rb
+- lib/nom/xml/decorators/terminology.rb
+- lib/nom/xml/nokogiri_extension.rb
+- lib/nom/xml/terminology.rb
+- lib/nom/xml/version.rb
+- nom.gemspec
+- spec/examples/nutrition_example_spec.rb
+- spec/fixtures/nutrition.xml
+- spec/lib/nodeset_decorator_spec.rb
+- spec/lib/nokogiri_extension_spec.rb
+- spec/lib/terminology_decorator_spec.rb
+- spec/lib/terminology_spec.rb
+- spec/spec_helper.rb
+- spec/test_spec.rb
+homepage: http://github.com/cbeer/nom
+licenses: []
+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: 1208570413108466077
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1208570413108466077
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: asdf
+test_files:
+- spec/examples/nutrition_example_spec.rb
+- spec/fixtures/nutrition.xml
+- spec/lib/nodeset_decorator_spec.rb
+- spec/lib/nokogiri_extension_spec.rb
+- spec/lib/terminology_decorator_spec.rb
+- spec/lib/terminology_spec.rb
+- spec/spec_helper.rb
+- spec/test_spec.rb
+has_rdoc: