github.com/sirupsen/logrus v1.9.3: JSONFormatter

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify github.com/sirupsen/logrus.JSONFormatter in pkg:golang/github.com/sirupsen/logrus@v1.9.3
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/sirupsen/logrus@v1.9.3
Demonstrate these symbols/APIs:
  - github.com/sirupsen/logrus.JSONFormatter
Required runtime conditions:
  - ecosystem: golang
  - language: go
  - packageManager: go@1.26.6
  - runtime: go@1.26.6

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:c53c3a2334465adf502d2176cb521fbae99292e95fa5887cfa2cdf2f63932368","contract":["logrus.JSONFormatter formats log entries into valid JSON with default keys level, msg, and time","logrus.JSONFormatter.TimestampFormat formats entry timestamps using the specified layout string","logrus.JSONFormatter.FieldMap remaps default keys to specified custom field names","logrus.JSONFormatter.DataKey nests custom fields under a single parent key in output JSON","logrus.JSONFormatter.PrettyPrint outputs indented multi-line JSON representation"],"goal":"verify github.com/sirupsen/logrus.JSONFormatter in pkg:golang/github.com/sirupsen/logrus@v1.9.3","kind":"HOW","packages":["pkg:golang/github.com/sirupsen/logrus@v1.9.3"],"schemaVersion":1,"symbols":["github.com/sirupsen/logrus.JSONFormatter"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","language":"go","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","packageManagerVersion":"1.26.6","runtime":"go","runtimeVersion":"1.26.6","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/sirupsen/logrus@v1.9.3"],"schemaVersion":1,"subject":"pkg:golang/github.com/sirupsen/logrus@v1.9.3","symbols":["github.com/sirupsen/logrus.JSONFormatter"],"verifierAdapter":"golang@1"}

module sample

go 1.22

require github.com/sirupsen/logrus v1.9.3

require golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 // indirect

github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/sirupsen/logrus v1.9.3 h1:dueUQJ1C2q9oE3F7wvmSGAaVtTmUizReu6fjN8uqzbQ=
github.com/sirupsen/logrus v1.9.3/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ=
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/testify v1.7.0 h1:nwc3DEeHmmLAfoZucVR881uASk0Mfjw8xYJ99tb5CcY=
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 h1:0A+M6Uqn+Eje4kHMK80dtF3JCXC4ykBgQG4Fe06QRhQ=
golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c h1:dUUwHk2QECo/6vqA44rthZ8ie2QXMNeKRTHCNY2nXvo=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package sample

import (
	"bytes"
	"io"

	"github.com/sirupsen/logrus"
)

// NewJSONLogger creates a logrus.Logger configured with the provided JSONFormatter and output destination.
func NewJSONLogger(out io.Writer, formatter *logrus.JSONFormatter) *logrus.Logger {
	l := logrus.New()
	l.SetOutput(out)
	if formatter != nil {
		l.SetFormatter(formatter)
	} else {
		l.SetFormatter(&logrus.JSONFormatter{})
	}
	return l
}

// LogBuffer wraps a buffer and a JSON-configured logger for inspecting formatted output.
type LogBuffer struct {
	Buffer *bytes.Buffer
	Logger *logrus.Logger
}

// NewBufferedJSONLogger returns a logger writing JSON output to an in-memory buffer.
func NewBufferedJSONLogger(formatter *logrus.JSONFormatter) *LogBuffer {
	buf := new(bytes.Buffer)
	logger := NewJSONLogger(buf, formatter)
	return &LogBuffer{
		Buffer: buf,
		Logger: logger,
	}
}

{
  "schemaVersion": 1,
  "goal": "verify github.com/sirupsen/logrus.JSONFormatter in pkg:golang/github.com/sirupsen/logrus@v1.9.3",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/sirupsen/logrus@v1.9.3"
  ],
  "symbols": [
    "github.com/sirupsen/logrus.JSONFormatter"
  ],
  "runtimeConditions": {
    "ecosystem": "golang",
    "language": "go",
    "packageManager": "go@1.26.6",
    "runtime": "go@1.26.6"
  }
}

package main

import (
	"encoding/json"
	"fmt"
	"os"
	"strings"
	"time"

	"github.com/sirupsen/logrus"
	"sample"
)

func main() {
	// Assertion 1: logrus.JSONFormatter formats log entries into valid JSON with default keys level, msg, and time
	lb1 := sample.NewBufferedJSONLogger(&logrus.JSONFormatter{})
	lb1.Logger.WithField("user_id", 42).Info("user logged in")

	var parsed1 map[string]interface{}
	if err := json.Unmarshal(lb1.Buffer.Bytes(), &parsed1); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: output is not valid JSON: %v\n", err)
		os.Exit(1)
	}

	if parsed1["msg"] != "user logged in" {
		fmt.Fprintf(os.Stderr, "FAIL: expected msg 'user logged in', got %v\n", parsed1["msg"])
		os.Exit(1)
	}
	if parsed1["level"] != "info" {
		fmt.Fprintf(os.Stderr, "FAIL: expected level 'info', got %v\n", parsed1["level"])
		os.Exit(1)
	}
	if _, ok := parsed1["time"]; !ok {
		fmt.Fprintf(os.Stderr, "FAIL: expected time key in JSON output\n")
		os.Exit(1)
	}
	if val, ok := parsed1["user_id"].(float64); !ok || val != 42 {
		fmt.Fprintf(os.Stderr, "FAIL: expected user_id 42, got %v\n", parsed1["user_id"])
		os.Exit(1)
	}

	// Assertion 2: logrus.JSONFormatter.TimestampFormat formats entry timestamps using the specified layout string
	customTimeLayout := "2006-01-02 15:04:05"
	lb2 := sample.NewBufferedJSONLogger(&logrus.JSONFormatter{
		TimestampFormat: customTimeLayout,
	})
	lb2.Logger.Warn("scheduled maintenance")

	var parsed2 map[string]interface{}
	if err := json.Unmarshal(lb2.Buffer.Bytes(), &parsed2); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: assertion 2 invalid JSON: %v\n", err)
		os.Exit(1)
	}
	timeStr, ok := parsed2["time"].(string)
	if !ok {
		fmt.Fprintf(os.Stderr, "FAIL: expected string timestamp, got %T\n", parsed2["time"])
		os.Exit(1)
	}
	if _, err := time.Parse(customTimeLayout, timeStr); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: timestamp %q does not match layout %q: %v\n", timeStr, customTimeLayout, err)
		os.Exit(1)
	}

	// Assertion 3: logrus.JSONFormatter.FieldMap remaps default keys to specified custom field names
	lb3 := sample.NewBufferedJSONLogger(&logrus.JSONFormatter{
		FieldMap: logrus.FieldMap{
			logrus.FieldKeyMsg:   "message",
			logrus.FieldKeyLevel: "severity",
		},
	})
	lb3.Logger.Error("disk volume critical")

	var parsed3 map[string]interface{}
	if err := json.Unmarshal(lb3.Buffer.Bytes(), &parsed3); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: assertion 3 invalid JSON: %v\n", err)
		os.Exit(1)
	}
	if parsed3["message"] != "disk volume critical" {
		fmt.Fprintf(os.Stderr, "FAIL: expected remapped key 'message', got %v\n", parsed3["message"])
		os.Exit(1)
	}
	if parsed3["severity"] != "error" {
		fmt.Fprintf(os.Stderr, "FAIL: expected remapped key 'severity', got %v\n", parsed3["severity"])
		os.Exit(1)
	}
	if _, hasOldMsg := parsed3["msg"]; hasOldMsg {
		fmt.Fprintf(os.Stderr, "FAIL: output still contains original 'msg' key\n")
		os.Exit(1)
	}
	if _, hasOldLevel := parsed3["level"]; hasOldLevel {
		fmt.Fprintf(os.Stderr, "FAIL: output still contains original 'level' key\n")
		os.Exit(1)
	}

	// Assertion 4: logrus.JSONFormatter.DataKey nests custom fields under a single parent key in output JSON
	lb4 := sample.NewBufferedJSONLogger(&logrus.JSONFormatter{
		DataKey: "metadata",
	})
	lb4.Logger.WithFields(logrus.Fields{
		"client_ip": "127.0.0.1",
		"attempt":   3,
	}).Info("login retry")

	var parsed4 map[string]interface{}
	if err := json.Unmarshal(lb4.Buffer.Bytes(), &parsed4); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: assertion 4 invalid JSON: %v\n", err)
		os.Exit(1)
	}
	meta, ok := parsed4["metadata"].(map[string]interface{})
	if !ok {
		fmt.Fprintf(os.Stderr, "FAIL: expected 'metadata' to be an object, got %T\n", parsed4["metadata"])
		os.Exit(1)
	}
	if meta["client_ip"] != "127.0.0.1" {
		fmt.Fprintf(os.Stderr, "FAIL: expected metadata.client_ip '127.0.0.1', got %v\n", meta["client_ip"])
		os.Exit(1)
	}
	if val, ok := meta["attempt"].(float64); !ok || val != 3 {
		fmt.Fprintf(os.Stderr, "FAIL: expected metadata.attempt 3, got %v\n", meta["attempt"])
		os.Exit(1)
	}

	// Assertion 5: logrus.JSONFormatter.PrettyPrint outputs indented multi-line JSON representation
	lb5 := sample.NewBufferedJSONLogger(&logrus.JSONFormatter{
		PrettyPrint: true,
	})
	lb5.Logger.Info("debug print payload")

	output5 := lb5.Buffer.String()
	if !strings.Contains(output5, "\n  \"") {
		fmt.Fprintf(os.Stderr, "FAIL: expected pretty-printed indentation, got:\n%s\n", output5)
		os.Exit(1)
	}

	fmt.Println("PASS: all logrus JSONFormatter contract assertions passed")
}