From 7d3e2ae290a05c4952631c12a83d34685545e2bc Mon Sep 17 00:00:00 2001 From: "Gerasimos (Makis) Maropoulos" Date: Wed, 27 Sep 2017 17:00:34 +0300 Subject: [PATCH] Update to version 8.4.3 Former-commit-id: ca3e87f77855424f1d50fa871741dac53375cb63 --- HISTORY.md | 9 ++++++ README.md | 87 +++++++++++++++++++++++++++--------------------------- VERSION | 2 +- doc.go | 2 +- faq.md | 12 ++++++++ iris.go | 2 +- 6 files changed, 67 insertions(+), 47 deletions(-) diff --git a/HISTORY.md b/HISTORY.md index 7f6968b5..721aa5b4 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -18,6 +18,15 @@ Developers are not forced to upgrade if they don't really need it. Upgrade whene **How to upgrade**: Open your command-line and execute this command: `go get -u github.com/kataras/iris`. + +# We, 27 September 2017 | v8.4.3 + +- MVC: Support for `ByBy` syntax as requested at https://github.com/kataras/iris/issues/751 +- Fix https://github.com/kataras/iris/issues/760 +- @itcrow fixed https://github.com/kataras/iris/issues/757 with PR: https://github.com/kataras/iris/pull/758 +- @balthild fixed https://github.com/kataras/iris/issues/764 with PR: https://github.com/kataras/iris/pull/765 +- Add a new session database(back-end storage) supported by the [badger](github.com/dgraph-io/badger) key-value file-based storage, example [here](https://github.com/kataras/iris/commit/204f8474687bad1178d5108b501c6f0c7d927b9a#diff-26d58a00b7f90165fb32043676ed17a5) + # Fr, 15 September 2017 | v8.4.2 ## MVC diff --git a/README.md b/README.md index 6f74d85b..5933687c 100644 --- a/README.md +++ b/README.md @@ -39,7 +39,7 @@ Iris may have reached version 8, but we're not stopping there. We have many feat ### 📑 Table of contents * [Installation](#-installation) -* [Latest changes](https://github.com/kataras/iris/blob/master/HISTORY.md#fr-15-september-2017--v842) +* [Latest changes](https://github.com/kataras/iris/blob/master/HISTORY.md#we-27-september-2017--v843) * [Learn](#-learn) * [HTTP Listening](_examples/#http-listening) * [Configuration](_examples/#configuration) @@ -136,28 +136,6 @@ $ go run main.go > Application started. Press CTRL+C to shut down. ``` -### 💎 Type aliases - -Go version 1.9 introduced the [type alias](https://golang.org/doc/go1.9#language) feature. - -Iris uses the `type alias` feature to help you writing less code by omitting some package imports. The examples and documentation are written using Go 1.9 as well. - -If you build your Go app with Go 1.9 you can, optionally, use all Iris web framework's features by importing one single package, the `github.com/kataras/iris`. - -Available type aliases; - - -| Go 1.8 | Go 1.8 usage | Go 1.9 (Optionally) | Go 1.9 usage | -| -----------|--------|--------|--------| -| `import "github.com/kataras/iris/context"` | `func(context.Context) {}`, `context.Handler`, `context.Map` | `import "github.com/kataras/iris"` | `func(iris.Context) {}`, `iris.Handler`, `iris.Map` | -| `import "github.com/kataras/iris/mvc"` | `type MyController struct { mvc.Controller }` , `mvc.SessionController` | `import "github.com/kataras/iris"` | `type MyController struct { iris.Controller }`, `iris.SessionController` | -| `import "github.com/kataras/iris/core/router"` | `app.PartyFunc("/users", func(p router.Party) {})` | `import "github.com/kataras/iris"` | `app.PartyFunc("/users", func(p iris.Party) {})` | -| `import "github.com/kataras/iris/core/host"` | `app.ConfigureHost(func(s *host.Supervisor) {})` | `import "github.com/kataras/iris"` | `app.ConfigureHost(func(s *iris.Supervisor) {})` | - -You can find all type aliases and their original package import statements at the [./context.go file](context.go). - -> Remember; this doesn't mean that you have to use those type alias, you can continue import the original packages as you did with Go version 1.8. -
Hello World with Go 1.8 @@ -259,47 +237,47 @@ The same day, later the night, I was reading a book about Greek mythology. I saw [![](http://comments.iris-go.com/screens/comment37.png)](https://twitter.com/ThePracticalDev/status/892022594031017988) -![](https://docs.iris-go.com/comment36.png) +![](https://comments.iris-go.com/comment36.png) -![](https://docs.iris-go.com/comment35.png) +![](https://comments.iris-go.com/comment35.png) -![](https://docs.iris-go.com/comment34.png) +![](https://comments.iris-go.com/comment34.png) -![](https://docs.iris-go.com/comment2.png) +![](https://comments.iris-go.com/comment2.png) -![](https://docs.iris-go.com/comment30.png) +![](https://comments.iris-go.com/comment30.png) -![](https://docs.iris-go.com/comment31.png) +![](https://comments.iris-go.com/comment31.png) -![](https://docs.iris-go.com/comment32.png) +![](https://comments.iris-go.com/comment32.png) -![](https://docs.iris-go.com/comment33.png) +![](https://comments.iris-go.com/comment33.png) -![](https://docs.iris-go.com/comment26.png) +![](https://comments.iris-go.com/comment26.png) -![](https://docs.iris-go.com/comment1.png) +![](https://comments.iris-go.com/comment1.png) -![](https://docs.iris-go.com/comment3.png) +![](https://comments.iris-go.com/comment3.png) -![](https://docs.iris-go.com/comment8.png) +![](https://comments.iris-go.com/comment8.png) -![](https://docs.iris-go.com/comment12.png) +![](https://comments.iris-go.com/comment12.png) -![](https://docs.iris-go.com/comment13.png) +![](https://comments.iris-go.com/comment13.png) -![](https://docs.iris-go.com/comment14.png) +![](https://comments.iris-go.com/comment14.png) -![](https://docs.iris-go.com/comment17.png) +![](https://comments.iris-go.com/comment17.png) -![](https://docs.iris-go.com/comment21.png) +![](https://comments.iris-go.com/comment21.png) -![](https://docs.iris-go.com/comment22.png) +![](https://comments.iris-go.com/comment22.png) -![](https://docs.iris-go.com/comment24.png) +![](https://comments.iris-go.com/comment24.png) -![](https://docs.iris-go.com/comment27.png) +![](https://comments.iris-go.com/comment27.png) ----- +---- _iris_ is easy, it has a familiar API while in the same has far more features than [Gin](https://github.com/gin-gonic/gin) or [Martini](https://github.com/go-martini/martini). @@ -356,6 +334,27 @@ Compared to the rest open source projects, this one is very active and you get a
+### 💎 Type aliases + +Go version 1.9 introduced the [type alias](https://golang.org/doc/go1.9#language) feature. + +Iris uses the `type alias` feature to help you writing less code by omitting some package imports. The examples and documentation are written using Go 1.9 as well. + +If you build your Go app with Go 1.9 you can, optionally, use all Iris web framework's features by importing one single package, the `github.com/kataras/iris`. + +Available type aliases; + +| Go 1.8 | Go 1.8 usage | Go 1.9 usage (optionally) | +| -----------|--------|--------|--------| +| `import "github.com/kataras/iris/context"` | `func(context.Context) {}`, `context.Handler`, `context.Map` | `func(iris.Context) {}`, `iris.Handler`, `iris.Map` | +| `import "github.com/kataras/iris/mvc"` | `type MyController struct { mvc.Controller }` , `mvc.SessionController` | `type MyController struct { iris.Controller }`, `iris.SessionController` | +| `import "github.com/kataras/iris/core/router"` | `app.PartyFunc("/users", func(p router.Party) {})` | `app.PartyFunc("/users", func(p iris.Party) {})` | +| `import "github.com/kataras/iris/core/host"` | `app.ConfigureHost(func(s *host.Supervisor) {})` | `app.ConfigureHost(func(s *iris.Supervisor) {})` | + +You can find all type aliases and their original package import statements at the [./context.go file](context.go). + +> Remember; this doesn't mean that you have to use those type alias, you can continue import the original packages as you did with Go version 1.8. + ### 📖 Learn diff --git a/VERSION b/VERSION index 0d2d877f..dc2b077a 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -8.4.2:https://github.com/kataras/iris/blob/master/HISTORY.md#fr-15-september-2017--v842 \ No newline at end of file +8.4.3:https://github.com/kataras/iris/blob/master/HISTORY.md#we-27-september-2017--v843 \ No newline at end of file diff --git a/doc.go b/doc.go index c363585c..c4b50c24 100644 --- a/doc.go +++ b/doc.go @@ -35,7 +35,7 @@ Source code and other details for the project are available at GitHub: Current Version -8.4.2 +8.4.3 Installation diff --git a/faq.md b/faq.md index 37040c7f..0962745d 100644 --- a/faq.md +++ b/faq.md @@ -20,6 +20,18 @@ More than 50 practical examples, tutorials and articles at: Want to help and join to the greatest community? Describe your skills and push your own sections at: https://github.com/kataras/build-a-better-web-together/issues/new +### common errors that new gophers may meet + +#### type aliases + +| build error | reason | solution | +| -----------|--------|--------|--------| +| `undefinied iris.Context` | caused of using the **optional type alias** `iris.Context` instead of the `context.Context` when building with Go 1.8 | import the original package `github.com/kataras/iris/context` and declare as `func(context.Context){})` **or** download and install the [latest go version](https://golang.org/dl) | + +Type alias is a new feature, introduced at Go version 1.9, so if you want to use Iris' type aliases you have to build using the latest Go version. Nothing really changes for your application if you use type alias or not, Iris' type aliases helps you to omit import statements -- to reduce lines of code, nothing more. + +> README.md has a section which helps you understand more about this new feature, [read it here](https://github.com/kataras/iris#-type-aliases). + ## Active development mode Iris may have reached version 8, but we're not stopping there. We have many feature ideas on our board that we're anxious to add and other innovative web development solutions that we're planning to build into Iris. diff --git a/iris.go b/iris.go index 6b33caa9..640ba22f 100644 --- a/iris.go +++ b/iris.go @@ -32,7 +32,7 @@ import ( const ( // Version is the current version number of the Iris Web Framework. - Version = "8.4.2" + Version = "8.4.3" ) // HTTP status codes as registered with IANA.