Adding upstream version 1.6.0.

Signed-off-by: Daniel Baumann <daniel@debian.org>

README.md

@@ -0,0 +1,92 @@
+# health
+![test](https://github.com/TwiN/health/workflows/test/badge.svg?branch=master) 
+[![Go Report Card](https://goreportcard.com/badge/github.com/TwiN/health)](https://goreportcard.com/report/github.com/TwiN/health)
+[![codecov](https://codecov.io/gh/TwiN/health/branch/master/graph/badge.svg)](https://codecov.io/gh/TwiN/health)
+[![Go version](https://img.shields.io/github/go-mod/go-version/TwiN/health.svg)](https://github.com/TwiN/health)
+[![Go Reference](https://pkg.go.dev/badge/github.com/TwiN/health.svg)](https://pkg.go.dev/github.com/TwiN/health)
+
+Health is a library used for creating a very simple health endpoint.
+
+While implementing a health endpoint is very simple, I've grown tired of implementing 
+it over and over again.
+
+
+## Installation
+```console
+go get -u github.com/TwiN/health
+```
+
+
+## Usage
+To retrieve the handler, you must use `health.Handler()` and are expected to pass it to the router like so:
+```go
+router := http.NewServeMux()
+router.Handle("/health", health.Handler())
+server := &http.Server{
+    Addr:    ":8080",
+    Handler: router,
+}
+```
+
+By default, the handler will return `UP` when the status is up, and `DOWN` when the status is down.
+If you prefer using JSON, however, you may initialize the health handler like so:
+```go
+router.Handle("/health", health.Handler().WithJSON(true))
+```
+The above will cause the response body to become `{"status":"UP"}` and `{"status":"DOWN"}` for both status respectively,
+unless there is a reason, in which case a reason set to `because` would return `{"status":"UP", "reason":"because"}`
+and `{"status":"DOWN", "reason":"because"}` respectively.
+
+To set the health status to `DOWN` with a reason:
+```go
+health.SetUnhealthy("<enter reason here>")
+```
+The string passed will be automatically set as the reason.
+
+In a similar fashion, to set the health status to `UP` and clear the reason:
+```go
+health.SetHealthy()
+```
+
+
+Alternatively, to set the status and the reason individually you can use `health.SetStatus(<status>)` where `<status>` is `health.Up`
+or `health.Down`:
+```go
+health.SetStatus(health.Up)
+health.SetStatus(health.Down)
+```
+As for the reason:
+```go
+health.SetReason("database is unreachable")
+```
+
+Generally speaking, you'd only want to include a reason if the status is `Down`, but you can do as you desire.
+
+For the sake of convenience, you can also use `health.SetStatusAndReason(<status>, <reason>)` instead of doing 
+`health.SetStatus(<status>)` and `health.SetReason(<reason>)` separately.
+
+
+### Complete example
+```go
+package main
+
+import (
+    "net/http"
+    "time"
+
+    "github.com/TwiN/health"
+)
+
+func main() {
+    router := http.NewServeMux()
+    router.Handle("/health", health.Handler())
+    server := &http.Server{
+        Addr:         "0.0.0.0:8080",
+        Handler:      router,
+        ReadTimeout:  15 * time.Second,
+        WriteTimeout: 15 * time.Second,
+        IdleTimeout:  15 * time.Second,
+    }
+    server.ListenAndServe()
+}
+```