The fastest HTTP/2 Go Web Framework. New, modern and easy to learn. Fast development with Code you control. Unbeatable cost-performance ratio 🚀
Go to file
2016-06-16 00:17:23 +03:00
config Fix https://github.com/kataras/iris/issues/175#issuecomment-226290922 2016-06-16 00:13:56 +03:00
context Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
errors Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
graceful Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
iris Add screenshots for iris tool 2016-06-07 12:38:41 +03:00
logger Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
mail Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
middleware Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
plugin Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
render Embrace the feature request for per-party layout https://github.com/kataras/iris/issues/180 2016-06-14 20:29:01 +03:00
sessions Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
tests Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
utils Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
websocket Fix https://github.com/kataras/iris/issues/175#issuecomment-226290922 2016-06-16 00:13:56 +03:00
.gitignore Version 3.0.0-beta cleaned 2016-05-30 17:08:09 +03:00
.travis.yml Version 3.0.0-beta cleaned 2016-05-30 17:08:09 +03:00
context.go Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
DONATIONS.md Version 3.0.0-beta cleaned 2016-05-30 17:08:09 +03:00
HISTORY.md Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
http.go Fix https://github.com/kataras/iris/issues/175#issuecomment-226290922 2016-06-16 00:13:56 +03:00
initiatory.go Fix https://github.com/kataras/iris/issues/175#issuecomment-226290922 2016-06-16 00:13:56 +03:00
iris.go Embrace the feature request for per-party layout https://github.com/kataras/iris/issues/180 2016-06-14 20:29:01 +03:00
LICENSE Version 3.0.0-beta cleaned 2016-05-30 17:08:09 +03:00
plugin.go Update to 3.0.0-rc.1 - Read the HISTORY.md. Relative: #183 #184 #166 #176 #181 2016-06-14 08:45:40 +03:00
README.md Add FAQ link on readme 2016-06-16 00:17:23 +03:00
THIRDPARTY.md Version 3.0.0-beta cleaned 2016-05-30 17:08:09 +03:00

Iris Logo

Travis Widget Release Widget Report Widget License Widget Gitter Widget Documentation Widget

the fastest web framework for Go while providing robust set of features for building modern web applications.

Benchmark Wizzard Processing Time Horizontal Graph

$ cat main.go
package main

import  "github.com/kataras/iris"

func main() {
	iris.Get("/hi_json", func(c *iris.Context) {
		c.JSON(200, iris.Map{
			"Name": "Iris",
			"Age":  2,
		})
	})
	iris.Listen(":8080")
}

Learn about configuration and 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 & static, 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 editor
  • Content negotiation & streaming
  • Transport Layer Security
  • and much more

Docs & Community

  • Read the book or wiki

  • Take a look at the examples

  • If for some reason your old code doesn't runs, view the HISTORY

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

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.

Benchmark Wizzard Processing Time Horizontal Graph

Please click here to view all detailed benchmarks.

Testing

Iris suggests you to use this new suite to test your API. Httpexpect supports fasthttp & Iris after recommandation. Its author is very active so I believe its a promising library. You can view examples here and here.

Versioning

Current: v3.0.0-rc.1

Iris is an active project

Read more about Semantic Versioning 2.0.0

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.

If you're willing to donate click here

People

The author of Iris is @kataras

License

This project is licensed under the Apache License 2.0.

License can be found here.