Skip to content

Commit ac4717b

Browse files
authored
Merge pull request #3 from dkrizic/copilot/implement-http-ui-service
Implement HTMX-based HTTP UI with gRPC backend integration
2 parents cf81a44 + 778b12e commit ac4717b

6 files changed

Lines changed: 317 additions & 19 deletions

File tree

‎cli/go.sum‎

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -28,22 +28,14 @@ go.opentelemetry.io/otel/sdk/metric v1.38.0 h1:aSH66iL0aZqo//xXzQLYozmWrXxyFkBJ6
2828
go.opentelemetry.io/otel/sdk/metric v1.38.0/go.mod h1:dg9PBnW9XdQ1Hd6ZnRz689CbtrUp0wMMs9iPcgT9EZA=
2929
go.opentelemetry.io/otel/trace v1.38.0 h1:Fxk5bKrDZJUH+AMyyIXGcFAPah0oRcT+LuNtJrmcNLE=
3030
go.opentelemetry.io/otel/trace v1.38.0/go.mod h1:j1P9ivuFsTceSWe1oY+EeW3sc+Pp42sO++GHkg4wwhs=
31-
golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY=
32-
golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU=
3331
golang.org/x/net v0.48.0 h1:zyQRTTrjc33Lhh0fBgT/H3oZq9WuvRR5gPC70xpDiQU=
3432
golang.org/x/net v0.48.0/go.mod h1:+ndRgGjkh8FGtu1w1FGbEC31if4VrNVMuKTgcAAnQRY=
35-
golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
36-
golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
3733
golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
3834
golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
39-
golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
40-
golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
4135
golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU=
4236
golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=
4337
gonum.org/v1/gonum v0.16.0 h1:5+ul4Swaf3ESvrOnidPp4GZbzf0mxVQpDCYUQE7OJfk=
4438
gonum.org/v1/gonum v0.16.0/go.mod h1:fef3am4MQ93R2HHpKnLk4/Tbh/s0+wqD5nfa6Pnwy4E=
45-
google.golang.org/genproto/googleapis/rpc v0.0.0-20251029180050-ab9386a59fda h1:i/Q+bfisr7gq6feoJnS/DlpdwEL4ihp41fvRiM3Ork0=
46-
google.golang.org/genproto/googleapis/rpc v0.0.0-20251029180050-ab9386a59fda/go.mod h1:7i2o+ce6H/6BluujYR+kqX3GKH+dChPTQU19wjRPiGk=
4739
google.golang.org/genproto/googleapis/rpc v0.0.0-20251222181119-0a764e51fe1b h1:Mv8VFug0MP9e5vUxfBcE3vUkV6CImK3cMNMIDFjmzxU=
4840
google.golang.org/genproto/googleapis/rpc v0.0.0-20251222181119-0a764e51fe1b/go.mod h1:j9x/tPzZkyxcgEFkiKEEGxfvyumM01BEtsW8xzOahRQ=
4941
google.golang.org/grpc v1.78.0 h1:K1XZG/yGDJnzMdd/uZHAkVqJE+xIDOcmdSFZkBUicNc=

‎ui/service/handlers.go‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
package service
2+
3+
import (
4+
"io"
5+
"log/slog"
6+
"net/http"
7+
8+
featurev1 "github.com/dkrizic/feature/ui/repository/feature/v1"
9+
"google.golang.org/protobuf/types/known/emptypb"
10+
)
11+
12+
// Feature represents a feature flag with a key and value.
13+
type Feature struct {
14+
Key string
15+
Value string
16+
}
17+
18+
// registerHandlers registers all HTTP handlers on the provided mux.
19+
func (s *Server) registerHandlers(mux *http.ServeMux) {
20+
mux.HandleFunc("GET /", s.handleIndex)
21+
mux.HandleFunc("GET /features/list", s.handleFeaturesList)
22+
mux.HandleFunc("POST /features/delete", s.handleFeatureDelete)
23+
mux.HandleFunc("GET /healthz", s.handleHealth)
24+
}
25+
26+
// handleIndex renders the full HTML page with HTMX.
27+
func (s *Server) handleIndex(w http.ResponseWriter, r *http.Request) {
28+
data := struct {
29+
UIVersion string
30+
BackendVersion string
31+
}{
32+
UIVersion: s.uiVersion,
33+
BackendVersion: s.backendVersion,
34+
}
35+
36+
if err := s.templates.ExecuteTemplate(w, "index.gohtml", data); err != nil {
37+
slog.Error("Failed to render index template", "error", err)
38+
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
39+
return
40+
}
41+
}
42+
43+
// handleFeaturesList calls the gRPC backend to get all features and renders the partial.
44+
func (s *Server) handleFeaturesList(w http.ResponseWriter, r *http.Request) {
45+
ctx := r.Context()
46+
47+
// Call the gRPC backend
48+
stream, err := s.featureClient.GetAll(ctx, &emptypb.Empty{})
49+
if err != nil {
50+
slog.Error("Failed to call GetAll", "error", err)
51+
http.Error(w, "Failed to fetch features", http.StatusInternalServerError)
52+
return
53+
}
54+
55+
// Collect all features from the stream
56+
var features []Feature
57+
58+
for {
59+
kv, err := stream.Recv()
60+
if err != nil {
61+
// Check if we've reached the end of the stream
62+
if err == io.EOF {
63+
break
64+
}
65+
slog.Error("Failed to receive feature", "error", err)
66+
http.Error(w, "Failed to fetch features", http.StatusInternalServerError)
67+
return
68+
}
69+
70+
features = append(features, Feature{
71+
Key: kv.Key,
72+
Value: kv.Value,
73+
})
74+
}
75+
76+
data := struct {
77+
Features []Feature
78+
}{
79+
Features: features,
80+
}
81+
82+
if err := s.templates.ExecuteTemplate(w, "features_list.gohtml", data); err != nil {
83+
slog.Error("Failed to render features_list template", "error", err)
84+
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
85+
return
86+
}
87+
}
88+
89+
// handleFeatureDelete deletes a feature and re-renders the list.
90+
func (s *Server) handleFeatureDelete(w http.ResponseWriter, r *http.Request) {
91+
ctx := r.Context()
92+
93+
// Parse form data
94+
if err := r.ParseForm(); err != nil {
95+
slog.Error("Failed to parse form", "error", err)
96+
http.Error(w, "Bad Request", http.StatusBadRequest)
97+
return
98+
}
99+
100+
key := r.FormValue("key")
101+
if key == "" {
102+
slog.Error("Missing key parameter")
103+
http.Error(w, "Missing key parameter", http.StatusBadRequest)
104+
return
105+
}
106+
107+
// Call the gRPC backend to delete
108+
_, err := s.featureClient.Delete(ctx, &featurev1.Key{Name: key})
109+
if err != nil {
110+
slog.Error("Failed to delete feature", "key", key, "error", err)
111+
http.Error(w, "Failed to delete feature", http.StatusInternalServerError)
112+
return
113+
}
114+
115+
slog.Info("Feature deleted", "key", key)
116+
117+
// Re-render the feature list by calling the list handler
118+
s.handleFeaturesList(w, r)
119+
}
120+
121+
// handleHealth is a simple health check endpoint.
122+
func (s *Server) handleHealth(w http.ResponseWriter, r *http.Request) {
123+
w.WriteHeader(http.StatusOK)
124+
w.Write([]byte("OK"))
125+
}

‎ui/service/service.go‎

Lines changed: 108 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,29 +2,126 @@ package service
22

33
import (
44
"context"
5+
"fmt"
6+
"html/template"
57
"log/slog"
8+
"net/http"
69
"os"
710
"os/signal"
811
"syscall"
912
"time"
1013

14+
"github.com/dkrizic/feature/ui/constant"
15+
"github.com/dkrizic/feature/ui/meta"
16+
featurev1 "github.com/dkrizic/feature/ui/repository/feature/v1"
17+
metav1 "github.com/dkrizic/feature/ui/repository/meta/v1"
1118
"github.com/urfave/cli/v3"
19+
"google.golang.org/grpc"
20+
"google.golang.org/grpc/credentials/insecure"
1221
)
1322

23+
// Server holds the HTTP server and gRPC clients.
24+
type Server struct {
25+
address string
26+
templates *template.Template
27+
featureClient featurev1.FeatureClient
28+
metaClient metav1.MetaClient
29+
backendVersion string
30+
uiVersion string
31+
httpServer *http.Server
32+
}
33+
34+
// Service is the CLI entrypoint for starting the HTTP UI service.
1435
func Service(ctx context.Context, cmd *cli.Command) error {
15-
// get the port
16-
port := cmd.Int("port")
17-
slog.InfoContext(ctx, "Starting the feature UI service", "port", port)
36+
port := cmd.Int(constant.Port)
37+
endpoint := cmd.String(constant.Endpoint)
1838

19-
cancelChan := make(chan os.Signal, 1)
20-
// catch SIGETRM or SIGINTERRUPT
21-
signal.Notify(cancelChan, syscall.SIGTERM, syscall.SIGINT)
39+
slog.Info("Starting the feature UI service", "port", port, "endpoint", endpoint)
40+
41+
// Parse templates
42+
templates := ParseTemplates()
43+
if templates == nil {
44+
return fmt.Errorf("failed to parse templates")
45+
}
46+
47+
// Dial the gRPC backend
48+
conn, err := grpc.NewClient(endpoint, grpc.WithTransportCredentials(insecure.NewCredentials()))
49+
if err != nil {
50+
slog.Error("Failed to dial gRPC backend", "endpoint", endpoint, "error", err)
51+
return fmt.Errorf("failed to dial gRPC backend: %w", err)
52+
}
53+
defer conn.Close()
54+
55+
// Initialize gRPC clients
56+
featureClient := featurev1.NewFeatureClient(conn)
57+
metaClient := metav1.NewMetaClient(conn)
58+
59+
// Fetch backend version
60+
backendVersion := ""
61+
metaCtx, cancel := context.WithTimeout(ctx, 5*time.Second)
62+
defer cancel()
63+
metaResp, err := metaClient.Meta(metaCtx, &metav1.MetaRequest{})
64+
if err != nil {
65+
slog.Warn("Failed to fetch backend version", "error", err)
66+
} else {
67+
backendVersion = metaResp.Version
68+
slog.Info("Backend version retrieved", "version", backendVersion)
69+
}
70+
71+
// Create server
72+
server := &Server{
73+
address: fmt.Sprintf(":%d", port),
74+
templates: templates,
75+
featureClient: featureClient,
76+
metaClient: metaClient,
77+
backendVersion: backendVersion,
78+
uiVersion: meta.Version,
79+
}
80+
81+
// Setup HTTP routes
82+
mux := http.NewServeMux()
83+
server.registerHandlers(mux)
84+
85+
// Create HTTP server
86+
server.httpServer = &http.Server{
87+
Addr: server.address,
88+
Handler: mux,
89+
}
90+
91+
// Start HTTP server in a goroutine
92+
errChan := make(chan error, 1)
2293
go func() {
23-
slog.Info("Running")
24-
time.Sleep(5 * time.Second)
94+
slog.Info("HTTP server listening", "address", server.address)
95+
if err := server.httpServer.ListenAndServe(); err != nil && err != http.ErrServerClosed {
96+
errChan <- err
97+
}
2598
}()
26-
sig := <-cancelChan
27-
slog.Info("Shutting down feature UI service", "signal", sig)
28-
return nil
2999

100+
// Setup signal handling for graceful shutdown
101+
cancelChan := make(chan os.Signal, 1)
102+
signal.Notify(cancelChan, syscall.SIGTERM, syscall.SIGINT)
103+
104+
// Wait for shutdown signal or error
105+
select {
106+
case <-ctx.Done():
107+
slog.Info("Context canceled, shutting down")
108+
case sig := <-cancelChan:
109+
slog.Info("Received signal, shutting down", "signal", sig)
110+
case err := <-errChan:
111+
slog.Error("HTTP server error", "error", err)
112+
return err
113+
}
114+
115+
// Graceful shutdown
116+
shutdownCtx, shutdownCancel := context.WithTimeout(context.Background(), 10*time.Second)
117+
defer shutdownCancel()
118+
119+
slog.Info("Shutting down HTTP server gracefully")
120+
if err := server.httpServer.Shutdown(shutdownCtx); err != nil {
121+
slog.Error("Failed to shutdown HTTP server gracefully", "error", err)
122+
return err
123+
}
124+
125+
slog.Info("Feature UI service stopped")
126+
return nil
30127
}

‎ui/service/templates.go‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
package service
2+
3+
import (
4+
"embed"
5+
"html/template"
6+
"log/slog"
7+
)
8+
9+
//go:embed templates/*.gohtml
10+
var templateFS embed.FS
11+
12+
// ParseTemplates parses all embedded templates and returns a *template.Template.
13+
// Logs any parse errors using slog.
14+
func ParseTemplates() *template.Template {
15+
tmpl, err := template.ParseFS(templateFS, "templates/*.gohtml")
16+
if err != nil {
17+
slog.Error("Failed to parse templates", "error", err)
18+
return nil
19+
}
20+
return tmpl
21+
}
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
{{if .Features}}
2+
<table role="grid">
3+
<thead>
4+
<tr>
5+
<th>Key</th>
6+
<th>Value</th>
7+
<th>Actions</th>
8+
</tr>
9+
</thead>
10+
<tbody>
11+
{{range .Features}}
12+
<tr>
13+
<td>{{.Key}}</td>
14+
<td>{{.Value}}</td>
15+
<td>
16+
<form hx-post="/features/delete"
17+
hx-target="#feature-list"
18+
hx-swap="innerHTML"
19+
style="margin: 0;">
20+
<input type="hidden" name="key" value="{{.Key}}">
21+
<button type="submit" class="secondary" style="margin: 0;">Delete</button>
22+
</form>
23+
</td>
24+
</tr>
25+
{{end}}
26+
</tbody>
27+
</table>
28+
{{else}}
29+
<p>No features found.</p>
30+
{{end}}

‎ui/service/templates/index.gohtml‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8">
5+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6+
<title>Feature Flags - UI</title>
7+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
8+
<script src="https://unpkg.com/htmx.org@2.0.4"></script>
9+
</head>
10+
<body>
11+
<main class="container">
12+
<header>
13+
<h1>Feature Flags</h1>
14+
<p>
15+
<small>
16+
UI v{{.UIVersion}}
17+
{{if .BackendVersion}} · Backend v{{.BackendVersion}}{{end}}
18+
</small>
19+
</p>
20+
</header>
21+
22+
<section>
23+
<h2>Features</h2>
24+
<div id="feature-list"
25+
hx-get="/features/list"
26+
hx-trigger="load"
27+
hx-swap="innerHTML">
28+
<p aria-busy="true">Loading features...</p>
29+
</div>
30+
</section>
31+
</main>
32+
</body>
33+
</html>

0 commit comments

Comments
 (0)