feat: [#495] Centralize Error Messages in Framework (PR#1)

contracts/errors/errors.go

@@ -0,0 +1,11 @@
+package errors
+
+// Error is the interface that wraps the basic error methods
+type Error interface {
+	// Args allows setting arguments for the placeholders in the text
+	Args(...any) Error
+	// Error implements the error interface and formats the error string
+	Error() string
+	// SetModule explicitly sets the module in the error message
+	SetModule(string) Error
+}

errors/errors.go

@@ -0,0 +1,63 @@
+package errors
+
+import (
+	"errors"
+	"fmt"
+
+	contractserrors "github.com/goravel/framework/contracts/errors"
+)
+
+type errorString struct {
+	text   string
+	module string
+	args   []any
+}
+
+// New creates a new error with the provided text and optional module
+func New(text string, module ...string) contractserrors.Error {
+	err := &errorString{
+		text: text,
+	}
+
+	if len(module) > 0 {
+		err.module = module[0]
+	}
+
+	return err
+}
+
+func (e *errorString) Args(args ...any) contractserrors.Error {
+	e.args = args
+	return e
+}
+
+func (e *errorString) Error() string {
+	formattedText := e.text
+
+	if len(e.args) > 0 {
+		formattedText = fmt.Sprintf(e.text, e.args...)
+	}
+
+	if e.module != "" {
+		formattedText = fmt.Sprintf("[%s] %s", e.module, formattedText)
+	}
+
+	return formattedText
+}
+
+func (e *errorString) SetModule(module string) contractserrors.Error {
+	e.module = module
+	return e
+}
+
+func Is(err, target error) bool {
+	return errors.Is(err, target)
+}
+
+func As(err error, target any) bool {
+	return errors.As(err, &target)
+}
+
+func Unwrap(err error) error {
+	return errors.Unwrap(err)
+}

errors/list.go

@@ -0,0 +1,12 @@
+package errors
+
+var (
+	ErrConfigFacadeNotSet = New("config facade is not initialized")
+	ErrJSONParserNotSet   = New("JSON parser is not initialized")
+
+	ErrSessionNotFound              = New("session [%s] not found")
+	ErrSessionDriverIsNotSet        = New("session driver is not set")
+	ErrSessionDriverNotSupported    = New("session driver [%s] not supported")
+	ErrSessionDriverAlreadyExists   = New("session driver [%s] already exists")
+	ErrSessionDriverExtensionFailed = New("failed to extend session [%s] driver [%v]")
+)

errors/modules.go

@@ -0,0 +1,5 @@
+package errors
+
+var (
+	ModuleSession = "session"
+)

session/driver/file.go

@@ -1,11 +1,11 @@
 package driver
 
 import (
-	"fmt"
 	"os"
 	"path/filepath"
 	"sync"
 
+	"github.com/goravel/framework/errors"
 	"github.com/goravel/framework/support/carbon"
 	"github.com/goravel/framework/support/file"
 )
@@ -80,7 +80,7 @@ func (f *File) Read(id string) (string, error) {
 		}
 	}
 
-	return "", fmt.Errorf("session [%s] not found", id)
+	return "", errors.ErrSessionNotFound.Args(id)
 }
 
 func (f *File) Write(id string, data string) error {