func init() {
revel.OnAppStart(func() {
go common.UnzipSwaggerAssets()
// build IndexArgs for rendering index template
// collect all of the swagger-endpoints then build the spec
routes := make([]*revel.Route, 0)
for _, route := range revel.MainRouter.Routes {
if strings.ToLower(route.Action) == "swaggify.spec" {
routes = append(routes, route)
}
}
for _, route := range routes {
// TODO test what cases cause bounds panic
// Don't duplicate building API specs
if _, exists := APIs[route.FixedParams[0]]; exists {
continue
}
APIs[route.FixedParams[0]] = newSpec(route.FixedParams[0])
fmt.Println(APIs[route.FixedParams[0]])
}
})
}
// init creates routes based on swagger specs defined in the conf/swagger folder
// it will create asset endpoints at /@basePath for serving the swagger-spec and UI
// which can be overridden with swaggerapi.add-ui = false
// TODO look into adding a Giles
func init() {
revel.OnAppStart(func() {
// TODO find out why AppRoot is empty
//doc, err := spec.Load(filepath.Join(revel.AppRoot, "conf", "swagger", "swagger.yml"))
//fmt.Println(revel.AppRoot, filepath.Join(revel.AppRoot, "conf", "swagger", "swagger.yml"))
// grab the old routes to append
oldRoutes := revel.MainRouter.Routes
// new and emtpy router
// NOTE WARNING calling MainRouter.Refresh will destroy the swagger routes since they do not have a routes file
revel.MainRouter = revel.NewRouter(filepath.Join(revel.BasePath, "conf", "routes"))
configs := revel.Config.StringDefault("swaggerapi.specs", "")
for _, config := range strings.Split(configs, ",") {
found := false
for _, path := range revel.ConfPaths {
doc, err := spec.Load(filepath.Join(path, config))
if os.IsNotExist(err) {
continue
}
if err != nil {
_fail(err)
}
// TODO decide if multiple of same name is allowed or not
// if found { }
if revel.Config.BoolDefault("swaggerapi.add-ui", true) {
AddSwaggerUi(doc.BasePath(), config)
// conncurently download or unzip the swagger ui assets
// only runs once
go common.UnzipSwaggerAssets()
}
AddSwaggerRoutes(doc)
found = true
}
if !found {
_fail(fmt.Errorf("Swagger configuration '%s' not found found in any of these folders:\t%v",
config, configs))
}
}
// Add oldRoutes back into the router
for _, route := range oldRoutes {
_fail(revel.MainRouter.Tree.Add(route.TreePath, route))
revel.MainRouter.Routes = append(revel.MainRouter.Routes, route)
}
})
}
