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

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