Add skeleton
This commit is contained in:
ElvinChan
parent
646fdc4da4
commit
306847994a
63
assets.go
Normal file
63
assets.go
Normal file
@ -0,0 +1,63 @@
|
||||
package echoswagger
|
||||
|
||||
const SwaggerUIContent = `{{define "swagger"}}
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<title>{{.title}}</title>
|
||||
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@3.17.6/swagger-ui.css" crossorigin="anonymous" />
|
||||
<link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@3.17.6/favicon-32x32.png" sizes="32x32" />
|
||||
<link rel="icon" type="image/png" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@3.17.6/favicon-16x16.png" sizes="16x16" />
|
||||
<style>
|
||||
html
|
||||
{
|
||||
box-sizing: border-box;
|
||||
overflow: -moz-scrollbars-vertical;
|
||||
overflow-y: scroll;
|
||||
}
|
||||
|
||||
*,
|
||||
*:before,
|
||||
*:after
|
||||
{
|
||||
box-sizing: inherit;
|
||||
}
|
||||
|
||||
body
|
||||
{
|
||||
margin:0;
|
||||
background: #fafafa;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div id="swagger-ui"></div>
|
||||
|
||||
<script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@3.17.6/swagger-ui-bundle.js" crossorigin="anonymous"></script>
|
||||
<script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@3.17.6/swagger-ui-standalone-preset.js" crossorigin="anonymous"></script>
|
||||
<script>
|
||||
window.onload = function() {
|
||||
|
||||
// Build a system
|
||||
const ui = SwaggerUIBundle({
|
||||
url: {{.url}},
|
||||
dom_id: '#swagger-ui',
|
||||
deepLinking: true,
|
||||
presets: [
|
||||
SwaggerUIBundle.presets.apis,
|
||||
SwaggerUIStandalonePreset
|
||||
],
|
||||
plugins: [
|
||||
SwaggerUIBundle.plugins.DownloadUrl
|
||||
],
|
||||
layout: "StandaloneLayout"
|
||||
})
|
||||
|
||||
window.ui = ui
|
||||
}
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
{{end}}`
|
||||
8
converter.go
Normal file
8
converter.go
Normal file
@ -0,0 +1,8 @@
|
||||
package echoswagger
|
||||
|
||||
func proccessPath(path string) string {
|
||||
if len(path) == 0 || path[0] != '/' {
|
||||
path = "/" + path
|
||||
}
|
||||
return path
|
||||
}
|
||||
362
models.go
Normal file
362
models.go
Normal file
@ -0,0 +1,362 @@
|
||||
package echoswagger
|
||||
|
||||
type (
|
||||
// Swagger represents an instance of a swagger object.
|
||||
// See https://swagger.io/specification/
|
||||
Swagger struct {
|
||||
Swagger string `json:"swagger,omitempty"`
|
||||
Info *Info `json:"info,omitempty"`
|
||||
Host string `json:"host,omitempty"`
|
||||
BasePath string `json:"basePath,omitempty"`
|
||||
Schemes []string `json:"schemes,omitempty"`
|
||||
Consumes []string `json:"consumes,omitempty"`
|
||||
Produces []string `json:"produces,omitempty"`
|
||||
Paths map[string]interface{} `json:"paths"`
|
||||
Definitions map[string]*JSONSchema `json:"definitions,omitempty"`
|
||||
Parameters map[string]*Parameter `json:"parameters,omitempty"`
|
||||
Responses map[string]*Response `json:"responses,omitempty"`
|
||||
SecurityDefinitions map[string]*SecurityDefinition `json:"securityDefinitions,omitempty"`
|
||||
Tags []*Tag `json:"tags,omitempty"`
|
||||
ExternalDocs *ExternalDocs `json:"externalDocs,omitempty"`
|
||||
}
|
||||
|
||||
// Info provides metadata about the API. The metadata can be used by the clients if needed,
|
||||
// and can be presented in the Swagger-UI for convenience.
|
||||
Info struct {
|
||||
Title string `json:"title,omitempty"`
|
||||
Description string `json:"description,omitempty"`
|
||||
TermsOfService string `json:"termsOfService,omitempty"`
|
||||
Contact *Contact `json:"contact,omitempty"`
|
||||
License *License `json:"license,omitempty"`
|
||||
Version string `json:"version"`
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
// Contact contains the API contact information.
|
||||
Contact struct {
|
||||
// Name of the contact person/organization
|
||||
Name string `json:"name,omitempty"`
|
||||
// Email address of the contact person/organization
|
||||
Email string `json:"email,omitempty"`
|
||||
// URL pointing to the contact information
|
||||
URL string `json:"url,omitempty"`
|
||||
}
|
||||
|
||||
// License contains the license information for the API.
|
||||
License struct {
|
||||
// Name of license used for the API
|
||||
Name string `json:"name,omitempty"`
|
||||
// URL to the license used for the API
|
||||
URL string `json:"url,omitempty"`
|
||||
}
|
||||
|
||||
// Path holds the relative paths to the individual endpoints.
|
||||
Path struct {
|
||||
// Ref allows for an external definition of this path item.
|
||||
Ref string `json:"$ref,omitempty"`
|
||||
// Get defines a GET operation on this path.
|
||||
Get *Operation `json:"get,omitempty"`
|
||||
// Put defines a PUT operation on this path.
|
||||
Put *Operation `json:"put,omitempty"`
|
||||
// Post defines a POST operation on this path.
|
||||
Post *Operation `json:"post,omitempty"`
|
||||
// Delete defines a DELETE operation on this path.
|
||||
Delete *Operation `json:"delete,omitempty"`
|
||||
// Options defines a OPTIONS operation on this path.
|
||||
Options *Operation `json:"options,omitempty"`
|
||||
// Head defines a HEAD operation on this path.
|
||||
Head *Operation `json:"head,omitempty"`
|
||||
// Patch defines a PATCH operation on this path.
|
||||
Patch *Operation `json:"patch,omitempty"`
|
||||
// Parameters is the list of parameters that are applicable for all the operations
|
||||
// described under this path.
|
||||
Parameters []*Parameter `json:"parameters,omitempty"`
|
||||
// Extensions defines the swagger extensions.
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
// Operation describes a single API operation on a path.
|
||||
Operation struct {
|
||||
// Tags is a list of tags for API documentation control. Tags can be used for
|
||||
// logical grouping of operations by resources or any other qualifier.
|
||||
Tags []string `json:"tags,omitempty"`
|
||||
// Summary is a short summary of what the operation does. For maximum readability
|
||||
// in the swagger-ui, this field should be less than 120 characters.
|
||||
Summary string `json:"summary,omitempty"`
|
||||
// Description is a verbose explanation of the operation behavior.
|
||||
// GFM syntax can be used for rich text representation.
|
||||
Description string `json:"description,omitempty"`
|
||||
// ExternalDocs points to additional external documentation for this operation.
|
||||
ExternalDocs *ExternalDocs `json:"externalDocs,omitempty"`
|
||||
// OperationID is a unique string used to identify the operation.
|
||||
OperationID string `json:"operationId,omitempty"`
|
||||
// Consumes is a list of MIME types the operation can consume.
|
||||
Consumes []string `json:"consumes,omitempty"`
|
||||
// Produces is a list of MIME types the operation can produce.
|
||||
Produces []string `json:"produces,omitempty"`
|
||||
// Parameters is a list of parameters that are applicable for this operation.
|
||||
Parameters []*Parameter `json:"parameters,omitempty"`
|
||||
// Responses is the list of possible responses as they are returned from executing
|
||||
// this operation.
|
||||
Responses map[string]*Response `json:"responses,omitempty"`
|
||||
// Schemes is the transfer protocol for the operation.
|
||||
Schemes []string `json:"schemes,omitempty"`
|
||||
// Deprecated declares this operation to be deprecated.
|
||||
Deprecated bool `json:"deprecated,omitempty"`
|
||||
// Secury is a declaration of which security schemes are applied for this operation.
|
||||
Security []map[string][]string `json:"security,omitempty"`
|
||||
// Extensions defines the swagger extensions.
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
// Parameter describes a single operation parameter.
|
||||
Parameter struct {
|
||||
// Name of the parameter. Parameter names are case sensitive.
|
||||
Name string `json:"name"`
|
||||
// In is the location of the parameter.
|
||||
// Possible values are "query", "header", "path", "formData" or "body".
|
||||
In string `json:"in"`
|
||||
// Description is`a brief description of the parameter.
|
||||
// GFM syntax can be used for rich text representation.
|
||||
Description string `json:"description,omitempty"`
|
||||
// Required determines whether this parameter is mandatory.
|
||||
Required bool `json:"required"`
|
||||
// Schema defining the type used for the body parameter, only if "in" is body
|
||||
Schema *JSONSchema `json:"schema,omitempty"`
|
||||
|
||||
// properties below only apply if "in" is not body
|
||||
|
||||
// Type of the parameter. Since the parameter is not located at the request body,
|
||||
// it is limited to simple types (that is, not an object).
|
||||
Type string `json:"type,omitempty"`
|
||||
// Format is the extending format for the previously mentioned type.
|
||||
Format string `json:"format,omitempty"`
|
||||
// AllowEmptyValue sets the ability to pass empty-valued parameters.
|
||||
// This is valid only for either query or formData parameters and allows you to
|
||||
// send a parameter with a name only or an empty value. Default value is false.
|
||||
AllowEmptyValue bool `json:"allowEmptyValue,omitempty"`
|
||||
// Items describes the type of items in the array if type is "array".
|
||||
Items *Items `json:"items,omitempty"`
|
||||
// CollectionFormat determines the format of the array if type array is used.
|
||||
// Possible values are csv, ssv, tsv, pipes and multi.
|
||||
CollectionFormat string `json:"collectionFormat,omitempty"`
|
||||
// Default declares the value of the parameter that the server will use if none is
|
||||
// provided, for example a "count" to control the number of results per page might
|
||||
// default to 100 if not supplied by the client in the request.
|
||||
Default interface{} `json:"default,omitempty"`
|
||||
Maximum *float64 `json:"maximum,omitempty"`
|
||||
ExclusiveMaximum bool `json:"exclusiveMaximum,omitempty"`
|
||||
Minimum *float64 `json:"minimum,omitempty"`
|
||||
ExclusiveMinimum bool `json:"exclusiveMinimum,omitempty"`
|
||||
MaxLength *int `json:"maxLength,omitempty"`
|
||||
MinLength *int `json:"minLength,omitempty"`
|
||||
Pattern string `json:"pattern,omitempty"`
|
||||
MaxItems *int `json:"maxItems,omitempty"`
|
||||
MinItems *int `json:"minItems,omitempty"`
|
||||
UniqueItems bool `json:"uniqueItems,omitempty"`
|
||||
Enum []interface{} `json:"enum,omitempty"`
|
||||
MultipleOf float64 `json:"multipleOf,omitempty"`
|
||||
// Extensions defines the swagger extensions.
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
// Response describes an operation response.
|
||||
Response struct {
|
||||
// Description of the response. GFM syntax can be used for rich text representation.
|
||||
Description string `json:"description,omitempty"`
|
||||
// Schema is a definition of the response structure. It can be a primitive,
|
||||
// an array or an object. If this field does not exist, it means no content is
|
||||
// returned as part of the response. As an extension to the Schema Object, its root
|
||||
// type value may also be "file".
|
||||
Schema *JSONSchema `json:"schema,omitempty"`
|
||||
// Headers is a list of headers that are sent with the response.
|
||||
Headers map[string]*Header `json:"headers,omitempty"`
|
||||
// Ref references a global API response.
|
||||
// This field is exclusive with the other fields of Response.
|
||||
Ref string `json:"$ref,omitempty"`
|
||||
// Extensions defines the swagger extensions.
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
// Header represents a header parameter.
|
||||
Header struct {
|
||||
// Description is`a brief description of the parameter.
|
||||
// GFM syntax can be used for rich text representation.
|
||||
Description string `json:"description,omitempty"`
|
||||
// Type of the header. it is limited to simple types (that is, not an object).
|
||||
Type string `json:"type,omitempty"`
|
||||
// Format is the extending format for the previously mentioned type.
|
||||
Format string `json:"format,omitempty"`
|
||||
// Items describes the type of items in the array if type is "array".
|
||||
Items *Items `json:"items,omitempty"`
|
||||
// CollectionFormat determines the format of the array if type array is used.
|
||||
// Possible values are csv, ssv, tsv, pipes and multi.
|
||||
CollectionFormat string `json:"collectionFormat,omitempty"`
|
||||
// Default declares the value of the parameter that the server will use if none is
|
||||
// provided, for example a "count" to control the number of results per page might
|
||||
// default to 100 if not supplied by the client in the request.
|
||||
Default interface{} `json:"default,omitempty"`
|
||||
Maximum *float64 `json:"maximum,omitempty"`
|
||||
ExclusiveMaximum bool `json:"exclusiveMaximum,omitempty"`
|
||||
Minimum *float64 `json:"minimum,omitempty"`
|
||||
ExclusiveMinimum bool `json:"exclusiveMinimum,omitempty"`
|
||||
MaxLength *int `json:"maxLength,omitempty"`
|
||||
MinLength *int `json:"minLength,omitempty"`
|
||||
Pattern string `json:"pattern,omitempty"`
|
||||
MaxItems *int `json:"maxItems,omitempty"`
|
||||
MinItems *int `json:"minItems,omitempty"`
|
||||
UniqueItems bool `json:"uniqueItems,omitempty"`
|
||||
Enum []interface{} `json:"enum,omitempty"`
|
||||
MultipleOf float64 `json:"multipleOf,omitempty"`
|
||||
}
|
||||
|
||||
// SecurityDefinition allows the definition of a security scheme that can be used by the
|
||||
// operations. Supported schemes are basic authentication, an API key (either as a header or
|
||||
// as a query parameter) and OAuth2's common flows (implicit, password, application and
|
||||
// access code).
|
||||
SecurityDefinition struct {
|
||||
// Type of the security scheme. Valid values are "basic", "apiKey" or "oauth2".
|
||||
Type string `json:"type"`
|
||||
// Description for security scheme
|
||||
Description string `json:"description,omitempty"`
|
||||
// Name of the header or query parameter to be used when type is "apiKey".
|
||||
Name string `json:"name,omitempty"`
|
||||
// In is the location of the API key when type is "apiKey".
|
||||
// Valid values are "query" or "header".
|
||||
In string `json:"in,omitempty"`
|
||||
// Flow is the flow used by the OAuth2 security scheme when type is "oauth2"
|
||||
// Valid values are "implicit", "password", "application" or "accessCode".
|
||||
Flow string `json:"flow,omitempty"`
|
||||
// The oauth2 authorization URL to be used for this flow.
|
||||
AuthorizationURL string `json:"authorizationUrl,omitempty"`
|
||||
// TokenURL is the token URL to be used for this flow.
|
||||
TokenURL string `json:"tokenUrl,omitempty"`
|
||||
// Scopes list the available scopes for the OAuth2 security scheme.
|
||||
Scopes map[string]string `json:"scopes,omitempty"`
|
||||
// Extensions defines the swagger extensions.
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
// Scope corresponds to an available scope for an OAuth2 security scheme.
|
||||
Scope struct {
|
||||
// Description for scope
|
||||
Description string `json:"description,omitempty"`
|
||||
}
|
||||
|
||||
// ExternalDocs allows referencing an external resource for extended documentation.
|
||||
ExternalDocs struct {
|
||||
// Description is a short description of the target documentation.
|
||||
// GFM syntax can be used for rich text representation.
|
||||
Description string `json:"description,omitempty"`
|
||||
// URL for the target documentation.
|
||||
URL string `json:"url"`
|
||||
}
|
||||
|
||||
// Items is a limited subset of JSON-Schema's items object. It is used by parameter
|
||||
// definitions that are not located in "body".
|
||||
Items struct {
|
||||
// Type of the items. it is limited to simple types (that is, not an object).
|
||||
Type string `json:"type,omitempty"`
|
||||
// Format is the extending format for the previously mentioned type.
|
||||
Format string `json:"format,omitempty"`
|
||||
// Items describes the type of items in the array if type is "array".
|
||||
Items *Items `json:"items,omitempty"`
|
||||
// CollectionFormat determines the format of the array if type array is used.
|
||||
// Possible values are csv, ssv, tsv, pipes and multi.
|
||||
CollectionFormat string `json:"collectionFormat,omitempty"`
|
||||
// Default declares the value of the parameter that the server will use if none is
|
||||
// provided, for example a "count" to control the number of results per page might
|
||||
// default to 100 if not supplied by the client in the request.
|
||||
Default interface{} `json:"default,omitempty"`
|
||||
Maximum *float64 `json:"maximum,omitempty"`
|
||||
ExclusiveMaximum bool `json:"exclusiveMaximum,omitempty"`
|
||||
Minimum *float64 `json:"minimum,omitempty"`
|
||||
ExclusiveMinimum bool `json:"exclusiveMinimum,omitempty"`
|
||||
MaxLength *int `json:"maxLength,omitempty"`
|
||||
MinLength *int `json:"minLength,omitempty"`
|
||||
Pattern string `json:"pattern,omitempty"`
|
||||
MaxItems *int `json:"maxItems,omitempty"`
|
||||
MinItems *int `json:"minItems,omitempty"`
|
||||
UniqueItems bool `json:"uniqueItems,omitempty"`
|
||||
Enum []interface{} `json:"enum,omitempty"`
|
||||
MultipleOf float64 `json:"multipleOf,omitempty"`
|
||||
}
|
||||
|
||||
// Tag allows adding meta data to a single tag that is used by the Operation Object. It is
|
||||
// not mandatory to have a Tag Object per tag used there.
|
||||
Tag struct {
|
||||
// Name of the tag.
|
||||
Name string `json:"name,omitempty"`
|
||||
// Description is a short description of the tag.
|
||||
// GFM syntax can be used for rich text representation.
|
||||
Description string `json:"description,omitempty"`
|
||||
// ExternalDocs is additional external documentation for this tag.
|
||||
ExternalDocs *ExternalDocs `json:"externalDocs,omitempty"`
|
||||
// Extensions defines the swagger extensions.
|
||||
Extensions map[string]interface{} `json:"-"`
|
||||
}
|
||||
|
||||
JSONSchema struct {
|
||||
Schema string `json:"$schema,omitempty"`
|
||||
// Core schema
|
||||
ID string `json:"id,omitempty"`
|
||||
Title string `json:"title,omitempty"`
|
||||
Type JSONType `json:"type,omitempty"`
|
||||
Items *JSONSchema `json:"items,omitempty"`
|
||||
Properties map[string]*JSONSchema `json:"properties,omitempty"`
|
||||
Definitions map[string]*JSONSchema `json:"definitions,omitempty"`
|
||||
Description string `json:"description,omitempty"`
|
||||
DefaultValue interface{} `json:"default,omitempty"`
|
||||
Example interface{} `json:"example,omitempty"`
|
||||
|
||||
// Hyper schema
|
||||
Media *JSONMedia `json:"media,omitempty"`
|
||||
ReadOnly bool `json:"readOnly,omitempty"`
|
||||
Ref string `json:"$ref,omitempty"`
|
||||
XML *XMLSchema `json:"xml,omitempty"`
|
||||
|
||||
// Validation
|
||||
Enum []interface{} `json:"enum,omitempty"`
|
||||
Format string `json:"format,omitempty"`
|
||||
Pattern string `json:"pattern,omitempty"`
|
||||
Minimum *float64 `json:"minimum,omitempty"`
|
||||
Maximum *float64 `json:"maximum,omitempty"`
|
||||
MinLength *int `json:"minLength,omitempty"`
|
||||
MaxLength *int `json:"maxLength,omitempty"`
|
||||
Required []string `json:"required,omitempty"`
|
||||
AdditionalProperties *JSONSchema `json:"additionalProperties,omitempty"`
|
||||
|
||||
// Union
|
||||
AnyOf []*JSONSchema `json:"anyOf,omitempty"`
|
||||
}
|
||||
|
||||
// JSONType is the JSON type enum.
|
||||
JSONType string
|
||||
|
||||
// JSONMedia represents a "media" field in a JSON hyper schema.
|
||||
JSONMedia struct {
|
||||
BinaryEncoding string `json:"binaryEncoding,omitempty"`
|
||||
Type string `json:"type,omitempty"`
|
||||
}
|
||||
|
||||
// JSONLink represents a "link" field in a JSON hyper schema.
|
||||
JSONLink struct {
|
||||
Title string `json:"title,omitempty"`
|
||||
Description string `json:"description,omitempty"`
|
||||
Rel string `json:"rel,omitempty"`
|
||||
Href string `json:"href,omitempty"`
|
||||
Method string `json:"method,omitempty"`
|
||||
Schema *JSONSchema `json:"schema,omitempty"`
|
||||
TargetSchema *JSONSchema `json:"targetSchema,omitempty"`
|
||||
MediaType string `json:"mediaType,omitempty"`
|
||||
EncType string `json:"encType,omitempty"`
|
||||
}
|
||||
|
||||
XMLSchema struct {
|
||||
Name string `json:"name,omitempty"`
|
||||
Namespace string `json:"namespace,omitempty"`
|
||||
Prefix string `json:"prefix,omitempty"`
|
||||
Attribute string `json:"attribute,omitempty"`
|
||||
Wrapped bool `json:"wrapped,omitempty"`
|
||||
}
|
||||
)
|
||||
55
spec.go
Normal file
55
spec.go
Normal file
@ -0,0 +1,55 @@
|
||||
package echoswagger
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"fmt"
|
||||
"html/template"
|
||||
"net/http"
|
||||
|
||||
"github.com/labstack/echo"
|
||||
)
|
||||
|
||||
const SwaggerVersion = "2.0"
|
||||
|
||||
func (r *Root) Spec(c echo.Context) error {
|
||||
err := r.genSpec(c)
|
||||
if err != nil {
|
||||
return c.String(http.StatusInternalServerError, err.Error())
|
||||
}
|
||||
return c.JSON(http.StatusOK, r.spec)
|
||||
}
|
||||
|
||||
func (r *Root) genSpec(c echo.Context) error {
|
||||
r.spec.Swagger = SwaggerVersion
|
||||
r.spec.Paths = make(map[string]interface{})
|
||||
r.spec.Host = c.Request().Host
|
||||
r.spec.Schemes = []string{c.Scheme()}
|
||||
|
||||
for i := range r.groups {
|
||||
group := &r.groups[i]
|
||||
r.spec.Tags = append(r.spec.Tags, &group.tag)
|
||||
for j := range group.apis {
|
||||
a := &group.apis[j]
|
||||
fmt.Println("Group:", a)
|
||||
// TODO
|
||||
}
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
func (r *Root) docHandler(swaggerPath string) echo.HandlerFunc {
|
||||
t, err := template.New("swagger").Parse(SwaggerUIContent)
|
||||
if err != nil {
|
||||
panic(err)
|
||||
}
|
||||
|
||||
return func(c echo.Context) error {
|
||||
buf := new(bytes.Buffer)
|
||||
t.Execute(buf, map[string]interface{}{
|
||||
"title": r.spec.Info.Title,
|
||||
"url": c.Scheme() + "://" + c.Request().Host + swaggerPath,
|
||||
})
|
||||
return c.HTMLBlob(http.StatusOK, buf.Bytes())
|
||||
}
|
||||
}
|
||||
61
wrapper.go
Normal file
61
wrapper.go
Normal file
@ -0,0 +1,61 @@
|
||||
package echoswagger
|
||||
|
||||
import (
|
||||
"reflect"
|
||||
|
||||
"github.com/labstack/echo"
|
||||
)
|
||||
|
||||
type RawDefine struct {
|
||||
Value reflect.Value
|
||||
Schema *JSONSchema
|
||||
}
|
||||
|
||||
type Root struct {
|
||||
apis []api
|
||||
spec *Swagger
|
||||
echo *echo.Echo
|
||||
groups []group
|
||||
}
|
||||
|
||||
type group struct {
|
||||
apis []api
|
||||
echoGroup *echo.Group
|
||||
security []map[string][]string
|
||||
tag Tag
|
||||
}
|
||||
|
||||
type api struct {
|
||||
route *echo.Route
|
||||
security []map[string][]string
|
||||
method string
|
||||
operation Operation
|
||||
}
|
||||
|
||||
func New(e *echo.Echo, basePath, docPath string, i *Info) *Root {
|
||||
if e == nil {
|
||||
panic("echoswagger: invalid Echo instance")
|
||||
}
|
||||
basePath = proccessPath(basePath)
|
||||
docPath = proccessPath(docPath)
|
||||
|
||||
var connector string
|
||||
if docPath[len(docPath)-1] != '/' {
|
||||
connector = "/"
|
||||
}
|
||||
specPath := docPath + connector + "swagger.json"
|
||||
|
||||
r := &Root{
|
||||
echo: e,
|
||||
spec: &Swagger{
|
||||
Info: i,
|
||||
SecurityDefinitions: make(map[string]*SecurityDefinition),
|
||||
BasePath: basePath,
|
||||
Definitions: make(map[string]*JSONSchema),
|
||||
},
|
||||
}
|
||||
|
||||
e.GET(docPath, r.docHandler(specPath))
|
||||
e.GET(specPath, r.Spec)
|
||||
return r
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user