[POLL] Iris + Go Modules (Import path suffix or not)

[kataras]

Hello Iris Community,

As you know the Go Team released the go modules.

There are two opened issues:

• go.mod missing /v11 at the end of the module directive
• sessions/sessiondb/badger package not compatible with badger v1.6.0

I would like to have your opinion on a serious subject about the import path. There are two ways to fix the above.

The first one is to keep the same import path and do:

$ go get github.com/kataras/iris@master

This will add a pseudo-version inside your project's go.mod:

require (
        github.com/kataras/iris v0.0.0-20191005193354-55afd07befa8
)

The import paths inside your program should look like that:

package mypackage

import "github.com/kataras/iris"
import "github.com/iris-contrib/middleware/cloudwatch"

However, tools like go mod tidy or if someone tried go get github.com/kataras/iris@v11.2.8 will fail after go 1.13 because it does not contain the version suffix.

The second solution one is to increment the major version, replace and keep updating all import paths inside Iris and iris-contrib/middleware, iris-contrib/examples and e.t.c. to github.com/kataras/iris/v12 (see the version suffix, which can be a git branch or tag of this repository).

$ go get github.com/kataras/iris@v12

This should download the latest tagged version of v12.

The go.mod can look like that:

require(
    github.com/kataras/iris v12.0.0
)

package mypackage

import "github.com/kataras/iris/v12"
import "github.com/iris-contrib/middleware/cloudwatch/v12"
// [...]

There are several downsides of changing the import path, as it is a huge breaking change but in the same time it's the standard Go's way nowadays.

---

Please think of it and vote up what you would like to happen here.

Yours,
Gerasimos Maropoulos, Author of Iris.

[kataras]

People have spoken, after 23 days, poll comes to its end. Thank you all so much for your interest and your contribution.

The next release of Iris will be used as import "github.com/kataras/iris/v12" , go get github.com/kataras/iris/v12@v12.0.1 and require github.com/kataras/iris/v12 v12.0.1 inside go.mod. The installation section, examples and middleware repositories are updated too.