refactor(printer): unify stateful context-aware printer (#4698)

- Consolidate CLI and Porch klog printer logic into an exported Printer interface in pkg/printer.
- Introduce stateful contextual scoping via WithField, WithFields, WithPackage, and WithFunction.
- Provide structured lifecycle event printing (PrintRunning, PrintPass, PrintFail, PrintResult, PrintSummary).
- Remove duplicate packagePrinter implementation in pkg/lib/kptops/render.go.
- Add comprehensive unit tests verifying stateful field scoping and formatting.

Signed-off-by: SurbhiAgarwal1 <surbhi.agarwal@example.com>

Author: SurbhiAgarwal1

pkg/lib/kptops/render.go

@@ -16,16 +16,11 @@ package kptops
 
 import (
 	"context"
-	"fmt"
-	"io"
-	"os"
 
 	fnresultv1 "github.com/kptdev/kpt/api/fnresult/v1"
 	"github.com/kptdev/kpt/pkg/fn"
-	"github.com/kptdev/kpt/pkg/lib/pkg"
 	"github.com/kptdev/kpt/pkg/lib/runneroptions"
 	"github.com/kptdev/kpt/pkg/printer"
-	"k8s.io/klog/v2"
 	"sigs.k8s.io/kustomize/kyaml/filesys"
 )
 
@@ -51,51 +46,5 @@ func (r *renderer) Render(ctx context.Context, pkg filesys.FileSystem, opts fn.R
 		FileSystem:    pkg,
 		RunnerOptions: r.runnerOptions,
 	}
-	return rr.Execute(printer.WithContext(ctx, &packagePrinter{}))
-}
-
-type packagePrinter struct{}
-
-var _ printer.Printer = &packagePrinter{}
-
-const (
-	packagePrefixFormat = "Package %q:"
-	logDepth            = 2
-)
-
-func (p *packagePrinter) PrintPackage(pkg *pkg.Pkg, _ bool) {
-	p.printfDepth(logDepth, packagePrefixFormat, pkg.DisplayPath)
-}
-
-func (p *packagePrinter) Printf(format string, args ...any) {
-	p.printfDepth(logDepth, format, args...)
-}
-
-func (p *packagePrinter) printfDepth(depth int, format string, args ...any) {
-	klog.InfofDepth(depth, format, args...)
-}
-
-func (p *packagePrinter) OptPrintf(opt *printer.Options, format string, args ...any) {
-	if opt == nil {
-		p.Printf(format, args...)
-		return
-	}
-	var prefix string
-	switch {
-	case opt.PkgDisplayName != "":
-		prefix = fmt.Sprintf(packagePrefixFormat, opt.PkgDisplayName)
-	case !opt.PkgDisplayPath.Empty():
-		prefix = fmt.Sprintf(packagePrefixFormat, string(opt.PkgDisplayPath))
-	case !opt.PkgPath.Empty():
-		prefix = fmt.Sprintf(packagePrefixFormat, string(opt.PkgPath))
-	}
-	p.printfDepth(logDepth, prefix+format, args...)
-}
-
-func (p *packagePrinter) OutStream() io.Writer {
-	return os.Stdout
-}
-
-func (p *packagePrinter) ErrStream() io.Writer {
-	return os.Stderr
+	return rr.Execute(printer.WithContext(ctx, printer.NewKlogPrinter()))
 }

pkg/lib/kptops/render_test.go

@@ -163,7 +163,7 @@ func TestPackagePrinter(t *testing.T) {
 
 func TestPackagePrinterStub(t *testing.T) {
 	t.Run("PrintPackage stub", func(t *testing.T) {
-		p := &packagePrinter{}
+		p := printer.NewKlogPrinter()
 		testPkg := &pkg.Pkg{
 			DisplayPath: "test/path",
 		}
@@ -178,7 +178,7 @@ func TestPackagePrinterStub(t *testing.T) {
 	})
 
 	t.Run("Printf stub", func(t *testing.T) {
-		p := &packagePrinter{}
+		p := printer.NewKlogPrinter()
 
 		assert.NotPanics(t, func() {
 			p.Printf("test message")
@@ -190,15 +190,15 @@ func TestPackagePrinterStub(t *testing.T) {
 	})
 
 	t.Run("OptPrintf stub with nil options", func(t *testing.T) {
-		p := &packagePrinter{}
+		p := printer.NewKlogPrinter()
 
 		assert.NotPanics(t, func() {
 			p.OptPrintf(nil, "test message")
 		})
 	})
 
 	t.Run("OptPrintf stub with options", func(t *testing.T) {
-		p := &packagePrinter{}
+		p := printer.NewKlogPrinter()
 		opt := printer.NewOpt().DisplayName("my-package")
 
 		assert.NotPanics(t, func() {
@@ -207,15 +207,15 @@ func TestPackagePrinterStub(t *testing.T) {
 	})
 
 	t.Run("OutStream stub", func(t *testing.T) {
-		p := &packagePrinter{}
+		p := printer.NewKlogPrinter()
 
 		stream := p.OutStream()
 		assert.NotNil(t, stream)
 		assert.Equal(t, os.Stdout, stream)
 	})
 
 	t.Run("ErrStream stub", func(t *testing.T) {
-		p := &packagePrinter{}
+		p := printer.NewKlogPrinter()
 
 		stream := p.ErrStream()
 		assert.NotNil(t, stream)
@@ -236,7 +236,7 @@ func TestPrinterLoggingDepth(t *testing.T) {
 	}
 	expectedFile := filepath.Base(filename)
 
-	p := &packagePrinter{}
+	p := printer.NewKlogPrinter()
 
 	tests := []struct {
 		name string

pkg/printer/fake/fake.go

@@ -17,6 +17,7 @@ package fake
 import (
 	"context"
 	"io"
+	"time"
 
 	"github.com/kptdev/kpt/pkg/lib/pkg"
 	"github.com/kptdev/kpt/pkg/printer"
@@ -29,6 +30,24 @@ type Printer struct {
 	errStream io.Writer
 }
 
+func (np *Printer) WithField(string, string) printer.Printer { return np }
+
+func (np *Printer) WithFields(printer.ContextualFields) printer.Printer { return np }
+
+func (np *Printer) WithPackage(string) printer.Printer { return np }
+
+func (np *Printer) WithFunction(string, string) printer.Printer { return np }
+
+func (np *Printer) PrintRunning(string, int) {}
+
+func (np *Printer) PrintPass(string, time.Duration) {}
+
+func (np *Printer) PrintFail(string, time.Duration, error) {}
+
+func (np *Printer) PrintResult(string, string, string) {}
+
+func (np *Printer) PrintSummary(int, int, time.Duration) {}
+
 func (np *Printer) PrintPackage(*pkg.Pkg, bool) {}
 
 func (np *Printer) OptPrintf(*printer.Options, string, ...any) {}