server

Documentation

Index

• type Server
  • func NewServer(host string, port int, watch bool, path string, maxDuration int, timeout int) (*Server, error)
  • func (s *Server) Run() error
• type Watcher
  • func NewWatcher(filename string, fileChanges chan bool) *Watcher
  • func (w *Watcher) Run() error

Types

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server provides functionality to serve Starlark over HTTP. It has functionality to watch a file and hot reload the browser on changes.

func NewServer

func NewServer(host string, port int, watch bool, path string, maxDuration int, timeout int) (*Server, error)

NewServer creates a new server initialized with the applet.

func (*Server) Run

func (s *Server) Run() error

Run serves the http server and runs forever in a blocking fashion.

type Watcher

type Watcher struct {
	// contains filtered or unexported fields
}

Watcher is a structure to watch a file for changes and notify a channel.

func NewWatcher

func NewWatcher(filename string, fileChanges chan bool) *Watcher

NewWatcher instantiates a new watcher with the provided filename and changes channel.

func (*Watcher) Run

func (w *Watcher) Run() error

Run starts the file watcher in a blocking fashion. This watches an entire directory and only notifies the channel when the specified file is changed. If there is an error, it's returned. It's up to the caller to respawn the watcher if it's desireable to keep watching.

The reason it watches a directory is becausde some editers like VIM write to a swap file and recreate the original file. So we can't simply watch the original file, we have to watch the directory. This is also why we check both the WRITE and CREATE events since VIM will write to a swap and then create the file on save. VSCode does a WRITE and then a CHMOD, so tracking WRITE catches the changes for VSCode exactly once.