roger-russel/fasthttp-router-middleware

# Fasthttp Router Middleware

[![CircleCI](https://circleci.com/gh/roger-russel/fasthttp-router-middleware.svg?style=shield)](https://circleci.com/gh/roger-russel/fasthttp-router-middleware) [![codecov](https://codecov.io/gh/roger-russel/fasthttp-router-middleware/branch/master/graph/badge.svg)](https://codecov.io/gh/roger-russel/fasthttp-router-middleware) [![Software License](https://img.shields.io/badge/license-Apache-brightgreen.svg?style=flat-square)](LICENSE.md) [![Maintainability](https://api.codeclimate.com/v1/badges/5d2405a6a435dd84f861/maintainability)](https://codeclimate.com/github/roger-russel/fasthttp-router-middleware/maintainability)

## Usage

It's possible to create a group of middlewares and use it per routes, or apply middlewares on demand.

### Middleware Groups

Middleware grous allow you to create a group of meiddlewares and reuse it into many routes that you like.
There is a working example of this [here](https://github.com/roger-russel/fasthttp-router-middleware/blob/master/docs/examples/group) with its tests.

```go

import "github.com/roger-russel/fasthttp-router-middleware/pkg/middleware"

func exampleAuthFunc(ctx *fasthttp.RequestCtx) bool { ... }
func exampleRuleFunc(ctx *fasthttp.RequestCtx) bool { ... }
func exampleRequestHandler(ctx *fasthttp.RequestCtx) { ... }

func main() {

  ...

  midGroupAuth = middleware.New([]middleware.Middleware{exampleAuthFunc, exampleRuleFunc})

  router := router.New()
  router.GET("/", exampleRequestHandler)
  router.GET("/protected", midGroupAuth(exampleRequestHandler))

  ...

}

```

### On demand

Ondemand you just put yours middlewares per route like the example bellow.
There is a working example of this [here](https://github.com/roger-russel/fasthttp-router-middleware/blob/master/docs/examples/ondemand) with its tests.

```go

import "github.com/roger-russel/fasthttp-router-middleware/pkg/middleware"

func exampleAuthFunc(ctx *fasthttp.RequestCtx) bool { ... }
func exampleRuleFunc(ctx *fasthttp.RequestCtx) bool { ... }
func exampleRequestHandler(ctx *fasthttp.RequestCtx) { ... }

func main() {

  ...

  router := router.New()
  router.GET("/", exampleRequestHandler)
  router.GET("/protected", middleware.Apply([]middleware.Middleware{
    exampleAuthFunc,
    exampleRuleFunc,
  }, exampleRequestHandler))

  ...

}

```

## Contribute Guide

Please take a look at [Contribute Guide](https://github.com/roger-russel/fasthttp-router-middleware/blob/master/docs/contributing.md).

## Thanks

* @Hanjm, I learn a lot on your [middleware project](https://github.com/hanjm/fasthttpmiddleware) for fasthttp.