|
|
||
|---|---|---|
| bindings | ||
| config | ||
| context | ||
| errors | ||
| graceful | ||
| iris | ||
| logger | ||
| middleware | ||
| npm | ||
| plugin | ||
| render | ||
| server | ||
| sessions | ||
| tests | ||
| utils | ||
| websocket | ||
| .gitignore | ||
| .travis.yml | ||
| branch.go | ||
| context_renderer.go | ||
| context_request.go | ||
| context_response.go | ||
| context_storage.go | ||
| context.go | ||
| DONATIONS.md | ||
| errors.go | ||
| handler.go | ||
| HISTORY.md | ||
| httperror.go | ||
| iris_singleton.go | ||
| iris.go | ||
| LICENSE | ||
| party.go | ||
| plugin.go | ||
| README.md | ||
| route.go | ||
| router.go | ||
| THIRDPARTY.md | ||
| tree.go | ||
$ 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
Features
- Focus on high performance
- Robust routing & 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
Docs & Community
If you'd like to discuss this package, or ask questions about it, feel free to
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.
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-beta.2
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.
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.