From 678a888067e890092b75be56bff563d1534a2c13 Mon Sep 17 00:00:00 2001
From: "Marc M. Adkins" <software@doorways.org>
Date: Tue, 11 Feb 2025 18:08:41 -0800
Subject: [PATCH 1/3] Add indentation by depth

---
 example/main.go | 22 +++++++++++++++---
 handler.go      | 61 ++++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 79 insertions(+), 4 deletions(-)

diff --git a/example/main.go b/example/main.go
index ca78958..b101120 100644
--- a/example/main.go
+++ b/example/main.go
@@ -8,10 +8,11 @@ import (
 	"github.com/phsym/console-slog"
 )
 
+var hdlr *console.Handler
+
 func main() {
-	logger := slog.New(
-		console.NewHandler(os.Stderr, &console.HandlerOptions{Level: slog.LevelDebug, AddSource: true}),
-	)
+	hdlr = console.NewHandler(os.Stderr, &console.HandlerOptions{Level: slog.LevelDebug, AddSource: true})
+	logger := slog.New(hdlr)
 	slog.SetDefault(logger)
 	slog.Info("Hello world!", "foo", "bar")
 	slog.Debug("Debug message")
@@ -23,4 +24,19 @@ func main() {
 		With("bar", "baz")
 
 	logger.Info("group info", "attr", "value")
+
+	hdlr.SetIndentation("", "  ")
+	slog.Info("factorial", "result", factorial(4))
+}
+
+func factorial(number uint) uint {
+	hdlr.Increment()
+	defer hdlr.Decrement()
+
+	slog.Info("factorial", "number", number)
+
+	if number < 2 {
+		return 1
+	}
+	return number * factorial(number-1)
 }
diff --git a/handler.go b/handler.go
index 82ce3ea..a8d5d11 100644
--- a/handler.go
+++ b/handler.go
@@ -40,12 +40,52 @@ type HandlerOptions struct {
 	Theme Theme
 }
 
+type Indenter interface {
+	SetIndentation(prefix, indent string)
+	Increment()
+	Decrement()
+}
+
+// indentation defines support data for enhanced message and arg indentation by depth.
+type indentation struct {
+	// Prefix for indentation string.
+	prefix string
+
+	// Indent string for each depth level.
+	indent string
+
+	// Depth is the current indentation depth
+	depth uint
+}
+
+func (hd *indentation) indentMsg(msg string) string {
+	if hd.prefix == "" && (hd.indent == "" || hd.depth < 1) {
+		// No indentation.
+		return msg
+	}
+
+	// Build indentation string.
+	builder := strings.Builder{}
+	if hd.prefix != "" {
+		builder.WriteString(hd.prefix)
+	}
+	if hd.indent != "" && hd.depth > 0 {
+		var i uint
+		for i = 0; i < hd.depth; i++ {
+			builder.WriteString(hd.indent)
+		}
+	}
+	builder.WriteString(msg)
+	return builder.String()
+}
+
 type Handler struct {
 	opts    HandlerOptions
 	out     io.Writer
 	group   string
 	context buffer
 	enc     *encoder
+	indentation
 }
 
 var _ slog.Handler = (*Handler)(nil)
@@ -89,7 +129,8 @@ func (h *Handler) Handle(_ context.Context, rec slog.Record) error {
 	if h.opts.AddSource && rec.PC > 0 {
 		h.enc.writeSource(buf, rec.PC, cwd)
 	}
-	h.enc.writeMessage(buf, rec.Level, rec.Message)
+	// TODO: Add indentation here.
+	h.enc.writeMessage(buf, rec.Level, h.indentMsg(rec.Message))
 	buf.copy(&h.context)
 	rec.Attrs(func(a slog.Attr) bool {
 		h.enc.writeAttr(buf, a, h.group)
@@ -135,3 +176,21 @@ func (h *Handler) WithGroup(name string) slog.Handler {
 		enc:     h.enc,
 	}
 }
+
+var _ Indenter = (*Handler)(nil)
+
+func (h *Handler) SetIndentation(prefix, indent string) {
+	h.prefix = prefix
+	h.indent = indent
+	h.depth = 0
+}
+
+func (h *Handler) Increment() {
+	h.depth++
+}
+
+func (h *Handler) Decrement() {
+	if h.depth > 0 {
+		h.depth--
+	}
+}

From 700f394beeb431f5d66fb53d77997aab4af38e8b Mon Sep 17 00:00:00 2001
From: "Marc M. Adkins" <software@doorways.org>
Date: Tue, 11 Feb 2025 19:49:04 -0800
Subject: [PATCH 2/3] Document the new 'feature'

---
 README.md                    |  72 ++++++++++++++++++++++++++++++++++-
 doc/img/factorial-indent.png | Bin 0 -> 10025 bytes
 example/main.go              |  42 --------------------
 examples/basic/main.go       |  26 +++++++++++++
 examples/indent/main.go      |  32 ++++++++++++++++
 handler.go                   |   8 ++++
 6 files changed, 137 insertions(+), 43 deletions(-)
 create mode 100644 doc/img/factorial-indent.png
 delete mode 100644 example/main.go
 create mode 100644 examples/basic/main.go
 create mode 100644 examples/indent/main.go

diff --git a/README.md b/README.md
index 193e151..cf47cca 100644
--- a/README.md
+++ b/README.md
@@ -72,4 +72,74 @@ BenchmarkLoggers/dummy-4                 1239873             893.2 ns/op
 BenchmarkLoggers/console-4                483354              2338 ns/op             128 B/op          1 allocs/op
 BenchmarkLoggers/std-text-4               368828              3141 ns/op             132 B/op          3 allocs/op
 BenchmarkLoggers/std-json-4               393322              2909 ns/op             248 B/op          4 allocs/op
-```
\ No newline at end of file
+```
+
+## Indentation
+`console.Handler` also implements the custom interface:
+```go
+type Indenter interface {
+    // SetIndentation configures the prefix and indent strings.
+    // The prefix, if any, is added first,
+    // then the indent string is added as many times as the current depth.
+    SetIndentation(prefix, indent string)
+    
+    // Increment the indentation depth.
+    Increment()
+    
+    // Decrement the indentation depth.
+    // If the current depth is already zero there is no change.
+    Decrement()
+}
+```
+Indentation of functions can occasionally be useful for delineating
+calls by indenting callees more than callers.
+
+This isn't something that `log.slog` provides.
+It is necessary to provide the handler pointer as a global variable or function
+in order to use the `Indenter` interface.
+
+Because the current `depth` is stored within the `console.Handler` this functionality is not thread-safe.
+In order to use it in a multi-thread environment there must be a handler (and logger) for each thread,
+and these items must be passed down through all intervening function calls (in lieu of thread variables).
+
+### Example
+
+```go
+package main
+
+import (
+	"log/slog"
+	"os"
+
+	"github.com/phsym/console-slog"
+)
+
+var hdlr *console.Handler
+
+func main() {
+	hdlr = console.NewHandler(os.Stderr, &console.HandlerOptions{Level: slog.LevelDebug})
+	hdlr.SetIndentation("", "  ")
+	slog.SetDefault(slog.New(hdlr))
+	slog.Info("factorial", "result", factorial(7))
+}
+
+func factorial(number uint) uint {
+	hdlr.Increment()
+	defer hdlr.Decrement()
+
+	slog.Debug("factorial", "number", number)
+	var result uint
+	if number < 2 {
+		result = 1
+	} else {
+		result = number * factorial(number-1)
+	}
+	slog.Debug("factorial", "result", result)
+	return result
+}
+```
+
+![factorial-indent](./doc/img/factorial-indent.png)
+
+The specific case of runaway recursion shows up clearly as the messages
+march repeatedly across the screen.
\ No newline at end of file
diff --git a/doc/img/factorial-indent.png b/doc/img/factorial-indent.png
new file mode 100644
index 0000000000000000000000000000000000000000..575aea2b237bb12431bd42c974a4478fb07132c5
GIT binary patch
literal 10025
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
CcZo3o

literal 0
HcmV?d00001

diff --git a/example/main.go b/example/main.go
deleted file mode 100644
index b101120..0000000
--- a/example/main.go
+++ /dev/null
@@ -1,42 +0,0 @@
-package main
-
-import (
-	"errors"
-	"log/slog"
-	"os"
-
-	"github.com/phsym/console-slog"
-)
-
-var hdlr *console.Handler
-
-func main() {
-	hdlr = console.NewHandler(os.Stderr, &console.HandlerOptions{Level: slog.LevelDebug, AddSource: true})
-	logger := slog.New(hdlr)
-	slog.SetDefault(logger)
-	slog.Info("Hello world!", "foo", "bar")
-	slog.Debug("Debug message")
-	slog.Warn("Warning message")
-	slog.Error("Error message", "err", errors.New("the error"))
-
-	logger = logger.With("foo", "bar").
-		WithGroup("the-group").
-		With("bar", "baz")
-
-	logger.Info("group info", "attr", "value")
-
-	hdlr.SetIndentation("", "  ")
-	slog.Info("factorial", "result", factorial(4))
-}
-
-func factorial(number uint) uint {
-	hdlr.Increment()
-	defer hdlr.Decrement()
-
-	slog.Info("factorial", "number", number)
-
-	if number < 2 {
-		return 1
-	}
-	return number * factorial(number-1)
-}
diff --git a/examples/basic/main.go b/examples/basic/main.go
new file mode 100644
index 0000000..ca78958
--- /dev/null
+++ b/examples/basic/main.go
@@ -0,0 +1,26 @@
+package main
+
+import (
+	"errors"
+	"log/slog"
+	"os"
+
+	"github.com/phsym/console-slog"
+)
+
+func main() {
+	logger := slog.New(
+		console.NewHandler(os.Stderr, &console.HandlerOptions{Level: slog.LevelDebug, AddSource: true}),
+	)
+	slog.SetDefault(logger)
+	slog.Info("Hello world!", "foo", "bar")
+	slog.Debug("Debug message")
+	slog.Warn("Warning message")
+	slog.Error("Error message", "err", errors.New("the error"))
+
+	logger = logger.With("foo", "bar").
+		WithGroup("the-group").
+		With("bar", "baz")
+
+	logger.Info("group info", "attr", "value")
+}
diff --git a/examples/indent/main.go b/examples/indent/main.go
new file mode 100644
index 0000000..5317233
--- /dev/null
+++ b/examples/indent/main.go
@@ -0,0 +1,32 @@
+package main
+
+import (
+	"log/slog"
+	"os"
+
+	"github.com/phsym/console-slog"
+)
+
+var hdlr *console.Handler
+
+func main() {
+	hdlr = console.NewHandler(os.Stderr, &console.HandlerOptions{Level: slog.LevelDebug})
+	hdlr.SetIndentation("", "  ")
+	slog.SetDefault(slog.New(hdlr))
+	slog.Info("factorial", "result", factorial(7))
+}
+
+func factorial(number uint) uint {
+	hdlr.Increment()
+	defer hdlr.Decrement()
+
+	slog.Debug("factorial", "number", number)
+	var result uint
+	if number < 2 {
+		result = 1
+	} else {
+		result = number * factorial(number-1)
+	}
+	slog.Debug("factorial", "result", result)
+	return result
+}
diff --git a/handler.go b/handler.go
index a8d5d11..1444394 100644
--- a/handler.go
+++ b/handler.go
@@ -41,8 +41,16 @@ type HandlerOptions struct {
 }
 
 type Indenter interface {
+	// SetIndentation configures the prefix and indent strings.
+	// The prefix, if any, is added first,
+	// then the indent string is added as many times as the current depth.
 	SetIndentation(prefix, indent string)
+
+	// Increment the indentation depth.
 	Increment()
+
+	// Decrement the indentation depth.
+	// If the current depth is already zero there is no change.
 	Decrement()
 }
 

From cf3525a36f540796d84bc9746c6d46e9088f90bf Mon Sep 17 00:00:00 2001
From: "Marc M. Adkins" <software@doorways.org>
Date: Tue, 11 Feb 2025 19:52:45 -0800
Subject: [PATCH 3/3] Remove redundant TODO comment

---
 handler.go | 1 -
 1 file changed, 1 deletion(-)

diff --git a/handler.go b/handler.go
index 1444394..f7ed79b 100644
--- a/handler.go
+++ b/handler.go
@@ -137,7 +137,6 @@ func (h *Handler) Handle(_ context.Context, rec slog.Record) error {
 	if h.opts.AddSource && rec.PC > 0 {
 		h.enc.writeSource(buf, rec.PC, cwd)
 	}
-	// TODO: Add indentation here.
 	h.enc.writeMessage(buf, rec.Level, h.indentMsg(rec.Message))
 	buf.copy(&h.context)
 	rec.Attrs(func(a slog.Attr) bool {