Make swgui relocatable?

[cobber]

I tried to use swaggest in my project today and I can't get the swaggest URL's to play nice with static files.

My goal was to have /api/... and /api/docs be provided by swaggest, with / being passed on to a http.FileServer, but using chi.Mount() to relocate swaggest from / to /api/ causes the swgui to 404 - but the actual REST connectors work just fine.

My code looks something like this (trimmed here for brevity):

func main() {
        // setup REST interface with OpenAPI documentation
        s := web.DefaultService()
	s.OpenAPI.Info.Title = "..."
	s.OpenAPI.Info.WithDescription("...")
	s.OpenAPI.Info.Version = "v0.0.1"
	s.Get("/item/{id}", getItemByID())
        // etc...
	s.Docs("/docs", v4emb.New)

	// static html/css/js files served from embedded FS
	uiFS := webui.StaticFS()

        // top-level router
	r := chi.NewRouter()
	r.Mount("/api/v1", s)                        // relocate swaggest to /api/v1/...
	r.Mount("/", http.FileServer(http.FS(uiFS))) // provide static files at /

        http.ListenAndServe("localhost:8080", r)
}

My problem here is that I have two different handlers (swaggest & http.FileServer) and chi only allows one to be mounted on "/", so I can't just use s.Get("/api/v1/item/{id}",...) because then I can't have the html files at "/"

If anyone has any working examples of having swaggest play nicely with other sub-routers, I'd be most interested.

by the way, I tried Mounting the FileServer on "/static", but that also didn't work. I'm thinking this may be an issue with chi :-/

Thanks in advance

[vearutop]

The *web.Service instance also exposes chi.Router and so you can mount static content directly into it.

Please check the following example:

package main

import (
	"context"
	"net/http"

	"github.com/swaggest/rest/web"
	"github.com/swaggest/swgui/v4emb"
	"github.com/swaggest/usecase"
)

func getItemByID() usecase.Interactor {
	type inp struct {
		ID int `path:"id"`
	}
	return usecase.NewInteractor[inp, string](func(ctx context.Context, i inp, o *string) error {
		*o = "abc!"

		return nil
	})
}

func main() {
	// setup REST interface with OpenAPI documentation
	s := web.DefaultService()
	s.OpenAPI.Info.Title = "..."
	s.OpenAPI.Info.WithDescription("...")
	s.OpenAPI.Info.Version = "v0.0.1"
	s.Get("/api/v1/item/{id}", getItemByID())
	// etc...
	s.Docs("/api/v1/docs", v4emb.New) // relocate swaggest to /api/v1/...

	// static html/css/js files served from embedded FS
	//uiFS := webui.StaticFS()

	s.Mount("/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		_, _ = w.Write([]byte(r.URL.String()))
	})) // provide static files at /

	http.ListenAndServe("localhost:8080", s)
}

There is also support for Mount introspection (added recently in rest v0.2.30), please check the example: https://github.com/swaggest/rest/blob/v0.2.30/_examples/mount/main.go.

There is also a small discussion about Mount in swaggest/rest#84.