caring-nokogiri 1.4.1.pre1

data/lib/nokogiri/xml/sax/parser_context.rb

@@ -0,0 +1,16 @@
+module Nokogiri
+  module XML
+    module SAX
+      ###
+      # Context for XML SAX parsers.  This class is usually not instantiated
+      # by the user.  Instead, you should be looking at
+      # Nokogiri::XML::SAX::Parser
+      class ParserContext
+        def self.new thing, encoding = 'UTF-8'
+          [:read, :close].all? { |x| thing.respond_to?(x) } ?
+            io(thing, Parser::ENCODINGS[encoding]) : memory(thing)
+        end
+      end
+    end
+  end
+end

data/lib/nokogiri/xml/sax/push_parser.rb

@@ -0,0 +1,60 @@
+module Nokogiri
+  module XML
+    module SAX
+      ###
+      # PushParser can parse a document that is fed to it manually.  It
+      # must be given a SAX::Document object which will be called with
+      # SAX events as the document is being parsed.
+      #
+      # Calling PushParser#<< writes XML to the parser, calling any SAX
+      # callbacks it can.
+      #
+      # PushParser#finish tells the parser that the document is finished
+      # and calls the end_document SAX method.
+      #
+      # Example:
+      #
+      #   parser = PushParser.new(Class.new(XML::SAX::Document) {
+      #     def start_document
+      #       puts "start document called"
+      #     end
+      #   }.new)
+      #   parser << "<div>hello<"
+      #   parser << "/div>"
+      #   parser.finish
+      class PushParser
+
+        # The Nokogiri::XML::SAX::Document on which the PushParser will be
+        # operating
+        attr_accessor :document
+
+        ###
+        # Create a new PushParser with +doc+ as the SAX Document, providing
+        # an optional +file_name+ and +encoding+
+        def initialize(doc = XML::SAX::Document.new, file_name = nil, encoding = 'ASCII')
+          @document = doc
+          @encoding = encoding
+          @sax_parser = XML::SAX::Parser.new(doc)
+
+          ## Create our push parser context
+          initialize_native(@sax_parser, file_name)
+        end
+
+        ###
+        # Write a +chunk+ of XML to the PushParser.  Any callback methods
+        # that can be called will be called immidiately.
+        def write chunk, last_chunk = false
+          native_write(chunk, last_chunk)
+        end
+        alias :<< :write
+
+        ###
+        # Finish the parsing.  This method is only necessary for
+        # Nokogiri::XML::SAX::Document#end_document to be called.
+        def finish
+          write '', true
+        end
+      end
+    end
+  end
+end

data/lib/nokogiri/xml/schema.rb

@@ -0,0 +1,61 @@
+module Nokogiri
+  module XML
+    class << self
+      ###
+      # Create a new Nokogiri::XML::Schema object using a +string_or_io+
+      # object.
+      def Schema string_or_io
+        Schema.new(string_or_io)
+      end
+    end
+
+    ###
+    # Nokogiri::XML::Schema is used for validating XML against a schema
+    # (usually from an xsd file).
+    #
+    # == Synopsis
+    #
+    # Validate an XML document against a Schema.  Loop over the errors that
+    # are returned and print them out:
+    #
+    #   xsd = Nokogiri::XML::Schema(File.read(PO_SCHEMA_FILE))
+    #   doc = Nokogiri::XML(File.read(PO_XML_FILE))
+    #
+    #   xsd.validate(doc).each do |error|
+    #     puts error.message
+    #   end
+    #
+    # The list of errors are Nokogiri::XML::SyntaxError objects.
+    class Schema
+      # Errors while parsing the schema file
+      attr_accessor :errors
+
+      ###
+      # Create a new Nokogiri::XML::Schema object using a +string_or_io+
+      # object.
+      def self.new string_or_io
+        from_document Nokogiri::XML(string_or_io)
+      end
+
+      ###
+      # Validate +thing+ against this schema.  +thing+ can be a
+      # Nokogiri::XML::Document object, or a filename.  An Array of
+      # Nokogiri::XML::SyntaxError objects found while validating the
+      # +thing+ is returned.
+      def validate thing
+        return validate_document(thing) if thing.is_a?(Nokogiri::XML::Document)
+
+        # FIXME libxml2 has an api for validating files.  We should switch
+        # to that because it will probably save memory.
+        validate_document(Nokogiri::XML(File.read(thing)))
+      end
+
+      ###
+      # Returns true if +thing+ is a valid Nokogiri::XML::Document or
+      # file.
+      def valid? thing
+        validate(thing).length == 0
+      end
+    end
+  end
+end

data/lib/nokogiri/xml/syntax_error.rb

@@ -0,0 +1,38 @@
+module Nokogiri
+  module XML
+    ###
+    # This class provides information about XML SyntaxErrors.  These
+    # exceptions are typically stored on Nokogiri::XML::Document#errors.
+    class SyntaxError < ::Nokogiri::SyntaxError
+      def initialize message
+        self.message = message
+      end
+
+      ###
+      # return true if this is a non error
+      def none?
+        level == 0
+      end
+
+      ###
+      # return true if this is a warning
+      def warning?
+        level == 1
+      end
+
+      ###
+      # return true if this is an error
+      def error?
+        level == 2
+      end
+
+      ###
+      # return true if this error is fatal
+      def fatal?
+        level == 3
+      end
+
+      alias :to_s :message
+    end
+  end
+end

data/lib/nokogiri/xml/xpath.rb

@@ -0,0 +1,10 @@
+require 'nokogiri/xml/xpath/syntax_error'
+
+module Nokogiri
+  module XML
+    class XPath
+      # The Nokogiri::XML::Document tied to this XPath instance
+      attr_accessor :document
+    end
+  end
+end

data/lib/nokogiri/xml/xpath/syntax_error.rb

@@ -0,0 +1,8 @@
+module Nokogiri
+  module XML
+    class XPath
+      class SyntaxError < XML::SyntaxError
+      end
+    end
+  end
+end

data/lib/nokogiri/xml/xpath_context.rb

@@ -0,0 +1,16 @@
+module Nokogiri
+  module XML
+    class XPathContext
+
+      ###
+      # Register namespaces in +namespaces+
+      def register_namespaces(namespaces)
+        namespaces.each do |k, v|
+          k = k.gsub(/.*:/,'') # strip off 'xmlns:' or 'xml:'
+          register_ns(k, v)
+        end
+      end
+
+    end
+  end
+end

data/lib/nokogiri/xslt.rb

@@ -0,0 +1,48 @@
+require 'nokogiri/xslt/stylesheet'
+
+module Nokogiri
+  class << self
+    ###
+    # Create a Nokogiri::XSLT::Stylesheet with +stylesheet+.
+    #
+    # Example:
+    #
+    #   xslt = Nokogiri::XSLT(File.read(ARGV[0]))
+    #
+    def XSLT stylesheet
+      XSLT.parse(stylesheet)
+    end
+  end
+
+  ###
+  # See Nokogiri::XSLT::Stylesheet for creating and maniuplating
+  # Stylesheet object.
+  module XSLT
+    class << self
+      ###
+      # Parse the stylesheet in +string+
+      def parse string
+        Stylesheet.parse_stylesheet_doc(XML.parse(string))
+      end
+      
+      ###
+      # Quote parameters in +params+ for stylesheet safety
+      def quote_params params
+        parray = (params.instance_of?(Hash) ? params.to_a.flatten : params).dup
+        parray.each_with_index do |v,i|
+          if i % 2 > 0
+            parray[i]=
+              if v =~ /'/
+                "concat('#{ v.gsub(/'/, %q{', "'", '}) }')"
+              else
+                "'#{v}'";
+              end
+          else
+            parray[i] = v.to_s
+          end
+        end
+        parray.flatten
+      end
+    end
+  end
+end

data/lib/nokogiri/xslt/stylesheet.rb

@@ -0,0 +1,25 @@
+module Nokogiri
+  module XSLT
+    ###
+    # A Stylesheet represents an XSLT Stylesheet object.  Stylesheet creation
+    # is done through Nokogiri.XSLT.  Here is an example of transforming
+    # an XML::Document with a Stylesheet:
+    #
+    #   doc   = Nokogiri::XML(File.read('some_file.xml'))
+    #   xslt  = Nokogir::XSLT(File.read('some_transformer.xslt'))
+    #
+    #   puts xslt.transform(doc)
+    #
+    # See Nokogiri::XSLT::Stylesheet#transform for more transformation
+    # information.
+    class Stylesheet
+      ###
+      # Apply an XSLT stylesheet to an XML::Document.
+      # +params+ is an array of strings used as XSLT parameters.
+      # returns serialized document
+      def apply_to document, params = []
+        transform(document, params).to_s
+      end
+    end
+  end
+end

data/lib/xsd/xmlparser/nokogiri.rb

@@ -0,0 +1,71 @@
+require 'nokogiri'
+
+module XSD # :nodoc:
+  module XMLParser # :nodoc:
+    ###
+    # Nokogiri XML parser for soap4r.
+    #
+    # Nokogiri may be used as the XML parser in soap4r.  Simply require
+    # 'xsd/xmlparser/nokogiri' in your soap4r applications, and soap4r
+    # will use Nokogiri as it's XML parser.  No other changes should be
+    # required to use Nokogiri as the XML parser.
+    #
+    # Example (using UW ITS Web Services):
+    #
+    #   require 'rubygems'
+    #   require 'nokogiri'
+    #   gem 'soap4r'
+    #   require 'defaultDriver'
+    #   require 'xsd/xmlparser/nokogiri'
+    #   
+    #   obj = AvlPortType.new
+    #   obj.getLatestByRoute(obj.getAgencies.first, 8).each do |bus|
+    #     p "#{bus.routeID}, #{bus.longitude}, #{bus.latitude}"
+    #   end
+    #
+    class Nokogiri < XSD::XMLParser::Parser
+      ###
+      # Create a new XSD parser with +host+ and +opt+
+      def initialize host, opt = {}
+        super
+        @parser = ::Nokogiri::XML::SAX::Parser.new(self, @charset || 'UTF-8')
+      end
+
+      ###
+      # Start parsing +string_or_readable+
+      def do_parse string_or_readable
+        @parser.parse(string_or_readable)
+      end
+
+      ###
+      # Handle the start_element event with +name+ and +attrs+
+      def start_element name, attrs = []
+        super(name, Hash[*attrs.flatten])
+      end
+
+      ###
+      # Handle the end_element event with +name+
+      def end_element name
+        super
+      end
+
+      ###
+      # Handle errors with message +msg+
+      def error msg
+        raise ParseError.new(msg)
+      end
+      alias :warning :error
+
+      ###
+      # Handle cdata_blocks containing +string+
+      def cdata_block string
+        characters string
+      end
+
+      %w{ start_document start_element_namespace end_element_namespace end_document comment }.each do |name|
+        class_eval %{ def #{name}(*args); end }
+      end
+      add_factory(self)
+    end
+  end
+end

data/tasks/test.rb

@@ -0,0 +1,100 @@
+def run_with_env(cmd)
+  cmd = "LD_LIBRARY_PATH='#{ENV['LD_LIBRARY_PATH']}' #{cmd}"
+  puts "=> #{cmd}"
+  system cmd
+end
+
+namespace :test do
+  desc "run test suite with aggressive GC"
+  task :gc => :build do
+    ENV['NOKOGIRI_GC'] = "true"
+    Rake::Task["test"].invoke
+  end
+
+  desc "find call-seq in the rdoc"
+  task :rdoc_call_seq => 'docs' do
+    Dir['doc/**/*.html'].each { |docfile|
+      next if docfile =~ /\.src/
+      puts "FAIL: #{docfile}" if File.read(docfile) =~ /call-seq/
+    }
+  end
+
+  desc "find all undocumented things"
+  task :rdoc => 'docs' do
+    base = File.expand_path(File.join(File.dirname(__FILE__), '..', 'doc'))
+    require 'test/unit'
+    test = Class.new(Test::Unit::TestCase)
+    Dir["#{base}/**/*.html"].each { |docfile|
+      test.class_eval(<<-eotest)
+        def test_#{docfile.sub("#{base}/", '').gsub(/[\/\.-]/, '_')}
+          assert_no_match(
+            /Not documented/,
+            File.read('#{docfile}'),
+            '#{docfile} has undocumented things'
+          )
+        end
+      eotest
+    }
+  end
+
+  desc "Test against multiple versions of libxml2 (MULTIXML2_DIR=directory)"
+  task :multixml2 do
+    MULTI_XML = File.join(ENV['HOME'], '.multixml2')
+    unless File.exists?(MULTI_XML)
+      %w{ versions install build }.each { |x|
+        FileUtils.mkdir_p(File.join(MULTI_XML, x))
+      }
+      Dir.chdir File.join(MULTI_XML, 'versions') do
+        require 'net/ftp'
+        ftp = Net::FTP.new('xmlsoft.org')
+        ftp.login('anonymous', 'anonymous')
+        ftp.chdir('libxml2')
+        ftp.list('libxml2-2.*.tar.gz').each do |x|
+          file = x[/[^\s]*$/]
+          puts "Downloading #{file}"
+          ftp.getbinaryfile(file)
+        end
+      end
+    end
+
+    # Build any libxml2 versions in $HOME/.multixml2/versions that
+    # haven't been built yet
+    Dir[File.join(MULTI_XML, 'versions','*.tar.gz')].each do |f|
+      filename = File.basename(f, '.tar.gz')
+
+      install_dir = File.join(MULTI_XML, 'install', filename)
+      next if File.exists?(install_dir)
+
+      Dir.chdir File.join(MULTI_XML, 'versions') do
+        system "tar zxvf #{f} -C #{File.join(MULTI_XML, 'build')}"
+      end
+
+      Dir.chdir File.join(MULTI_XML, 'build', filename) do
+        system "./configure --prefix=#{install_dir}"
+        system "make && make install"
+      end
+    end
+
+    test_results = {}
+    libxslt = Dir[File.join(MULTI_XML, 'install', 'libxslt*')].first
+
+    directories = ENV['MULTIXML2_DIR'] ? [ENV['MULTIXML2_DIR']] : Dir[File.join(MULTI_XML, 'install', '*')]
+    directories.sort.reverse.each do |xml2_version|
+      next unless xml2_version =~ /libxml2/
+      extopts = "--with-xml2-include=#{xml2_version}/include/libxml2 --with-xml2-lib=#{xml2_version}/lib --with-xslt-dir=#{libxslt} --with-iconv-dir=/usr"
+      cmd = "#{$0} clean test EXTOPTS='#{extopts}' LD_LIBRARY_PATH='#{xml2_version}/lib'"
+
+      version = File.basename(xml2_version)
+      result = system(cmd)
+      test_results[version] = {
+        :result => result,
+        :cmd    => cmd
+      }
+    end
+    test_results.sort_by { |k,v| k }.each do |k,v|
+      passed = v[:result]
+      puts "#{k}: #{passed ? 'PASS' : 'FAIL'}"
+      puts "repro: #{v[:cmd]}" unless passed
+    end
+  end
+end