webui.go

  1package commands
  2
  3import (
  4	"context"
  5	"errors"
  6	"fmt"
  7	"io"
  8	"log"
  9	"net"
 10	"net/http"
 11	"net/url"
 12	"os"
 13	"os/signal"
 14	"strconv"
 15	"time"
 16
 17	"github.com/99designs/gqlgen/graphql/playground"
 18	"github.com/gorilla/mux"
 19	"github.com/phayes/freeport"
 20	"github.com/skratchdot/open-golang/open"
 21	"github.com/spf13/cobra"
 22
 23	"github.com/MichaelMure/git-bug/api/auth"
 24	"github.com/MichaelMure/git-bug/api/graphql"
 25	httpapi "github.com/MichaelMure/git-bug/api/http"
 26	"github.com/MichaelMure/git-bug/cache"
 27	"github.com/MichaelMure/git-bug/commands/execenv"
 28	"github.com/MichaelMure/git-bug/entities/identity"
 29	"github.com/MichaelMure/git-bug/repository"
 30	"github.com/MichaelMure/git-bug/webui"
 31)
 32
 33const webUIOpenConfigKey = "git-bug.webui.open"
 34
 35type webUIOptions struct {
 36	host      string
 37	port      int
 38	open      bool
 39	noOpen    bool
 40	readOnly  bool
 41	logErrors bool
 42	query     string
 43}
 44
 45func newWebUICommand() *cobra.Command {
 46	env := execenv.NewEnv()
 47	options := webUIOptions{}
 48
 49	cmd := &cobra.Command{
 50		Use:   "webui",
 51		Short: "Launch the web UI",
 52		Long: `Launch the web UI.
 53
 54Available git config:
 55  git-bug.webui.open [bool]: control the automatic opening of the web UI in the default browser
 56`,
 57		PreRunE: execenv.LoadRepo(env),
 58		RunE: func(cmd *cobra.Command, args []string) error {
 59			return runWebUI(env, options)
 60		},
 61	}
 62
 63	flags := cmd.Flags()
 64	flags.SortFlags = false
 65
 66	flags.StringVar(&options.host, "host", "127.0.0.1", "Network address or hostname to listen to (default to 127.0.0.1)")
 67	flags.BoolVar(&options.open, "open", false, "Automatically open the web UI in the default browser")
 68	flags.BoolVar(&options.noOpen, "no-open", false, "Prevent the automatic opening of the web UI in the default browser")
 69	flags.IntVarP(&options.port, "port", "p", 0, "Port to listen to (default to random available port)")
 70	flags.BoolVar(&options.readOnly, "read-only", false, "Whether to run the web UI in read-only mode")
 71	flags.BoolVar(&options.logErrors, "log-errors", false, "Whether to log errors")
 72	flags.StringVarP(&options.query, "query", "q", "", "The query to open in the web UI bug list")
 73
 74	return cmd
 75}
 76
 77func runWebUI(env *execenv.Env, opts webUIOptions) error {
 78	if opts.port == 0 {
 79		var err error
 80		opts.port, err = freeport.GetFreePort()
 81		if err != nil {
 82			return err
 83		}
 84	}
 85
 86	addr := net.JoinHostPort(opts.host, strconv.Itoa(opts.port))
 87	webUiAddr := fmt.Sprintf("http://%s", addr)
 88	toOpen := webUiAddr
 89
 90	if len(opts.query) > 0 {
 91		// Explicitly set the query parameter instead of going with a default one.
 92		toOpen = fmt.Sprintf("%s/?q=%s", webUiAddr, url.QueryEscape(opts.query))
 93	}
 94
 95	router := mux.NewRouter()
 96
 97	// If the webUI is not read-only, use an authentication middleware with a
 98	// fixed identity: the default user of the repo
 99	// TODO: support dynamic authentication with OAuth
100	if !opts.readOnly {
101		author, err := identity.GetUserIdentity(env.Repo)
102		if err != nil {
103			return err
104		}
105		router.Use(auth.Middleware(author.Id()))
106	}
107
108	mrc := cache.NewMultiRepoCache()
109	_, err := mrc.RegisterDefaultRepository(env.Repo)
110	if err != nil {
111		return err
112	}
113
114	var errOut io.Writer
115	if opts.logErrors {
116		errOut = env.Err
117	}
118
119	graphqlHandler := graphql.NewHandler(mrc, errOut)
120
121	// Routes
122	router.Path("/playground").Handler(playground.Handler("git-bug", "/graphql"))
123	router.Path("/graphql").Handler(graphqlHandler)
124	router.Path("/gitfile/{repo}/{hash}").Handler(httpapi.NewGitFileHandler(mrc))
125	router.Path("/upload/{repo}").Methods("POST").Handler(httpapi.NewGitUploadFileHandler(mrc))
126	router.PathPrefix("/").Handler(webui.NewHandler())
127
128	srv := &http.Server{
129		Addr:    addr,
130		Handler: router,
131	}
132
133	done := make(chan bool)
134	quit := make(chan os.Signal, 1)
135
136	// register as handler of the interrupt signal to trigger the teardown
137	signal.Notify(quit, os.Interrupt)
138
139	go func() {
140		<-quit
141		env.Out.Println("WebUI is shutting down...")
142
143		ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
144		defer cancel()
145
146		srv.SetKeepAlivesEnabled(false)
147		if err := srv.Shutdown(ctx); err != nil {
148			log.Fatalf("Could not gracefully shutdown the WebUI: %v\n", err)
149		}
150
151		// Teardown
152		err := graphqlHandler.Close()
153		if err != nil {
154			env.Out.Println(err)
155		}
156
157		close(done)
158	}()
159
160	env.Out.Printf("Web UI: %s\n", webUiAddr)
161	env.Out.Printf("Graphql API: http://%s/graphql\n", addr)
162	env.Out.Printf("Graphql Playground: http://%s/playground\n", addr)
163	env.Out.Println("Press Ctrl+c to quit")
164
165	configOpen, err := env.Repo.AnyConfig().ReadBool(webUIOpenConfigKey)
166	if errors.Is(err, repository.ErrNoConfigEntry) {
167		// default to true
168		configOpen = true
169	} else if err != nil {
170		return err
171	}
172
173	shouldOpen := (configOpen && !opts.noOpen) || opts.open
174
175	if shouldOpen {
176		err = open.Run(toOpen)
177		if err != nil {
178			env.Out.Println(err)
179		}
180	}
181
182	err = srv.ListenAndServe()
183	if err != nil && err != http.ErrServerClosed {
184		return err
185	}
186
187	<-done
188
189	env.Out.Println("WebUI stopped")
190	return nil
191}