generated from TBD54566975/tbd-project-template
/
jsonschema.go
193 lines (167 loc) 路 5.49 KB
/
jsonschema.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
package schema
import (
"fmt"
"strings"
"github.com/swaggest/jsonschema-go"
)
// DataToJSONSchema converts the schema for a Data object to a JSON Schema.
//
// It takes in the full schema in order to resolve and define references.
func DataToJSONSchema(sch *Schema, ref Ref) (*jsonschema.Schema, error) {
data, err := sch.ResolveRefMonomorphised(&ref)
if err != nil {
return nil, err
}
if data == nil {
return nil, fmt.Errorf("unknown data type %s", ref)
}
// Encode root, and collect all data types reachable from the root.
refs := map[RefKey]*Ref{}
root := nodeToJSSchema(data, refs)
if len(refs) == 0 {
return root, nil
}
// Resolve and encode all types reachable from the root.
root.Definitions = map[string]jsonschema.SchemaOrBool{}
for _, r := range refs {
decl := sch.ResolveRef(r)
switch n := decl.(type) {
case *Data:
if len(r.TypeParameters) > 0 {
monomorphisedData, err := n.Monomorphise(r)
if err != nil {
return nil, err
}
ref := fmt.Sprintf("%s.%s", r.Module, refName(r))
root.Definitions[ref] = jsonschema.SchemaOrBool{TypeObject: nodeToJSSchema(monomorphisedData, refs)}
} else {
root.Definitions[r.String()] = jsonschema.SchemaOrBool{TypeObject: nodeToJSSchema(n, refs)}
}
case *Enum:
root.Definitions[r.String()] = jsonschema.SchemaOrBool{TypeObject: nodeToJSSchema(n, refs)}
case *Config, *Database, *Secret, *Verb:
return nil, fmt.Errorf("reference to unsupported node type %T", decl)
}
}
return root, nil
}
func nodeToJSSchema(node Node, refs map[RefKey]*Ref) *jsonschema.Schema {
switch node := node.(type) {
case *Any:
return &jsonschema.Schema{}
case *Unit:
st := jsonschema.Object
return &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &st}}
case *Data:
st := jsonschema.Object
schema := &jsonschema.Schema{
Description: jsComments(node.Comments),
Type: &jsonschema.Type{SimpleTypes: &st},
Properties: map[string]jsonschema.SchemaOrBool{},
AdditionalProperties: jsBool(false),
}
for _, field := range node.Fields {
jsField := nodeToJSSchema(field.Type, refs)
jsField.Description = jsComments(field.Comments)
if _, ok := field.Type.(*Optional); !ok {
schema.Required = append(schema.Required, field.Name)
}
schema.Properties[field.Name] = jsonschema.SchemaOrBool{TypeObject: jsField}
}
return schema
case *Enum:
schema := &jsonschema.Schema{
Description: jsComments(node.Comments),
}
values := make([]any, len(node.Variants))
for i, v := range node.Variants {
values[i] = v.Value.GetValue()
}
return schema.WithEnum(values...)
case *Int:
st := jsonschema.Integer
return &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &st}}
case *Float:
st := jsonschema.Number
return &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &st}}
case *String:
st := jsonschema.String
return &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &st}}
case *Bytes:
st := jsonschema.String
encoding := "base64"
mediaType := "application/octet-stream"
return &jsonschema.Schema{
Type: &jsonschema.Type{SimpleTypes: &st},
ContentEncoding: &encoding,
ContentMediaType: &mediaType,
}
case *Bool:
st := jsonschema.Boolean
return &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &st}}
case *Time:
st := jsonschema.String
dt := "date-time"
return &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &st}, Format: &dt}
case *Array:
st := jsonschema.Array
return &jsonschema.Schema{
Type: &jsonschema.Type{SimpleTypes: &st},
Items: &jsonschema.Items{
SchemaOrBool: &jsonschema.SchemaOrBool{
TypeObject: nodeToJSSchema(node.Element, refs),
},
},
}
case *Map:
st := jsonschema.Object
// JSON schema generic map of key type to value type
return &jsonschema.Schema{
Type: &jsonschema.Type{SimpleTypes: &st},
PropertyNames: &jsonschema.SchemaOrBool{TypeObject: nodeToJSSchema(node.Key, refs)},
AdditionalProperties: &jsonschema.SchemaOrBool{TypeObject: nodeToJSSchema(node.Value, refs)},
}
case *Ref:
var ref string
if len(node.TypeParameters) > 0 {
name := refName(node)
ref = fmt.Sprintf("#/definitions/%s.%s", node.Module, name)
} else {
ref = fmt.Sprintf("#/definitions/%s", node.String())
}
refs[node.ToRefKey()] = node
return &jsonschema.Schema{Ref: &ref}
case *Optional:
null := jsonschema.Null
return &jsonschema.Schema{AnyOf: []jsonschema.SchemaOrBool{
{TypeObject: nodeToJSSchema(node.Type, refs)},
{TypeObject: &jsonschema.Schema{Type: &jsonschema.Type{SimpleTypes: &null}}},
}}
case *TypeParameter:
return &jsonschema.Schema{}
case Decl, *Field, Metadata, *MetadataCalls, *MetadataDatabases, *MetadataIngress,
*MetadataAlias, IngressPathComponent, *IngressPathLiteral, *IngressPathParameter, *Module,
*Schema, Type, *Database, *Verb, *EnumVariant, *MetadataCronJob,
Value, *StringValue, *IntValue, *TypeValue, *Config, *Secret, Symbol, Named:
panic(fmt.Sprintf("unsupported node type %T", node))
default:
panic(fmt.Sprintf("unsupported node type %T", node))
}
}
func jsBool(ok bool) *jsonschema.SchemaOrBool {
return &jsonschema.SchemaOrBool{TypeBoolean: &ok}
}
func jsComments(comments []string) *string {
if len(comments) == 0 {
return nil
}
out := strings.Join(comments, "\n")
return &out
}
func refName(ref *Ref) string {
var suffix []string
for _, t := range ref.TypeParameters {
suffix = append(suffix, t.String())
}
return fmt.Sprintf("%s[%s]", ref.Name, strings.Join(suffix, ", "))
}