Fork of go-gemini
f2921a396f
Error handling is currently missing is a couple of places. Most of them are i/o related. This change adds checks, an therefore sometimes also has to change function signatures by adding an error return value. In the case of the response writer the status and meta handling is changed and this also breaks the API. In some places where we don't have any reasonable I've added assignment to a blank identifier to make it clear that we're ignoring an error. text: read the Err() that can be set by the scanner. client: check if conn.SetDeadline() returns an error. client: check if req.Write() returns an error. fs: panic if mime type registration fails. server: stop performing i/o in Header/Status functions By deferring the actual header write to the first Write() or Flush() call we don't have to do any error handling in Header() or Status(). As Server.respond() now defers a ResponseWriter.Flush() instead of directly flushing the underlying bufio.Writer this has the added benefit of ensuring that we always write a header to the client, even if the responder is a complete NOOP. tofu: return an error if we fail to write to the known hosts writer. |
||
|---|---|---|
| examples | ||
| .gitignore | ||
| cert.go | ||
| client.go | ||
| fs.go | ||
| gemini.go | ||
| go.mod | ||
| LICENSE | ||
| mux.go | ||
| query.go | ||
| README.md | ||
| request.go | ||
| response.go | ||
| server.go | ||
| status.go | ||
| text.go | ||
| tofu.go | ||
| vendor.go | ||
go-gemini
Package gemini implements the Gemini protocol in Go.
It aims to provide an API similar to that of net/http to make it easy to develop Gemini clients and servers.
Usage
import "git.sr.ht/~adnano/go-gemini"
Examples
There are a few examples provided in the examples directory. To run an example:
go run examples/server.go
Contributing
Send patches and questions to ~adnano/go-gemini-devel.
Subscribe to release announcements on ~adnano/go-gemini-announce.