Make language option explicit for overriding the default language.

Author: gkellogg

lib/json/ld/api.rb

@@ -71,6 +71,8 @@ class API
     #   A context that is used to initialize the active context when expanding a document.
     # @option options [Boolean, String, RDF::URI] :flatten
     #   If set to a value that is not `false`, the JSON-LD processor must modify the output of the Compaction Algorithm or the Expansion Algorithm by coalescing all properties associated with each subject via the Flattening Algorithm. The value of `flatten must` be either an _IRI_ value representing the name of the graph to flatten, or `true`. If the value is `true`, then the first graph encountered in the input document is selected and flattened.
+    # @option options [String] :language
+    #   When set, this has the effect of inserting a context definition with `@language` set to the associated value, creating a default language for interpreting string values.
     # @option options [String] :processingMode
     #   Processing mode, json-ld-1.0 or json-ld-1.1.
     #   If `processingMode` is not specified, a mode of `json-ld-1.0` or `json-ld-1.1` is set, the context used for `expansion` or `compaction`.
@@ -84,6 +86,7 @@ class API
     # @yieldparam [API]
     # @raise [JsonLdError]
     def initialize(input, context, rename_bnodes: true, unique_bnodes: false, **options, &block)
+      #require 'byebug'; byebug
       @options = {
         compactArrays:      true,
         documentLoader:     self.class.method(:documentLoader)

spec/expand_spec.rb

@@ -96,6 +96,32 @@
       it(title) {run_expand params}
     end
 
+    context "default language" do
+      {
+        "base": {
+          input: %({
+            "http://example/foo": "bar"
+          }),
+          output: %([{
+            "http://example/foo": [{"@value": "bar", "@language": "en"}]
+          }]),
+          language: "en"
+        },
+        "override": {
+          input: %({
+            "@context": {"@language": null},
+            "http://example/foo": "bar"
+          }),
+          output: %([{
+            "http://example/foo": [{"@value": "bar"}]
+          }]),
+          language: "en"
+        }
+      }.each_pair do |title, params|
+        it(title) {run_expand params}
+      end
+    end
+
     context "with relative IRIs" do
       {
         "base": {
@@ -2349,14 +2375,14 @@
   end
 
   def run_expand(params)
-    input, output, processingMode = params[:input], params[:output], params[:processingMode]
+    input, output = params[:input], params[:output]
     input = ::JSON.parse(input) if input.is_a?(String)
     output = ::JSON.parse(output) if output.is_a?(String)
     pending params.fetch(:pending, "test implementation") unless input
     if params[:exception]
-      expect {JSON::LD::API.expand(input, {processingMode: processingMode}.merge(params))}.to raise_error(params[:exception])
+      expect {JSON::LD::API.expand(input, params)}.to raise_error(params[:exception])
     else
-      jld = JSON::LD::API.expand(input, base: params[:base], logger: logger, processingMode: processingMode)
+      jld = JSON::LD::API.expand(input, {logger: logger}.merge(params))
       expect(jld).to produce(output, logger)
     end
   end