Rough setup for a custom #inspect format.

This format is a lot more readable than the default Ruby #inspect format
(mostly due to not including previous/next/parent nodes).

lib/oga/xml/doctype.rb

@@ -24,6 +24,19 @@ module Oga
 
         return segments + '>'
       end
+
+      def inspect(indent = 0)
+        class_name = self.class.to_s.split('::').last
+
+        return <<-EOF.strip
+#{class_name}(
+    name: #{name.inspect}
+    type: #{type.inspect}
+    public_id: #{public_id.inspect}
+    system_id: #{system_id.inspect}
+  )
+        EOF
+      end
     end # Doctype
   end # XML
 end # Oga

lib/oga/xml/document.rb

@@ -30,6 +30,20 @@ module Oga
 
         return xml
       end
+
+      def inspect
+        class_name  = self.class.to_s.split('::').last
+        child_lines = children.map { |child| child.inspect(4) }.join("\n")
+
+        return <<-EOF.strip
+#{class_name}(
+  doctype: #{doctype.inspect}
+  xml_declaration: #{xml_declaration.inspect}
+  children: [
+#{child_lines}
+])
+        EOF
+      end
     end # Document
   end # XML
 end # Oga

lib/oga/xml/element.rb

@@ -30,6 +30,22 @@ module Oga
 
         return "<#{ns}#{name}#{attrs}>#{body}</#{name}>"
       end
+
+      def extra_inspect_data(indent)
+        spacing     = ' ' * indent
+        child_lines = children.map { |child| child.inspect(indent + 4) }
+          .join("\n")
+
+        return <<-EOF.chomp
+
+#{spacing}  name: #{name.inspect}
+#{spacing}  namespace: #{namespace.inspect}
+#{spacing}  attributes: #{attributes.inspect}
+#{spacing}  children: [
+#{child_lines}
+#{spacing}]
+        EOF
+      end
     end # Element
   end # XML
 end # Oga

lib/oga/xml/node.rb

@@ -35,6 +35,16 @@ module Oga
 
         after_initialize if respond_to?(:after_initialize)
       end
+
+      def inspect(indent = 0)
+        class_name = self.class.to_s.split('::').last
+        spacing    = ' ' * indent
+
+        return "#{spacing}#{class_name}(#{extra_inspect_data(indent)})"
+      end
+
+      def extra_inspect_data
+      end
     end # Element
   end # XML
 end # Oga

lib/oga/xml/text.rb

@@ -8,6 +8,10 @@ module Oga
       def to_xml
         return text.to_s
       end
+
+      def extra_inspect_data(indent)
+        return "text: #{text.inspect}"
+      end
     end # Text
   end # XML
 end # Oga

lib/oga/xml/xml_declaration.rb

@@ -33,6 +33,19 @@ module Oga
 
         return "<?xml #{pairs.join(' ')} ?>"
       end
+
+
+      def inspect
+        class_name = self.class.to_s.split('::').last
+
+        return <<-EOF.strip
+#{class_name}(
+    version: #{version.inspect}
+    encoding: #{encoding.inspect}
+    standalone: #{standalone.inspect}
+  )
+        EOF
+      end
     end # XmlDeclaration
   end # XML
 end # Oga