Pull request 110: imp-osutil-slogutil

Squashed commit of the following:

commit c4b2739
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Thu Jun 20 22:03:42 2024 +0300

    all: imp osutil, slogutil

logutil/slogutil/slogutil.go

@@ -11,6 +11,7 @@ import (
 	"log/slog"
 	"os"
 	"runtime/debug"
+	"strings"
 )
 
 // Additional key constants.
@@ -131,6 +132,24 @@ func PrintStack(ctx context.Context, l *slog.Logger, lvl slog.Level) {
 	}
 }
 
+// PrintLines splits s and logs the lines to l using the given level, including
+// empty lines.
+func PrintLines(ctx context.Context, l *slog.Logger, lvl slog.Level, msg, s string) {
+	lines := strings.Split(s, "\n")
+	for i, line := range lines {
+		l.Log(ctx, lvl, msg, "line_num", i+1, "line", line)
+	}
+}
+
+// PrintByteLines splits b and logs the lines to l using the given level,
+// including empty lines.
+func PrintByteLines(ctx context.Context, l *slog.Logger, lvl slog.Level, msg string, b []byte) {
+	lines := bytes.Split(b, []byte{'\n'})
+	for i, line := range lines {
+		l.Log(ctx, lvl, msg, "line_num", i+1, "line", line)
+	}
+}
+
 // bufferedTextHandler is a combination of one bytes buffer and a text handler
 // that writes to it.
 type bufferedTextHandler struct {

logutil/slogutil/slogutil_example_test.go

@@ -1,6 +1,9 @@
 package slogutil_test
 
 import (
+	"context"
+	"log/slog"
+
 	"github.com/AdguardTeam/golibs/logutil/slogutil"
 )
 
@@ -54,3 +57,18 @@ func ExampleNew_text() {
 	// level=INFO msg="group test info" test_group.time="too late"
 	// level=DEBUG msg="group test debug" test_group.time="too late"
 }
+
+func ExamplePrintLines() {
+	text := `A Very Long Text
+
+This is a very long text with many lines.`
+	l := slogutil.New(nil)
+
+	ctx := context.Background()
+	slogutil.PrintLines(ctx, l, slog.LevelInfo, "my text", text)
+
+	// Output:
+	// INFO my text line_num=1 line="A Very Long Text"
+	// INFO my text line_num=2 line=""
+	// INFO my text line_num=3 line="This is a very long text with many lines."
+}

osutil/cmd.go

@@ -5,6 +5,7 @@ type ExitCode = int
 
 // Exit status constants.
 const (
-	ExitCodeSuccess ExitCode = 0
-	ExitCodeFailure ExitCode = 1
+	ExitCodeSuccess       ExitCode = 0
+	ExitCodeFailure       ExitCode = 1
+	ExitCodeArgumentError ExitCode = 2
 )