Allo for extra arguments and options to the serializer interface.

Author: gkellogg

Diff for: README.md

@@ -32,10 +32,10 @@ This gem also implements an optimized streaming writer used for generating JSON-
 * Each statement written as a separate node in expanded/flattened form.
 * `RDF List`s are written as separate nodes using `rdf:first` and `rdf:rest` properties.
 
-The order of triples retrieved from the `RDF::Enumerable` dataset determines the way that JSON-LD node objects are written; for best results, statements should be ordered by _graph name_, _subect_, _predicate_ and _object_.
+The order of triples retrieved from the `RDF::Enumerable` dataset determines the way that JSON-LD node objects are written; for best results, statements should be ordered by _graph name_, _subject_, _predicate_ and _object_.
 
 ### MultiJson parser
-The [MultiJson](https://rubygems.org/gems/multi_json) gem is used for parsing JSON; this defaults to the native JSON parser, but will use a more performant parser if one is available. A specific parser can be specified by adding the `:adapter` option to any API call. See [MultiJson](https://rubygems.org/gems/multi_json) for more information.
+The [MultiJson](https://rubygems.org/gems/multi_json) gem is used for parsing and serializing JSON; this defaults to the native JSON parser/serializer, but will use a more performant parser if one is available. A specific parser can be specified by adding the `:adapter` option to any API call. Additionally, a custom serialilzer may be specified by passing the `:serializer` option to {JSON::LD::Writer} or methods of {JSON::LD::API}. See [MultiJson](https://rubygems.org/gems/multi_json) for more information.
 
 ### JSON-LD-star (RDFStar)
 

Diff for: lib/json/ld/api.rb

@@ -184,7 +184,7 @@ def self.expand(input, framing: false, serializer: nil, **options, &block)
 
       # Finally, if element is a JSON object, it is wrapped into an array.
       result = [result].compact unless result.is_a?(Array)
-      result = serializer.call(result) if serializer
+      result = serializer.call(result, **options) if serializer
 
       if block_given?
         case block.arity
@@ -246,7 +246,7 @@ def self.compact(input, context, expanded: false, serializer: nil, **options)
         end
         result = ctx.merge(result) unless ctx.fetch('@context', {}).empty?
       end
-      result = serializer.call(result) if serializer
+      result = serializer.call(result, **options) if serializer
       block_given? ? yield(result) : result
     end
 
@@ -330,7 +330,7 @@ def self.flatten(input, context, expanded: false, serializer: nil, **options)
         end
       end
 
-      flattened = serializer.call(flattened) if serializer
+      flattened = serializer.call(flattened, **options) if serializer
       block_given? ? yield(flattened) : flattened
     end
 
@@ -481,7 +481,7 @@ def self.frame(input, frame, expanded: false, serializer: nil, **options)
         result
       end
 
-      result = serializer.call(result) if serializer
+      result = serializer.call(result, **options) if serializer
       block_given? ? yield(result) : result
     end
 
@@ -566,7 +566,7 @@ def self.fromRdf(input, useRdfType: false, useNativeTypes: false, serializer: ni
           useNativeTypes: useNativeTypes)
       end
 
-      result = serializer.call(result) if serializer
+      result = serializer.call(result, **options) if serializer
       block_given? ? yield(result) : result
     end
 
@@ -823,7 +823,11 @@ def self.load_html(input, url:,
     # Defaults to `MultiJson.dump`
     #
     # @param [Object] object
-    def self.serializer(object)
+    # @param [Array<Object>] args
+    #   other arguments that may be passed for some specific implementation.
+    # @param [Hash<Symbol, Object>] options
+    #   options passed from the invoking context.
+    def self.serializer(object, *args, **options)
       MultiJson.dump(object, JSON_STATE)
     end
 

Diff for: lib/json/ld/writer.rb

@@ -334,7 +334,7 @@ def write_epilogue
           result = API.compact(result, context,  **@options.merge(serializer: nil))
         end
 
-        @output.write(@serializer.call(result))
+        @output.write(@serializer.call(result, **@options))
       end
 
       super