github.com/rs/zerolog v1.15.0: SetGlobalLevel

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/rs/zerolog.SetGlobalLevel in pkg:golang/github.com/rs/zerolog@v1.15.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/rs/zerolog@v1.15.0
Demonstrate these symbols/APIs:
  - github.com/rs/zerolog.SetGlobalLevel

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:a6eaeb496c2e701ce709ab5209c4723c4e36044f42b0faad41301b277601ae4a","contract":["SetGlobalLevel updates the active global level returned by GlobalLevel","SetGlobalLevel filters out log messages below the specified global threshold","SetGlobalLevel allows log messages at or above the specified global threshold","SetGlobalLevel set to Disabled suppresses all log output across levels","SetGlobalLevel set to DebugLevel enables debug-level logging output"],"goal":"verify github.com/rs/zerolog.SetGlobalLevel in pkg:golang/github.com/rs/zerolog@v1.15.0","kind":"HOW","packages":["pkg:golang/github.com/rs/zerolog@v1.15.0"],"schemaVersion":1,"symbols":["github.com/rs/zerolog.SetGlobalLevel"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/rs/zerolog@v1.15.0"],"schemaVersion":1,"subject":"pkg:golang/github.com/rs/zerolog@v1.15.0","symbols":["github.com/rs/zerolog.SetGlobalLevel"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

require github.com/rs/zerolog v1.15.0

github.com/coreos/go-systemd v0.0.0-20190321100706-95778dfbb74e/go.mod h1:F5haX7vjVVG0kc13fIWeqUViNPyEJxv/OmvnBo0Yme4=
github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
github.com/rs/xid v1.2.1/go.mod h1:+uKXf+4Djp6Md1KODXJxgGQPKngRmWyn10oCKFzNHOQ=
github.com/rs/zerolog v1.15.0 h1:uPRuwkWF4J6fGsJ2R0Gn2jB1EQiav9k3S6CSdygQJXY=
github.com/rs/zerolog v1.15.0/go.mod h1:xYTKnLHcpfU2225ny5qZjxnj9NvkumZYjJHlAThCjNc=
github.com/zenazn/goji v0.9.0/go.mod h1:7S9M489iMyHBNxwZnk9/EHS098H4/F6TATF2mIxtB1Q=
golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/tools v0.0.0-20190425163242-31fd60d6bfdc/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=

package sample

import (
	"bytes"

	"github.com/rs/zerolog"
)

// ConfigureGlobalLevel configures the global logging threshold using zerolog.SetGlobalLevel.
func ConfigureGlobalLevel(level zerolog.Level) {
	zerolog.SetGlobalLevel(level)
}

// CurrentGlobalLevel retrieves the current global logging threshold via zerolog.GlobalLevel.
func CurrentGlobalLevel() zerolog.Level {
	return zerolog.GlobalLevel()
}

// NewBufferLogger creates a zerolog.Logger that outputs JSON formatted logs to the provided buffer.
func NewBufferLogger(buf *bytes.Buffer) zerolog.Logger {
	return zerolog.New(buf)
}

{
  "schemaVersion": 1,
  "goal": "verify github.com/rs/zerolog.SetGlobalLevel in pkg:golang/github.com/rs/zerolog@v1.15.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/rs/zerolog@v1.15.0"
  ],
  "symbols": [
    "github.com/rs/zerolog.SetGlobalLevel"
  ]
}

package main

import (
	"bytes"
	"fmt"
	"os"
	"strings"

	"github.com/rs/zerolog"
	"sample"
)

func main() {
	// Assertion 1: SetGlobalLevel updates the active global level returned by GlobalLevel
	sample.ConfigureGlobalLevel(zerolog.InfoLevel)
	if sample.CurrentGlobalLevel() != zerolog.InfoLevel {
		fmt.Fprintf(os.Stderr, "FAIL: expected GlobalLevel InfoLevel, got %v\n", sample.CurrentGlobalLevel())
		os.Exit(1)
	}

	sample.ConfigureGlobalLevel(zerolog.WarnLevel)
	if sample.CurrentGlobalLevel() != zerolog.WarnLevel {
		fmt.Fprintf(os.Stderr, "FAIL: expected GlobalLevel WarnLevel, got %v\n", sample.CurrentGlobalLevel())
		os.Exit(1)
	}

	// Assertion 2: SetGlobalLevel filters out log messages below the specified global threshold
	var buf bytes.Buffer
	logger := sample.NewBufferLogger(&buf)

	logger.Debug().Msg("debug message should be discarded")
	logger.Info().Msg("info message should be discarded")
	if buf.Len() > 0 {
		fmt.Fprintf(os.Stderr, "FAIL: expected empty buffer for sub-threshold logs, got: %s\n", buf.String())
		os.Exit(1)
	}

	// Assertion 3: SetGlobalLevel allows log messages at or above the specified global threshold
	logger.Warn().Msg("warn message should appear")
	outWarn := buf.String()
	if !strings.Contains(outWarn, "warn message should appear") || !strings.Contains(outWarn, `"level":"warn"`) {
		fmt.Fprintf(os.Stderr, "FAIL: expected warn log in output, got: %s\n", outWarn)
		os.Exit(1)
	}

	buf.Reset()
	logger.Error().Msg("error message should appear")
	outErr := buf.String()
	if !strings.Contains(outErr, "error message should appear") || !strings.Contains(outErr, `"level":"error"`) {
		fmt.Fprintf(os.Stderr, "FAIL: expected error log in output, got: %s\n", outErr)
		os.Exit(1)
	}

	// Assertion 4: SetGlobalLevel set to Disabled suppresses all log output across levels
	sample.ConfigureGlobalLevel(zerolog.Disabled)
	if sample.CurrentGlobalLevel() != zerolog.Disabled {
		fmt.Fprintf(os.Stderr, "FAIL: expected GlobalLevel Disabled, got %v\n", sample.CurrentGlobalLevel())
		os.Exit(1)
	}

	buf.Reset()
	logger.Error().Msg("error suppressed by Disabled")
	logger.Warn().Msg("warn suppressed by Disabled")
	if buf.Len() > 0 {
		fmt.Fprintf(os.Stderr, "FAIL: expected no logs when level is Disabled, got: %s\n", buf.String())
		os.Exit(1)
	}

	// Assertion 5: SetGlobalLevel set to DebugLevel enables debug-level logging output
	sample.ConfigureGlobalLevel(zerolog.DebugLevel)
	if sample.CurrentGlobalLevel() != zerolog.DebugLevel {
		fmt.Fprintf(os.Stderr, "FAIL: expected GlobalLevel DebugLevel, got %v\n", sample.CurrentGlobalLevel())
		os.Exit(1)
	}

	buf.Reset()
	logger.Debug().Msg("debug message now enabled")
	outDebug := buf.String()
	if !strings.Contains(outDebug, "debug message now enabled") || !strings.Contains(outDebug, `"level":"debug"`) {
		fmt.Fprintf(os.Stderr, "FAIL: expected debug log in output, got: %s\n", outDebug)
		os.Exit(1)
	}

	fmt.Println("PASS: github.com/rs/zerolog.SetGlobalLevel contract verified")
}