server

Documentation

Overview

Package server serves the 2dph brain over HTTP.

Async by design: every request runs on its own goroutine, and CPU-heavy searches are serialized through a bounded worker pool (a counting semaphore) so N requests can't spawn N Python interpreters at once.

Used by bin/serve.go which is a self-executing shebang script:

///usr/bin/env go run "$0" "$@"; exit
package main
import "github.com/eSlider/2dph/bin/server"
func main() { server.Run() }

Index

• func NewServer(searcher Searcher, workers int) http.Handler
• func Run()
• type Searcher
• type Server
  • func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

Functions

func NewServer

func NewServer(searcher Searcher, workers int) http.Handler

func Run

func Run()

Run starts the HTTP server. Reads env: KB_SEARCH_CMD (default bin/kb/search, relative to the repo root given by KB_ROOT), KB_WORKERS (default 4), KB_PORT (default 8630).

Types

type Searcher

type Searcher interface {
	Search(ctx context.Context, query string, limit int) ([]byte, error)
}

type Server

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

func (*Server) ServeHTTP

func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)