server

server

Use any http.Handler implementation of your choice. Register the handler for a given path using the server.RegisterHandler function.

Check out these premade handlers to get you going!

• http server
• git server
• grpc server
• graphql endpoint

Running and Stopping

To stop the server send the program an SIGINT or SIGKILL - either natively through another process or with a Ctrl-C.

Stopping the server is not "graceful" - it does not await any open connections and will likely attempt to close down IO/handles without consideration of consumers waiting their results.

HTTP/2 and Certs

Deploy production-grade cert files (backed by a trusted CA) to the same machine as the server binary.

Load them in and pass them to the server.Run function.

NOTE Still in process of testing.

Consuming

This is a very high-level server library. Using it requires the import and use of a single Run function:

import (
  "context"
  "crypto/tls"
  "os"

  "git.sonicoriginal.software/server/v2"
)

const (
	portEnvKey = "APP_PORT"
  enableHeartBeat = true
)

var (
	certs               []tls.Certificate
	mux                 = http.NewServeMux()
	ctx, cancelFunction = context.WithCancel(context.Background())
)

func main() {
	defer cancelFunction()

  // TODO Import your desired handlers and register them here
  // e.g. if importing the 'app' handler, use
  // _ = app.New()

  // TODO Load your cert and key or skip and just use
  // cert, err := tls.X509KeyPair(cert, key)
  // if err != nil {
  //   // Handle a certificate server failure for your app here
  // }

	address, serverErrorChannel := server.Run(ctx, &certs, mux, portEnvKey)
	logger.DefaultLogger.Info("Serving on [%v]\n", address)

	serverError := <-serverErrorChannel
	contextError := serverError.Context.Error()

	if serverError.Close != nil {
		logger.DefaultLogger.Error("Error closing server: %v", serverError.Close.Error())
	}

	if contextError != server.ErrContextCancelled.Error() {
		logger.DefaultLogger.Error("Server failed unexpectedly: %v", contextError)
	}
}