Files
libopenapi/datamodel/high/base/external_doc_test.go
Dave Shanley 8bd691b9bd Working through adding documentation to datamodel.
Adding examples and docs, A long way to go, but like always, we just keep chipping away.
2022-09-14 08:55:26 -04:00

66 lines
1.5 KiB
Go

// Copyright 2022 Princess B33f Heavy Industries / Dave Shanley
// SPDX-License-Identifier: MIT
package base
import (
"fmt"
lowmodel "github.com/pb33f/libopenapi/datamodel/low"
lowbase "github.com/pb33f/libopenapi/datamodel/low/base"
"github.com/stretchr/testify/assert"
"gopkg.in/yaml.v3"
"testing"
)
func TestNewExternalDoc(t *testing.T) {
var cNode yaml.Node
yml := `description: hack code
url: https://pb33f.io
x-hack: code`
_ = yaml.Unmarshal([]byte(yml), &cNode)
var lowExt lowbase.ExternalDoc
_ = lowmodel.BuildModel(&cNode, &lowExt)
_ = lowExt.Build(cNode.Content[0], nil)
highExt := NewExternalDoc(&lowExt)
assert.Equal(t, "hack code", highExt.Description)
assert.Equal(t, "https://pb33f.io", highExt.URL)
assert.Equal(t, "code", highExt.Extensions["x-hack"])
wentLow := highExt.GoLow()
assert.Equal(t, 2, wentLow.URL.ValueNode.Line)
}
func ExampleNewExternalDoc() {
// create a new external documentation spec reference
// this can be YAML or JSON.
yml := `description: hack code docs
url: https://pb33f.io/docs
x-hack: code`
// unmarshal the raw bytes into a *yaml.Node
var node yaml.Node
_ = yaml.Unmarshal([]byte(yml), &node)
// build low-level ExternalDoc
var lowExt lowbase.ExternalDoc
_ = lowmodel.BuildModel(&node, &lowExt)
// build out low-level properties (like extensions)
_ = lowExt.Build(node.Content[0], nil)
// create new high-level ExternalDoc
highExt := NewExternalDoc(&lowExt)
// print out a extension
fmt.Print(highExt.Extensions["x-hack"])
// Output: code
}