jsi 0.2.0 → 0.6.0

data/lib/jsi/base/to_rb.rb

@@ -1,126 +0,0 @@
-module JSI
-  class Base
-    class << self
-      def class_comment
-        lines = []
-
-        description = schema &&
-          schema['description'].respond_to?(:to_str) &&
-          schema['description'].to_str
-        if description
-          description.split("\n", -1).each do |descline|
-            lines << "# " + descline
-          end
-          lines << "#"
-        end
-
-        schema.described_object_property_names.each_with_index do |propname, i|
-          lines << "#" unless i == 0
-          lines << "# @!attribute [rw] #{propname}"
-
-          property_schema = schema['properties'].respond_to?(:to_hash) &&
-            schema['properties'][propname].respond_to?(:to_hash) &&
-            schema['properties'][propname]
-
-          required = property_schema && property_schema['required']
-          required ||= schema['required'].respond_to?(:to_ary) && schema['required'].include?(propname)
-          lines << "#   @required" if required
-
-          type = property_schema &&
-            property_schema['type'].respond_to?(:to_str) &&
-            property_schema['type'].to_str
-          simple = {'string' => 'String', 'number' => 'Numeric', 'boolean' => 'Boolean', 'null' => 'nil'}
-          rettypes = []
-          if simple.key?(type)
-            rettypes << simple[type]
-          elsif type == 'object' || type == 'array'
-            rettypes = []
-            schema_class = JSI.class_for_schema(property_schema)
-            unless schema_class.name =~ /\AJSI::SchemaClasses::/
-              rettypes << schema_class.name
-            end
-            rettypes << {'object' => '#to_hash', 'array' => '#to_ary'}[type]
-          elsif type
-            # not really valid, but there's some information in there. whatever it is.
-            rettypes << type
-          end
-          # we'll add Object to all because the accessor methods have no enforcement that their value is
-          # of the specified type, and may return anything really. TODO: consider if this is of any value?
-          rettypes << 'Object'
-          lines << "#   @return [#{rettypes.join(', ')}]"
-
-          description = property_schema &&
-            property_schema['description'].respond_to?(:to_str) &&
-            property_schema['description'].to_str
-          if description
-            description.split("\n", -1).each do |descline|
-              lines << "#     " + descline
-            end
-          end
-        end
-        lines.join("\n")
-      end
-
-      def to_rb
-        lines = []
-        description = schema &&
-          schema['description'].respond_to?(:to_str) &&
-          schema['description'].to_str
-        if description
-          description.split("\n", -1).each do |descline|
-            lines << "# " + descline
-          end
-        end
-        lines << "class #{name}"
-        schema.described_object_property_names.each_with_index do |propname, i|
-          lines << "" unless i == 0
-          property_schema = schema['properties'].respond_to?(:to_hash) &&
-            schema['properties'][propname].respond_to?(:to_hash) &&
-            schema['properties'][propname]
-          description = property_schema &&
-            property_schema['description'].respond_to?(:to_str) &&
-            property_schema['description'].to_str
-          if description
-            description.split("\n", -1).each do |descline|
-              lines << "  # " + descline
-            end
-            lines << "  #" # blank comment line between description and @return
-          end
-
-          required = property_schema && property_schema['required']
-          required ||= schema['required'].respond_to?(:to_ary) && schema['required'].include?(propname)
-          lines << "  # @required" if required
-
-          type = property_schema &&
-            property_schema['type'].respond_to?(:to_str) &&
-            property_schema['type'].to_str
-          simple = {'string' => 'String', 'number' => 'Numeric', 'boolean' => 'Boolean', 'null' => 'nil'}
-          rettypes = []
-          if simple.key?(type)
-            rettypes << simple[type]
-          elsif type == 'object' || type == 'array'
-            rettypes = []
-            schema_class = JSI.class_for_schema(property_schema)
-            unless schema_class.name =~ /\AJSI::SchemaClasses::/
-              rettypes << schema_class.name
-            end
-            rettypes << {'object' => '#to_hash', 'array' => '#to_ary'}[type]
-          elsif type
-            # not really valid, but there's some information in there. whatever it is.
-            rettypes << type
-          end
-          # we'll add Object to all because the accessor methods have no enforcement that their value is
-          # of the specified type, and may return anything really. TODO: consider if this is of any value?
-          rettypes << 'Object'
-          lines << "  # @return [#{rettypes.join(', ')}]"
-
-          lines << "  def #{propname}"
-          lines << "    super"
-          lines << "  end"
-        end
-        lines << "end"
-        lines.join("\n")
-      end
-    end
-  end
-end

data/lib/jsi/json/node.rb

@@ -1,243 +0,0 @@
-module JSI
-  module JSON
-    # JSI::JSON::Node is an abstraction of a node within a JSON document.
-    # it aims to act like the underlying data type of the node's content
-    # (generally Hash or Array-like) in most cases.
-    #
-    # the main advantage offered by using a Node over the underlying data
-    # is in dereferencing. if a Node consists of a hash with a $ref property
-    # pointing within the same document, then the Node will transparently
-    # follow the ref and return the referenced data.
-    #
-    # in most other respects, a Node aims to act like a Hash when the content
-    # is Hash-like, an Array when the content is Array-like. methods of Hash
-    # and Array are defined and delegated to the node's content.
-    #
-    # however, destructive methods are for the most part not implemented.
-    # at the moment only #[]= is implemented. since Node thinly wraps the
-    # underlying data, you can change the data and it will be reflected in
-    # the node. implementations of destructive methods are planned.
-    #
-    # methods that return a modified copy such as #merge are defined, and
-    # return a copy of the document with the content of the node modified.
-    # the original node's document and content are untouched.
-    class Node
-      include PathedNode
-
-      def self.new_doc(document)
-        new_by_type(document, JSI::JSON::Pointer.new([]))
-      end
-
-      # if the content of the document at the given pointer is Hash-like, returns
-      # a HashNode; if Array-like, returns ArrayNode. otherwise returns a
-      # regular Node, although Nodes are for the most part instantiated from
-      # Hash or Array-like content.
-      def self.new_by_type(document, pointer)
-        content = pointer.evaluate(document)
-        if content.respond_to?(:to_hash)
-          HashNode.new(document, pointer)
-        elsif content.respond_to?(:to_ary)
-          ArrayNode.new(document, pointer)
-        else
-          Node.new(document, pointer)
-        end
-      end
-
-      # a Node represents the content of a document at a given pointer.
-      def initialize(document, pointer)
-        unless pointer.is_a?(JSI::JSON::Pointer)
-          raise(TypeError, "pointer must be a JSI::JSON::Pointer. got: #{pointer.pretty_inspect.chomp} (#{pointer.class})")
-        end
-        if document.is_a?(JSI::JSON::Node)
-          raise(TypeError, "document of a Node should not be another JSI::JSON::Node: #{document.inspect}")
-        end
-        @document = document
-        @pointer = pointer
-      end
-
-      # the document containing this Node at our pointer
-      attr_reader :document
-
-      # JSI::JSON::Pointer pointing to this node within its document
-      attr_reader :pointer
-
-      # @return [Array<Object>] the path of this node; an array of reference_tokens of the pointer
-      def path
-        pointer.reference_tokens
-      end
-
-      alias_method :node_document, :document
-      alias_method :node_ptr, :pointer
-
-      # the raw content of this Node from the underlying document at this Node's pointer.
-      alias_method :content, :node_content
-
-      # returns content at the given subscript - call this the subcontent.
-      #
-      # if the content cannot be subscripted, raises TypeError.
-      #
-      # if the subcontent is Hash-like, it is wrapped as a JSI::JSON::HashNode before being returned.
-      # if the subcontent is Array-like, it is wrapped as a JSI::JSON::ArrayNode before being returned.
-      #
-      # if this node's content is a $ref - that is, a hash with a $ref attribute - and the subscript is
-      # not a key of the hash, then the $ref is followed before returning the subcontent.
-      def [](subscript)
-        ptr = self.pointer
-        content = self.content
-        if content.respond_to?(:to_hash) && !(content.respond_to?(:key?) ? content : content.to_hash).key?(subscript)
-          pointer.deref(document) do |deref_ptr|
-            ptr = deref_ptr
-            content = ptr.evaluate(document)
-          end
-        end
-        unless content.respond_to?(:[])
-          if content.respond_to?(:to_hash)
-            content = content.to_hash
-          elsif content.respond_to?(:to_ary)
-            content = content.to_ary
-          else
-            raise(NoMethodError, "undefined method `[]`\nsubscripting with #{subscript.pretty_inspect.chomp} (#{subscript.class}) from #{content.class.inspect}. content is: #{content.pretty_inspect.chomp}")
-          end
-        end
-        begin
-          subcontent = content[subscript]
-        rescue TypeError => e
-          raise(e.class, e.message + "\nsubscripting with #{subscript.pretty_inspect.chomp} (#{subscript.class}) from #{content.class.inspect}. content is: #{content.pretty_inspect.chomp}", e.backtrace)
-        end
-        if subcontent.respond_to?(:to_hash)
-          HashNode.new(document, ptr[subscript])
-        elsif subcontent.respond_to?(:to_ary)
-          ArrayNode.new(document, ptr[subscript])
-        else
-          subcontent
-        end
-      end
-
-      # assigns the given subscript of the content to the given value. the document is modified in place.
-      def []=(subscript, value)
-        if value.is_a?(Node)
-          content[subscript] = value.content
-        else
-          content[subscript] = value
-        end
-      end
-
-      # returns a Node, dereferencing a $ref attribute if possible. if this node is not hash-like,
-      # does not have a $ref, or if what its $ref cannot be found, this node is returned.
-      #
-      # currently only $refs pointing within the same document are followed.
-      #
-      # @yield [Node] if a block is given (optional), this will yield a deref'd node. if this
-      #   node is not a $ref object, the block is not called. if we are a $ref which cannot be followed
-      #   (e.g. a $ref to an external document, which is not yet supported), the block is not called.
-      # @return [JSI::JSON::Node] dereferenced node, or this node
-      def deref(&block)
-        pointer.deref(document) do |deref_ptr|
-          return Node.new_by_type(document, deref_ptr).tap(&(block || Util::NOOP))
-        end
-        return self
-      end
-
-      # a Node at the root of the document
-      def document_node
-        Node.new_doc(document)
-      end
-
-      alias_method :document_root_node, :document_node
-
-      # @return [Boolean] whether this node is the root of its document
-      def root_node?
-        pointer.root?
-      end
-
-      # the parent of this node. if this node is the document root, raises
-      # JSI::JSON::Pointer::ReferenceError.
-      def parent_node
-        Node.new_by_type(document, pointer.parent)
-      end
-
-      # the pointer path to this node within the document, per RFC 6901 https://tools.ietf.org/html/rfc6901
-      def pointer_path
-        pointer.pointer
-      end
-
-      # the pointer fragment to this node within the document, per RFC 6901 https://tools.ietf.org/html/rfc6901
-      def fragment
-        pointer.fragment
-      end
-
-      # returns a jsonifiable representation of this node's content
-      def as_json(*opt)
-        Typelike.as_json(content, *opt)
-      end
-
-      # takes a block. the block is yielded the content of this node. the block MUST return a modified
-      # copy of that content (and NOT modify the object it is given).
-      def modified_copy(&block)
-        Node.new_by_type(pointer.modified_document_copy(document, &block), pointer)
-      end
-
-      def dup
-        modified_copy(&:dup)
-      end
-
-      # meta-information about the object, outside the content. used by #inspect / #pretty_print
-      def object_group_text
-        "fragment=#{fragment.inspect}" + (content.respond_to?(:object_group_text) ? ' ' + content.object_group_text : '')
-      end
-
-      # a string representing this node
-      def inspect
-        "\#<#{self.class.inspect} #{object_group_text} #{content.inspect}>"
-      end
-
-      # pretty-prints a representation this node to the given printer
-      def pretty_print(q)
-        q.instance_exec(self) do |obj|
-          text "\#<#{obj.class.inspect} #{obj.object_group_text}"
-          group_sub {
-            nest(2) {
-              breakable ' '
-              pp obj.content
-            }
-          }
-          breakable ''
-          text '>'
-        end
-      end
-
-      # fingerprint for equality (see FingerprintHash). two nodes are equal if they are both nodes
-      # (regardless of type, e.g. one may be a Node and the other may be a HashNode) within equal
-      # documents at equal pointers. note that this means two nodes with the same content may not be
-      # considered equal.
-      def fingerprint
-        {class: JSI::JSON::Node, document: document, pointer: pointer}
-      end
-      include FingerprintHash
-    end
-
-    # a JSI::JSON::Node whose content is Array-like (responds to #to_ary)
-    # and includes Array methods from Arraylike
-    class ArrayNode < Node
-      include Enumerable
-      include PathedArrayNode
-
-      # returns a jsonifiable representation of this node's content
-      def as_json(*opt) # needs redefined after including Enumerable
-        Typelike.as_json(content, *opt)
-      end
-    end
-
-    # a JSI::JSON::Node whose content is Hash-like (responds to #to_hash)
-    # and includes Hash methods from Hashlike
-    class HashNode < Node
-      include Enumerable
-      include PathedHashNode
-
-      # returns a jsonifiable representation of this node's content
-      def as_json(*opt) # needs redefined after including Enumerable
-        Typelike.as_json(content, *opt)
-      end
-    end
-  end
-end