(feat): Circular / resolving errors returned with document creation. #18

Tristan made a good point, part of the doc building process performs a resolving check and circular reference check, which is ignored by the returned errors. So resolving errors are now unpacked into standard errors and returned. Not sure why gofmt has shifted everything around however.

test_specs/swagger-circular-tests.yaml

@@ -0,0 +1,51 @@
+swagger: "2.0"
+paths:
+  /burgers:
+    post:
+      responses:
+        200:
+          schema:
+            $ref: '#/definitions/Nine'
+definitions:
+  One:
+    description: "test one"
+    properties:
+      things:
+        "$ref": "#/definitions/Two"
+  Two:
+    description: "test two"
+    properties:
+      testThing:
+        "$ref": "#/definitions/One"
+  Three:
+    description: "test three"
+    properties:
+      tester:
+        "$ref": "#/definitions/Four"
+      bester:
+        "$ref": "#/definitions/Seven"
+      yester:
+        "$ref": "#/definitions/Seven"
+  Four:
+    description: "test four"
+    properties:
+      lemons:
+        "$ref": "#/definitions/Nine"
+  Five:
+    properties:
+      rice:
+        "$ref": "#/definitions/Six"
+  Six:
+    properties:
+      mints:
+        "$ref": "#/definitions/Nine"
+  Seven:
+    properties:
+      wow:
+        "$ref": "#/definitions/Three"
+  Nine:
+    description: done.
+  Ten:
+    properties:
+      yeah:
+        "$ref": "#/definitions/Ten"