RubyGems - saxon-xslt - Versions diffs - 0.2.0.1-java → 0.5.0-java - Mend

saxon-xslt 0.2.0.1-java → 0.5.0-java

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

checksums.yaml +7 -0
data/.rspec +1 -0
data/.ruby-version +1 -1
data/README.md +35 -1
data/lib/saxon/processor.rb +48 -6
data/lib/saxon/s9api.rb +1 -2
data/lib/saxon/source_helper.rb +44 -0
data/lib/saxon/xml.rb +39 -9
data/lib/saxon/xslt.rb +28 -10
data/lib/saxon/xslt/version.rb +1 -1
data/saxon-xslt.gemspec +7 -4
data/spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/is_set_to_an_open-uri_d_URI_s_URI.yml +63 -0
data/spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/overrides_the_inferred_system_ID_if_set_explicitly.yml +63 -0
data/spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/for_input_backed_by_an_InputStream/converts_an_open-uri_d_Uri_correctly.yml +123 -0
data/spec/fixtures/config.xml +70 -0
data/spec/fixtures/simple-xsl-import.xsl +7 -0
data/spec/saxon/processor_spec.rb +22 -5
data/spec/saxon/source_helper_spec.rb +117 -0
data/spec/saxon/xml_spec.rb +38 -3
data/spec/saxon/xslt_spec.rb +24 -6
data/spec/spec_helper.rb +8 -0
data/vendor/saxonica/saxon9-unpack.jar +0 -0
data/vendor/saxonica/saxon9-xqj.jar +0 -0
data/vendor/saxonica/saxon9he.jar +0 -0
metadata +70 -19
data/lib/saxon/source_helpers.rb +0 -14

checksums.yaml ADDED

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cfa11992486ed13c2359031da17082e29520754e
+  data.tar.gz: ca8e42087c7b82f890e8caff64dadb42d7e46f0d
+SHA512:
+  metadata.gz: 0246341e380043c327f6de92383073213efdbf018abee0b0a39af92845d0f7462df6fedc1fd7f43fe2cae50234377aeb422315ea0861b6310631745c2a199b78
+  data.tar.gz: f7fd284b2d4a162173dd854000e35b00e245d42c1eecc1ebfef4a2d1c713a307960c9ce7fbb792e9d7f04efe40ad7195efe82ca0909d049e7bd54f160d390851

data/.rspec ADDED

	@@ -0,0 +1 @@
1	+ --color

data/.ruby-version CHANGED

	@@ -1 +1 @@
1	- jruby-1.7.4
1	+ jruby-1.7.13

data/README.md CHANGED

@@ -26,7 +26,7 @@ Or install it yourself as:
     $ gem install saxon-xslt
-## Usage
+## Simple usage
 ```ruby
 require 'saxon-xslt'
@@ -35,6 +35,40 @@ input = Saxon.XML(File.open('/path/to/your.xml'))
 output = transformer.transform(input)
 ```
+## Saxon version
+`saxon-xslt` 0.5 includes Saxon HE 9.5.1.7
+## Differences between Saxon and Nokogiri
+Saxon uses a `Processor` class as its central object: it holds configuration information and acts as a Factory for creating documents or XSLT stylesheet compilers. Unless you need to tweak the config you don't need to worry about this – `saxon-xslt` creates a shared instance behind the scenes when you call `Saxon.XSLT` or `Saxon.XML`. If you need to change the configuration you can create your own instance of `Saxon::Processor` and pass it an open `File` pointing at a Saxon configuration file. (See http://www.saxonica.com/documentation/index.html#!configuration/configuration-file for details of the configuration file.) Once you have a `Saxon::Processor` instance you can call the `XML` and `XSLT` methods on it directly:
+```ruby
+require 'saxon-xslt'
+processor = Saxon::Processor.new(File.open('/path/to/config.xml'))
+transformer = processor.XSLT(File.open('/path/to/your.xsl'))
+input = processor.XML(File.open('/path/to/your.xml'))
+output = transformer.transform(input)
+```
+### System IDs
+XML has this idea of 'Public' and 'System' identifiers for documents. The public ID is a kind of abstract name and the system ID is a URI, for example:
+```xml
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+            "http://www.w3.org/TR/html4/loose.dtd">
+```
+There the Public ID is `-//W3C//DTD HTML 4.01 Transitional//EN` and the System ID is `http://www.w3.org/TR/html4/loose.dtd`. An XML or XSLT processor uses the System ID as a base URI for resolving linked objects, e.g. `<xsl:import>` or `<xsl:include>` calls with relative URIs.
+With Nokogiri the System ID for a document is inferred from its file path, if you hand in a `File` object to `Nokogiri::XML`. With `saxon-xslt` you can also explicitly set the System ID:
+```ruby
+xslt = Saxon.XSLT("<xsl:stylesheet>...</xsl:stylesheet>",
+  system_id: "/path/to/resources/file.xsl")
+```
+So, if you have other XSLT stylesheets in `/path/to/resources/` then your dynamically generated XSLT can refer to them with import statements like `<xsl:import href="other_stylesheet.xsl"/>`.
 ## Contributing
 1. Fork it

data/lib/saxon/processor.rb CHANGED

@@ -1,23 +1,65 @@
 require 'saxon/s9api'
+require 'saxon/source_helper'
 require 'saxon/xslt'
 require 'saxon/xml'
 module Saxon
+  # Saxon::Processor wraps the S9API::Processor object. This is the object
+  # responsible for creating an XSLT compiler or an XML Document object.
+  #
+  # The Processor is threadsafe, and can be shared between threads. But, most
+  # importantly XSLT or XML objects created by a Processor can only be used
+  # with other XSLT or XML objects created by the same Processor instance.
   class Processor
+    # Provides a processor with default configuration. Essentially a singleton
+    # instance
+    # @return [Saxon::Processor]
     def self.default
       @processor ||= new
     end
-    def initialize
-      @processor = S9API::Processor.new(false)
+    # @param config [File, String, IO] an open File, or string,
+    #   containing a Saxon configuration file
+    # @return [Saxon::Processor]
+    def self.create(config = nil)
+      licensed_or_config_source = false
+      if config
+        licensed_or_config_source = Saxon::SourceHelper.to_stream_source(config)
+      end
+      s9_processor = S9API::Processor.new(licensed_or_config_source)
+      new(s9_processor)
     end
-    def XSLT(*args)
-      Saxon::XSLT::Stylesheet.new(@processor, *args)
+    # @param [net.sf.saxon.s9api.Processor] s9_processor The Saxon Processor
+    #   instance to wrap
+    def initialize(s9_processor)
+      @s9_processor = s9_processor
     end
-    def XML(*args)
-      Saxon::XML::Document.new(@processor, *args)
+    # @param input [File, IO, String] the input XSLT file
+    # @param opts [Hash] options for the XSLT
+    # @return [Saxon::XSLT::Stylesheet] the new XSLT Stylesheet
+    def XSLT(input, opts = {})
+      Saxon::XSLT::Stylesheet.parse(self, input, opts)
+    end
+    # @param input [File, IO, String] the input XML file
+    # @param opts [Hash] options for the XML file
+    # @return [Saxon::XML::Document] the new XML Document
+    def XML(input, opts = {})
+      Saxon::XML::Document.parse(self, input, opts)
+    end
+    # @return [net.sf.saxon.s9api.Processor] The underlying Saxon processor
+    def to_java
+      @s9_processor
+    end
+    # compare equal if the underlying java processor is the same instance for
+    # self and other
+    # @param other object to compare against
+    def ==(other)
+      other.to_java === to_java
     end
   end
 end

data/lib/saxon/s9api.rb CHANGED

@@ -2,9 +2,8 @@ require 'java'
 $CLASSPATH << File.expand_path('../../../vendor/saxonica/saxon9he.jar', __FILE__)
 $CLASSPATH << File.expand_path('../../../vendor/saxonica/saxon9-unpack.jar', __FILE__)
-java_import javax.xml.transform.stream.StreamSource
 module Saxon
+  # Puts the Saxon Java classes into a sensible namespace
   module S9API
     java_import 'net.sf.saxon.s9api.Processor'
     java_import 'net.sf.saxon.s9api.XdmDestination'

data/lib/saxon/source_helper.rb ADDED

@@ -0,0 +1,44 @@
+java_import javax.xml.transform.stream.StreamSource
+module Saxon
+  # Helper methods for converting Ruby File, IO, Path, or String objects into a
+  # Javax StreamSource object for Saxon's Document parser or XSLT compiler to
+  # consume
+  class SourceHelper
+    # Creates a StreamSource from its input
+    # @param [File, IO, String] path_io_or_string A File, or IO
+    #   object representing the input XML file or data, or a String containing
+    #   the XML
+    # @param [Hash] opts
+    # @option opts [String] :system_id The System ID of the source - an
+    #   absolute URI or relative path pointing to the location of the source
+    # @return [java.xml.transform.stream.StreamSource] a StreamSource for
+    #   consuming the input
+    def self.to_stream_source(path_io_or_string, opts = {})
+      system_id = opts.fetch(:system_id) { to_system_id(path_io_or_string) }
+      StreamSource.new(to_inputstream(path_io_or_string), system_id)
+    end
+    # Given a File, or IO object which will return either #path or
+    # #base_uri, return the #base_uri, if present, or the #path, if present, or
+    # nil
+    # @param [File, IO, String] path_io_or_string A Path, File, or IO
+    #   object representing the input XML file or data, or a String containing
+    #   the XML
+    def self.to_system_id(path_io_or_string)
+      if path_io_or_string.respond_to?(:base_uri)
+        return path_io_or_string.base_uri.to_s
+      end
+      return path_io_or_string.path if path_io_or_string.respond_to?(:path)
+    end
+    # Given a File, IO, or String return a Java InputStream or StringReader
+    # @param [File, IO, String] path_io_or_string input to be converted to an
+    #   input stream
+    # @return [java.io.InputStream, java.io.StringReader] the wrapped input
+    def self.to_inputstream(path_io_or_string)
+      return path_io_or_string.to_inputstream if path_io_or_string.respond_to?(:read)
+      return java.io.StringReader.new(path_io_or_string)
+    end
+  end
+end

data/lib/saxon/xml.rb CHANGED

@@ -1,21 +1,51 @@
 require 'saxon/s9api'
-require 'saxon/source_helpers'
+require 'saxon/source_helper'
 require 'saxon/processor'
 module Saxon
-  def self.XML(string_or_io)
-    Saxon::Processor.default.XML(string_or_io)
+  # Create an XML Document object using the default processor
+  # @param input [File, IO, String] the input XML file
+  # @param opts [Hash] options for the XML
+  # @return [Saxon::XML::Document]
+  def self.XML(input, opts = {})
+    Saxon::Processor.default.XML(input, opts)
   end
   module XML
+    # Parse an XML File or String into a Document object
     class Document
-      class << self
-        include Saxon::SourceHelpers
+      # @param [Saxon::Processor] processor The processor object which should
+      #   be used to build the document
+      # @param [String, File, IO] string_or_io The input XML
+      # @param [Hash] opts (see Saxon::SourceHelper#to_stream_source)
+      # @return [Saxon::XML::Document]
+      def self.parse(processor, string_or_io, opts = {})
+        builder = processor.to_java.newDocumentBuilder()
+        source = SourceHelper.to_stream_source(string_or_io, opts)
+        xdm_document = builder.build(source)
+        new(xdm_document)
+      end
+      # @api private
+      def initialize(xdm_document)
+        @xdm_document = xdm_document
+      end
+      # @return [net.sf.saxon.s9api.XdmNode] return the underlying Saxon
+      #   document object
+      def to_java
+        @xdm_document
+      end
+      # @return [String] return a simple serialisation of the document
+      def to_s
+        @xdm_document.to_s
+      end
-        def new(processor, string_or_io)
-          builder = processor.newDocumentBuilder()
-          builder.build(to_stream_source(string_or_io))
-        end
+      # @return [Saxon::Processor] return the processor used to create this
+      #   document
+      def processor
+        Saxon::Processor.new(@xdm_document.processor)
       end
     end
   end

data/lib/saxon/xslt.rb CHANGED

@@ -1,29 +1,47 @@
 require 'saxon/s9api'
-require 'saxon/source_helpers'
+require 'saxon/source_helper'
 require 'saxon/processor'
 require 'saxon/xml'
 module Saxon
-  def self.XSLT(string_or_io)
-    Saxon::Processor.default.XSLT(string_or_io)
+  # Create an XSLT Stylesheet object using the default processor
+  # @param input [File, IO, String] the input XSLT file
+  # @param opts [Hash] options for the XSLT
+  # @return [Saxon::XSLT::Stylesheet]
+  def self.XSLT(input, opts = {})
+    Saxon::Processor.default.XSLT(input, opts)
   end
   module XSLT
+    # a Stylesheet transforms input (XML) into output
     class Stylesheet
-      include Saxon::SourceHelpers
+      # @param processor [Saxon::Processor] the Saxon processor object
+      # @param string_or_io [File, IO, String] the input XSLT
+      # @param opts [Hash] Stylesheet and input options
+      # @return [Saxon::XSLT::Stylesheet] the compiled XSLT stylesheet
+      def self.parse(processor, string_or_io, opts = {})
+        source = processor.XML(string_or_io, opts)
+        new(source)
+      end
-      def initialize(processor, string_or_io)
-        compiler = processor.newXsltCompiler()
-        @xslt = compiler.compile(to_stream_source(string_or_io))
+      # @param [Saxon::XML::Document] source the input XSLT as an XML document
+      def initialize(source)
+        processor = source.processor
+        compiler = processor.to_java.new_xslt_compiler()
+        @xslt = compiler.compile(source.to_java.as_source)
       end
-      def transform(xdm_node)
+      # Transform an input document
+      # @param [Saxon::XML::Document] document the XML Document object to
+      #   transform
+      # @return a Saxon::XML::Document object
+      def transform(document)
         output = S9API::XdmDestination.new
         transformer = @xslt.load
-        transformer.setInitialContextNode(xdm_node)
+        transformer.setInitialContextNode(document.to_java)
         transformer.setDestination(output)
         transformer.transform
-        output.getXdmNode
+        Saxon::XML::Document.new(output.getXdmNode)
       end
     end
   end

data/lib/saxon/xslt/version.rb CHANGED

@@ -1,5 +1,5 @@
 module Saxon
   module XSLT
-    VERSION = "0.2.0.1"
+    VERSION = "0.5.0"
   end
 end

data/saxon-xslt.gemspec CHANGED

@@ -8,8 +8,8 @@ Gem::Specification.new do |gem|
   gem.version       = Saxon::XSLT::VERSION
   gem.authors       = ["Matt Patterson"]
   gem.email         = ["matt@reprocessed.org"]
-  gem.description   = %q{Wraps the Saxon 9.4 HE XSLT 2.0 processor so that you can transform XSLT 2 stylesheets in JRuby. Sticks closely to the Nokogiri API}
-  gem.summary       = %q{Saxon 9.4 HE XSLT 2.0 for JRuby with Nokogiri's API}
+  gem.description   = %q{Wraps the Saxon 9.5 HE XSLT 2.0 processor so that you can transform XSLT 2 stylesheets in JRuby. Sticks closely to the Nokogiri API}
+  gem.summary       = %q{Saxon 9.5 HE XSLT 2.0 for JRuby with Nokogiri's API}
   gem.homepage      = "https://github.com/fidothe/saxon-xslt"
   gem.licenses      = ["MIT", "MPL-1.0"]
   gem.platform      = 'java'
@@ -19,6 +19,9 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
-  gem.add_development_dependency('rake', '~> 10.1.0')
-  gem.add_development_dependency('rspec', '~> 2.14.0')
+  gem.add_development_dependency('rake', '~> 10.1')
+  gem.add_development_dependency('rspec', '~> 3.0')
+  gem.add_development_dependency('vcr', '~> 2.9.2')
+  gem.add_development_dependency('webmock', '~> 1.18.0')
+  gem.add_development_dependency('yard', '~> 0.8.7')
 end

data/spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/is_set_to_an_open-uri_d_URI_s_URI.yml ADDED

@@ -0,0 +1,63 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://example.org/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - '*/*'
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      Cache-Control:
+      - max-age=604800
+      Content-Type:
+      - text/html
+      Date:
+      - Sun, 10 Aug 2014 09:37:13 GMT
+      Etag:
+      - '"359670651"'
+      Expires:
+      - Sun, 17 Aug 2014 09:37:13 GMT
+      Last-Modified:
+      - Fri, 09 Aug 2013 23:54:35 GMT
+      Server:
+      - ECS (iad/182A)
+      X-Cache:
+      - HIT
+      X-Ec-Custom-Error:
+      - '1'
+      Content-Length:
+      - '1270'
+    body:
+      encoding: US-ASCII
+      string: "<!doctype html>\n<html>\n<head>\n    <title>Example Domain</title>\n\
+        \n    <meta charset=\"utf-8\" />\n    <meta http-equiv=\"Content-type\" content=\"\
+        text/html; charset=utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width,\
+        \ initial-scale=1\" />\n    <style type=\"text/css\">\n    body {\n      \
+        \  background-color: #f0f0f2;\n        margin: 0;\n        padding: 0;\n \
+        \       font-family: \"Open Sans\", \"Helvetica Neue\", Helvetica, Arial,\
+        \ sans-serif;\n        \n    }\n    div {\n        width: 600px;\n       \
+        \ margin: 5em auto;\n        padding: 50px;\n        background-color: #fff;\n\
+        \        border-radius: 1em;\n    }\n    a:link, a:visited {\n        color:\
+        \ #38488f;\n        text-decoration: none;\n    }\n    @media (max-width:\
+        \ 700px) {\n        body {\n            background-color: #fff;\n        }\n\
+        \        div {\n            width: auto;\n            margin: 0 auto;\n  \
+        \          border-radius: 0;\n            padding: 1em;\n        }\n    }\n\
+        \    </style>    \n</head>\n\n<body>\n<div>\n    <h1>Example Domain</h1>\n\
+        \    <p>This domain is established to be used for illustrative examples in\
+        \ documents. You may use this\n    domain in examples without prior coordination\
+        \ or asking for permission.</p>\n    <p><a href=\"http://www.iana.org/domains/example\"\
+        >More information...</a></p>\n</div>\n</body>\n</html>\n"
+    http_version:
+  recorded_at: Sun, 10 Aug 2014 09:37:13 GMT
+recorded_with: VCR 2.9.2

data/spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/overrides_the_inferred_system_ID_if_set_explicitly.yml ADDED

@@ -0,0 +1,63 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://example.org/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - '*/*'
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      Cache-Control:
+      - max-age=604800
+      Content-Type:
+      - text/html
+      Date:
+      - Sun, 10 Aug 2014 09:52:49 GMT
+      Etag:
+      - '"359670651"'
+      Expires:
+      - Sun, 17 Aug 2014 09:52:49 GMT
+      Last-Modified:
+      - Fri, 09 Aug 2013 23:54:35 GMT
+      Server:
+      - ECS (iad/182A)
+      X-Cache:
+      - HIT
+      X-Ec-Custom-Error:
+      - '1'
+      Content-Length:
+      - '1270'
+    body:
+      encoding: US-ASCII
+      string: "<!doctype html>\n<html>\n<head>\n    <title>Example Domain</title>\n\
+        \n    <meta charset=\"utf-8\" />\n    <meta http-equiv=\"Content-type\" content=\"\
+        text/html; charset=utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width,\
+        \ initial-scale=1\" />\n    <style type=\"text/css\">\n    body {\n      \
+        \  background-color: #f0f0f2;\n        margin: 0;\n        padding: 0;\n \
+        \       font-family: \"Open Sans\", \"Helvetica Neue\", Helvetica, Arial,\
+        \ sans-serif;\n        \n    }\n    div {\n        width: 600px;\n       \
+        \ margin: 5em auto;\n        padding: 50px;\n        background-color: #fff;\n\
+        \        border-radius: 1em;\n    }\n    a:link, a:visited {\n        color:\
+        \ #38488f;\n        text-decoration: none;\n    }\n    @media (max-width:\
+        \ 700px) {\n        body {\n            background-color: #fff;\n        }\n\
+        \        div {\n            width: auto;\n            margin: 0 auto;\n  \
+        \          border-radius: 0;\n            padding: 1em;\n        }\n    }\n\
+        \    </style>    \n</head>\n\n<body>\n<div>\n    <h1>Example Domain</h1>\n\
+        \    <p>This domain is established to be used for illustrative examples in\
+        \ documents. You may use this\n    domain in examples without prior coordination\
+        \ or asking for permission.</p>\n    <p><a href=\"http://www.iana.org/domains/example\"\
+        >More information...</a></p>\n</div>\n</body>\n</html>\n"
+    http_version:
+  recorded_at: Sun, 10 Aug 2014 09:52:49 GMT
+recorded_with: VCR 2.9.2

data/spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/for_input_backed_by_an_InputStream/converts_an_open-uri_d_Uri_correctly.yml ADDED

@@ -0,0 +1,123 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://example.org/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - '*/*'
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      Cache-Control:
+      - max-age=604800
+      Content-Type:
+      - text/html
+      Date:
+      - Sun, 10 Aug 2014 09:34:50 GMT
+      Etag:
+      - '"359670651"'
+      Expires:
+      - Sun, 17 Aug 2014 09:34:50 GMT
+      Last-Modified:
+      - Fri, 09 Aug 2013 23:54:35 GMT
+      Server:
+      - ECS (iad/182A)
+      X-Cache:
+      - HIT
+      X-Ec-Custom-Error:
+      - '1'
+      Content-Length:
+      - '1270'
+    body:
+      encoding: US-ASCII
+      string: "<!doctype html>\n<html>\n<head>\n    <title>Example Domain</title>\n\
+        \n    <meta charset=\"utf-8\" />\n    <meta http-equiv=\"Content-type\" content=\"\
+        text/html; charset=utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width,\
+        \ initial-scale=1\" />\n    <style type=\"text/css\">\n    body {\n      \
+        \  background-color: #f0f0f2;\n        margin: 0;\n        padding: 0;\n \
+        \       font-family: \"Open Sans\", \"Helvetica Neue\", Helvetica, Arial,\
+        \ sans-serif;\n        \n    }\n    div {\n        width: 600px;\n       \
+        \ margin: 5em auto;\n        padding: 50px;\n        background-color: #fff;\n\
+        \        border-radius: 1em;\n    }\n    a:link, a:visited {\n        color:\
+        \ #38488f;\n        text-decoration: none;\n    }\n    @media (max-width:\
+        \ 700px) {\n        body {\n            background-color: #fff;\n        }\n\
+        \        div {\n            width: auto;\n            margin: 0 auto;\n  \
+        \          border-radius: 0;\n            padding: 1em;\n        }\n    }\n\
+        \    </style>    \n</head>\n\n<body>\n<div>\n    <h1>Example Domain</h1>\n\
+        \    <p>This domain is established to be used for illustrative examples in\
+        \ documents. You may use this\n    domain in examples without prior coordination\
+        \ or asking for permission.</p>\n    <p><a href=\"http://www.iana.org/domains/example\"\
+        >More information...</a></p>\n</div>\n</body>\n</html>\n"
+    http_version:
+  recorded_at: Sun, 10 Aug 2014 09:34:50 GMT
+- request:
+    method: get
+    uri: http://example.org/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - '*/*'
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      Cache-Control:
+      - max-age=604800
+      Content-Type:
+      - text/html
+      Date:
+      - Sun, 10 Aug 2014 09:34:50 GMT
+      Etag:
+      - '"359670651"'
+      Expires:
+      - Sun, 17 Aug 2014 09:34:50 GMT
+      Last-Modified:
+      - Fri, 09 Aug 2013 23:54:35 GMT
+      Server:
+      - ECS (iad/182A)
+      X-Cache:
+      - HIT
+      X-Ec-Custom-Error:
+      - '1'
+      Content-Length:
+      - '1270'
+    body:
+      encoding: US-ASCII
+      string: "<!doctype html>\n<html>\n<head>\n    <title>Example Domain</title>\n\
+        \n    <meta charset=\"utf-8\" />\n    <meta http-equiv=\"Content-type\" content=\"\
+        text/html; charset=utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width,\
+        \ initial-scale=1\" />\n    <style type=\"text/css\">\n    body {\n      \
+        \  background-color: #f0f0f2;\n        margin: 0;\n        padding: 0;\n \
+        \       font-family: \"Open Sans\", \"Helvetica Neue\", Helvetica, Arial,\
+        \ sans-serif;\n        \n    }\n    div {\n        width: 600px;\n       \
+        \ margin: 5em auto;\n        padding: 50px;\n        background-color: #fff;\n\
+        \        border-radius: 1em;\n    }\n    a:link, a:visited {\n        color:\
+        \ #38488f;\n        text-decoration: none;\n    }\n    @media (max-width:\
+        \ 700px) {\n        body {\n            background-color: #fff;\n        }\n\
+        \        div {\n            width: auto;\n            margin: 0 auto;\n  \
+        \          border-radius: 0;\n            padding: 1em;\n        }\n    }\n\
+        \    </style>    \n</head>\n\n<body>\n<div>\n    <h1>Example Domain</h1>\n\
+        \    <p>This domain is established to be used for illustrative examples in\
+        \ documents. You may use this\n    domain in examples without prior coordination\
+        \ or asking for permission.</p>\n    <p><a href=\"http://www.iana.org/domains/example\"\
+        >More information...</a></p>\n</div>\n</body>\n</html>\n"
+    http_version:
+  recorded_at: Sun, 10 Aug 2014 09:34:50 GMT
+recorded_with: VCR 2.9.2

data/spec/fixtures/config.xml ADDED

@@ -0,0 +1,70 @@
+<?xml version="1.0"?><!-- This is an example configuration file. Many of the options included here are defaults,
+     and do not need to be specified in a real configuration file. They are provided for
+     convenience of editing, so it is easy to set up a configuration file with non-default options.
+     For documentation on the contents of a Saxon configuration file, see
+     http://www.saxonica.com/documentation/index/configuration-file.html
+-->
+<configuration edition="HE" xmlns="http://saxon.sf.net/ns/configuration" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://saxon.sf.net/ns/configuration config.xsd">
+  <global dtdValidation="false"
+          dtdValidationRecoverable="true"
+          xInclude="false"
+          lineNumbering="true"
+          treeModel="tinyTree"
+          stripSpace="all"
+          expandAttributeDefaults="true"
+          versionOfXml="1.1"
+          preferJaxpParser="true"
+          sourceResolver=""
+          uriResolver="net.sf.saxon.lib.StandardURIResolver"
+          collectionUriResolver="net.sf.saxon.lib.StandardCollectionURIResolver"
+          defaultCollection="file:///tmp"
+          recognizeUriQueryParameters="true"
+          useTypedValueCache="false"
+          parser=""
+          timing="false"
+          traceInstructions="false"
+          allowExternalFunctions="true"
+          traceExternalFunctions="false"
+          optimizationLevel="10"
+          traceOptimizerDecisions="false"
+          collationUriResolver="net.sf.saxon.lib.StandardCollationURIResolver"
+          lazyConstructionMode="false"
+          preEvaluateDoc="false"
+          serializerFactory=""
+          errorListener="net.sf.saxon.lib.StandardErrorListener"
+          errorListenerFile=""
+          traceListener="net.sf.saxon.trace.XSLTTraceListener"
+          traceListenerFile=""
+          usePiDisableOutputEscaping="false"
+          validationWarnings="true"/>
+  <serialization method="xml"
+                 indent="yes"/>
+  <collations>
+    <collation uri="http://codepoint/" class="net.sf.saxon.expr.sort.CodepointCollator"/>
+    <collation uri="http://www.microsoft.com/collation/caseblind" lang="en" ignore-case="yes"/>
+  </collations>
+  <localizations defaultLanguage="en" defaultCountry="US">
+    <localization lang="de" class="net.sf.saxon.option.local.Numberer_de"/>
+    <localization lang="en" class="net.sf.saxon.expr.number.Numberer_en"/>
+  </localizations>
+  <xslt recoveryPolicy="recoverWithWarnings"
+        version="2.0"
+        versionWarning="false"
+        schemaAware="false"
+        errorListener="net.sf.saxon.StandardErrorListener">
+  </xslt>
+  <xquery version="1.1"
+          allowUpdate="false"
+          errorListener="net.sf.saxon.StandardErrorListener"
+          errorListenerFile=""
+          moduleUriResolver="net.sf.saxon.lib.StandardModuleURIResolver"
+          inheritNamespaces="true"
+          preserveNamespaces="true"
+          constructionMode="preserve"
+          defaultFunctionNamespace="http://www.w3.org/2005/xpath-functions"
+          defaultElementNamespace=""
+          preserveBoundarySpace="false"
+          requiredContextItemType="document-node()"
+          emptyLeast="true"/>
+</configuration>

data/spec/fixtures/simple-xsl-import.xsl ADDED

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    exclude-result-prefixes="xs"
+    version="2.0">
+    <xsl:import href="eg.xsl"/>
+</xsl:stylesheet>

data/spec/saxon/processor_spec.rb CHANGED

@@ -2,14 +2,31 @@ require 'spec_helper'
 require 'saxon/processor'
 describe Saxon::Processor do
-  let(:processor) { Saxon::Processor.new }
   let(:xsl_file) { File.open(fixture_path('eg.xsl')) }
-  it "can make a new XSLT instance" do
-    expect(processor.XSLT(xsl_file)).to respond_to(:transform)
+  context "without configuration" do
+    let(:processor) { Saxon::Processor.create }
+    it "can make a new XSLT instance" do
+      expect(processor.XSLT(xsl_file)).to respond_to(:transform)
+    end
+    it "can make a new XML instance" do
+      expect(processor.XML(xsl_file)).to be_a(Saxon::XML::Document)
+    end
+    it "can return the underlying Saxon Processor" do
+      expect(processor.to_java).to respond_to(:new_xslt_compiler)
+    end
   end
-  it "can make a new XML instance" do
-    expect(processor.XML(xsl_file)).to respond_to(:getNodeKind)
+  context "with a configuration file" do
+    it "works, given a valid config XML file" do
+      processor = Saxon::Processor.create(File.open(fixture_path('config.xml')))
+      saxon_processor = processor.to_java
+      configuration = saxon_processor.underlying_configuration
+      expect(configuration.xml_version).to eq(11)
+    end
   end
 end

data/spec/saxon/source_helper_spec.rb ADDED

@@ -0,0 +1,117 @@
+require 'spec_helper'
+require 'stringio'
+require 'open-uri'
+require 'saxon/source_helper'
+java_import org.jruby.embed.io.ReaderInputStream
+describe Saxon::SourceHelper do
+  describe "returning a StreamSource" do
+    context "for input backed by a StringReader" do
+      it "converts a String correctly" do
+        input = "Hello mum"
+        source = Saxon::SourceHelper.to_stream_source(input)
+        stream = ReaderInputStream.new(source.reader)
+        expect(source).to respond_to(:system_id)
+        expect(stream.to_io.read).to eq(input)
+      end
+    end
+    context "for input backed by an InputStream" do
+      it "converts a File correctly" do
+        path = fixture_path('eg.xml')
+        source = Saxon::SourceHelper.to_stream_source(File.open(path))
+        expect(source).to respond_to(:system_id)
+        expect(source.input_stream.to_io.read).to eq(File.read(path))
+      end
+      it "converts a StringIO correctly" do
+        input = "Hello mum"
+        source = Saxon::SourceHelper.to_stream_source(StringIO.new(input))
+        expect(source).to respond_to(:system_id)
+        expect(source.input_stream.to_io.read).to eq(input)
+      end
+      it "converts an open-uri'd File correctly" do
+        path = fixture_path('eg.xml')
+        uri = "file://#{path}"
+        source = Saxon::SourceHelper.to_stream_source(open(uri))
+        expect(source).to respond_to(:system_id)
+        expect(source.input_stream.to_io.read).to eq(File.read(path))
+      end
+      it "converts an open-uri'd Uri correctly", :vcr do
+        uri = "http://example.org/"
+        expected = open(uri).read
+        source = Saxon::SourceHelper.to_stream_source(open(uri))
+        expect(source).to respond_to(:system_id)
+        expect(source.input_stream.to_io.read).to eq(expected)
+      end
+    end
+    context "StreamSource systemId" do
+      context "for inputs where we can't infer the path or URI" do
+        it "is set to nil for Strings" do
+          input = "Hello mum"
+          source = Saxon::SourceHelper.to_stream_source(input)
+          expect(source.system_id).to be(nil)
+        end
+        it "is set to nil for StringIOs" do
+          input = "Hello mum"
+          source = Saxon::SourceHelper.to_stream_source(StringIO.new(input))
+          expect(source.system_id).to be(nil)
+        end
+        it "can be set explicitly" do
+          input = "Hello mum"
+          source = Saxon::SourceHelper.to_stream_source(input,
+            system_id: '/path/to/src'
+          )
+          expect(source.system_id).to eq('/path/to/src')
+        end
+      end
+      context "for inputs where we can infer the path or URI" do
+        it "is set to a File's path" do
+          path = fixture_path('eg.xml')
+          source = Saxon::SourceHelper.to_stream_source(File.open(path))
+          expect(source.system_id).to eq(path)
+        end
+        it "is set to an open-uri'd File's URI" do
+          path = fixture_path('eg.xml')
+          uri = "file://#{path}"
+          source = Saxon::SourceHelper.to_stream_source(open(uri))
+          expect(source.system_id).to eq(uri)
+        end
+        it "is set to an open-uri'd URI's URI", :vcr do
+          uri = "http://example.org/"
+          source = Saxon::SourceHelper.to_stream_source(open(uri))
+          expect(source.system_id).to eq(uri)
+        end
+        it "overrides the inferred system ID if set explicitly", :vcr do
+          uri = "http://example.org/"
+          source = Saxon::SourceHelper.to_stream_source(open(uri),
+            system_id: '/path/to/src'
+          )
+          expect(source.system_id).to eq('/path/to/src')
+        end
+      end
+    end
+  end
+end

data/spec/saxon/xml_spec.rb CHANGED

@@ -1,21 +1,56 @@
 require 'spec_helper'
 require 'saxon/xml'
+java_import 'net.sf.saxon.s9api.XdmNodeKind'
+java_import 'net.sf.saxon.s9api.XdmNode'
 describe Saxon::XML do
+  let(:processor) { Saxon::Processor.create }
   context "parsing a document" do
+    it "returns a Document (wrapper) object" do
+      doc = processor.XML('<input/>')
+      expect(doc.class).to be(Saxon::XML::Document)
+    end
+    it "makes the underlying Saxon XDM document available" do
+      doc = processor.XML('<input/>')
+      expect(doc.to_java.class).to be(XdmNode)
+    end
     it "can parse a document from a File object" do
-      expect(Saxon.XML(File.open(fixture_path('eg.xml')))).to respond_to(:getNodeKind)
+      doc = processor.XML(File.open(fixture_path('eg.xml')))
+      expect(doc.to_java.node_kind).to eq(XdmNodeKind::DOCUMENT)
     end
     it "can parse a document from a string" do
       xml = File.read(fixture_path('eg.xml'))
-      expect(Saxon.XML(xml)).to respond_to(:getNodeKind)
+      doc = processor.XML(xml)
+      expect(doc.to_java.node_kind).to eq(XdmNodeKind::DOCUMENT)
     end
     it "can parse a document from an IO object" do
       xml = File.read(fixture_path('eg.xml'))
       io = StringIO.new(xml)
-      expect(Saxon.XML(io)).to respond_to(:getNodeKind)
+      doc = processor.XML(io)
+      expect(doc.to_java.node_kind).to eq(XdmNodeKind::DOCUMENT)
+    end
+    it "can set the system ID of a parsed document" do
+      xml = File.read(fixture_path('eg.xml'))
+      doc = processor.XML(xml, system_id: 'http://example.org/')
+      expect(doc.to_java.document_uri.to_s).to eq('http://example.org/')
     end
   end
+  it "can produce a simple serialisation of its content" do
+    doc = processor.XML('<input/>')
+    expect(doc.to_s.strip).to eq('<input/>')
+  end
+  it "can return the Saxon::Processor it was created with" do
+    doc = processor.XML('<input/>')
+    expect(doc.processor).to eq(processor)
+  end
 end

data/spec/saxon/xslt_spec.rb CHANGED

@@ -3,30 +3,47 @@ require 'saxon-xslt'
 require 'stringio'
 describe Saxon::XSLT do
+  let(:processor) { Saxon::Processor.create }
   context "compiling the stylesheet" do
     it "can compile a stylesheet from a File object" do
-      expect(Saxon.XSLT(File.open(fixture_path('eg.xsl')))).to respond_to(:transform)
+      expect(processor.XSLT(File.open(fixture_path('eg.xsl')))).to respond_to(:transform)
     end
     it "can compile a stylesheet from a string" do
       xsl = File.read(fixture_path('eg.xsl'))
-      expect(Saxon.XSLT(xsl)).to respond_to(:transform)
+      expect(processor.XSLT(xsl)).to respond_to(:transform)
     end
     it "can compile a stylesheet from an IO object" do
       xsl = File.read(fixture_path('eg.xsl'))
       io = StringIO.new(xsl)
-      expect(Saxon.XSLT(io)).to respond_to(:transform)
+      expect(processor.XSLT(io)).to respond_to(:transform)
+    end
+    it "can set the system ID of the Stylesheet correctly" do
+      xml = File.read(fixture_path('simple-xsl-import.xsl'))
+      xslt = processor.XSLT(xml, system_id: fixture_path('samedir.xsl'))
+      # We test this by using an XSL which calls xsl:import with a relative path
+      # The relative path breaks unless the system ID is correctly set
+      expect(xslt).to respond_to(:transform)
+    end
+    it "can compile a stylesheet from a Saxon::XML::Document" do
+      input = processor.XML(File.open(fixture_path('eg.xsl')))
+      xslt = Saxon::XSLT::Stylesheet.new(input)
+      expect(xslt).to respond_to(:transform)
     end
   end
   context "transforming a document" do
     context "emitting a Document object as the result" do
-      let(:xsl) { Saxon.XSLT(File.open(fixture_path('eg.xsl'))) }
-      let(:xml) { Saxon.XML(File.open(fixture_path('eg.xml'))) }
+      let(:xsl) { processor.XSLT(File.open(fixture_path('eg.xsl'))) }
+      let(:xml) { processor.XML(File.open(fixture_path('eg.xml'))) }
       it "takes a Document object as input for a transformation" do
-        expect(xsl.transform(xml)).to respond_to(:getNodeKind)
+        expect { xsl.transform(xml) }.not_to raise_error
       end
       context "the transform result" do
@@ -43,3 +60,4 @@ describe Saxon::XSLT do
     end
   end
 end

data/spec/spec_helper.rb CHANGED

@@ -1,9 +1,17 @@
+require 'vcr'
 module FixtureHelpers
   def fixture_path(path)
     File.expand_path(File.join('../fixtures', path), __FILE__)
   end
 end
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/fixtures/cassettes'
+  c.hook_into :webmock
+  c.configure_rspec_metadata!
+end
 RSpec.configure do |c|
   c.include FixtureHelpers
 end

data/vendor/saxonica/saxon9-unpack.jar CHANGED

Binary file

data/vendor/saxonica/saxon9-xqj.jar ADDED

Binary file

data/vendor/saxonica/saxon9he.jar CHANGED

Binary file

metadata CHANGED

@@ -1,49 +1,86 @@
 --- !ruby/object:Gem::Specification
 name: saxon-xslt
 version: !ruby/object:Gem::Version
-  prerelease:
-  version: 0.2.0.1
+  version: 0.5.0
 platform: java
 authors:
 - Matt Patterson
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-09-19 00:00:00.000000000 Z
+date: 2014-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.1'
   name: rake
+  prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 10.1.0
-    none: false
+        version: '10.1'
+- !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 10.1.0
-    none: false
+        version: '3.0'
+  name: rspec
   prerelease: false
   type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.2
+  name: vcr
+  prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.14.0
-    none: false
+        version: 2.9.2
+- !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.14.0
-    none: false
+        version: 1.18.0
+  name: webmock
   prerelease: false
   type: :development
-description: Wraps the Saxon 9.4 HE XSLT 2.0 processor so that you can transform XSLT 2 stylesheets in JRuby. Sticks closely to the Nokogiri API
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.18.0
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  name: yard
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+description: Wraps the Saxon 9.5 HE XSLT 2.0 processor so that you can transform XSLT 2 stylesheets in JRuby. Sticks closely to the Nokogiri API
 email:
 - matt@reprocessed.org
 executables: []
@@ -51,6 +88,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rspec
 - .ruby-version
 - .travis.yml
 - Gemfile
@@ -60,23 +98,31 @@ files:
 - lib/saxon-xslt.rb
 - lib/saxon/processor.rb
 - lib/saxon/s9api.rb
-- lib/saxon/source_helpers.rb
+- lib/saxon/source_helper.rb
 - lib/saxon/xml.rb
 - lib/saxon/xslt.rb
 - lib/saxon/xslt/version.rb
 - saxon-xslt.gemspec
+- spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/is_set_to_an_open-uri_d_URI_s_URI.yml
+- spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/overrides_the_inferred_system_ID_if_set_explicitly.yml
+- spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/for_input_backed_by_an_InputStream/converts_an_open-uri_d_Uri_correctly.yml
+- spec/fixtures/config.xml
 - spec/fixtures/eg.xml
 - spec/fixtures/eg.xsl
+- spec/fixtures/simple-xsl-import.xsl
 - spec/saxon/processor_spec.rb
+- spec/saxon/source_helper_spec.rb
 - spec/saxon/xml_spec.rb
 - spec/saxon/xslt_spec.rb
 - spec/spec_helper.rb
 - vendor/saxonica/saxon9-unpack.jar
+- vendor/saxonica/saxon9-xqj.jar
 - vendor/saxonica/saxon9he.jar
 homepage: https://github.com/fidothe/saxon-xslt
 licenses:
 - MIT
 - MPL-1.0
+metadata: {}
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -86,23 +132,28 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-  none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-  none: false
 requirements: []
 rubyforge_project:
-rubygems_version: 1.8.24
+rubygems_version: 2.1.9
 signing_key:
-specification_version: 3
-summary: Saxon 9.4 HE XSLT 2.0 for JRuby with Nokogiri's API
+specification_version: 4
+summary: Saxon 9.5 HE XSLT 2.0 for JRuby with Nokogiri's API
 test_files:
+- spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/is_set_to_an_open-uri_d_URI_s_URI.yml
+- spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/StreamSource_systemId/for_inputs_where_we_can_infer_the_path_or_URI/overrides_the_inferred_system_ID_if_set_explicitly.yml
+- spec/fixtures/cassettes/Saxon_SourceHelper/returning_a_StreamSource/for_input_backed_by_an_InputStream/converts_an_open-uri_d_Uri_correctly.yml
+- spec/fixtures/config.xml
 - spec/fixtures/eg.xml
 - spec/fixtures/eg.xsl
+- spec/fixtures/simple-xsl-import.xsl
 - spec/saxon/processor_spec.rb
+- spec/saxon/source_helper_spec.rb
 - spec/saxon/xml_spec.rb
 - spec/saxon/xslt_spec.rb
 - spec/spec_helper.rb
+has_rdoc:

data/lib/saxon/source_helpers.rb DELETED

@@ -1,14 +0,0 @@
-module Saxon
-  module SourceHelpers
-    private
-    def to_stream_source(path_io_or_string)
-      StreamSource.new(to_inputstream(path_io_or_string))
-    end
-    def to_inputstream(path_io_or_string)
-      return path_io_or_string.to_inputstream if path_io_or_string.respond_to?(:read)
-      return java.io.StringReader.new(path_io_or_string)
-    end
-  end
-end