gores
http response utility library for Go
this package is very small and lightweight, useful for RESTful APIs.
installation
go get github.com/alioygur/gores
requirements
gores library requires Go version >=1.7
usage
package main
import (
"log"
"net/http"
"github.com/alioygur/gores"
)
type User struct {
Name string
Email string
Age int
}
func main() {
// Plain text response
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
gores.String(w, http.StatusOK, "Hello World")
})
// HTML response
http.HandleFunc("/html", func(w http.ResponseWriter, r *http.Request) {
gores.HTML(w, http.StatusOK, "<h1>Hello World</h1>")
})
// JSON response
http.HandleFunc("/json", func(w http.ResponseWriter, r *http.Request) {
user := User{Name: "Ali", Email: "[email protected]", Age: 28}
gores.JSON(w, http.StatusOK, user)
})
// File response
http.HandleFunc("/file", func(w http.ResponseWriter, r *http.Request) {
err := gores.File(w, r, "./path/to/file.html")
if err != nil {
log.Println(err.Error())
}
})
// Download file
http.HandleFunc("/download-file", func(w http.ResponseWriter, r *http.Request) {
err := gores.Download(w, r, "./path/to/file.pdf", "example.pdf")
if err != nil {
log.Println(err.Error())
}
})
// No content
http.HandleFunc("/no-content", func(w http.ResponseWriter, r *http.Request) {
gores.NoContent(w)
})
// Error response
http.HandleFunc("/error", func(w http.ResponseWriter, r *http.Request) {
gores.Error(w, http.StatusInternalServerError, http.StatusText(http.StatusInternalServerError))
})
err := http.ListenAndServe(":8000", nil)
if err != nil {
log.Fatal("ListenAndServe: ", err)
}
}
for more documentation godoc
Contribute
Use issues for everything
- Report problems
- Discuss before sending a pull request
- Suggest new features/recipes
- Improve/fix documentation
Thanks & Authors
I use code/got inspiration from these excellent libraries:
- labstack/echo micro web framework
1.1k Jan 5, 2023
531 Dec 28, 2022
32 Sep 2, 2022
4 Nov 11, 2022
532 Jan 4, 2023
50 Sep 26, 2022
0 Jan 7, 2022
5 Aug 21, 2022
21 Dec 24, 2022
237 Dec 7, 2022
2.3k Dec 29, 2022
25 Mar 3, 2022
0 Dec 18, 2021
2k Jan 8, 2023
32 Sep 27, 2022
20 Dec 15, 2022
3 Nov 22, 2022
250 Dec 13, 2022
586 Dec 10, 2022
2.5k Dec 29, 2022
15 Jul 6, 2021
681 Dec 28, 2022
34 Dec 29, 2022
168 Dec 21, 2022
1.7k Jan 8, 2023
5 Dec 5, 2022