2018-08-06 12:47:05 -07:00
< a href = "https://echo.labstack.com" > < img height = "80" src = "https://cdn.labstack.com/images/echo-logo.svg" > < / a >
[![Sourcegraph ](https://sourcegraph.com/github.com/labstack/echo/-/badge.svg?style=flat-square )](https://sourcegraph.com/github.com/labstack/echo?badge)
[![GoDoc ](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square )](http://godoc.org/github.com/labstack/echo)
[![Go Report Card ](https://goreportcard.com/badge/github.com/labstack/echo?style=flat-square )](https://goreportcard.com/report/github.com/labstack/echo)
[![Build Status ](http://img.shields.io/travis/labstack/echo.svg?style=flat-square )](https://travis-ci.org/labstack/echo)
[![Codecov ](https://img.shields.io/codecov/c/github/labstack/echo.svg?style=flat-square )](https://codecov.io/gh/labstack/echo)
[![Join the chat at https://gitter.im/labstack/echo ](https://img.shields.io/badge/gitter-join%20chat-brightgreen.svg?style=flat-square )](https://gitter.im/labstack/echo)
[![Forum ](https://img.shields.io/badge/community-forum-00afd1.svg?style=flat-square )](https://forum.labstack.com)
[![Twitter ](https://img.shields.io/badge/twitter-@labstack-55acee.svg?style=flat-square )](https://twitter.com/labstack)
[![License ](http://img.shields.io/badge/license-mit-blue.svg?style=flat-square )](https://raw.githubusercontent.com/labstack/echo/master/LICENSE)
## Feature Overview
- Optimized HTTP router which smartly prioritize routes
- Build robust and scalable RESTful APIs
- Group APIs
- Extensible middleware framework
- Define middleware at root, group or route level
- Data binding for JSON, XML and form payload
- Handy functions to send variety of HTTP responses
- Centralized HTTP error handling
- Template rendering with any template engine
- Define your format for the logger
- Highly customizable
- Automatic TLS via Let’ s Encrypt
- HTTP/2 support
2018-11-18 09:55:05 -08:00
## Benchmarks
2018-08-06 12:47:05 -07:00
2018-11-18 09:55:05 -08:00
Date: 2018/03/15< br >
Source: https://github.com/vishr/web-framework-benchmark< br >
Lower is better!
< img src = "https://api.labstack.com/chart/bar?values=37223,55382,2985,5265|42013,59865,3350,6424&labels=Static,GitHub%20API,Parse%20API,Gplus%20API&titles=Echo,Gin&colors=lightseagreen,goldenrod&x_title=Routes&y_title=ns/op" >
2018-08-06 12:47:05 -07:00
## [Guide](https://echo.labstack.com/guide)
### Example
```go
package main
import (
"net/http"
"github.com/labstack/echo"
"github.com/labstack/echo/middleware"
)
func main() {
// Echo instance
e := echo.New()
// Middleware
e.Use(middleware.Logger())
e.Use(middleware.Recover())
// Routes
e.GET("/", hello)
// Start server
e.Logger.Fatal(e.Start(":1323"))
}
// Handler
func hello(c echo.Context) error {
return c.String(http.StatusOK, "Hello, World!")
}
```
## Help
- [Forum ](https://forum.labstack.com )
- [Chat ](https://gitter.im/labstack/echo )
## Contribute
**Use issues for everything**
- For a small change, just send a PR.
- For bigger changes open an issue for discussion before sending a PR.
- PR should have:
- Test case
- Documentation
- Example (If it makes sense)
- You can also contribute by:
- Reporting issues
- Suggesting new features or enhancements
- Improve/fix documentation
## Credits
- [Vishal Rana ](https://github.com/vishr ) - Author
- [Nitin Rana ](https://github.com/nr17 ) - Consultant
- [Contributors ](https://github.com/labstack/echo/graphs/contributors )
## License
[MIT ](https://github.com/labstack/echo/blob/master/LICENSE )