openapi

Author: metaleap

srv/codegen_apistuff.go

@@ -230,19 +230,25 @@ func codegenOpenApi(apiRefl *apiReflect) (didFsWrites []string) {
 			},
 			ReqBody: yopenapi.ReqBody{
 				Required: true,
-				Descr:    "Type name auto-suggestion: `" + method.In + "`",
+				Descr:    "Internal type ident: `" + method.In + "`",
 				Content:  map[string]yopenapi.Media{apisContentType: {Example: dummy_arg}},
 			},
 			Responses: map[string]yopenapi.Resp{
 				"200": {
-					Descr:   method.Out,
+					Descr:   "Internal type ident: `" + method.Out + "`",
 					Content: map[string]yopenapi.Media{apisContentType: {Example: dummy_ret}},
 					Headers: map[string]yopenapi.Header{
 						yoctx.HttpResponseHeaderName_UserId: {Descr: "0 if not authenticated, else current user's ID", Content: map[string]yopenapi.Media{"text/plain": {Example: "123"}}},
 					},
 				},
 			},
 		}}
+		for http_status_code, errs := range sl.Grouped(api_method.KnownErrs(), func(it Err) string { return str.FromInt(it.HttpStatusCodeOr(500)) }) {
+			path.Post.Responses[http_status_code] = yopenapi.Resp{
+				Descr:   "foo",
+				Content: map[string]yopenapi.Media{"text/plain": {Examples: kv.FromKeys(errs, func(it Err) yopenapi.Example { return yopenapi.Example{Value: it} })}},
+			}
+		}
 		openapi.Paths["/"+method.Path] = path
 	}
 

srv/openapi/openapi.go

@@ -60,7 +60,7 @@ type ReqBody struct {
 
 type Resp struct {
 	Descr   string            `json:"description"`
-	Headers map[string]Header `json:"headers"`
+	Headers map[string]Header `json:"headers,omitempty"`
 	Content map[string]Media  `json:"content"`
 }
 
@@ -72,7 +72,14 @@ type Header struct {
 }
 
 type Media struct {
-	Example any `json:"example"`
+	Example  any                `json:"example,omitempty"`
+	Examples map[string]Example `json:"examples,omitempty"`
+}
+
+type Example struct {
+	Summary string `json:"summary,omitempty"`
+	Descr   string `json:"description,omitempty"`
+	Value   any    `json:"value"`
 }
 
 var tyTime = reflect.TypeOf(time.Time{})

util/err.go

@@ -28,6 +28,7 @@ var errSubstrToHttpStatusCode = map[string]int{
 
 func (me Err) Error() string  { return string(me) }
 func (me Err) String() string { return string(me) }
+func (me Err) AsAny() any     { return me }
 func (me Err) HttpStatusCodeOr(preferredDefault int) int {
 	for substr, code := range errSubstrToHttpStatusCode {
 		if str.Has(string(me), substr) {

util/kv/kv.go

@@ -17,3 +17,19 @@ func Fill[K comparable, V any](dst map[K]V, from map[K]V) map[K]V {
 	}
 	return dst
 }
+
+func FromKeys[K comparable, V any](keys []K, value func(K) V) map[K]V {
+	ret := make(map[K]V, len(keys))
+	for _, key := range keys {
+		ret[key] = value(key)
+	}
+	return ret
+}
+
+func FromValues[K comparable, V any](values []V, key func(V) K) map[K]V {
+	ret := make(map[K]V, len(values))
+	for _, val := range values {
+		ret[key(val)] = val
+	}
+	return ret
+}

util/sl/sl.go

@@ -200,8 +200,8 @@ func FirstNonNil[T any](slice ...*T) *T {
 	return nil
 }
 
-func Grouped[TKey comparable, TItem any, TSlice ~[]TItem](slice TSlice, key func(TItem) TKey) (ret map[TKey]TSlice) {
-	ret = make(map[TKey]TSlice, len(slice)/2)
+func Grouped[TKey comparable, TItem any](slice Of[TItem], key func(TItem) TKey) (ret map[TKey]Of[TItem]) {
+	ret = make(map[TKey]Of[TItem], len(slice)/2)
 	for i := range slice {
 		key := key(slice[i])
 		ret[key] = append(ret[key], slice[i])