You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Gerasimos (Makis) Maropoulos a3b5797e54
add a shortcut for ConfigureContainer().Use as UseFunc on Party
1 day ago
.github remove the 'retract' directive, as it's only available on the latest go release 2 weeks ago
_benchmarks Thanks @ky2s and @unixedia :heart: :heart: 8 months ago
_examples remove the 'retract' directive, as it's only available on the latest go release 2 weeks ago
apps add on-site documentation for the new 'apps' subpackage 9 months ago
cache add IsDebug() shortcut method 9 months ago
context New Context.FormFiles method 4 days ago
core add a shortcut for ConfigureContainer().Use as UseFunc on Party 1 day ago
hero dependency injection: func (...<T>) iris.Handler can be generated to a simple iris handler if <T> are static dependencies 1 day ago
httptest Add Strict option to httptest as requested at: #1722 3 months ago
i18n :) 5 months ago
macro minor: see previous commits 3 months ago
middleware minor test fix 3 months ago
mvc godoc: minor 1 month ago
sessions :) 5 months ago
versioning minor 5 months ago
view upgrade jet parser to version 6 as requested 4 months ago
websocket (#1554) Add support for all common compressions (write and read) 11 months ago
.deepsource.toml Merge branch 'master' into master 5 months ago
.fossa.yml Add the new websocket package (which is just a helper for kataras/neffos) and an example for go server, client, browser client and nodejs client. Add a .fossa.yml and the generated NOTICE file for 3rd-party libs. Update go.mod, go.sum. Update the vendor folder for pongo2 to its latest master as well 2 years ago
.gitattributes minor 1 year ago
.gitignore upgrade dependencies 3 months ago
AUTHORS Update to version 8.5.5 | Read HISTORY.md 3 years ago
CODE_OF_CONDUCT.md Update to version 8.5.5 | Read HISTORY.md 3 years ago
CONTRIBUTING.md update faq, contributing and go workflow 1 year ago
FAQ.md FAQ: minor 10 months ago
HISTORY.md New Context.FormFiles method 4 days ago
HISTORY_ES.md reorganization of _examples and add some new examples such as iris+groupcache+mysql+docker 1 year ago
LICENSE minor: typo 5 months ago
NOTICE API versioning improvements 5 months ago
README.md Thanks @paulxu21 @DavidShaw @lingyingtan and @Laotanling for your kind donations :heart: 1 month ago
README_ES.md minor 3 months ago
README_FA.md minor 3 months ago
README_FR.md minor 3 months ago
README_GR.md minor 3 months ago
README_KO.md minor 3 months ago
README_RU.md minor 3 months ago
README_ZH.md minor 3 months ago
VERSION accesslog middleware: add total bytes received and sent 9 months ago
aliases.go respect the iris.WithEmptyFormError option on Context.ReadQuery too 3 months ago
cli.go :) 5 months ago
configuration.go respect the iris.WithEmptyFormError option on Context.ReadQuery too 3 months ago
configuration_test.go Add Configuration.RemoteAddrHeadersForce as requested at #1567 and change RemoteAddrHeaders from map to string slice 10 months ago
doc.go implement #1536 with (SetRegisterRule(iris.RouteOverlap)) 1 year ago
go.mod replace snappy dependency 2 weeks ago
go.sum replace snappy dependency 2 weeks ago
iris.go New iris.WithKeepAlive(time.Duration) Configurator is added as a helper to enable TCP listener featured with keep-alive 4 months ago

README.md

Black Lives Matter

News

This is the under-development branch. Stay tuned for the upcoming release v12.2.0. Looking for a stable release? Head over to the v12.1.8 branch instead.

Try the official Iris Command Line Interface today!

Due to the large workload, there may be delays in answering your questions.

Iris Web Framework

build status view examples chat donate

Iris is a fast, simple yet fully featured and very efficient web framework for Go.

It provides a beautifully expressive and easy to use foundation for your next website or API.

Simple Handler
package main

import "github.com/kataras/iris/v12"

type (
  request struct {
    Firstname string `json:"firstname"`
    Lastname  string `json:"lastname"`
  }

  response struct {
    ID      uint64 `json:"id"`
    Message string `json:"message"`
  }
)

func main() {
  app := iris.New()
  app.Handle("PUT", "/users/{id:uint64}", updateUser)
  app.Listen(":8080")
}

func updateUser(ctx iris.Context) {
  id, _ := ctx.Params().GetUint64("id")

  var req request
  if err := ctx.ReadJSON(&req); err != nil {
    ctx.StopWithError(iris.StatusBadRequest, err)
    return
  }

  resp := response{
    ID:      id,
    Message: req.Firstname + " updated successfully",
  }
  ctx.JSON(resp)
}

Read the routing examples for more!

Handler with custom input and output arguments

Interesting? Read the examples.

MVC
package main

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

type (
  request struct {
    Firstname string `json:"firstname"`
    Lastname  string `json:"lastname"`
  }

  response struct {
    ID      uint64 `json:"id"`
    Message string `json:"message"`
  }
)

func main() {
  app := iris.New()
  mvc.Configure(app.Party("/users"), configureMVC)
  app.Listen(":8080")
}

func configureMVC(app *mvc.Application) {
  app.Handle(new(userController))
}

type userController struct {
  // [...dependencies]
}

func (c *userController) PutBy(id uint64, req request) response {
  return response{
    ID:      id,
    Message: req.Firstname + " updated successfully",
  }
}

Want to see more? Navigate through mvc examples!

Learn what others saying about Iris and star this open-source project to support its potentials.

👑 Supporters

With your help, we can improve Open Source web development for everyone!

Donations from China are now accepted!

Paul Xu David Shaw Stone Travel Tan Andre Dias Rafael Francischini Heyuan Li Rainer Gevers Matic Zarnec Navid Dezashibi Sky Lee Richard Bondi Anthonius Prinslo Vladimir George Fourikis Александр Лебединский Li Yang Qianyu Zhou anilpdv CAO HOAI BAO Oscar Hernandez Gerard Lancea neulhan xushiquan Matt Ľuboš Pinteš Leighton McKeen Weliam simranjit singh Kenneth Jordan Morlé Koudeka Rui Carlos Augusto Horst Ender Pavithran MULYAWAN SENTOSA KIT UNITED Ricardo Hernandez Lopez ChinChuanKuo Nikhar Saxena Servio Zambrano Nate Anderson Claude Muller Marco Moeser Sanketh P B Vu Hoang Lam Dimitar Trifonov Midhubalan Balasubramanian AANAND NATARAJAN Edsongley Almeida ganben Tejus Pratap cui hexiang tinawang Juan David Parra Pimiento Andy Chong Ying Zhi Kevin Zhou Jasper Simranjit Singh Christopher Lamm 叶峻峣 TSAI LI TING zhutao George Alexiou Jobert Azares Tam Nguyen 
Venkatt Guhesan Anibal C C Budaye ARAN ROKA Valentine Chakravarthy Raghunandan Massimiliano Bertinetti Hieu Trinh J.T. Feng Gabor Lekeny LiHaotian Muyang Li Hao Tu Cetin Basoz Hazmi Amalul Rémy Deme Vincent Li Max Trense Matej Lach Joseph De Paola Damon Blais 陆 轶丰 Weihang Ding Li Fang TechMaster lenses.io Celso Souza Altafino Thomas Fritz Conrad Steenberg Damon Zhao George Opritescu Juanses Ankur Srivastava Lex Tang li3p

📖 Learning Iris

Create a new project

$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v12@master # or @v12.2.0-alpha2
Install on existing project
$ cd myapp
$ go get github.com/kataras/iris/v12@master
Install with a go.mod file
module myapp

go 1.16

require github.com/kataras/iris/v12 master

Run

$ go mod download
$ go run main.go
# OR just:
# go run -mod=mod main.go

Iris contains extensive and thorough documentation making it easy to get started with the framework.

For a more detailed technical documentation you can head over to our godocs. And for executable code you can always visit the ./_examples repository's subdirectory.

Do you like to read while traveling?

Book cover

follow author on twitter

follow Iris web framework on twitter

follow Iris web framework on facebook

You can request a PDF and online access of the Iris E-Book (New Edition, future v12.2.0+) today and be participated in the development of Iris.

🙌 Contributing

We'd love to see your contribution to the Iris Web Framework! For more information about contributing to the Iris project please check the CONTRIBUTING.md file.

List of all Contributors

🛡 Security Vulnerabilities

If you discover a security vulnerability within Iris, please send an e-mail to iris-go@outlook.com. All security vulnerabilities will be promptly addressed.

📝 License

This project is licensed under the BSD 3-clause license, just like the Go project itself.

The project name “Iris” was inspired by the Greek mythology.