rasantiago-tiny_xpath_helper 0.1.0

data/README.rdoc

@@ -0,0 +1,48 @@
+= TinyXPathHelper
+
+== Description
+
+Very light syntax for using XPaths on XML documents or REXML nodes
+
+== Examples
+
+TinyXPathHelper.new takes one parameter: an XML document (as a string or IO) or a REXML element
+  >> xpath = TinyXPathHelper.new( File.open( 'test/xml/sample.xml' ) )
+
+Then, to find the string values of matching nodes, there's a super-light syntax:
+  >> xpath[ 'node/' ]
+  => ["one", "two", "three\n    "]
+
+It works on attributes, too
+  >> xpath[ 'node/@style' ]
+  => ["first"]
+
+If you prefer, you can use #all instead of square brackets
+  >> xpath.all( 'node/@style' )
+  => ["first"]
+
+If you just want the first match, use #first
+  >> xpath.first( 'node/' )
+  => "one"
+
+A slightly more elaborate API is available as #find_xpath
+  >> xpath.find_xpath( 'node/@style', :format => :xml, :find => :first )
+  => style='first'
+
+Where :format can be :text (returns a string), or :xml (returns a REXML element),
+and :find can be :first or :all
+
+  >> xpath.find_xpath( 'node/@style', :format => :xml, :find => :all )
+  => [style='first']
+
+The output from :format => :xml is suitable for passing to another TinyXPathHelper
+  >> node_tree = xpath.find_xpath( 'node/three', :format => :xml )
+  >> deeper_xpath = TinyXPathHelper.new( node_tree )
+  >> deeper_xpath[ 'b/@beta' ]
+  => ["true"]
+  
+--
+doctest_require: 'lib/tiny_xpath_helper.rb'
+++
+
+Copyright (c) 2009 raSANTIAGO + Associates LLC

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the tiny_xpath_helper plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the tiny_xpath_helper plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'TinyXPathHelper'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), "lib", "tiny_path_helper")

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/tiny_xpath_helper.rb

@@ -0,0 +1,97 @@
+require 'rexml/document'
+
+class TinyXPathHelper
+  attr :node
+
+  def initialize(xml)
+    @xml  = xml
+    @node = self.class.xml_node_for_xmlish(xml)
+  end
+  
+  def find_xpath(xpath_expr, options = {})
+    self.class.find_xpath_from( node, xpath_expr, options )
+  end
+
+  alias at find_xpath
+
+  def first(xpath_expr, options = {})
+    self.find_xpath( xpath_expr, options.update(:find => :first) )
+  end
+
+  def all(xpath_expr, options = {})
+    self.find_xpath( xpath_expr, options.update(:find => :all) )
+  end
+  alias [] all
+
+  def self.io_stream_classes
+    [ IOStream ] rescue [ IO, StringIO ] # thoughtbot-paperclip fixes the ducktype mess here
+  end
+
+  def self.classes_that_are_xmlish
+    io_stream_classes + [ String, REXML::Document ]
+  end
+
+  def self.xml_node_for_xmlish( xml )
+    if io_stream_classes.any?{|k| k === xml }
+      xml = xml.read
+    end
+    if String === xml
+      xml = REXML::Document.new(xml)
+    end
+    if REXML::Document === xml
+      xml = xml.root
+    end
+    if not REXML::Element === xml
+      raise TypeError.new("Expected REXML::Element, got #{xml.class}")
+    end
+    return xml
+  end
+
+  def self.xml_node_to_text(node)
+    if(node.respond_to? :text)
+      # XML::Elements don't to_s in the way we want
+      val = node.text
+    else
+      val = node.to_s
+    end
+  end
+
+  def self.find_xpath_from(element, path, options = {}, &blk)
+
+    format = options[:format] || :text
+    if format == :array
+      options.update( :format => :text, :find => :all )
+    end
+
+    count = options[:find] || :first
+
+    if format == :text
+      filter = lambda{|node| node && xml_node_to_text(node) }
+    elsif format == :xml
+      filter = lambda{|node| node }
+    else
+      raise "I don't know the format #{format.inspect}"
+    end
+
+    if count == :all
+      val = REXML::XPath.match(element, path).map do |node|
+        filter.call( node )
+      end
+    elsif count == :first
+      val = filter.call(
+        REXML::XPath.first(element, path)
+      )
+    else 
+      raise "I don't know how to find #{count.inspect}"
+    end
+
+    if(blk)
+      return val if val == nil or val == []
+      return blk.call(val)
+    end
+    return val
+  end
+
+end
+
+TinyXpathHelper = TinyXPathHelper

data/tasks/tiny_xpath_helper_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :tiny_xpath_helper do
+#   # Task goes here
+# end

data/test/test_helper.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'active_support'
+require 'active_support/test_case'
+require 'test/unit'
+require 'tiny_xpath_helper.rb'

data/test/tiny_xpath_helper_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class TinyXPathHelperTest < ActiveSupport::TestCase
+  test "find first returns nil if there is no match" do
+    xpath = TinyXPathHelper.new("<xml/>")
+    assert xpath.first('*').nil?
+  end
+end

data/test/xml/sample.xml

@@ -0,0 +1,9 @@
+<xml>
+  <node style="first">one</node>
+  <node>two</node>
+  <node>three
+    <three>
+      <a/><b beta="true"/><c/>
+    </three>
+  </node>
+</xml>

data/tiny_xpath_helper.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{tiny_xpath_helper}
+  s.version = "0.1.0"
+
+  s.authors = ["Jesse Wolfe"]
+  s.date = %q{2009-06-01}
+  s.description = %q{Very light syntax for using XPaths on XML documents or REXML nodes}
+  s.email = %q{jesse@rasantiago.com}
+  s.files = %w[ uninstall.rb init.rb Rakefile lib/tiny_xpath_helper.rb tiny_xpath_helper.gemspec README.rdoc tasks/tiny_xpath_helper_tasks.rake install.rb test/tiny_xpath_helper_test.rb test/xml test/xml/sample.xml test/test_helper.rb ]
+  s.has_rdoc = false
+  s.homepage = %q{http://github.com/rasantiago/tiny_xpath_helper}
+  s.rdoc_options = ["--inline-source", "--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Very light syntax for using XPaths on XML documents or REXML nodes}
+end
+

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: rasantiago-tiny_xpath_helper
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Jesse Wolfe
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-01 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Very light syntax for using XPaths on XML documents or REXML nodes
+email: jesse@rasantiago.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- uninstall.rb
+- init.rb
+- Rakefile
+- lib/tiny_xpath_helper.rb
+- tiny_xpath_helper.gemspec
+- README.rdoc
+- tasks/tiny_xpath_helper_tasks.rake
+- install.rb
+- test/tiny_xpath_helper_test.rb
+- test/xml
+- test/xml/sample.xml
+- test/test_helper.rb
+has_rdoc: false
+homepage: http://github.com/rasantiago/tiny_xpath_helper
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Very light syntax for using XPaths on XML documents or REXML nodes
+test_files: []
+