1
0
mirror of https://github.com/labstack/echo.git synced 2024-11-24 08:22:21 +02:00
High performance, minimalist Go web framework https://echo.labstack.com/
Go to file
Yusuf Eyisan 124825ee62
Bugfix/1834 Fix X-Real-IP bug (#2007)
* Fix incorrect return ip value for RealIpHeader
* Improve test file to compare correct real IPs to each other and have better comments
* Refactor ip extractor tests to be more readable (longer but readable)

Co-authored-by: toimtoimtoim <desinformatsioon@gmail.com>
2022-03-01 08:56:46 +01:00
_fixture Fix Echo.Serve() will not serve on HTTP port correctly when there is already TLSListener set to Echo instance. (#1785) (#1793) 2021-02-28 19:13:04 +01:00
.github Create FUNDING.yml 2021-10-06 21:47:37 -07:00
middleware JWT, KeyAuth, CSRF multivalue extractors (#2060) 2022-01-24 22:03:45 +02:00
.editorconfig
.gitattributes
.gitignore adds middleware for rate limiting (#1724) 2021-01-15 17:53:15 -03:00
.travis.yml Update .travis.yml 2020-11-02 10:10:16 -05:00
bind_test.go feat: Bind data using headers as source (#1866) 2021-05-25 14:50:49 +02:00
bind.go Adding support for HEAD method query params binding (#2027) 2022-01-24 10:28:48 +01:00
binder_external_test.go Fluent Binder for Query/Path/Form binding (#1717) (#1736) 2021-01-08 00:43:38 +01:00
binder_go1.15_test.go Fluent Binder for Query/Path/Form binding (#1717) (#1736) 2021-01-08 00:43:38 +01:00
binder_test.go Fluent Binder for Query/Path/Form binding (#1717) (#1736) 2021-01-08 00:43:38 +01:00
binder.go improve code quality (#1792) 2021-02-26 12:04:34 +02:00
CHANGELOG.md Fix Echo version number which was not incremented with Release 4.6.2. Now bumped to 4.6.3 2022-01-10 21:51:37 +02:00
codecov.yml Adding Codecov configuration 2020-12-01 05:00:19 +00:00
context_fs_go1.16_test.go Improve filesystem support. 2022-01-24 15:55:16 +02:00
context_fs_go1.16.go improve comments 2022-01-24 15:55:16 +02:00
context_fs.go Improve filesystem support (Go 1.16+). Add field echo.Filesystem, methods: echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS. Following methods will use echo.Filesystem to server files: echo.File, echo.Static, group.File, group.Static, Context.File 2022-01-24 15:55:16 +02:00
context_test.go Split XFF header only by comma 2021-06-02 21:42:27 +03:00
context.go Improve filesystem support (Go 1.16+). Add field echo.Filesystem, methods: echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS. Following methods will use echo.Filesystem to server files: echo.File, echo.Static, group.File, group.Static, Context.File 2022-01-24 15:55:16 +02:00
echo_fs_go1.16_test.go Improve filesystem support. 2022-01-24 15:55:16 +02:00
echo_fs_go1.16.go Improve filesystem support. 2022-01-24 15:55:16 +02:00
echo_fs.go Improve filesystem support (Go 1.16+). Add field echo.Filesystem, methods: echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS. Following methods will use echo.Filesystem to server files: echo.File, echo.Static, group.File, group.Static, Context.File 2022-01-24 15:55:16 +02:00
echo_test.go remove redundant 0 in make chan (#2101) 2022-02-23 09:22:20 +02:00
echo.go Bugfix/1834 Fix X-Real-IP bug (#2007) 2022-03-01 08:56:46 +01:00
go.mod build: upgrade go directive in go.mod to 1.17 (#2049) 2022-01-24 17:09:49 +01:00
go.sum Improve filesystem support (Go 1.16+). Add field echo.Filesystem, methods: echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS. Following methods will use echo.Filesystem to server files: echo.File, echo.Static, group.File, group.Static, Context.File 2022-01-24 15:55:16 +02:00
group_fs_go1.16_test.go Improve filesystem support. 2022-01-24 15:55:16 +02:00
group_fs_go1.16.go Improve filesystem support. 2022-01-24 15:55:16 +02:00
group_fs.go Improve filesystem support (Go 1.16+). Add field echo.Filesystem, methods: echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS. Following methods will use echo.Filesystem to server files: echo.File, echo.Static, group.File, group.Static, Context.File 2022-01-24 15:55:16 +02:00
group_test.go Revert "Add a test" 2020-12-17 02:01:57 +02:00
group.go Improve filesystem support (Go 1.16+). Add field echo.Filesystem, methods: echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS. Following methods will use echo.Filesystem to server files: echo.File, echo.Static, group.File, group.Static, Context.File 2022-01-24 15:55:16 +02:00
ip_test.go Bugfix/1834 Fix X-Real-IP bug (#2007) 2022-03-01 08:56:46 +01:00
ip.go Bugfix/1834 Fix X-Real-IP bug (#2007) 2022-03-01 08:56:46 +01:00
json_test.go Allow for custom JSON encoding implementations (#1880) 2021-07-05 22:33:19 +03:00
json.go Allow for custom JSON encoding implementations (#1880) 2021-07-05 22:33:19 +03:00
LICENSE Create LICENSE 2021-04-17 12:47:48 -07:00
log.go the logging interface add SetHeader method (#1092) 2018-09-28 10:47:23 -07:00
Makefile Fix Echo.Serve() will not serve on HTTP port correctly when there is already TLSListener set to Echo instance. (#1785) (#1793) 2021-02-28 19:13:04 +01:00
README.md Add pagoda to the README. 2022-01-23 22:37:13 +02:00
response_test.go Add the ability to change the status code using Response beforeFuncs 2020-12-06 18:31:15 +03:30
response.go Add the ability to change the status code using Response beforeFuncs 2020-12-06 18:31:15 +03:30
router_test.go Allow header support in Router, MethodNotFoundHandler (405) and CORS middleware 2022-01-03 21:04:17 +02:00
router.go Minor syntax fixes (#1994) 2022-01-24 10:33:13 +01:00

Sourcegraph GoDoc Go Report Card Build Status Codecov Forum Twitter License

Supported Go versions

As of version 4.0.0, Echo is available as a Go module. Therefore a Go version capable of understanding /vN suffixed imports is required:

  • 1.9.7+
  • 1.10.3+
  • 1.14+

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.

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: 2020/11/11
Source: https://github.com/vishr/web-framework-benchmark
Lower is better!

The benchmarks above were run on an Intel(R) Core(TM) i7-6820HQ CPU @ 2.70GHz

Guide

Installation

// go get github.com/labstack/echo/{version}
go get github.com/labstack/echo/v4

Example

package main

import (
  "github.com/labstack/echo/v4"
  "github.com/labstack/echo/v4/middleware"
  "net/http"
)

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!")
}

Third-party middlewares

Repository Description
github.com/labstack/echo-contrib (by Echo team) casbin, gorilla/sessions, jaegertracing, prometheus, pprof, zipkin middlewares
deepmap/oapi-codegen Automatically generate RESTful API documentation with OpenAPI Client and Server Code Generator
github.com/swaggo/echo-swagger Automatically generate RESTful API documentation with Swagger 2.0.
github.com/ziflex/lecho Zerolog logging library wrapper for Echo logger interface.
github.com/brpaz/echozap Uber´s Zap logging library wrapper for Echo logger interface.
github.com/darkweak/souin/plugins/echo HTTP cache system based on Souin to automatically get your endpoints cached. It supports some distributed and non-distributed storage systems depending your needs.
github.com/mikestefanello/pagoda Rapid, easy full-stack web development starter kit built with Echo.

Please send a PR to add your own library here.

Help

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

License

MIT