saxaphone 0.1.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Matthew Higgins
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+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.

data/Rakefile

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

data/lib/saxaphone/document.rb

@@ -0,0 +1,34 @@
+require 'nokogiri'
+
+module Saxaphone
+  class Document < Nokogiri::XML::SAX::Document
+    class << self
+      def parse(io, root_element_class)
+        parser = Nokogiri::XML::SAX::Parser.new(new(root_element_class))
+        parser.parse(io)
+      end
+    end
+
+    attr_accessor :element_stack, :root_element_class
+    def initialize(root_element_class)
+      @element_stack = []
+      @root_element_class = root_element_class
+    end
+
+    def start_element(name, attributes = [])
+      new_element = element_stack.empty? ? root_element_class.new(name) : element_stack.last.new_element(name)
+      element_stack << new_element
+    end
+
+    def end_element(name)
+      ending_element = element_stack.pop
+      unless element_stack.empty?
+        element_stack.last.add_element(ending_element)
+      end
+    end
+
+    def characters(string)
+      element_stack.last.append_content(string)
+    end
+  end
+end

data/lib/saxaphone/element.rb

@@ -0,0 +1,74 @@
+module Saxaphone
+  class Element
+    @@base_class_name = 'Saxaphone::Element'
+
+    class ElementHandler < Struct.new(:class_name, :proc)
+    end
+
+    class << self
+      def setup(&block)
+        define_method(:setup, &block)
+      end
+
+      def element_attributes(element_names)
+        element_names.each do |element_name|
+          element_attribute(element_name)
+        end
+      end
+
+      def element_attribute(element_name, options = {})
+        converted_name = options.delete(:as) || element_name
+        logic = proc { |element| attributes[converted_name] = element.content }
+        element_handler = ElementHandler.new(@@base_class_name, logic)
+
+        element_handlers[element_name] = element_handler
+      end
+
+      def has_element(element_name, class_name = @@base_class_name, &block)
+        element_handlers[element_name] = ElementHandler.new(class_name, block)
+      end
+
+      def has_attributes(attribute_names)
+        raise 'not implemented'
+      end
+
+      def element_handlers
+        @element_handlers ||= {}
+      end
+
+      def parse(xml)
+        Saxaphone::Document.parse(xml, self)
+      end
+    end
+
+    attr_accessor :name, :content, :attributes
+    def initialize(name = '', content = '')
+      self.name = name
+      self.content = content
+      self.attributes = {}
+      setup
+    end
+
+    def setup
+    end
+
+    def add_element(element)
+      if element_handler = self.class.element_handlers[element.name]
+        instance_exec(element, &element_handler.proc)
+      end
+    end
+
+    def new_element(element_name)
+      if element_handler = self.class.element_handlers[element_name]
+        klass = element_handler.class_name.constantize
+      else
+        klass = Saxaphone::Element
+      end
+      klass.new(element_name)
+    end
+
+    def append_content(string)
+      content << string
+    end
+  end
+end

data/lib/saxaphone.rb

@@ -0,0 +1,4 @@
+module Saxaphone
+  autoload :Document, 'saxaphone/document'
+  autoload :Element, 'saxaphone/element'
+end

data/test/document_test.rb

@@ -0,0 +1,22 @@
+require 'test_helper'
+
+class Saxaphone::DocumentTest < MiniTest::Spec
+  class TestDocument < Saxaphone::Document
+    class FooElement < Saxaphone::Element
+    end
+  end
+
+  def test_parse_xml
+    # assert false
+  end
+
+  private
+    def xml
+      StringIO.new %{<?xml version="1.0" encoding="utf-8"?>
+        <foo>
+          <hola>como estas</hola>
+          <omg>wtf</omg>
+        </foo>
+      }
+    end
+end

data/test/element_test.rb

@@ -0,0 +1,52 @@
+require 'test_helper'
+
+class Saxaphone::ElementTest < MiniTest::Spec
+  class TestChildElement < Saxaphone::Element
+    attr_accessor :special
+  end
+
+  class TestElement < Saxaphone::Element
+    attr_accessor :setup_attr
+    attr_accessor :child_special
+    setup do
+      self.setup_attr = 'hola'
+    end
+
+    element_attributes %w(foo bar)
+    element_attribute 'faz', as: 'baz'
+
+    has_element 'omg', 'TestChildElement' do |element|
+      self.child_special = element.special
+    end
+  end
+
+  def test_setup
+    element = TestElement.new
+    assert_equal 'hola', element.setup_attr
+  end
+
+  def test_element_attributes
+    element = TestElement.new
+    element.add_element(Saxaphone::Element.new('foo', 'value1'))
+    element.add_element(Saxaphone::Element.new('bar', 'value2'))
+    element.add_element(Saxaphone::Element.new('invalid', 'value3'))
+
+    assert_equal({'foo' => 'value1', 'bar' => 'value2'}, element.attributes)
+  end
+
+  def test_element_attribute
+    element = TestElement.new
+    element.add_element(Saxaphone::Element.new('faz', 'value'))
+
+    assert_equal({'baz' => 'value'}, element.attributes)
+  end
+
+  def test_has_element
+    element = TestElement.new
+    child_element = TestChildElement.new('omg')
+    child_element.special = 'weee'
+    element.add_element(child_element)
+
+    assert_equal 'weee', element.child_special
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'saxaphone'
+require 'minitest/autorun'

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: saxaphone
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Matthew Higgins
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-26 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Use objects
+email: developer@matthewhiggins.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- MIT-LICENSE
+- Rakefile
+- README.rdoc
+- lib/saxaphone/document.rb
+- lib/saxaphone/element.rb
+- lib/saxaphone.rb
+- test/document_test.rb
+- test/element_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/matthuhiggins/saxaphone
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.3.5
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Sexy SAX Parsing
+test_files: []
+