-
Notifications
You must be signed in to change notification settings - Fork 206
/
api_collection.go
147 lines (127 loc) · 6.78 KB
/
api_collection.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
package types
import (
"fmt"
)
// this means the current collection data can be expanded from other, i.e other is allowed to be in InheritanceApis
func (cd *CollectionData) CanExpand(other *CollectionData) bool {
return cd.ApiInterface == other.ApiInterface && cd.Type == other.Type || other.ApiInterface == ""
}
// expand is called within the same spec apiCollections, to manage inheritance within collections of different add_ons
func (apic *ApiCollection) Expand(myCollections map[CollectionData]*ApiCollection, dependencies map[CollectionData]struct{}) error {
dependencies[apic.CollectionData] = struct{}{}
defer delete(dependencies, apic.CollectionData)
inheritanceApis := apic.InheritanceApis
apic.InheritanceApis = []*CollectionData{} // delete inheritance so if someone calls expand on this in the future without dependency we don't repeat this
relevantCollections := []*ApiCollection{}
for _, inheritingCollection := range inheritanceApis {
if collection, ok := myCollections[*inheritingCollection]; ok {
if !apic.CollectionData.CanExpand(&collection.CollectionData) {
return fmt.Errorf("invalid inheriting collection %v", inheritingCollection)
}
if _, ok := dependencies[collection.CollectionData]; ok {
return fmt.Errorf("circular dependency in inheritance, %v", collection)
}
err := collection.Expand(myCollections, dependencies)
if err != nil {
return err
}
relevantCollections = append(relevantCollections, collection)
} else {
return fmt.Errorf("did not find inheritingCollection in myCollections %v", inheritingCollection)
}
}
// since expand is called within the same spec it needs to combine with disabled apiCollections
return apic.CombineWithOthers(relevantCollections, true, true)
}
// inherit is
func (apic *ApiCollection) Inherit(relevantCollections []*ApiCollection, dependencies map[CollectionData]struct{}) error {
// do not set dependencies because this mechanism protects inheritance within the same spec and inherit is inheritance between different specs so same type is allowed
return apic.CombineWithOthers(relevantCollections, false, true)
}
func (apic *ApiCollection) Equals(other *ApiCollection) bool {
return other.CollectionData == apic.CollectionData
}
// assumes relevantParentCollections are already expanded
func (apic *ApiCollection) InheritAllFields(myCollections map[CollectionData]*ApiCollection, relevantParentCollections []*ApiCollection) error {
for _, other := range relevantParentCollections {
if !apic.Equals(other) {
return fmt.Errorf("incompatible inheritance, apiCollections aren't equal %v", apic)
}
}
err := apic.Expand(myCollections, map[CollectionData]struct{}{})
if err != nil {
return err
}
return apic.Inherit(relevantParentCollections, map[CollectionData]struct{}{})
}
// this function combines apis, headers and parsers into the api collection from others. it does not check type compatibility
// changes in place inside the apic
// nil merge maps means not to combine that field
func (apic *ApiCollection) CombineWithOthers(others []*ApiCollection, combineWithDisabled, allowOverwrite bool) (err error) {
mergedApis := map[string]interface{}{}
mergedHeaders := map[string]interface{}{}
mergedParsers := map[string]interface{}{}
mergedExtensions := map[string]interface{}{}
mergedVerifications := map[string]interface{}{}
mergedApisList := []*Api{}
mergedHeadersList := []*Header{}
mergedParsersList := []*ParseDirective{}
mergedExtensionsList := []*Extension{}
mergedVerificationsList := []*Verification{}
currentApis := GetCurrentFromCombinable(apic.Apis)
currentHeaders := GetCurrentFromCombinable(apic.Headers)
currentParsers := GetCurrentFromCombinable(apic.ParseDirectives)
currentExtensions := GetCurrentFromCombinable(apic.Extensions)
currentVerifications := GetCurrentFromCombinable(apic.Verifications)
for _, collection := range others {
if !collection.Enabled && !combineWithDisabled {
continue
}
mergedApisList, mergedApis, err = CombineFields(currentApis, collection.Apis, mergedApis, mergedApisList, allowOverwrite)
if err != nil {
return fmt.Errorf("merging apis error %w, %v other collection %v", err, apic, collection.CollectionData)
}
mergedHeadersList, mergedHeaders, err = CombineFields(currentHeaders, collection.Headers, mergedHeaders, mergedHeadersList, allowOverwrite)
if err != nil {
return fmt.Errorf("merging headers error %w, %v other collection %v", err, apic, collection.CollectionData)
}
mergedParsersList, mergedParsers, err = CombineFields(currentParsers, collection.ParseDirectives, mergedParsers, mergedParsersList, allowOverwrite)
if err != nil {
return fmt.Errorf("merging parse directives error %w, %v other collection %v", err, apic, collection.CollectionData)
}
mergedExtensionsList, mergedExtensions, err = CombineFields(currentExtensions, collection.Extensions, mergedExtensions, mergedExtensionsList, allowOverwrite)
if err != nil {
return fmt.Errorf("merging extensions error %w, %v other collection %v", err, apic, collection.CollectionData)
}
mergedVerificationsList, mergedVerifications, err = CombineFields(currentVerifications, collection.Verifications, mergedVerifications, mergedVerificationsList, allowOverwrite)
if err != nil {
return fmt.Errorf("merging verifications error %w, %v other collection %v", err, apic, collection.CollectionData)
}
}
// merge collected APIs into current apiCollection's APIs (unless overridden)
apic.Apis, err = CombineUnique(mergedApisList, apic.Apis, currentApis, allowOverwrite)
if err != nil {
return fmt.Errorf("error %w in apis combination in collection %#v", err, apic)
}
// merge collected headers into current apiCollection's headers (unless overridden)
apic.Headers, err = CombineUnique(mergedHeadersList, apic.Headers, currentHeaders, allowOverwrite)
if err != nil {
return fmt.Errorf("error %w in headers combination in collection %#v", err, apic)
}
// merge collected functionTags into current apiCollection's parsing (unless overridden)
apic.ParseDirectives, err = CombineUnique(mergedParsersList, apic.ParseDirectives, currentParsers, allowOverwrite)
if err != nil {
return fmt.Errorf("error %w in parse directive combination in collection %#v", err, apic)
}
// merge collected extensions into current apiCollection's parsing (unless overridden)
apic.Extensions, err = CombineUnique(mergedExtensionsList, apic.Extensions, currentExtensions, allowOverwrite)
if err != nil {
return fmt.Errorf("error %w in extension combination in collection %#v", err, apic)
}
// merge collected verifications into current apiCollection's parsing (unless overridden)
apic.Verifications, err = CombineUnique(mergedVerificationsList, apic.Verifications, currentVerifications, allowOverwrite)
if err != nil {
return fmt.Errorf("error %w in verification combination in collection %#v", err, apic)
}
return nil
}