Documentation ¶
Overview ¶
Package webutil provides functions for making developing a website easier.
Index ¶
- func AuthTemplateFunctions(r *http.Request, t *template.Template) *template.Template
- func HandleHealth(w http.ResponseWriter, r *http.Request, _ httprouter.Params)
- func ListenAndServerWithContext(ctx context.Context, addr string, handler http.Handler) error
- func RespondError(w http.ResponseWriter, err error) bool
- func RespondJSON(w http.ResponseWriter, data interface{})
- func SessionFromContext(ctx context.Context) (*sessions.Session, error)
- func SessionFromRequest(r *http.Request) (*sessions.Session, error)
- func SessionSecretSourceVolatile() []byte
- type AuthInfo
- type Middleware
- type MiddlewareChain
- type SessionSecret
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AuthTemplateFunctions ¶
AuthTemplateFunctions curries the given Template with auth related functions. These can then directly be used in the templates without having to add the auth info manually to the template data.
Function `func AuthIsAuthenticated() bool` returns true, if the user is logged in.
Function `func AuthInfo() *AuthInfo` returns the AuthInfo, if the user is logged and `nil` otherwise.
Example:
{{ if AuthIsAuthenticated }} <span class="navbar-text">Hello, <em>{{ AuthInfo.Name }}</em>!</span> {{ else }} <a class="nav-link" href="/auth/login">Login</span></a> {{ end }}
func HandleHealth ¶
func HandleHealth(w http.ResponseWriter, r *http.Request, _ httprouter.Params)
HandleHealth returns a simple HTTP handler, that responds with 200 OK as long as the context is not done. When the context is done, it returns with 503. This only works, if the BaseContext of the http server gets canceled on shutdown. See ListenAndServerWithContext for details.
func ListenAndServerWithContext ¶
ListenAndServerWithContext does the same as http.ListenAndServe with the difference that is properly utilises the context. This means it does a graceful shutdown when the context is done and a context cancellation gets propagated down to the actual request context.
func RespondError ¶
func RespondError(w http.ResponseWriter, err error) bool
RespondError sends an error ID to the client and logs the error, if it is not nil. It returns true, if the error was not nil. This makes it possible to do condensed error checking:
err := DoSomething() if webutil.RespondError(w, err) { return }
func RespondJSON ¶
func RespondJSON(w http.ResponseWriter, data interface{})
RespondJSON sets the proper content type and sends the given data as JSON to the client.
func SessionFromContext ¶
SessionFromContext extracts the Session store from the given context. The session store is injected into the request via the SessionMiddleware. Therefore it is required to use this middleware to be able to get the store.
func SessionFromRequest ¶
SessionFromRequest returns the results of SessionFromContext for the context of the given request.
func SessionSecretSourceVolatile ¶
func SessionSecretSourceVolatile() []byte
SessionSecretSourceVolatile creates a session secret that is stored in memory only. This implies, that all session data is lost after an application restart and an application cannot have more than one replicas.
Types ¶
type AuthInfo ¶
type AuthInfo struct { GitHubToken string UpdatedAt time.Time Login string Name string Teams []string }
AuthInfo contains data about the currently logged in user.
func AuthInfoFromContext ¶
AuthInfoFromContext extracts the AuthInfo from the given context. The AuthInfo is injected into the request via the AuthMiddleware. Therefore it is required to use this middleware to be able to get the AuthInfo.
func AuthInfoFromRequest ¶
AuthInfoFromRequest extracts the AuthInfo from the context within the given request. The AuthInfo is injected into the request via the AuthMiddleware. Therefore it is required to use this middleware to be able to get the AuthInfo.
type Middleware ¶
Middleware is a function that wraps an http.Handler. The function is supposed to call the next handler to continue to execute the process. This type is used by the MiddlewareChain to allow an easy usage of multiple middlewares which makes it easy to see the proper calling order.
func AuthMiddleware ¶
func AuthMiddleware(teams ...string) Middleware
AuthMiddleware is an HTTP request middleware that adds login endpoints. The request makes use of sessions, therefore the SessionMiddleware is required.
The teams argument contains a whitelist of team names, that are copied into the AuthInfo, if the user is in those teams. It is desirable to copy only the needed subset of teams into the AuthInfo, because this data is carried in the session cookie.
Endpoint "/auth/login" initiates the user login and redirects them to the GitHub OAuth page.
Endpoint "/auth/callback" gets called by the user after being redirected from GitHub after a successful login.
func SessionMiddleware ¶
func SessionMiddleware(secret SessionSecret) Middleware
SessionMiddleware inizializes the session store and injects it into the context of the requests.
type MiddlewareChain ¶
type MiddlewareChain []Middleware
MiddlewareChain is a builder for an http.Handler out of multiple middlewares.
func NewMiddlewareChain ¶
func NewMiddlewareChain() MiddlewareChain
NewMiddlewareChain initializes an empty MiddlewareChain.
func (MiddlewareChain) Finally ¶
func (c MiddlewareChain) Finally(h http.Handler) http.Handler
Finally builds the http.Handler that is used by the HTTP server.
func (MiddlewareChain) Then ¶
func (c MiddlewareChain) Then(mw Middleware) MiddlewareChain
Then defines the next middleware to call.
type SessionSecret ¶
type SessionSecret []byte