nex

package

v0.2.0 Latest Latest Go to latest Published: Nov 24, 2025 License: BSD-2-Clause Imports: 11 Imported by: 2

Details

Package nex provides nex station (server) and client functionality.

For more information about nex, see https://nightfall.city/nex/info/.

This section is empty.

This section is empty.

This section is empty.

type Response struct {
	Raw  io.Reader
	Conn net.Conn
}

A Response represents a response from a nex station. It implements the io.ReadCloser interface.

func Request(ctx context.Context, rawURL string) (*Response, error)

Request makes a nex request to rawURL.

func (r *Response) Close() error

Close the connection

func (r *Response) Read(b []byte) (int, error)

Read reads up to len(b) bytes into b.

type Station struct {
	FS        fs.FS
	Nocturnal bool
	Latitude  float64
	Longitude float64
}

A Station serves content from FS. Only open at night if Nocturnal is true. Uses Latitude and Longitude to roughly estimate dawn and dusk.

func (station *Station) Serve(rw io.ReadWriteCloser) error

Reads a nex request from rw and tries to serve the matching file.

func (station *Station) ServeAt(tm time.Time, rw io.ReadWriteCloser) error

Tries to serve a request at the specific time tm. Useful for testing Nocturnal stations.