Server struct

Fields:

  • Port (string)
  • Host (bool)
  • Debug (bool)
  • stopCh (chan os.Signal)
  • watcher (*fsnotify.Watcher)
  • hostCmd (*exec.Cmd)
  • buildType (string)
  • hostPort (string)
  • ignoreUntil (time.Time)
  • hmrMu (sync.Mutex)
  • hmrClients (map[chan []byte]struct{})

Methods:

Start


Returns:
  • error

Show/Hide Method Body
{
	if err := build.Build(); err != nil {
		return err
	}

	// Detect build type from manifest to know if host components are enabled.
	s.buildType = readBuildType()
	var mux *http.ServeMux
	httpsPort := incrementPort(s.Port)
	if s.buildType == "ssc" {
		s.hostPort = incrementPort(httpsPort)
		if err := s.startHost(); err != nil {
			return err
		}
		target := &url.URL{Scheme: "http", Host: fmt.Sprintf("localhost:%s", s.hostPort)}
		proxy := httputil.NewSingleHostReverseProxy(target)
		mux = http.NewServeMux()
		mux.HandleFunc("/__rfw/hmr", s.handleHMR)
		mux.Handle("/", proxy)
		go func() {
			if err := http.ListenAndServe(":"+s.Port, mux); err != nil {
				utils.Fatal("Server failed: ", err)
			}
		}()
		go func() {
			if err := hostpkg.ListenAndServeTLSWithMux(":"+httpsPort, mux); err != nil {
				utils.Fatal("HTTPS server failed: ", err)
			}
		}()
	} else {
		root := filepath.Join("build", "client")
		mux = hostpkg.NewMux(root)
		mux.HandleFunc("/__rfw/hmr", s.handleHMR)
		go func() {
			if err := http.ListenAndServe(":"+s.Port, mux); err != nil {
				utils.Fatal("Server failed: ", err)
			}
		}()
		go func() {
			if err := hostpkg.ListenAndServeTLSWithMux(":"+httpsPort, mux); err != nil {
				utils.Fatal("HTTPS server failed: ", err)
			}
		}()
	}
	watcher, err := fsnotify.NewWatcher()
	if err != nil {
		return err
	}
	s.watcher = watcher
	if err := s.addWatchers("."); err != nil {
		return err
	}
	go s.watchFiles()

	signal.Notify(s.stopCh, syscall.SIGINT, syscall.SIGTERM)

	localIP := ""
	if s.Host {
		localIP, err = utils.GetLocalIP()
		if err != nil {
			return err
		}
	}

	utils.ClearScreen()
	utils.PrintStartupInfo(s.Port, httpsPort, localIP, s.Host)

	go s.listenForCommands()

	<-s.stopCh
	utils.Info("Server stopped.")
	s.stopHost()
	return nil
}

listenForCommands


Show/Hide Method Body
{
	reader := bufio.NewReader(os.Stdin)
	for {
		input, _ := reader.ReadString('\n')
		input = strings.TrimSpace(input)

		switch strings.ToLower(input) {
		case "h":
			utils.PrintHelp()
		case "u":
			utils.ClearScreen()
			localIP, err := utils.GetLocalIP()
			if err != nil {
				utils.Fatal("Failed to get local IP address: ", err)
			}
			httpsPort := incrementPort(s.Port)
			utils.PrintStartupInfo(s.Port, httpsPort, localIP, s.Host)
		case "c", "q":
			utils.Info("Closing the server...")
			s.stopCh <- syscall.SIGINT
			return
		case "o":
			utils.Info("Opening the browser...")
			url := fmt.Sprintf("http://localhost:%s/", s.Port)
			if err := utils.OpenBrowser(url); err != nil {
				utils.Info(fmt.Sprintf("Failed to open browser: %v", err))
			}
		default:
			utils.Info("Unknown command. Press 'h' for help.")
		}
	}
}

addWatchers


Parameters:
  • root string

Returns:
  • error

Show/Hide Method Body
{
	return filepath.WalkDir(root, func(path string, d os.DirEntry, err error) error {
		if err != nil {
			return err
		}
		if d.IsDir() {
			name := d.Name()
			if name != "." && (name == "build" || strings.HasPrefix(name, ".")) {
				return filepath.SkipDir
			}
			return s.watcher.Add(path)
		}
		return nil
	})
}

shouldIgnore


Parameters:
  • now time.Time

Returns:
  • bool

Show/Hide Method Body
{
	return now.Before(s.ignoreUntil)
}

watchFiles


Show/Hide Method Body
{
	for {
		select {
		case event, ok := <-s.watcher.Events:
			if !ok {
				return
			}
			if s.shouldIgnore(time.Now()) {
				continue
			}
			utils.Debug(fmt.Sprintf("event: %s", event))
			if event.Op&fsnotify.Create != 0 {
				if fi, err := os.Stat(event.Name); err == nil && fi.IsDir() {
					name := filepath.Base(event.Name)
					if name == "build" || strings.HasPrefix(name, ".") {
						continue
					}
					utils.Debug(fmt.Sprintf("watching new directory: %s", event.Name))
					_ = s.watcher.Add(event.Name)
					continue
				}
			}
			if event.Op&(fsnotify.Write|fsnotify.Create|fsnotify.Remove|fsnotify.Rename) != 0 {
				if isGenerated(event.Name) {
					continue
				}
				if strings.HasSuffix(event.Name, ".go") ||
					strings.HasSuffix(event.Name, ".rtml") ||
					strings.HasSuffix(event.Name, ".md") ||
					plugins.NeedsRebuild(event.Name) {
					rebuilds.Add(1)
					utils.Info("Changes detected, rebuilding...")
					if err := build.Build(); err != nil {
						utils.Fatal("Failed to rebuild project: ", err)
					}
					if strings.HasSuffix(event.Name, ".rtml") {
						markup, err := os.ReadFile(event.Name)
						if err == nil {
							if comps := componentNamesForTemplate(event.Name); len(comps) > 0 {
								for _, name := range comps {
									if err := s.broadcastTemplateUpdate(event.Name, name, string(markup)); err != nil {
										utils.Debug(fmt.Sprintf("template broadcast failed: %v", err))
									}
								}
							} else {
								if err := s.broadcastReload(event.Name); err != nil {
									utils.Debug(fmt.Sprintf("hmr broadcast skipped: %v", err))
								}
							}
						} else {
							utils.Debug(fmt.Sprintf("failed reading template %s: %v", event.Name, err))
							if err := s.broadcastReload(event.Name); err != nil {
								utils.Debug(fmt.Sprintf("hmr broadcast skipped: %v", err))
							}
						}
					} else {
						if err := s.broadcastReload(event.Name); err != nil {
							utils.Debug(fmt.Sprintf("hmr broadcast skipped: %v", err))
						}
					}
					if s.buildType == "ssc" {
						s.stopHost()
						if err := s.startHost(); err != nil {
							utils.Fatal("Failed to restart host server: ", err)
						}
					}
					s.ignoreUntil = time.Now().Add(ignoreDelay)
					drainWatcher(s.watcher)
				}
			}
		case err, ok := <-s.watcher.Errors:
			if !ok {
				return
			}
			utils.Info(fmt.Sprintf("Watcher error: %v", err))
		case <-s.stopCh:
			s.watcher.Close()
			s.stopHost()
			return
		}
	}
}

startHost


Returns:
  • error

Show/Hide Method Body
{
	path := filepath.Join("build", "host", "host")
	s.hostCmd = exec.Command(path)
	s.hostCmd.Stdout = os.Stdout
	s.hostCmd.Stderr = os.Stderr
	if s.hostPort != "" {
		env := os.Environ()
		env = append(env, fmt.Sprintf("RFW_HOST_PORT=%s", s.hostPort))
		s.hostCmd.Env = env
	}
	return s.hostCmd.Start()
}

stopHost


Show/Hide Method Body
{
	if s.hostCmd != nil && s.hostCmd.Process != nil {
		_ = s.hostCmd.Process.Kill()
		_, _ = s.hostCmd.Process.Wait()
	}
	s.hostCmd = nil
}

handleHMR


Parameters:
  • w http.ResponseWriter
  • r *http.Request

Show/Hide Method Body
{
	flusher, ok := w.(http.Flusher)
	if !ok {
		http.Error(w, "stream unsupported", http.StatusInternalServerError)
		return
	}

	w.Header().Set("Content-Type", "text/event-stream")
	w.Header().Set("Cache-Control", "no-cache")
	w.Header().Set("Connection", "keep-alive")

	client := make(chan []byte, 8)

	s.hmrMu.Lock()
	s.hmrClients[client] = struct{}{}
	s.hmrMu.Unlock()

	utils.Debug("hmr client connected")

	fmt.Fprintf(w, ": connected\n\n")
	flusher.Flush()

	defer func() {
		s.hmrMu.Lock()
		delete(s.hmrClients, client)
		s.hmrMu.Unlock()
		utils.Debug("hmr client disconnected")
	}()

	ping := time.NewTicker(30 * time.Second)
	defer ping.Stop()

	for {
		select {
		case msg, ok := <-client:
			if !ok {
				return
			}
			fmt.Fprintf(w, "data: %s\n\n", msg)
			flusher.Flush()
		case <-ping.C:
			fmt.Fprintf(w, ": ping\n\n")
			flusher.Flush()
		case <-r.Context().Done():
			return
		}
	}
}

broadcast


Parameters:
  • msg devMessage

Returns:
  • error

References:


Show/Hide Method Body
{
	data, err := json.Marshal(msg)
	if err != nil {
		return err
	}

	s.hmrMu.Lock()
	defer s.hmrMu.Unlock()
	if len(s.hmrClients) == 0 {
		return nil
	}
	for ch := range s.hmrClients {
		select {
		case ch <- data:
		default:
			// Drop slow clients to avoid blocking rebuilds.
			delete(s.hmrClients, ch)
			close(ch)
		}
	}
	return nil
}

broadcastReload


Parameters:
  • path string

Returns:
  • error

Show/Hide Method Body
{
	rel := path
	if abs, err := filepath.Abs(path); err == nil {
		if cwd, err := filepath.Abs("."); err == nil {
			if r, err := filepath.Rel(cwd, abs); err == nil {
				rel = filepath.ToSlash(r)
			}
		}
	}
	utils.Debug(fmt.Sprintf("broadcasting reload for %s", rel))
	return s.broadcast(devMessage{Type: "reload", Path: rel})
}

broadcastTemplateUpdate


Parameters:
  • path string
  • component string
  • markup string

Returns:
  • error

Show/Hide Method Body
{
	rel := path
	if abs, err := filepath.Abs(path); err == nil {
		if cwd, err := filepath.Abs("."); err == nil {
			if r, err := filepath.Rel(cwd, abs); err == nil {
				rel = filepath.ToSlash(r)
			}
		}
	}
	utils.Debug(fmt.Sprintf("streaming template update for %s (%s)", rel, component))
	return s.broadcast(devMessage{Type: "rtml", Path: rel, Component: component, Markup: markup})
}

NewServer function

Parameters:

  • port string
  • host bool
  • debug bool

Returns:

  • *Server
Show/Hide Function Body
{
	utils.EnableDebug(debug)
	return &Server{
		Port:       port,
		Host:       host,
		Debug:      debug,
		stopCh:     make(chan os.Signal, 1),
		hmrClients: make(map[chan []byte]struct{}),
	}
}

isGenerated function

Parameters:

  • path string

Returns:

  • bool
Show/Hide Function Body
{
	return strings.HasPrefix(filepath.Base(path), "rfw_")
}

drainWatcher function

Parameters:

  • w *fsnotify.Watcher
Show/Hide Function Body
{
	for {
		select {
		case <-w.Events:
		case <-w.Errors:
		case <-time.After(50 * time.Millisecond):
			return
		}
	}
}

readBuildType function

readBuildType reads the build type from rfw.json if present.

Returns:

  • string
Show/Hide Function Body
{
	var manifest struct {
		Build struct {
			Type string `json:"type"`
		} `json:"build"`
	}
	data, err := os.ReadFile("rfw.json")
	if err != nil {
		return ""
	}
	_ = json.Unmarshal(data, &manifest)
	return strings.ToLower(manifest.Build.Type)
}

incrementPort function

Parameters:

  • port string

Returns:

  • string
Show/Hide Function Body
{
	p, _ := strconv.Atoi(port)
	return strconv.Itoa(p + 1)
}

TestIncrementPort function

TestIncrementPort verifies port arithmetic.

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	if got := incrementPort("8080"); got != "8081" {
		t.Fatalf("expected 8081, got %s", got)
	}
}

TestReadBuildType function

TestReadBuildType reads build type from temporary manifest.

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	dir := t.TempDir()
	oldwd, err := os.Getwd()
	if err != nil {
		t.Fatalf("Getwd failed: %v", err)
	}
	defer os.Chdir(oldwd)
	if err := os.Chdir(dir); err != nil {
		t.Fatalf("Chdir failed: %v", err)
	}

	// No file should return empty string.
	if got := readBuildType(); got != "" {
		t.Fatalf("expected empty build type, got %q", got)
	}

	// Create manifest and verify value.
	data := []byte(`{"build":{"type":"SSC"}}`)
	if err := os.WriteFile(filepath.Join(dir, "rfw.json"), data, 0644); err != nil {
		t.Fatalf("write manifest: %v", err)
	}
	if got := readBuildType(); got != "ssc" {
		t.Fatalf("expected 'ssc', got %q", got)
	}
}

TestIsGenerated function

TestIsGenerated ensures generated files are skipped.

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	tests := map[string]bool{
		"rfw_devtools.go":       true,
		"some/rfw_generated.go": true,
		"rfw.go":                false,
		"cmd/rfw/server.go":     false,
	}
	for path, want := range tests {
		if got := isGenerated(path); got != want {
			t.Fatalf("isGenerated(%q) = %v, want %v", path, got, want)
		}
	}
}

TestShouldIgnore function

TestShouldIgnore verifies the ignore window logic.

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	s := &Server{}
	if s.shouldIgnore(time.Now()) {
		t.Fatalf("expected no ignore by default")
	}
	s.ignoreUntil = time.Now().Add(time.Second)
	if !s.shouldIgnore(time.Now()) {
		t.Fatalf("expected ignore within window")
	}
}

devMessage struct

Fields:

  • Type (string) - json:"type"
  • Path (string) - json:"path,omitempty"
  • Component (string) - json:"component,omitempty"
  • Markup (string) - json:"markup,omitempty"

componentNamesForTemplate function

Parameters:

  • templatePath string

Returns:

  • []string
Show/Hide Function Body
{
	abs := templatePath
	if v, err := filepath.Abs(templatePath); err == nil {
		abs = v
	}
	dir := filepath.Dir(abs)
	if filepath.Base(dir) == "templates" {
		dir = filepath.Dir(dir)
	}
	entries, err := os.ReadDir(dir)
	if err != nil {
		return nil
	}
	rel, err := filepath.Rel(dir, abs)
	if err != nil {
		rel = filepath.Base(abs)
	}
	rel = filepath.ToSlash(rel)
	var names []string
	seen := map[string]struct{}{}
	for _, entry := range entries {
		if entry.IsDir() || !strings.HasSuffix(entry.Name(), ".go") {
			continue
		}
		goFile := filepath.Join(dir, entry.Name())
		fileNames := embedVariablesForTemplate(goFile, rel)
		if len(fileNames) == 0 {
			continue
		}
		comps := componentsUsingTemplates(goFile, fileNames)
		for _, name := range comps {
			if _, ok := seen[name]; ok {
				continue
			}
			seen[name] = struct{}{}
			names = append(names, name)
		}
	}
	if len(names) == 0 {
		return nil
	}
	return names
}

embedVariablesForTemplate function

Parameters:

  • goFile string
  • rel string

Returns:

  • map[string]struct{}
Show/Hide Function Body
{
	fset := token.NewFileSet()
	file, err := parser.ParseFile(fset, goFile, nil, parser.ParseComments)
	if err != nil {
		return nil
	}
	vars := map[string]struct{}{}
	for _, decl := range file.Decls {
		gen, ok := decl.(*ast.GenDecl)
		if !ok || gen.Tok != token.VAR {
			continue
		}
		for _, spec := range gen.Specs {
			vs, ok := spec.(*ast.ValueSpec)
			if !ok {
				continue
			}
			if !specEmbedsPath(rel, gen.Doc, vs.Doc, vs.Comment) {
				continue
			}
			for _, name := range vs.Names {
				vars[name.Name] = struct{}{}
			}
		}
	}
	return vars
}

specEmbedsPath function

Parameters:

  • rel string
  • groups ...*ast.CommentGroup

Returns:

  • bool
Show/Hide Function Body
{
	for _, grp := range groups {
		if grp == nil {
			continue
		}
		for _, comment := range grp.List {
			text := strings.TrimSpace(comment.Text)
			if !strings.HasPrefix(text, "//go:embed") {
				continue
			}
			fields := strings.Fields(strings.TrimPrefix(text, "//go:embed"))
			for _, field := range fields {
				candidate := strings.Trim(field, "`\"")
				if candidate == "" {
					continue
				}
				if filepath.ToSlash(candidate) == rel {
					return true
				}
			}
		}
	}
	return false
}

componentsUsingTemplates function

Parameters:

  • goFile string
  • vars map[string]struct{}

Returns:

  • []string
Show/Hide Function Body
{
	fset := token.NewFileSet()
	file, err := parser.ParseFile(fset, goFile, nil, 0)
	if err != nil {
		return nil
	}
	var names []string
	ast.Inspect(file, func(n ast.Node) bool {
		call, ok := n.(*ast.CallExpr)
		if !ok || len(call.Args) < 2 {
			return true
		}
		fun := call.Fun
		switch f := fun.(type) {
		case *ast.IndexExpr:
			fun = f.X
		case *ast.IndexListExpr:
			fun = f.X
		}
		sel, ok := fun.(*ast.SelectorExpr)
		if !ok {
			return true
		}
		pkg, ok := sel.X.(*ast.Ident)
		if !ok || pkg.Name != "core" {
			return true
		}
		if sel.Sel.Name != "NewComponent" && sel.Sel.Name != "NewComponentWith" {
			return true
		}
		lit, ok := call.Args[0].(*ast.BasicLit)
		if !ok || lit.Kind != token.STRING {
			return true
		}
		name, err := strconv.Unquote(lit.Value)
		if err != nil || name == "" {
			return true
		}
		ident, ok := call.Args[1].(*ast.Ident)
		if !ok {
			return true
		}
		if _, ok := vars[ident.Name]; !ok {
			return true
		}
		names = append(names, name)
		return true
	})
	return names
}

TestComponentNamesForTemplate function

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	tmpl := filepath.Join("..", "..", "..", "docs", "examples", "components", "templates", "input_component.rtml")
	names := componentNamesForTemplate(tmpl)
	t.Logf("names: %v", names)
	if len(names) == 0 {
		t.Fatalf("expected component names for %s", tmpl)
	}
	found := false
	for _, name := range names {
		if name == "InputComponent" {
			found = true
			break
		}
	}
	if !found {
		t.Fatalf("expected InputComponent in %v", names)
	}
}

TestComponentNamesForTemplateGenerics function

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	tmpl := filepath.Join("..", "..", "..", "docs", "examples", "components", "templates", "webgl_component.rtml")
	names := componentNamesForTemplate(tmpl)
	t.Logf("names: %v", names)
	found := false
	for _, name := range names {
		if name == "WebGLComponent" {
			found = true
			break
		}
	}
	if !found {
		t.Fatalf("expected WebGLComponent in %v", names)
	}
}

TestComponentNamesForTemplateNoMatch function

Parameters:

  • t *testing.T
Show/Hide Function Body
{
	tmpl := filepath.Join("hmr_template_test.go")
	if names := componentNamesForTemplate(tmpl); names != nil {
		t.Fatalf("expected nil, got %v", names)
	}
}

bufio import

Import example:

import "bufio"

encoding/json import

Import example:

import "encoding/json"

expvar import

Import example:

import "expvar"

fmt import

Import example:

import "fmt"

net/http import

Import example:

import "net/http"

net/http/httputil import

Import example:

import "net/http/httputil"

net/url import

Import example:

import "net/url"

os import

Import example:

import "os"

os/exec import

Import example:

import "os/exec"

os/signal import

Import example:

import "os/signal"

path/filepath import

Import example:

import "path/filepath"

strconv import

Import example:

import "strconv"

strings import

Import example:

import "strings"

sync import

Import example:

import "sync"

syscall import

Import example:

import "syscall"

time import

Import example:

import "time"

github.com/fsnotify/fsnotify import

Import example:

import "github.com/fsnotify/fsnotify"

github.com/rfwlab/rfw/cmd/rfw/build import

Import example:

import "github.com/rfwlab/rfw/cmd/rfw/build"

github.com/rfwlab/rfw/cmd/rfw/plugins import

Import example:

import "github.com/rfwlab/rfw/cmd/rfw/plugins"

github.com/rfwlab/rfw/cmd/rfw/utils import

Import example:

import "github.com/rfwlab/rfw/cmd/rfw/utils"

github.com/rfwlab/rfw/v1/host import

Import example:

import "github.com/rfwlab/rfw/v1/host"

Imported as:

hostpkg

os import

Import example:

import "os"

path/filepath import

Import example:

import "path/filepath"

testing import

Import example:

import "testing"

time import

Import example:

import "time"

encoding/json import

Import example:

import "encoding/json"

fmt import

Import example:

import "fmt"

net/http import

Import example:

import "net/http"

path/filepath import

Import example:

import "path/filepath"

time import

Import example:

import "time"

github.com/rfwlab/rfw/cmd/rfw/utils import

Import example:

import "github.com/rfwlab/rfw/cmd/rfw/utils"

go/ast import

Import example:

import "go/ast"

go/parser import

Import example:

import "go/parser"

go/token import

Import example:

import "go/token"

os import

Import example:

import "os"

path/filepath import

Import example:

import "path/filepath"

strconv import

Import example:

import "strconv"

strings import

Import example:

import "strings"

path/filepath import

Import example:

import "path/filepath"

testing import

Import example:

import "testing"