github.com/spf13/cast v1.4.1: ToBoolE

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/spf13/cast.ToBoolE in pkg:golang/github.com/spf13/cast@v1.4.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/spf13/cast@v1.4.1
Demonstrate these symbols/APIs:
  - github.com/spf13/cast.ToBoolE
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@10.9.8
  - runtime: node@22.23.2

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.

package sample

import (
	"github.com/spf13/cast"
)

// ToBoolE converts an arbitrary value into a boolean, returning an error if conversion is not possible.
func ToBoolE(val any) (bool, error) {
	return cast.ToBoolE(val)
}

package sample

import (
	"testing"

	"github.com/spf13/cast"
)

func TestToBoolE_SupportedTypes(t *testing.T) {
	bTrue := true
	iVal := 42
	sVal := "true"

	tests := []struct {
		name     string
		input    any
		expected bool
	}{
		{"bool true", true, true},
		{"bool false", false, false},
		{"nil", nil, false},
		{"int positive", 1, true},
		{"int negative", -1, true},
		{"int zero", 0, false},
		{"string true lowercase", "true", true},
		{"string true uppercase", "TRUE", true},
		{"string true titlecase", "True", true},
		{"string t lowercase", "t", true},
		{"string t uppercase", "T", true},
		{"string 1", "1", true},
		{"string false lowercase", "false", false},
		{"string false uppercase", "FALSE", false},
		{"string false titlecase", "False", false},
		{"string f lowercase", "f", false},
		{"string f uppercase", "F", false},
		{"string 0", "0", false},
		{"pointer to bool", &bTrue, true},
		{"pointer to int", &iVal, true},
		{"pointer to string", &sVal, true},
	}

	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			got, err := cast.ToBoolE(tt.input)
			if err != nil {
				t.Fatalf("cast.ToBoolE(%v) returned unexpected error: %v", tt.input, err)
			}
			if got != tt.expected {
				t.Fatalf("cast.ToBoolE(%v) = %v; want %v", tt.input, got, tt.expected)
			}

			// Also verify via helper function
			gotHelper, errHelper := ToBoolE(tt.input)
			if errHelper != nil {
				t.Fatalf("ToBoolE(%v) returned unexpected error: %v", tt.input, errHelper)
			}
			if gotHelper != tt.expected {
				t.Fatalf("ToBoolE(%v) = %v; want %v", tt.input, gotHelper, tt.expected)
			}
		})
	}
}

func TestToBoolE_UnsupportedTypesReturnError(t *testing.T) {
	tests := []struct {
		name  string
		input any
	}{
		{"int64", int64(1)},
		{"float64", float64(1.0)},
		{"float32", float32(0.0)},
		{"invalid string", "not_a_bool"},
		{"numeric string other than 0 or 1", "2"},
		{"struct", struct{}{}},
		{"slice", []int{1}},
		{"map", map[string]bool{"key": true}},
	}

	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			got, err := cast.ToBoolE(tt.input)
			if err == nil {
				t.Fatalf("cast.ToBoolE(%v) expected error, got %v without error", tt.input, got)
			}

			gotHelper, errHelper := ToBoolE(tt.input)
			if errHelper == nil {
				t.Fatalf("ToBoolE(%v) expected error, got %v without error", tt.input, gotHelper)
			}
		})
	}
}

{"case":{"caseId":"case:sha256:d54fb26986cedcf8c6edb7527abb7f59dfbfc425cfd3875eaac7e9f9deee4e3d","contract":["cast.ToBoolE converts bool, nil, int, and bool-like strings to boolean without error","cast.ToBoolE unwraps pointers to supported types before conversion","cast.ToBoolE returns an error for unsupported types and invalid strings","ToBoolE converts the given value to a boolean using cast.ToBoolE"],"goal":"verify github.com/spf13/cast.ToBoolE in pkg:golang/github.com/spf13/cast@v1.4.1","kind":"HOW","packages":["pkg:golang/github.com/spf13/cast@v1.4.1"],"schemaVersion":1,"symbols":["github.com/spf13/cast.ToBoolE"]},"contractCommand":["go","test","./..."],"environment":{"arch":"amd64","compiler":"go","compilerVersion":"1.26.6","distro":"ubuntu","ecosystem":"golang","language":"go","languageVersion":"1.26.6","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/spf13/cast@v1.4.1"],"schemaVersion":1,"subject":"pkg:golang/github.com/spf13/cast@v1.4.1","symbols":["github.com/spf13/cast.ToBoolE"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

require github.com/spf13/cast v1.4.1

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/spf13/cast v1.4.1 h1:s0hze+J0196ZfEMTs80N7UlFt0BDuQ7Q+JDnHiMWKdA=
github.com/spf13/cast v1.4.1/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE=
github.com/stretchr/testify v1.2.2 h1:bSDNvY7ZPG5RlJ8otE/7V6gMiyenm9RtJ7IUVIAoJ1w=
github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=

{
  "schemaVersion": 1,
  "goal": "verify github.com/spf13/cast.ToBoolE in pkg:golang/github.com/spf13/cast@v1.4.1",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/spf13/cast@v1.4.1"
  ],
  "symbols": [
    "github.com/spf13/cast.ToBoolE"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "packageManager": "npm@10.9.8",
    "runtime": "node@22.23.2"
  }
}