module JSON::LD module Compact include Utils ## # This algorithm compacts a JSON-LD document, such that the given context is applied. This must result in shortening any applicable IRIs to terms or compact IRIs, any applicable keywords to keyword aliases, and any applicable JSON-LD values expressed in expanded form to simple values such as strings or numbers. # # @param [Array, Hash] element # @param [String] property (nil) # @return [Array, Hash] def compact(element, property = nil) if property.nil? debug("compact") {"element: #{element.inspect}, ec: #{context.inspect}"} else debug("compact") {"property: #{property.inspect}"} end case element when Array debug("") {"Array #{element.inspect}"} result = depth {element.map {|item| compact(item, property)}.compact} # If element has a single member and the active property has no # @container mapping to @list or @set, the compacted value is that # member; otherwise the compacted value is element if result.length == 1 && context.container(property).nil? && @options[:compactArrays] debug("=> extract single element: #{result.first.inspect}") result.first else debug("=> array result: #{result.inspect}") result end when Hash # Otherwise element is a JSON object. # @null objects are used in framing return nil if element.has_key?('@null') if element.keys.any? {|k| %w(@id @value).include?(k)} result = context.compact_value(property, element, depth: @depth) unless result.is_a?(Hash) debug("") {"=> scalar result: #{result.inspect}"} return result end end inside_reverse = property == '@reverse' result = {} element.each_key do |expanded_property| expanded_value = element[expanded_property] debug("") {"#{expanded_property}: #{expanded_value.inspect}"} if %w(@id @type).include?(expanded_property) compacted_value = [expanded_value].flatten.compact.map do |expanded_type| depth {context.compact_iri(expanded_type, vocab: (expanded_property == '@type'), depth: @depth)} end compacted_value = compacted_value.first if compacted_value.length == 1 al = context.compact_iri(expanded_property, vocab: true, quiet: true) debug(expanded_property) {"result[#{al}] = #{compacted_value.inspect}"} result[al] = compacted_value next end if expanded_property == '@reverse' compacted_value = depth {compact(expanded_value, '@reverse')} debug("@reverse") {"compacted_value: #{compacted_value.inspect}"} compacted_value.each do |prop, value| if context.reverse?(prop) value = [value] if !value.is_a?(Array) && (context.container(prop) == '@set' || !@options[:compactArrays]) debug("") {"merge #{prop} => #{value.inspect}"} merge_compacted_value(result, prop, value) compacted_value.delete(prop) end end unless compacted_value.empty? al = context.compact_iri('@reverse', quiet: true) debug("") {"remainder: #{al} => #{compacted_value.inspect}"} result[al] = compacted_value end next end if expanded_property == '@index' && context.container(property) == '@index' debug("@index") {"drop @index"} next end # Otherwise, if expanded property is @index, @value, or @language: if %w(@index @value @language).include?(expanded_property) al = context.compact_iri(expanded_property, vocab: true, quiet: true) debug(expanded_property) {"#{al} => #{expanded_value.inspect}"} result[al] = expanded_value next end if expanded_value == [] item_active_property = depth do context.compact_iri(expanded_property, value: expanded_value, vocab: true, reverse: inside_reverse, depth: @depth) end iap = result[item_active_property] ||= [] result[item_active_property] = [iap] unless iap.is_a?(Array) end # At this point, expanded value must be an array due to the Expansion algorithm. expanded_value.each do |expanded_item| item_active_property = depth do context.compact_iri(expanded_property, value: expanded_item, vocab: true, reverse: inside_reverse, depth: @depth) end container = context.container(item_active_property) value = list?(expanded_item) ? expanded_item['@list'] : expanded_item compacted_item = depth {compact(value, item_active_property)} debug("") {" => compacted key: #{item_active_property.inspect} for #{compacted_item.inspect}"} if list?(expanded_item) compacted_item = [compacted_item] unless compacted_item.is_a?(Array) unless container == '@list' al = context.compact_iri('@list', vocab: true, quiet: true) compacted_item = {al => compacted_item} if expanded_item.has_key?('@index') key = context.compact_iri('@index', vocab: true, quiet: true) compacted_item[key] = expanded_item['@index'] end else raise JsonLdError::CompactionToListOfLists, "key cannot have more than one list value" if result.has_key?(item_active_property) end end if %w(@language @index).include?(container) map_object = result[item_active_property] ||= {} compacted_item = compacted_item['@value'] if container == '@language' && value?(compacted_item) map_key = expanded_item[container] merge_compacted_value(map_object, map_key, compacted_item) else compacted_item = [compacted_item] if !compacted_item.is_a?(Array) && ( !@options[:compactArrays] || %w(@set @list).include?(container) || %w(@list @graph).include?(expanded_property) ) merge_compacted_value(result, item_active_property, compacted_item) end end end # Re-order result keys result.keys.kw_sort.inject({}) {|map, kk| map[kk] = result[kk]; map} else # For other types, the compacted value is the element value debug("compact") {element.class.to_s} element end end end end