feat: Add Debug and Fatal logging methods to the logger interface and implementation

Author: ayberkgezer

README.md

@@ -41,6 +41,8 @@ import (
 )
 
 func main() {
+	gocolorlog.Debug("Starting debug mode")
+	gocolorlog.Debugf("Debug info: %s", "application initialization")
 	gocolorlog.Info("Starting application")
 	gocolorlog.Infof("Listening on port %d", 8080)
 	gocolorlog.Warn("Cache miss for key user:123")
@@ -53,11 +55,16 @@ func main() {
 	gocolorlog.HTTP(500, "DELETE", "/api/error", 200*time.Millisecond,"ip-adress", "Requsetid",fmt.Errorf("internal server error"))
 
 	gocolorlog.ContextLevel("INFO", "Bootstrap", "Application is running on: %s", "http://localhost:3000")
+
+	gocolorlog.Fatal("Critical error system shutdown")
+	gocolorlog.Fatalf("Critical error: %v", fmt.Errorf("system failure"))
 }
 ```
 
 **Sample Output:**
 ```
+[Log] 16639 - 2025-05-25 00:44:02  DEBUG [App] Starting debug mode
+[Log] 16639 - 2025-05-25 00:44:02  DEBUG [App] Debug info: application initialization
 [Log] 12345 - 2025-05-15 12:34:56  [INFO ] [App] Starting application
 [Log] 12345 - 2025-05-15 12:34:56  [INFO ] [App] Listening on port 8080
 [Log] 12345 - 2025-05-15 12:34:56  [WARN ] [App] Cache miss for key user:123
@@ -68,6 +75,8 @@ func main() {
 [Log] 62388 - 2025-05-16 21:29:01  HTTP  [404] POST | /api/notfound | 80ms - 80ms | RequestID: 71g261g61 |192.168.1.1 |
 [Log] 62388 - 2025-05-16 21:29:01  HTTP  [500] DELETE | /api/error | 200ms - 200ms | 192.168.1.1 | RequestID: 71g261g61 | [Error]: internal server error
 [Log] 12345 - 2025-05-15 12:34:56  [INFO ] [Bootstrap] Application is running on: http://localhost:3000
+
+[Log] 16639 - 2025-05-25 00:44:02  FATAL [App] Critical error occurred - shutting down
 ```
 *(Colors will be visible in a terminal that supports ANSI colors.)*
 
@@ -79,6 +88,8 @@ func main() {
 
 ```go
 type Logger interface {
+	Debug(msg string)
+	Debugf(format string, args ...any)
     Info(msg string)
     Infof(format string, args ...any)
     Warn(msg string)
@@ -87,16 +98,20 @@ type Logger interface {
     Errorf(format string, args ...any)
     HTTP(status int, method, path string, latency time.Duration, ip string, requestID string, err error)
     ContextLevel(level, context, msg string, args ...any)
+	Fatal(msg string)
+	Fatalf(format string, args ...any)
 }
 ```
 
 #### Method Descriptions
 
+- **Debug / Debugf**: Debug mod log
 - **Info / Infof**: Log informational messages.
 - **Warn / Warnf**: Log warnings.
 - **Error / Errorf**: Log errors.
 - **HTTP**: Log HTTP requests with status, method, path, latency, and optional error.
 - **ContextLevel**: Log with a custom level and context.
+- **Fatal / Fatalf**: Log critical errors and exit the application.
 
 ---
 

colorlog.go

@@ -12,6 +12,10 @@ import (
 // Logger is the extensible logging interface for gocolorlog.
 // You can implement this interface to customize logging behavior.
 type Logger interface {
+	// Debug logs a debug message.
+	Debug(msg string)
+	// Debugf logs a formatted debug message.
+	Debugf(format string, args ...any)
 	// Info logs an informational message.
 	Info(msg string)
 	// Infof logs a formatted informational message.
@@ -24,6 +28,10 @@ type Logger interface {
 	Error(msg string)
 	// Errorf logs a formatted error message.
 	Errorf(format string, args ...any)
+	// Fatal logs a fatal error message and exits the application.
+	Fatal(msg string)
+	// Fatalf logs a formatted fatal error message and exits the application.
+	Fatalf(format string, args ...any)
 	// HTTP logs an HTTP request with status, method, path, latency, and optional error.
 	HTTP(status int, method, path string, latency time.Duration, ip string, requestID string, err error)
 	// Context logs a message with a custom level and context.
@@ -40,6 +48,22 @@ func SetLogger(l Logger) {
 	}
 }
 
+// Debug logs a debug message using the default logger.
+func Debug(msg string) { defaultLogger.Debug(msg) }
+
+// Debugf logs a formatted debug message using the default logger.
+func Debugf(format string, args ...any) { defaultLogger.Debugf(format, args...) }
+
+// Fatal logs a fatal error message using the default logger and exits the application.
+func Fatal(msg string) {
+	defaultLogger.Fatal(msg)
+}
+
+// Fatalf logs a formatted fatal error message using the default logger and exits the application.
+func Fatalf(format string, args ...any) {
+	defaultLogger.Fatalf(format, args...)
+}
+
 // Info logs an informational message using the default logger.
 func Info(msg string) { defaultLogger.Info(msg) }
 

internal/level/level.go

@@ -11,4 +11,6 @@ const (
 	Warn  Level = "WARN"  // WARN
 	Error Level = "ERROR" // ERROR
 	HTTP  Level = "HTTP"  // HTTP
+	Debug Level = "DEBUG" // DEBUG
+	Fatal Level = "FATAL" // FATAL
 )

internal/logger/stdlogger.go

@@ -18,6 +18,13 @@ func NewStdLogger() *stdLogger {
 	return &stdLogger{l: log.New(os.Stdout, "", 0)}
 }
 
+func (s *stdLogger) Debug(msg string) {
+	s.Context(level.Debug, "App", "%s", msg)
+}
+func (s *stdLogger) Debugf(format string, args ...any) {
+	s.Context(level.Debug, "App", format, args...)
+}
+
 func (s *stdLogger) Info(msg string) {
 	s.Context(level.Info, "App", "%s", msg)
 }
@@ -37,11 +44,19 @@ func (s *stdLogger) Warnf(format string, args ...any) {
 func (s *stdLogger) Error(msg string) {
 	s.Context(level.Error, "App", "%s", msg)
 }
-
 func (s *stdLogger) Errorf(format string, args ...any) {
 	s.Context(level.Error, "App", format, args...)
 }
 
+func (s *stdLogger) Fatal(msg string) {
+	s.Context(level.Fatal, "App", "%s", msg)
+	os.Exit(1)
+}
+func (s *stdLogger) Fatalf(format string, args ...any) {
+	s.Context(level.Fatal, "App", format, args...)
+	os.Exit(1)
+}
+
 func (s *stdLogger) HTTP(status int, method, path string, latency time.Duration, ip string, requestID string, err error) {
 	lvl := level.HTTP
 	context := fmt.Sprintf("%d", status)
@@ -105,6 +120,10 @@ func colorForLevel(lvl level.Level) string {
 		return color.BrightRed
 	case level.HTTP:
 		return color.BrightCyan
+	case level.Debug:
+		return color.BrightBlue
+	case level.Fatal:
+		return color.BgRed + color.White
 	default:
 		return color.White
 	}

main/main.go

@@ -9,11 +9,16 @@ import (
 )
 
 func main() {
-	// Varsayılan renkli logger ile kullanım:
+
+	gocolorlog.Debug("Starting debug mode")
+	gocolorlog.Debugf("Debug info: %s", "application initialization")
+
 	gocolorlog.Info("Starting application")
 	gocolorlog.Infof("Listening on port %d", 8080)
+
 	gocolorlog.Warn("Cache miss for key user:123")
 	gocolorlog.Warnf("Slow query: %s", "SELECT * FROM users")
+
 	gocolorlog.Error("Failed to connect to DB")
 	gocolorlog.Errorf("Failed to open file: %s", "config.yaml")
 
@@ -22,9 +27,12 @@ func main() {
 	gocolorlog.HTTP(500, "DELETE", "/api/error", 200*time.Millisecond, "192.168.1.1", "", errors.New("internal server error"))
 
 	gocolorlog.Info("Database connection: Successful")
+	gocolorlog.ContextLevel("DEBUG", "Bootstrap", "Loading configuration from: %s", "/etc/app/config.yaml")
 	gocolorlog.ContextLevel("INFO", "Bootstrap", "Application is running on: %s", "http://localhost:3000")
 	gocolorlog.ContextLevel("INFO", "Bootstrap", "Environment: %s", "development")
 	gocolorlog.HTTP(201, "POST", "/ai-chat", 6*time.Millisecond, "192.168.1.1", "", nil)
 	gocolorlog.ContextLevel("WARN", "Bootstrap", "Cache miss for key %s", "user:123")
 	gocolorlog.ContextLevel("ERROR", "Bootstrap", "Failed to connect to DB: %v", fmt.Errorf("timeout"))
+
+	gocolorlog.Fatal("Critical error occurred - shutting down")
 }