513cebe7b7
* Add Virtual Kubelet provider for VIC Initial virtual kubelet provider for VMware VIC. This provider currently handles creating and starting of a pod VM via the VIC portlayer and persona server. Image store handling via the VIC persona server. This provider currently requires the feature/wolfpack branch of VIC. * Added pod stop and delete. Also added node capacity. Added the ability to stop and delete pod VMs via VIC. Also retrieve node capacity information from the VCH. * Cleanup and readme file Some file clean up and added a Readme.md markdown file for the VIC provider. * Cleaned up errors, added function comments, moved operation code 1. Cleaned up error handling. Set standard for creating errors. 2. Added method prototype comments for all interface functions. 3. Moved PodCreator, PodStarter, PodStopper, and PodDeleter to a new folder. * Add mocking code and unit tests for podcache, podcreator, and podstarter Used the unit test framework used in VIC to handle assertions in the provider's unit test. Mocking code generated using OSS project mockery, which is compatible with the testify assertion framework. * Vendored packages for the VIC provider Requires feature/wolfpack branch of VIC and a few specific commit sha of projects used within VIC. * Implementation of POD Stopper and Deleter unit tests (#4) * Updated files for initial PR
102 lines
2.3 KiB
Go
102 lines
2.3 KiB
Go
package middleware
|
|
|
|
import (
|
|
"bytes"
|
|
"fmt"
|
|
"html/template"
|
|
"net/http"
|
|
"path"
|
|
)
|
|
|
|
// RedocOpts configures the Redoc middlewares
|
|
type RedocOpts struct {
|
|
// BasePath for the UI path, defaults to: /
|
|
BasePath string
|
|
// Path combines with BasePath for the full UI path, defaults to: docs
|
|
Path string
|
|
// SpecURL the url to find the spec for
|
|
SpecURL string
|
|
// RedocURL for the js that generates the redoc site, defaults to: https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js
|
|
RedocURL string
|
|
// Title for the documentation site, default to: API documentation
|
|
Title string
|
|
}
|
|
|
|
// EnsureDefaults in case some options are missing
|
|
func (r *RedocOpts) EnsureDefaults() {
|
|
if r.BasePath == "" {
|
|
r.BasePath = "/"
|
|
}
|
|
if r.Path == "" {
|
|
r.Path = "docs"
|
|
}
|
|
if r.SpecURL == "" {
|
|
r.SpecURL = "/swagger.json"
|
|
}
|
|
if r.RedocURL == "" {
|
|
r.RedocURL = redocLatest
|
|
}
|
|
if r.Title == "" {
|
|
r.Title = "API documentation"
|
|
}
|
|
}
|
|
|
|
// Redoc creates a middleware to serve a documentation site for a swagger spec.
|
|
// This allows for altering the spec before starting the http listener.
|
|
//
|
|
func Redoc(opts RedocOpts, next http.Handler) http.Handler {
|
|
opts.EnsureDefaults()
|
|
|
|
pth := path.Join(opts.BasePath, opts.Path)
|
|
tmpl := template.Must(template.New("redoc").Parse(redocTemplate))
|
|
|
|
buf := bytes.NewBuffer(nil)
|
|
tmpl.Execute(buf, opts)
|
|
b := buf.Bytes()
|
|
|
|
return http.HandlerFunc(func(rw http.ResponseWriter, r *http.Request) {
|
|
if r.URL.Path == pth {
|
|
rw.Header().Set("Content-Type", "text/html; charset=utf-8")
|
|
rw.WriteHeader(http.StatusOK)
|
|
|
|
rw.Write(b)
|
|
return
|
|
}
|
|
|
|
if next == nil {
|
|
rw.Header().Set("Content-Type", "text/plain")
|
|
rw.WriteHeader(http.StatusNotFound)
|
|
rw.Write([]byte(fmt.Sprintf("%q not found", pth)))
|
|
return
|
|
}
|
|
next.ServeHTTP(rw, r)
|
|
})
|
|
}
|
|
|
|
const (
|
|
redocLatest = "https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js"
|
|
redocTemplate = `<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>{{ .Title }}</title>
|
|
<!-- needed for adaptive design -->
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
|
|
<!--
|
|
ReDoc doesn't change outer page styles
|
|
-->
|
|
<style>
|
|
body {
|
|
margin: 0;
|
|
padding: 0;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<redoc spec-url='{{ .SpecURL }}'></redoc>
|
|
<script src="{{ .RedocURL }}"> </script>
|
|
</body>
|
|
</html>
|
|
`
|
|
)
|