gohf

GoHF ✨

GO Http Framework (Golang)

❓ WHY GoHF

• Easier Error Handling
• Middleware
• Sub-Router (route grouping)
• Customizable Response
• Lightweight
• Based on net/http

📍 Getting started

go get github.com/gohf-http/gohf/v4

import (
  "github.com/gohf-http/gohf/v4"
  "github.com/gohf-http/gohf/v4/gohf_responses"
)

Hello GoHF Example

🪄 Features

Feature: Easier Error Handing

router.Handle("GET /greeting", func(c *gohf.Context) gohf.Response {
  name := c.Req.GetQuery("name")
  if name == "" {
    return gohf_responses.NewErrorResponse(
      http.StatusBadRequest,
      errors.New("Name is required"),
    )
  }

  greeting := fmt.Sprintf("Hello, %s!", name)
  return gohf_responses.NewTextResponse(http.StatusOK, greeting)
})

Feature: Middleware

router.Use(func(c *gohf.Context) gohf.Response {
  token := c.Req.GetHeader("Authorization")
  if !isValidToken(token) {
    return gohf_responses.NewErrorResponse(
      http.StatusUnauthorized,
      errors.New("Invalid token"),
    )
  }

  return c.Next()
})

This is how middleware works in GoHF.

Feature: Sub-Router

authRouter := router.SubRouter("/auth")
authRouter.Use(AuthMiddleware)
authRouter.Handle("GET /users", func(c *gohf.Context) gohf.Response {
  // ...
})

Feature: Customizable Response

You can define a customizable response by implementing gohf.Response interface.

type Response interface {
	Send(http.ResponseWriter, *gohf.Request)
}

Refer to gohf_responses for examples.

This is one of my favorite features, as it promotes a centralized response handler and simplifies adding additional functionality, such as logging.

Hello GoHF Example

package main

import (
  "errors"
  "fmt"
  "log"
  "net/http"

  "github.com/gohf-http/gohf/v4"
  "github.com/gohf-http/gohf/v4/gohf_responses"
)

func main() {
  router := gohf.New()

  router.Handle("GET /greeting", func(c *gohf.Context) gohf.Response {
    name := c.Req.GetQuery("name")
    if name == "" {
      return gohf_responses.NewErrorResponse(
        http.StatusBadRequest,
        errors.New("Name is required"),
      )
    }

    greeting := fmt.Sprintf("Hello, %s!", name)
    return gohf_responses.NewTextResponse(http.StatusOK, greeting)
  })

  router.Use(func(c *gohf.Context) gohf.Response {
    return gohf_responses.NewErrorResponse(
      http.StatusNotFound,
      errors.New("Page not found"),
    )
  })

  mux := router.CreateServeMux()
  log.Fatal(http.ListenAndServe(":8080", mux))
}

🌟 Show your support

Give a ⭐️ if this project helped you!