add NeverDone function for package gctx that creates and returns a never done ctx (#2784)

contrib/drivers/mssql/mssql.go

@@ -7,9 +7,8 @@
 // Package mssql implements gdb.Driver, which supports operations for database MSSql.
 //
 // Note:
-// 1. It needs manually import: _ "github.com/denisenkom/go-mssqldb"
-// 2. It does not support Save/Replace features.
-// 3. It does not support LastInsertId.
+// 1. It does not support Save/Replace features.
+// 2. It does not support LastInsertId.
 package mssql
 
 import (

contrib/drivers/oracle/oracle.go

@@ -7,9 +7,8 @@
 // Package oracle implements gdb.Driver, which supports operations for database Oracle.
 //
 // Note:
-// 1. It needs manually import: _ "github.com/sijms/go-ora/v2"
-// 2. It does not support Save/Replace features.
-// 3. It does not support LastInsertId.
+// 1. It does not support Save/Replace features.
+// 2. It does not support LastInsertId.
 package oracle
 
 import (
@@ -19,7 +18,6 @@ import (
 	"strconv"
 	"strings"
 
-	"github.com/gogf/gf/v2/util/gutil"
 	gora "github.com/sijms/go-ora/v2"
 
 	"github.com/gogf/gf/v2/database/gdb"
@@ -28,6 +26,7 @@ import (
 	"github.com/gogf/gf/v2/text/gregex"
 	"github.com/gogf/gf/v2/text/gstr"
 	"github.com/gogf/gf/v2/util/gconv"
+	"github.com/gogf/gf/v2/util/gutil"
 )
 
 // Driver is the driver for oracle database.

contrib/drivers/pgsql/pgsql.go

@@ -7,8 +7,7 @@
 // Package pgsql implements gdb.Driver, which supports operations for database PostgreSQL.
 //
 // Note:
-// 1. It needs manually import: _ "github.com/lib/pq"
-// 2. It does not support Save/Replace features.
+// 1. It does not support Save/Replace features.
 package pgsql
 
 import (

contrib/drivers/sqlite/sqlite.go

@@ -7,8 +7,7 @@
 // Package sqlite implements gdb.Driver, which supports operations for database SQLite.
 //
 // Note:
-// 1. It needs manually import: _ "github.com/glebarez/go-sqlite"
-// 2. It does not support Save/Replace features.
+// 1. It does not support Save/Replace features.
 package sqlite
 
 import (
@@ -18,6 +17,7 @@ import (
 	"strings"
 
 	_ "github.com/glebarez/go-sqlite"
+
 	"github.com/gogf/gf/v2/database/gdb"
 	"github.com/gogf/gf/v2/encoding/gurl"
 	"github.com/gogf/gf/v2/errors/gcode"

net/ghttp/ghttp_request_param_ctx.go

@@ -8,32 +8,11 @@ package ghttp
 
 import (
 	"context"
-	"time"
 
 	"github.com/gogf/gf/v2/container/gvar"
 	"github.com/gogf/gf/v2/os/gctx"
 )
 
-// neverDoneCtx never done.
-type neverDoneCtx struct {
-	context.Context
-}
-
-// Done forbids the context done from parent context.
-func (*neverDoneCtx) Done() <-chan struct{} {
-	return nil
-}
-
-// Deadline forbids the context deadline from parent context.
-func (*neverDoneCtx) Deadline() (deadline time.Time, ok bool) {
-	return time.Time{}, false
-}
-
-// Err forbids the context done from parent context.
-func (c *neverDoneCtx) Err() error {
-	return nil
-}
-
 // RequestFromCtx retrieves and returns the Request object from context.
 func RequestFromCtx(ctx context.Context) *Request {
 	if v := ctx.Value(ctxKeyForRequest); v != nil {
@@ -72,7 +51,7 @@ func (r *Request) GetCtx() context.Context {
 // This change is considered for common usage habits of developers for context propagation
 // in multiple goroutines creation in one HTTP request.
 func (r *Request) GetNeverDoneCtx() context.Context {
-	return &neverDoneCtx{r.Context()}
+	return gctx.NeverDone(r.Context())
 }
 
 // SetCtx custom context for current request.

os/gctx/gctx_never_done.go

@@ -0,0 +1,38 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+package gctx
+
+import (
+	"context"
+	"time"
+)
+
+// neverDoneCtx never done.
+type neverDoneCtx struct {
+	context.Context
+}
+
+// Done forbids the context done from parent context.
+func (*neverDoneCtx) Done() <-chan struct{} {
+	return nil
+}
+
+// Deadline forbids the context deadline from parent context.
+func (*neverDoneCtx) Deadline() (deadline time.Time, ok bool) {
+	return time.Time{}, false
+}
+
+// Err forbids the context done from parent context.
+func (c *neverDoneCtx) Err() error {
+	return nil
+}
+
+// NeverDone wraps and returns a new context object that will be never done,
+// which forbids the context manually done, to make the context can be propagated to asynchronous goroutines.
+func NeverDone(ctx context.Context) context.Context {
+	return &neverDoneCtx{ctx}
+}

os/gctx/gctx_z_unit_internal_test.go

@@ -0,0 +1,38 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+package gctx_test
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"github.com/gogf/gf/v2/os/gctx"
+	"github.com/gogf/gf/v2/test/gtest"
+)
+
+func Test_NeverDone(t *testing.T) {
+	gtest.C(t, func(t *gtest.T) {
+		ctx, _ := context.WithDeadline(gctx.New(), time.Now().Add(time.Hour))
+		t.AssertNE(ctx, nil)
+		t.AssertNE(ctx.Done(), nil)
+		t.Assert(ctx.Err(), nil)
+
+		tm, ok := ctx.Deadline()
+		t.AssertNE(tm, time.Time{})
+		t.Assert(ok, true)
+
+		ctx = gctx.NeverDone(ctx)
+		t.AssertNE(ctx, nil)
+		t.Assert(ctx.Done(), nil)
+		t.Assert(ctx.Err(), nil)
+
+		tm, ok = ctx.Deadline()
+		t.Assert(tm, time.Time{})
+		t.Assert(ok, false)
+	})
+}