foweb

foweb is a minimal framework for web backends written in Go using the default net/http package. This is currently only intended for my personal use, but if I am willing to fix bugs and add features if requested and I find the feature fits.

Example

package main

import (
	"fmt"
	"net/http"

	"github.com/s22h/foweb"
)

// APIBaseURL is the base URL of the API endpoint
const APIBaseURL = "/api/v1"

var users = map[string]string{
	"user": "test",
}

func main() {
	// this is the method that will be called when a user tries to authenticate,
	// to check if the credentials are valid, this would be querying a database
	// or users file in a real programme
	foweb.SigninCallback = func(creds foweb.Credentials) bool {
		expectedPassword, ok := users[creds.Username]
		return ok && expectedPassword == creds.Password
	}

	http.Handle(APIBaseURL+"/test", test)
	http.Handle("/", http.FileServer(http.Dir("./web/")))

	fmt.Println("Listening on port 3003")
	http.ListenAndServe(":3003", nil)
}

var test = foweb.MaybeAuthHandler{
	Callback: func(handler foweb.MaybeAuthHandler) {
		// handle GET request without authentication
		if handler.Request.Method == "GET" {
			foweb.WriteJSON(handler.Response, "Hello Go!")
			return
		}

		// check if authenticated, send unauthorized otherwise and return
		if !handler.CheckAuth() {
			return
		}

		// handle POST request only if authenticated
		if handler.Request.Method == "POST" {
			foweb.WriteJSON(handler.Response, "Hello POST")
		} else {
			foweb.WriteJSONResponse(handler.Response, foweb.JSONResponse{
				Status:  http.StatusMethodNotAllowed,
				Message: "Request method not allowed",
			})
		}
	},
}