Git Product home page Git Product logo

bnkamalesh / webgo Goto Github PK

View Code? Open in Web Editor NEW
295.0 13.0 30.0 426 KB

A microframework to build web apps; with handler chaining, middleware support, and most of all; standard library compliant HTTP handlers(i.e. http.HandlerFunc).

License: MIT License

Go 93.63% CSS 0.71% HTML 2.41% JavaScript 3.26%
golang go web-framework api-server api-rest middleware webframework multiplexer awesome-go router

webgo's People

Contributors

bnkamalesh avatar hlts2 avatar kirilldanshin avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

webgo's Issues

Route grouping

Is your feature request related to a problem? Please describe.

If you want to group a set of APIs under a particular prefix (e.g. all URIs starting with /v2), it's tedious or have to verify manually at multiple places.

Describe the solution you'd like

Create a Route group capability where we append to the current list of routes. e.g.

v2Routes := webgo.NewGroup("/v2", <skipRouterMiddleware>, routes...)
v2Routes.Add(*Route...)

// skipRouterMiddleware is a boolean, which if set to true, all middleware applied using router.Use will be skipped from this route group

Each URI should be automatically be prefixed with the group prefix. In the above example, the group prefix is /v2. After adding the prefix, the URI would look like /v2/<URI>

Describe alternatives you've considered

The same can be easily achieved outside of webgo's scope. Since it is merely maintaining a list of *Route. Though all the methods and implementation adds to the convenience of developers

Additional context
N/A

Invalid response HTTP status

file: responses.go

When responses are send using SendResponse or SendError, in case of a JSON encoding error within these functions, the following happens:

w.WriteHeader(rCode) // Write header is already called here, this cannot be overwritten if err := json.NewEncoder(w).Encode(&dOutput{data, rCode}); err != nil { Log.Println(err) R500(w, ErrInternalServer) // HTTP response status set by this function will not work }

So the response in such cases would look like this:
HTTP Status: 200 { errors: "Internal server error occurred", status: 500 }

Login Auth solutions.

Is your feature request related to a problem? Please describe.
I wanted to get some examples of how to add login authentication. I have some ideas myself, but curious what the world has in mind.

Describe the solution you'd like
I would like to see examples for:
Firebase auth
3rd party Auth
perhaps some JWT and or cookie solutions

url with trailing slash /matchall/webgo/ and /matchall/webgo/ all return 200 not 404

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

  1. git clone https://github.com/bnkamalesh/webgo/blob/master/cmd/main.go
  2. go run main
  3. curl http://localhost:8080/matchall/
    curl http://localhost:8080/matchall/webgo/
  4. "status":200

Expected behavior
A clear and concise description of what you expected to happen.

curl http://localhost:8080/matchall/ return 404
curl http://localhost:8080/matchall/xxx/ return 404
like net/http

package main
import (
    "fmt"
    "net/http"
)
func main() {
    http.HandleFunc("/matchall/webgo", func (w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Welcome to my website!")
    })
   http.ListenAndServe(":80", nil)
}

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

  • OS:win7
  • Browser [e.g. chrome, safari]
  • Version [e.g. 22]

Smartphone (please complete the following information):

  • Device: [e.g. iPhone6]
  • OS: [e.g. iOS8.1]
  • Browser [e.g. stock browser, safari]
  • Version [e.g. 22]

Additional context
Add any other context about the problem here.

CORS middleware update

CORS middleware provided with the package currently responds with a wildcard *. It should be updated to accept a list of domains, and default to wildcard if no domains provided.

  • All CORS middleware functions should accept an optional list of domains
  • Do not break backward compatibility / New functions if cannot maitnain backward compatibility

Convenience methods for adding routes

Is your feature request related to a problem? Please describe.

Adding routes currently requires the developer to prepare a single list of *Route with all the routes defined in one go. This can be split up and made easier for the developer

Describe the solution you'd like

We can add convenience method for each type of HTTP method supported by webgo (). e.g.

router.Add(*Route)
router.Get("URI",[]Handlers{}, opts...)
router.Head("URI",[]Handlers{}, opts...)
router.Post("URI",[]Handlers{}, opts...)
router.Put("URI",[]Handlers{}, opts...)
router.Patch("URI",[]Handlers{}, opts...)
router.Delete("URI",[]Handlers{}, opts...)
router.Option("URI",[]Handlers{},opts...)

Each method should keep updating routes of the router, for the respective HTTP method.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Route example in readme gives error: errors.go:54: Unsupported HTTP request method provided.

Hello. This code in the readme:

import (
	"github.com/bnkamalesh/webgo"
	"github.com/bnkamalesh/webgo/middleware"
)

func routes() []*webgo.Route {
	return []*webgo.Route{
		&webo.Route{
			Name: "home",
			Pattern: "/",
			Handlers: []http.HandlerFunc{
				func(w http.ResponseWriter, r *http.Request) {
					webgo.R200(w, "home")
				}
			},
		},
	}
}

func main() {
	router := webgo.NewRouter(*webgo.Config, routes())

	router.UseOnSpecialHandlers(middleware.AccessLog)
	
	router.Use(middleware.AccessLog)

	router.Start()
}

Doesn't work. You need to define a Method field in the Route struct. Also it complains about *webgo.Config not being an expression (unless it was intentional as a placeholder for any pointer to Config). This works:

func routes() []*webgo.Route {
	return []*webgo.Route{
		&webo.Route{
			Name: "home",
			Method: "GET",	
			Pattern: "/",
			Handlers: []http.HandlerFunc{
				func(w http.ResponseWriter, r *http.Request) {
					webgo.R200(w, "home")
				}
			},
		},
	}
}

func main() {
	config := webgo.Config{
		Host: "localhost",
		Port: "8888",
	}
	router := webgo.NewRouter(&config, routes())

	router.UseOnSpecialHandlers(middleware.AccessLog)
	
	router.Use(middleware.AccessLog)

	router.Start()
}

feat: HTTP cache implementation.

Is your feature request related to a problem? Please describe.
An HTTP cache system would be great in webgo to avoid the execution of unchanged response.

Describe the solution you'd like
I can implement Souin as the HTTP cache middleware. With that it will support the CDN validation/invalidation too, set default cache-control header, store in a distributed system using olric or in memory with badger.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
It's already available as Træfik/Tyk plugin, skipper/gin/echo middleware, and is used in the official caddy cache-handler.

Cheers ✌️

optional parameters

Is your feature request related to a problem? Please describe.
Unable to use optional parameters

Describe the solution you'd like
To have the ability to use optional parameters that would allow the use of /user or /user/1

Additional context

// something like
Pattern: "/user/:id?"

spelling error

Hello,

Thanks for developing this simple framework.
As a non-voice developer I can easily lift up with your framework.
file word written as fil in errors.go file.

//C003 Error Code 3
C003 = "App environment provided in config fil Accepted values are production or development"

-Vasu

Add provision of setting and getting Error

Since all the handlers are std lib compliant, it's difficult to do a centralized/easy of error logging. Hence, implementing Webgotcontext.SetErrror(err error) & Webgocontext.Error() error would be useful. And we could write a normal middleware which fetches the the error from webgocontext and handle appropriately

About fasthttp support

The project was installed on the net/http package as the base. In addition, we can bring fasthttp support. I can even develop it. :)

Comparison benchmark

Comparison benchmark done between multiple frameworks, in an identical environment and the exact same functionality.

Auto HTTPS with Letsencrypt

If autoTLS is enabled, it should do the following:

  • Check if there's a certificate path provided, if not, default to a path
  • Inject acme routes for Letsencrypt verification
  • Accept list of domains to provide HTTPS
  • Check expiry of all generated Letsencrypt certificates
  • Update certificates automatically N days prior to expiry

Support to choose the logging interface

By default the logs are printed to stdout. Though, there should be a provision of providing an output of users' choice. Need to update the logging mechanism to use an interface, so that it can be set to a thirdparty/external logger

  • Convert current logs to use an interface
  • Expose a method to replace the logging interface on the fly (should be concurrency safe)

Plugging database

Hello, I'm wondering how can I plug sqlx in order to use MySQL database. A sample code would be very appreciated.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.