CodeSampleX

Sample

github.com/dustin/go-humanize v1.0.0

Verified sample for golang github.com/dustin/go-humanize v1.0.0. The contract ran on go 1.26 · linux alpine/x64 · docker and passed.

sha256:9775d3bb476b0b67916f47e683023422b532a0b019b11d66c3a25d08ba7f86e8

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
1
Signing keys that built it
1
Declared environment linux 24 · ubuntu · glibc 2.39 x64 go

Verification-run environments

Environment Contract Stages Run
go 1.26 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-21

Case

HOW
Goal
verify pkg:golang/github.com/dustin/go-humanize@v1.0.0
Packages
Created
2026-08-21T01:38:40Z

Contract

  1. humanize.ParseBytes parses decimal SI byte size strings into integer byte counts
  2. humanize.ParseBytes parses binary IEC byte size strings using base-2 multiplier units
  3. humanize.ParseBytes returns an error for empty or invalid byte size strings
  4. humanize.RelTime computes human-readable relative duration descriptions between timestamps
  5. humanize.SI formats numbers with metric unit prefixes and ParseSI parses prefixed metric strings back into magnitude and base unit

Files

  • PROMPT.md
  • csx.json
  • go.mod
  • go.sum
  • main.go
  • spec.json
  • test/contract.go

Download the source artifact (tar.gz)

Source

PROMPT.md
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 pkg:golang/github.com/dustin/go-humanize@v1.0.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/dustin/go-humanize@v1.0.0

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.
csx.json
{"case":{"caseId":"case:sha256:c378fd55e66bcf7a7f2a3407ab44c927528ca5b80d8bf516e0b74dca36f1609d","contract":["humanize.ParseBytes parses decimal SI byte size strings into integer byte counts","humanize.ParseBytes parses binary IEC byte size strings using base-2 multiplier units","humanize.ParseBytes returns an error for empty or invalid byte size strings","humanize.RelTime computes human-readable relative duration descriptions between timestamps","humanize.SI formats numbers with metric unit prefixes and ParseSI parses prefixed metric strings back into magnitude and base unit"],"goal":"verify pkg:golang/github.com/dustin/go-humanize@v1.0.0","kind":"HOW","packages":["pkg:golang/github.com/dustin/go-humanize@v1.0.0"],"schemaVersion":1},"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/dustin/go-humanize@v1.0.0"],"schemaVersion":1,"subject":"pkg:golang/github.com/dustin/go-humanize@v1.0.0","verifierAdapter":"golang@1"}
go.mod
module sample

go 1.26.6

require github.com/dustin/go-humanize v1.0.0
go.sum
github.com/dustin/go-humanize v1.0.0 h1:VSnTsYCnlFHaM2/igO1h6X3HA71jcobQuxemgkq4zYo=
github.com/dustin/go-humanize v1.0.0/go.mod h1:HtrtbFcZ19U5GC7JDqmcUSB87Iq5E25KnS6fMYU6eOk=
main.go
package main

import (
	"fmt"
	"time"

	"github.com/dustin/go-humanize"
)

func main() {
	// Parse human-readable byte sizes into integer byte counts
	bytes, err := humanize.ParseBytes("42 MB")
	if err != nil {
		panic(err)
	}
	fmt.Printf("Parsed '42 MB': %d bytes\n", bytes)

	// Format relative time durations
	now := time.Now()
	twoHoursAgo := now.Add(-2 * time.Hour)
	relPast := humanize.RelTime(twoHoursAgo, now, "ago", "from now")
	fmt.Printf("Relative time: %s\n", relPast)

	// Format and parse metric SI units
	formattedSI := humanize.SI(1500000, "Hz")
	fmt.Printf("Formatted SI: %s\n", formattedSI)

	val, unit, err := humanize.ParseSI("1.5 MHz")
	if err != nil {
		panic(err)
	}
	fmt.Printf("Parsed SI '1.5 MHz': %f %s\n", val, unit)
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/github.com/dustin/go-humanize@v1.0.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/dustin/go-humanize@v1.0.0"
  ]
}
test/contract.go
package main

import (
	"fmt"
	"os"
	"time"

	"github.com/dustin/go-humanize"
)

func main() {
	if err := runContract(); err != nil {
		fmt.Fprintf(os.Stderr, "Contract verification failed: %v\n", err)
		os.Exit(1)
	}
	fmt.Println("All go-humanize contract assertions passed successfully.")
}

func runContract() error {
	// Assertion 1: humanize.ParseBytes parses decimal SI byte size strings into integer byte counts
	b1, err := humanize.ParseBytes("42 MB")
	if err != nil || b1 != 42000000 {
		return fmt.Errorf("ParseBytes('42 MB') expected 42000000, got %v (err: %v)", b1, err)
	}
	b2, err := humanize.ParseBytes("1.5 GB")
	if err != nil || b2 != 1500000000 {
		return fmt.Errorf("ParseBytes('1.5 GB') expected 1500000000, got %v (err: %v)", b2, err)
	}
	b3, err := humanize.ParseBytes("500 kB")
	if err != nil || b3 != 500000 {
		return fmt.Errorf("ParseBytes('500 kB') expected 500000, got %v (err: %v)", b3, err)
	}

	// Assertion 2: humanize.ParseBytes parses binary IEC byte size strings using base-2 multiplier units
	mib, err := humanize.ParseBytes("42 MiB")
	if err != nil || mib != 42*1024*1024 {
		return fmt.Errorf("ParseBytes('42 MiB') expected %d, got %v (err: %v)", 42*1024*1024, mib, err)
	}
	gib, err := humanize.ParseBytes("1.5 GiB")
	expectedGiB := uint64(1.5 * 1024 * 1024 * 1024)
	if err != nil || gib != expectedGiB {
		return fmt.Errorf("ParseBytes('1.5 GiB') expected %d, got %v (err: %v)", expectedGiB, gib, err)
	}
	kib, err := humanize.ParseBytes("10 KiB")
	if err != nil || kib != 10*1024 {
		return fmt.Errorf("ParseBytes('10 KiB') expected %d, got %v (err: %v)", 10*1024, kib, err)
	}

	// Assertion 3: humanize.ParseBytes returns an error for empty or invalid byte size strings
	if _, err := humanize.ParseBytes("invalid"); err == nil {
		return fmt.Errorf("expected error for 'invalid', got nil")
	}
	if _, err := humanize.ParseBytes(""); err == nil {
		return fmt.Errorf("expected error for empty string, got nil")
	}
	if _, err := humanize.ParseBytes("100 XB"); err == nil {
		return fmt.Errorf("expected error for invalid unit '100 XB', got nil")
	}

	// Assertion 4: humanize.RelTime computes human-readable relative duration descriptions between timestamps
	tRef := time.Date(2025, 6, 15, 12, 0, 0, 0, time.UTC)
	tPastMin := tRef.Add(-1 * time.Minute)
	if res := humanize.RelTime(tPastMin, tRef, "ago", "from now"); res != "1 minute ago" {
		return fmt.Errorf("RelTime(-1m) expected '1 minute ago', got %q", res)
	}
	tPastHours := tRef.Add(-3 * time.Hour)
	if res := humanize.RelTime(tPastHours, tRef, "ago", "from now"); res != "3 hours ago" {
		return fmt.Errorf("RelTime(-3h) expected '3 hours ago', got %q", res)
	}
	tPastDays := tRef.Add(-2 * 24 * time.Hour)
	if res := humanize.RelTime(tPastDays, tRef, "ago", "from now"); res != "2 days ago" {
		return fmt.Errorf("RelTime(-2d) expected '2 days ago', got %q", res)
	}
	tFutureHours := tRef.Add(5 * time.Hour)
	if res := humanize.RelTime(tFutureHours, tRef, "ago", "from now"); res != "5 hours from now" {
		return fmt.Errorf("RelTime(+5h) expected '5 hours from now', got %q", res)
	}

	// Assertion 5: humanize.SI formats numbers with metric unit prefixes and ParseSI parses prefixed metric strings back into magnitude and base unit
	if res := humanize.SI(1000000, "B"); res != "1 MB" {
		return fmt.Errorf("SI(1000000, 'B') expected '1 MB', got %q", res)
	}
	if res := humanize.SI(0.001, "s"); res != "1 ms" {
		return fmt.Errorf("SI(0.001, 's') expected '1 ms', got %q", res)
	}
	if res := humanize.SI(0.000001, "F"); res != "1 µF" {
		return fmt.Errorf("SI(0.000001, 'F') expected '1 µF', got %q", res)
	}

	val, unit, err := humanize.ParseSI("2.5 MB")
	if err != nil || val != 2500000 || unit != "B" {
		return fmt.Errorf("ParseSI('2.5 MB') expected 2500000 B, got %v %s (err: %v)", val, unit, err)
	}
	val, unit, err = humanize.ParseSI("100 mV")
	if err != nil || val != 0.1 || unit != "V" {
		return fmt.Errorf("ParseSI('100 mV') expected 0.1 V, got %v %s (err: %v)", val, unit, err)
	}
	if _, _, err := humanize.ParseSI("invalid"); err == nil {
		return fmt.Errorf("expected ParseSI error for 'invalid', got nil")
	}

	return nil
}

Origin Seeder

anonymous