100 lines
3.3 KiB
Markdown
100 lines
3.3 KiB
Markdown
<a href="https://echo.labstack.com"><img height="80" src="https://cdn.labstack.com/images/echo-logo.svg"></a>
|
||
|
||
[](https://sourcegraph.com/github.com/labstack/echo?badge)
|
||
[](http://godoc.org/github.com/labstack/echo)
|
||
[](https://goreportcard.com/report/github.com/labstack/echo)
|
||
[](https://travis-ci.org/labstack/echo)
|
||
[](https://codecov.io/gh/labstack/echo)
|
||
[](https://gitter.im/labstack/echo)
|
||
[](https://forum.labstack.com)
|
||
[](https://twitter.com/labstack)
|
||
[](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
|
||
|
||
## Benchmarks
|
||
|
||
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">
|
||
|
||
## [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)
|