new-linter: ireturn (checks for function return type) (#2219)

test/testdata/configs/ireturn.yml

@@ -0,0 +1,4 @@
+linters-settings:
+  ireturn:
+    allow:
+    - IreturnAllowDoer

test/testdata/configs/ireturn_stdlib_reject.yml

@@ -0,0 +1,4 @@
+linters-settings:
+  ireturn:
+    reject:
+    - stdlib

test/testdata/ireturn_allow.go

@@ -0,0 +1,13 @@
+// args: -Eireturn
+// config_path: testdata/configs/ireturn.yml
+package testdata
+
+type (
+	IreturnAllowDoer interface{ Do() }
+	ireturnAllowDoer struct{}
+)
+
+func NewAllowDoer() IreturnAllowDoer { return new(ireturnAllowDoer) }
+func (d *ireturnAllowDoer) Do()      { /*...*/ }
+
+func NewerAllowDoer() *ireturnAllowDoer { return new(ireturnAllowDoer) }

test/testdata/ireturn_default.go

@@ -0,0 +1,12 @@
+// args: -Eireturn
+package testdata
+
+type (
+	IreturnDoer interface{ Do() }
+	ireturnDoer struct{}
+)
+
+func New() IreturnDoer     { return new(ireturnDoer) } // ERROR `New returns interface \(command-line-arguments.IreturnDoer\)`
+func (d *ireturnDoer) Do() { /*...*/ }
+
+func Newer() *ireturnDoer { return new(ireturnDoer) }

test/testdata/ireturn_reject_stdlib.go

@@ -0,0 +1,28 @@
+// args: -Eireturn
+// config_path: testdata/configs/ireturn_stdlib_reject.yml
+package testdata
+
+import (
+	"bytes"
+	"io"
+)
+
+func NewWriter() io.Writer { // ERROR `NewWriter returns interface \(io.Writer\)`
+	var buf bytes.Buffer
+	return &buf
+}
+
+func TestError() error {
+	return nil
+}
+
+type Foo interface {
+	Foo()
+}
+type foo int
+
+func (f foo) Foo() {}
+
+func NewFoo() Foo {
+	return foo(1)
+}