Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

gemini

package module

Go to main page

Versions in this module

v0

v0.0.69

Aug 6, 2023

v0.0.68

Aug 6, 2023

v0.0.67

Aug 6, 2023

v0.0.66

Nov 21, 2021

Changes in this version

type Handler

+ func RequireInputHandler(h Handler, prompt string) Handler

v0.0.61

Mar 15, 2021

Changes in this version

type Writer

+ WrittenBody int64

+ WrittenHeader int

v0.0.51

Mar 8, 2021

v0.0.49

Feb 26, 2021

Changes in this version

+ const CodeBadRequest

+ const CodeCGIError

+ const CodeClientCertificateNotAuthorised

+ const CodeClientCertificateNotValid

+ const CodeClientCertificateRequired

+ const CodeGone

+ const CodeInput

+ const CodeInputSensitive

+ const CodeNotFound

+ const CodePermanentFailure

+ const CodeProxyError

+ const CodeProxyRequestRefused

+ const CodeRedirect

+ const CodeRedirectPermanent

+ const CodeRedirectTemporary

+ const CodeServerUnavailable

+ const CodeSlowDown

+ const CodeSuccess

+ const CodeTemporaryFailure

+ const DefaultMIMEType

+ var ErrCannotWriteBodyWithoutSuccessCode = errors.New("gemini: cannot write body without success code")

+ var ErrCrLfNotFoundWithinMaxLength = errors.New("gemini: invalid header - CRLF not found within maximum length")

+ var ErrHeaderAlreadyWritten = errors.New("gemini: header already written")

+ var ErrInvalidCode = errors.New("gemini: invalid code")

+ var ErrInvalidMeta = errors.New("gemini: invalid meta")

+ var ErrInvalidStatus = errors.New("gemini: server status did not match the expected format")

+ var ErrServerClosed = errors.New("gemini: server closed")

+ func AuthoriserAllowAll(id, key string) bool

+ func BadRequest(w ResponseWriter, r *Request)

+ func IsErrorCode(code Code) bool

+ func ListenAndServe(ctx context.Context, addr string, domains ...*DomainHandler) (err error)

+ func NotFound(w ResponseWriter, r *Request)

+ type Certificate struct

+ Error string

+ ID string

+ Key string

+ type Client struct

+ Insecure bool

+ ReadTimeout time.Duration

+ WriteTimeout time.Duration

+ func NewClient() *Client

+ func (client *Client) AddClientCertificate(prefix string, cert tls.Certificate)

+ func (client *Client) AddServerCertificate(host, certificateHash string)

+ func (client *Client) GetCertificate(u *url.URL) (cert tls.Certificate, ok bool)

+ func (client *Client) Request(ctx context.Context, u string) (resp *Response, certificates []string, authenticated, ok bool, err error)

+ func (client *Client) RequestConn(ctx context.Context, conn net.Conn, u *url.URL) (resp *Response, err error)

+ func (client *Client) RequestNoTLS(ctx context.Context, u *url.URL) (resp *Response, err error)

+ func (client *Client) RequestURL(ctx context.Context, u *url.URL) (resp *Response, certificates []string, authenticated, ok bool, err error)

+ type Code string

+ type Dir string

+ func (d Dir) Open(name string) (File, error)

+ type DomainHandler struct

+ Handler Handler

+ KeyPair tls.Certificate

+ ServerName string

+ func NewDomainHandler(serverName string, cert tls.Certificate, handler Handler) *DomainHandler

+ func NewDomainHandlerFromFiles(serverName, certFile, keyFile string, handler Handler) (*DomainHandler, error)

+ type File interface

+ Readdir func(count int) ([]os.FileInfo, error)

+ Stat func() (os.FileInfo, error)

+ type FileSystem interface

+ Open func(name string) (File, error)

+ type Handler interface

+ ServeGemini func(w ResponseWriter, r *Request)

+ func BadRequestHandler() Handler

+ func DirectoryListingHandler(path string, f File) Handler

+ func FileContentHandler(name string, f File) Handler

+ func FileSystemHandler(fs FileSystem) Handler

+ func NotFoundHandler() Handler

+ func RedirectPermanentHandler(to string) Handler

+ func RedirectTemporaryHandler(to string) Handler

+ func RequireCertificateHandler(h Handler, authoriser func(certID, certKey string) bool) Handler

+ func StripPrefixHandler(prefix string, h Handler) Handler

+ type HandlerFunc func(ResponseWriter, *Request)

+ func (f HandlerFunc) ServeGemini(w ResponseWriter, r *Request)

+ type Header struct

+ Code Code

+ Meta string

+ type Request struct

+ Certificate Certificate

+ Context context.Context

+ URL *url.URL

+ type Response struct

+ Body io.ReadCloser

+ Header *Header

+ func NewResponse(r io.ReadCloser) (resp *Response, err error)

+ func Record(r *Request, handler Handler) (resp *Response, err error)

+ type ResponseWriter interface

+ SetHeader func(code Code, meta string) error

+ type Server struct

+ Addr string

+ Context context.Context

+ DomainToHandler map[string]*DomainHandler

+ HandlerTimeout time.Duration

+ Insecure bool

+ ReadTimeout time.Duration

+ WriteTimeout time.Duration

+ func NewServer(ctx context.Context, addr string, domainToHandler map[string]*DomainHandler) *Server

+ func (srv *Server) ListenAndServe() error

+ type Writer struct

+ Code string

+ Writer io.Writer

+ func NewWriter(w io.Writer) *Writer

+ func (gw *Writer) SetHeader(code Code, meta string) (err error)

+ func (gw *Writer) Write(p []byte) (n int, err error)

v0.0.13

Aug 21, 2020

v0.0.12

Aug 21, 2020

v0.0.11

Aug 21, 2020