[![Iris Logo](http://iris-go.com/assets/iris_full_logo_2.png)](http://iris-go.com) [![Travis Widget]][Travis] [![Release Widget]][Release] [![Report Widget]][Report] [![License Widget]][License] [![Gitter Widget]][Gitter] [![Documentation Widget]][Documentation] [Travis Widget]: https://img.shields.io/travis/tmrts/boilr.svg?style=flat-square [Travis]: http://travis-ci.org/kataras/iris [License Widget]: https://img.shields.io/badge/license-Apache%20License%202.0-E91E63.svg?style=flat-square [License]: https://github.com/kataras/iris/blob/master/LICENSE [Release Widget]: https://img.shields.io/badge/release-v3.0.0--beta-blue.svg?style=flat-square [Release]: https://github.com/kataras/iris/releases [Gitter Widget]: https://img.shields.io/badge/chat-on%20gitter-00BCD4.svg?style=flat-square [Gitter]: https://gitter.im/kataras/iris [Report Widget]: https://img.shields.io/badge/report%20card-A%2B-F44336.svg?style=flat-square [Report]: http://goreportcard.com/report/kataras/iris [Documentation Widget]: https://img.shields.io/badge/documentation-reference-5272B4.svg?style=flat-square [Documentation]: https://www.gitbook.com/book/kataras/iris/details [Language Widget]: https://img.shields.io/badge/powered_by-Go-3362c2.svg?style=flat-square [Language]: http://golang.org [Platform Widget]: https://img.shields.io/badge/platform-Any--OS-gray.svg?style=flat-square Iris is 3 months baby which has succeeded to be the fastest go web framework that exists, so far, while providing a robust set of features for building web applications. - [why v3 has 1 commit ?](https://github.com/kataras/iris/issues/162) [![Benchmark Wizzard Processing Time Horizontal Graph](https://raw.githubusercontent.com/iris-contrib/website/cf71811e6acb2f9bf1e715e25660392bf090b923/assets/benchmark_horizontal_transparent.png)](#benchmarks) ```sh $ cat main.go ``` ```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](https://kataras.gitbooks.io/iris/content/configuration.html) and [render](https://kataras.gitbooks.io/iris/content/render.html). 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](https://kataras.gitbooks.io/iris/content/install.html) Features ------------ - Focus on high performance - Robust routing & subdomains - View system supporting [5+](https://kataras.gitbooks.io/iris/content/render_templates.html) 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 Docs & Community ------------ - Read the [book](https://www.gitbook.com/book/kataras/iris/details) or [wiki](https://github.com/kataras/iris/wiki) - Take a look at the [examples](https://github.com/iris-contrib/examples) If you'd like to discuss this package, or ask questions about it, feel free to * Post an issue or idea [here](https://github.com/kataras/iris/issues) * [Chat]( https://gitter.im/kataras/iris) with us Open debates - [E-book Cover - Which one you suggest?](https://github.com/kataras/iris/issues/67) **TIP** Be sure to read the [history](HISTORY.md) 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](https://github.com/smallnest/go-web-framework-benchmark) aims to compare the whole HTTP request processing between Go web frameworks. ![Benchmark Wizzard Processing Time Horizontal Graph](https://raw.githubusercontent.com/iris-contrib/website/cf71811e6acb2f9bf1e715e25660392bf090b923/assets/benchmark_horizontal_transparent.png) [Please click here to view all detailed benchmarks.](https://github.com/smallnest/go-web-framework-benchmark) Testing ------------ Iris suggests you to use [this](https://github.com/gavv/httpexpect) new suite to test your API. [Httpexpect](https://github.com/gavv/httpexpect) supports fasthttp & Iris after [recommandation](https://github.com/gavv/httpexpect/issues/2). Its author is very active so I believe its a promising library. You can view examples [here](https://github.com/gavv/httpexpect/blob/master/example/iris_test.go) and [here](https://github.com/kataras/iris/blob/master/tests/router_test.go). Versioning ------------ Current: **v3.0.0-beta** > 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' - [x] Create server & client side (js) library for .on('event', func action(...)) / .emit('event')... (like socket.io but supports only websocket). - [x] Find and provide support for the most stable template engine and be able to change it via the configuration, keep html/templates support. - [x] Extend, test and publish to the public the [Iris' cmd](https://github.com/kataras/iris/tree/master/iris). If you're willing to donate click [here](DONATIONS.md) People ------------ The author of Iris is [@kataras](https://github.com/kataras) License ------------ This project is licensed under the Apache License 2.0. License can be found [here](https://github.com/kataras/iris/blob/master/LICENSE).