From ef9d84e9b3d46ec3b1520d235295a78c586bdc11 Mon Sep 17 00:00:00 2001
From: Maxim Korolyov <mk@gojuno.com>
Date: Tue, 28 Aug 2018 18:13:29 +0300
Subject: [PATCH] Added trace log level.

---
 README.md |  3 ++-
 entry.go  | 34 +++++++++++++++++-----------------
 logrus.go |  3 +--
 3 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 072e99b..f088432 100644
--- a/README.md
+++ b/README.md
@@ -246,9 +246,10 @@ A list of currently known of service hook can be found in this wiki [page](https
 
 #### Level logging
 
-Logrus has six logging levels: Debug, Info, Warning, Error, Fatal and Panic.
+Logrus has seven logging levels: Trace, Debug, Info, Warning, Error, Fatal and Panic.
 
 ```go
+log.Trace("Something very low level.")
 log.Debug("Useful debugging information.")
 log.Info("Something noteworthy happened!")
 log.Warn("You should probably take a look at this.")
diff --git a/entry.go b/entry.go
index eb4ae5c..a76be76 100644
--- a/entry.go
+++ b/entry.go
@@ -23,9 +23,9 @@ func init() {
 var ErrorKey = "error"
 
 // An entry is the final or intermediate Logrus logging entry. It contains all
-// the fields passed with WithField{,s}. It's finally logged when Debug, Info,
-// Warn, Error, Fatal or Panic is called on it. These objects can be reused and
-// passed around as much as you wish to avoid field duplication.
+// the fields passed with WithField{,s}. It's finally logged when Trace, Debug,
+// Info, Warn, Error, Fatal or Panic is called on it. These objects can be
+// reused and passed around as much as you wish to avoid field duplication.
 type Entry struct {
 	Logger *Logger
 
@@ -35,11 +35,11 @@ type Entry struct {
 	// Time at which the log entry was created
 	Time time.Time
 
-	// Level the log entry was logged at: Debug, Info, Warn, Error, Fatal or Panic
+	// Level the log entry was logged at: Trace, Debug, Info, Warn, Error, Fatal or Panic
 	// This field will be set on entry firing and the value will be equal to the one in Logger struct field.
 	Level Level
 
-	// Message passed to Debug, Info, Warn, Error, Fatal or Panic
+	// Message passed to Trace, Debug, Info, Warn, Error, Fatal or Panic
 	Message string
 
 	// When formatter is called in entry.log(), a Buffer may be set to entry
@@ -162,18 +162,18 @@ func (entry *Entry) write() {
 	}
 }
 
-func (entry *Entry) Debug(args ...interface{}) {
-	if entry.Logger.IsLevelEnabled(DebugLevel) {
-		entry.log(DebugLevel, fmt.Sprint(args...))
-	}
-}
-
 func (entry *Entry) Trace(args ...interface{}) {
 	if entry.Logger.IsLevelEnabled(TraceLevel) {
 		entry.log(TraceLevel, fmt.Sprint(args...))
 	}
 }
 
+func (entry *Entry) Debug(args ...interface{}) {
+	if entry.Logger.IsLevelEnabled(DebugLevel) {
+		entry.log(DebugLevel, fmt.Sprint(args...))
+	}
+}
+
 func (entry *Entry) Print(args ...interface{}) {
 	entry.Info(args...)
 }
@@ -216,18 +216,18 @@ func (entry *Entry) Panic(args ...interface{}) {
 
 // Entry Printf family functions
 
-func (entry *Entry) Debugf(format string, args ...interface{}) {
-	if entry.Logger.IsLevelEnabled(DebugLevel) {
-		entry.Debug(fmt.Sprintf(format, args...))
-	}
-}
-
 func (entry *Entry) Tracef(format string, args ...interface{}) {
 	if entry.Logger.IsLevelEnabled(TraceLevel) {
 		entry.Trace(fmt.Sprintf(format, args...))
 	}
 }
 
+func (entry *Entry) Debugf(format string, args ...interface{}) {
+	if entry.Logger.IsLevelEnabled(DebugLevel) {
+		entry.Debug(fmt.Sprintf(format, args...))
+	}
+}
+
 func (entry *Entry) Infof(format string, args ...interface{}) {
 	if entry.Logger.IsLevelEnabled(InfoLevel) {
 		entry.Info(fmt.Sprintf(format, args...))
diff --git a/logrus.go b/logrus.go
index d657c41..8834b5b 100644
--- a/logrus.go
+++ b/logrus.go
@@ -87,8 +87,7 @@ const (
 	InfoLevel
 	// DebugLevel level. Usually only enabled when debugging. Very verbose logging.
 	DebugLevel
-	// TraceLevel level. Usually only enabled when debugging. Very verbose logging.
-	// Usually reserved for message traces.
+	// TraceLevel level. Designates finer-grained informational events than the Debug.
 	TraceLevel
 )