internal

Documentation

Index

• func ContentsAreText(fpath string) bool
• func JoinDefaultPort(address string, port string) string
• func ListUsersWithHomeSubdir(subdir string, required_perms os.FileMode) ([]string, error)
• func MediaType(fpath string) string
• type PathTree
  • func (pt *PathTree[V]) Add(pattern string, value V)
  • func (pt PathTree[V]) Match(path string) (*V, map[string]string)
  • func (pt PathTree[V]) Routes() []Route[V]
• type Route
• type Server
  • func NewServer(ctx context.Context, hostname string, network string, address string, ...) (Server, error)
  • func (s *Server) Address() string
  • func (s *Server) Close()
  • func (s *Server) Closed() bool
  • func (s *Server) Hostname() string
  • func (s *Server) LogError(keyvals ...any) error
  • func (s *Server) Network() string
  • func (s *Server) Port() string
  • func (s *Server) Serve() error

Functions

func ContentsAreText

func ContentsAreText(fpath string) bool

func JoinDefaultPort

func JoinDefaultPort(address string, port string) string

JoinDefaultPort appends ":<port>" iff the address does not already contain a port.

func ListUsersWithHomeSubdir

func ListUsersWithHomeSubdir(subdir string, required_perms os.FileMode) ([]string, error)

ListUsersWithHomeSubdir provides a list of user names on the current host.

The users returned will only be those with a specifically named subdirectory of their home dir, which has the given permission bits.

func MediaType

func MediaType(fpath string) string

Types

type PathTree

type PathTree[V any] struct {
	// contains filtered or unexported fields
}

func (*PathTree[V]) Add

func (pt *PathTree[V]) Add(pattern string, value V)

func (PathTree[V]) Match

func (pt PathTree[V]) Match(path string) (*V, map[string]string)

func (PathTree[V]) Routes

func (pt PathTree[V]) Routes() []Route[V]

type Route

type Route[V any] struct {
	Pattern string
	Value   V
}

type Server

type Server struct {
	Ctx         context.Context
	Cancel      context.CancelFunc
	Wg          *sync.WaitGroup
	Listener    net.Listener
	HandleConn  connHandler
	ErrorLog    logging.Logger
	Host        string
	NetworkAddr net.Addr
}

func NewServer

func NewServer(
	ctx context.Context,
	hostname string,
	network string,
	address string,
	baseLog logging.Logger,
	handleConn connHandler,
) (Server, error)

func (*Server) Address

func (s *Server) Address() string

func (*Server) Close

func (s *Server) Close()

func (*Server) Closed

func (s *Server) Closed() bool

func (*Server) Hostname

func (s *Server) Hostname() string

func (*Server) LogError

func (s *Server) LogError(keyvals ...any) error

func (*Server) Network

func (s *Server) Network() string

func (*Server) Port

func (s *Server) Port() string

func (*Server) Serve

func (s *Server) Serve() error