vikunja-api/vendor/github.com/labstack/echo/v4/README.md

121 lines
3.7 KiB
Markdown
Raw Normal View History

2018-11-03 16:05:45 +01: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)
2019-05-07 21:42:24 +02:00
[![Codecov](https://img.shields.io/codecov/c/github/labstack/echo.svg?style=flat-square)](https://codecov.io/gh/labstack/echo)
2018-11-03 16:05:45 +01:00
[![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)
2018-06-10 11:11:41 +02:00
2019-05-07 21:42:24 +02:00
## Supported Go versions
As of version 4.0.0, Echo is available as a [Go module](https://github.com/golang/go/wiki/Modules).
Therefore a Go version capable of understanding /vN suffixed imports is required:
- 1.9.7+
- 1.10.3+
- 1.11+
Any of these versions will allow you to import Echo as `github.com/labstack/echo/v4` which is the recommended
way of using Echo going forward.
For older versions, please use the latest v3 tag.
2018-06-10 11:11:41 +02:00
## 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 Lets Encrypt
- HTTP/2 support
2018-11-03 16:05:45 +01:00
## Benchmarks
Date: 2018/03/15<br>
Source: https://github.com/vishr/web-framework-benchmark<br>
Lower is better!
2019-03-24 10:13:40 +01:00
<img src="https://i.imgur.com/I32VdMJ.png">
2018-11-03 16:05:45 +01:00
## [Guide](https://echo.labstack.com/guide)
### Installation
```go
// go get github.com/labstack/echo/{version}
go get github.com/labstack/echo/v4
```
2018-11-03 16:05:45 +01:00
### Example
```go
package main
import (
2019-06-22 23:51:58 +02:00
"net/http"
"github.com/labstack/echo/v4"
"github.com/labstack/echo/v4/middleware"
2018-11-03 16:05:45 +01:00
)
func main() {
2019-06-22 23:51:58 +02:00
// Echo instance
e := echo.New()
2018-11-03 16:05:45 +01:00
2019-06-22 23:51:58 +02:00
// Middleware
e.Use(middleware.Logger())
e.Use(middleware.Recover())
2018-11-03 16:05:45 +01:00
2019-06-22 23:51:58 +02:00
// Routes
e.GET("/", hello)
2018-06-10 11:11:41 +02:00
2019-06-22 23:51:58 +02:00
// Start server
e.Logger.Fatal(e.Start(":1323"))
2018-11-03 16:05:45 +01:00
}
2018-06-10 11:11:41 +02:00
2018-11-03 16:05:45 +01:00
// Handler
func hello(c echo.Context) error {
2019-06-22 23:51:58 +02:00
return c.String(http.StatusOK, "Hello, World!")
2018-11-03 16:05:45 +01:00
}
```
2018-06-10 11:11:41 +02:00
2018-11-03 16:05:45 +01:00
## Help
2018-06-10 11:11:41 +02:00
2018-11-03 16:05:45 +01:00
- [Forum](https://forum.labstack.com)
- [Chat](https://gitter.im/labstack/echo)
2018-06-10 11:11:41 +02:00
## 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
2019-05-07 21:42:24 +02:00
2018-06-10 11:11:41 +02:00
- [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)