The fastest web framework for Go.

$ cat test_json.go

package main

import (
	"github.com/kataras/iris"
)

func main() {

	// render JSON
	iris.Get("/hi_json", func(c *iris.Context) {
		c.JSON(iris.StatusOK, iris.Map{
			"Name":  "Iris",
			"Born":  "13 March 2016",
			"Stars": 3404,
		})
	})
	iris.Listen(":8080")
}

Learn more about render.

Installation

The only requirement is Go 1.6

$ go get -u github.com/kataras/iris/iris

If you are connected to the Internet through China click here

FAQ

You can find answers by exploring these questions.

Features

• Focus on high performance
• Robust routing supports static and wildcard subdomains
• View system supporting 5+ template engines
• Highly scalable Websocket API with custom events
• Sessions support with GC, memory & redis providers
• Middlewares & Plugins were never be easier
• Full REST API
• Custom HTTP Errors
• Typescript compiler + Browser-based editor
• Content negotiation & streaming
• Transport Layer Security
• Reload on source code changes
• OAuth, OAuth2 supporting 27+ API providers
• JSON Web Tokens
• and more

Name	Description	Usage
Basicauth Middleware	HTTP Basic authentication	example 1, example 2, book section
JWT Middleware	JSON Web Tokens	example , book section
Cors Middleware	Cross Origin Resource Sharing W3 specification	how to use
Secure Middleware	Facilitates some quick security wins	example
I18n Middleware	Simple internationalization	example, book section
Recovery Middleware	Safety recover the station from panic	example
Logger Middleware	Logs every request	example, book section
Editor Plugin	Alm-tools, a typescript online IDE/Editor	book section
Typescript Plugin	Auto-compile client-side typescript files	book section
OAuth,OAuth2 Plugin	User Authentication was never be easier, supports >27 providers	example, book section
Iris control Plugin	Basic (browser-based) control over your Iris station	example, book section

Docs & Community

• Read the book or wiki

• Take a look at the examples

• HISTORY file is your friend.

If you'd like to discuss this package, or ask questions about it, feel free to

• Post an issue or idea here
• Chat with us

Open debates

• Contribute: New website and logo for Iris
• E-book Cover - Which one you suggest?
• Feature request: session.Exists

TIP Be sure to read the history for Migrating from 2.x to 3.x.

Philosophy

The Iris philosophy is to provide robust tooling for HTTP, making it a great solution for single page applications, web sites, hybrids, or public HTTP APIs.

Iris does not force you to use any specific ORM or template engine. With support for the most used template engines, you can quickly craft the perfect application.

Benchmarks

This Benchmark suite aims to compare the whole HTTP request processing between Go web frameworks.

Please click here to view all detailed benchmarks.

Testing

Tests are located to the iris-contrib/tests repository, community should write some code there! I recommend writing your API tests using this new library, httpexpect which supports Iris and fasthttp now, after my request here.

Versioning

Current: v3.0.0-rc.3

Iris is an active project

Read more about Semantic Versioning 2.0.0

• http://semver.org/
• https://en.wikipedia.org/wiki/Software_versioning
• https://wiki.debian.org/UpstreamGuide#Releases_and_Versions

Todo

for the next release 'v3'

• Dynamic/Wildcard subdomains.
• Create server & client side (js) library for .on('event', func action(...)) / .emit('event')... (like socket.io but supports only websocket).
• Find and provide support for the most stable template engine and be able to change it via the configuration, keep html/templates support.
• Extend, test and publish to the public the Iris' cmd.
• Route naming and html url func, requested here.
• Move middleware & plugins to other repository

If you're willing to donate click here!

People

A big thanks goes to all people who help building this framework with feature-requests & bug reports!

The author of Iris is @kataras.

Contributing

If you are interested in contributing to the Iris project, please see the document CONTRIBUTING.

License

This project is licensed under the Apache License 2.0.

License can be found here.