Add documentation and test for #to_h

Author: Kevin Paulisse

doc/dev/api/v1/objects/diff.md

@@ -241,3 +241,12 @@ For example, a diff involving `File['/etc/passwd']` would have:
 - `diff.type #=> 'File`
 
 Note that the type will be capitalized because Puppet capitalizes this in catalogs.
+
+## Other methods
+
+These methods are available for debugging or development purposes but are not guaranteed to remain consistent between versions:
+
+- `#inspect` (String): Returns inspection of object
+- `#raw` (Array): Returns internal array data structure of the "diff"
+- `#to_h` (Hash): Returns object as a hash, where keys are above described methods
+- `#[]` (Object): Retrieve indexed array elements from raw internal array object

lib/octocatalog-diff/api/v1/diff.rb

@@ -124,7 +124,6 @@ def new_line
         def to_h
           {
             change_type: change_type,
-            change_type_word: change_type_word,
             type: type,
             title: title,
             structure: structure,

spec/octocatalog-diff/tests/api/v1/diff_spec.rb

@@ -272,4 +272,17 @@
       expect(testobj.new_line).to be_nil
     end
   end
+
+  describe '#to_h' do
+    it 'should return a hash with the expected keys and values' do
+      methods = %w(change_type type title structure old_value new_value old_line new_line old_file new_file)
+      testobj = described_class.new(chg_2)
+      result = testobj.to_h
+      methods.each do |method_name|
+        method = method_name.to_sym
+        expect(result.key?(method)).to eq(true)
+        expect(result[method]).to eq(testobj.send(method))
+      end
+    end
+  end
 end