echo's Introduction

NOTICE

Master branch, website and godoc now points to Echo v2.
It is advisable to migrate to v2. (https://labstack.com/echo/guide/migrating)
Looking for v1?
- Installation: Use a package manager (https://github.com/Masterminds/glide, it's nice!) to get stable v1 release/commit or use go get gopkg.in/labstack/echo.v1.
- Godoc: https://godoc.org/gopkg.in/labstack/echo.v1
- Docs: https://github.com/labstack/echo/tree/v1.3/website/content

Echo

A fast and unfancy micro web framework for Go.

Features

Fast HTTP router which smartly prioritize routes.
Run with standard HTTP server or FastHTTP server.
Extensible middleware framework.
Router groups with nesting.
Handy functions to send variety of HTTP responses.
Centralized HTTP error handling.
Template rendering with any template engine.

Performance

Based on [vishr/go-http-routing-benchmark] (https://github.com/vishr/go-http-routing-benchmark), June 5, 2015.

Getting Started

Installation

$ go get github.com/labstack/echo

Hello, World!

Create main.go

package main

import (
	"net/http"

	"github.com/labstack/echo"
	"github.com/labstack/echo/engine/standard"
	"github.com/labstack/echo/middleware"
)

// Handler
func hello() echo.HandlerFunc {
	return func(c echo.Context) error {
		return c.String(http.StatusOK, "Hello, World!\n")
	}
}

func main() {
	// Echo instance
	e := echo.New()

	// Middleware
	e.Use(middleware.Logger())
	e.Use(middleware.Recover())

	// Routes
	e.Get("/", hello())

	// Start server
	e.Run(standard.New(":1323"))
}