CodeSampleX

Ejemplo

github.com/spf13/pflag v1.0.9: FlagSet, NewFlagSet

Muestra verificada para golang github.com/spf13/pflag v1.0.9: FlagSet, NewFlagSet. El contrato se ejecutó en go 1.26 · linux alpine/x64 · docker y pasó.

sha256:d6cc7d51114fabe10454034207ecc9cc828fae3c35f8a584e2220b539028a9af

Esta red ofrece una sola cosa: una muestra que compila. La ejecutó en un sandbox y guardó el recibo firmado. No califica ni garantiza nada: si el mismo código compila donde estás no es algo que haya medido. Cuántas claves de firma distintas presentaron un recibo de contrato aprobado. Una es solo el autor; más de una significa que alguien más también lo compiló. Una clave se genera sola y no tiene identidad registrada detrás, así que cuenta claves, no personas. MIT-0

Evidencia de ejecución

El entorno declarado y las ejecuciones firmadas se muestran por separado, para que veas exactamente qué ejecutó esta muestra y dónde.

Base de evidencia
Contrato firmado aprobado
Recibos de verificación
1
Claves de firma que lo compilaron
1
Entorno declarado windows 11 x64 go

Entornos de las ejecuciones de verificación

Entorno Contrato Etapas Ejecución
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-19

Caso

HOW
Objetivo
verify pkg:golang/github.com/spf13/pflag@v1.0.9
Paquetes
Símbolos
  • github.com/spf13/pflag.FlagSet
  • github.com/spf13/pflag.NewFlagSet
Creado
2026-08-18T17:49:21Z

Contrato

  1. pflag.FlagSet parses short and long flags with type conversions
  2. pflag.FlagSet tracks changed flags, positional arguments, and reports unknown flag errors

Archivos

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

Descargar el artefacto de código fuente (tar.gz)

Código fuente

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/spf13/pflag@v1.0.9
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/spf13/pflag@v1.0.9

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:59270738eab5388044e090e7f692f5ec08639fbed58a1535fa1cc4ffb53d6962","contract":["pflag.FlagSet parses short and long flags with type conversions","pflag.FlagSet tracks changed flags, positional arguments, and reports unknown flag errors"],"goal":"verify pkg:golang/github.com/spf13/pflag@v1.0.9","kind":"HOW","packages":["pkg:golang/github.com/spf13/pflag@v1.0.9"],"schemaVersion":1,"symbols":["github.com/spf13/pflag.FlagSet","github.com/spf13/pflag.NewFlagSet"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","ecosystem":"golang","os":"windows","osVersionBucket":"11","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/spf13/pflag@v1.0.9"],"schemaVersion":1,"symbols":["github.com/spf13/pflag.FlagSet","github.com/spf13/pflag.NewFlagSet"],"verifierAdapter":"golang@1"}
go.mod
module example.com/pflag-sample

go 1.25.0

require github.com/spf13/pflag v1.0.9
go.sum
github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
pflag_cli.go
package pflagcli

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

// Config holds CLI options parsed by FlagSet.
type Config struct {
	Name    string
	Port    int
	Verbose bool
	Tags    []string
}

// NewFlagSet creates and configures a FlagSet with typed flags.
func NewFlagSet(name string, cfg *Config) *pflag.FlagSet {
	fs := pflag.NewFlagSet(name, pflag.ContinueOnError)
	fs.StringVarP(&cfg.Name, "name", "n", "default", "Name parameter")
	fs.IntVarP(&cfg.Port, "port", "p", 8080, "Port parameter")
	fs.BoolVarP(&cfg.Verbose, "verbose", "v", false, "Verbose mode")
	fs.StringSliceVarP(&cfg.Tags, "tags", "t", []string{}, "Tag list")
	return fs
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/github.com/spf13/pflag@v1.0.9",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/spf13/pflag@v1.0.9"
  ]
}
test/contract.go
package main

import (
	"fmt"
	"os"

	pflagcli "example.com/pflag-sample"
	"github.com/spf13/pflag"
)

func main() {
	// Assertion 1: Parse default values when no flags provided
	var cfg1 pflagcli.Config
	fs1 := pflagcli.NewFlagSet("test-defaults", &cfg1)
	if err := fs1.Parse([]string{}); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: default flag parsing failed: %v\n", err)
		os.Exit(1)
	}
	if cfg1.Name != "default" || cfg1.Port != 8080 || cfg1.Verbose != false || len(cfg1.Tags) != 0 {
		fmt.Fprintf(os.Stderr, "FAIL: expected defaults (default, 8080, false, []), got %+v\n", cfg1)
		os.Exit(1)
	}

	// Assertion 2: Parse short flags (-n, -p, -v) and positional arguments
	var cfg2 pflagcli.Config
	fs2 := pflagcli.NewFlagSet("test-short", &cfg2)
	if err := fs2.Parse([]string{"-n", "custom-app", "-p", "9000", "-v", "extra1", "extra2"}); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: short flags parsing failed: %v\n", err)
		os.Exit(1)
	}
	if cfg2.Name != "custom-app" || cfg2.Port != 9000 || cfg2.Verbose != true {
		fmt.Fprintf(os.Stderr, "FAIL: short flags values mismatch: %+v\n", cfg2)
		os.Exit(1)
	}
	if fs2.NArg() != 2 || fs2.Args()[0] != "extra1" || fs2.Args()[1] != "extra2" {
		fmt.Fprintf(os.Stderr, "FAIL: positional arguments mismatch: %v\n", fs2.Args())
		os.Exit(1)
	}

	// Assertion 3: Parse long flags (--name, --port, --tags) and check Changed()
	var cfg3 pflagcli.Config
	fs3 := pflagcli.NewFlagSet("test-long", &cfg3)
	if err := fs3.Parse([]string{"--name=server", "--port=3000", "--tags=alpha,beta"}); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: long flags parsing failed: %v\n", err)
		os.Exit(1)
	}
	if cfg3.Name != "server" || cfg3.Port != 3000 || len(cfg3.Tags) != 2 || cfg3.Tags[0] != "alpha" || cfg3.Tags[1] != "beta" {
		fmt.Fprintf(os.Stderr, "FAIL: long flags values mismatch: %+v\n", cfg3)
		os.Exit(1)
	}
	if !fs3.Changed("name") || !fs3.Changed("port") || !fs3.Changed("tags") || fs3.Changed("verbose") {
		fmt.Fprintf(os.Stderr, "FAIL: Changed() reporting incorrect status\n")
		os.Exit(1)
	}

	// Assertion 4: Direct pflag.FlagSet usage with Lookup and type getters
	directFS := pflag.NewFlagSet("direct", pflag.ContinueOnError)
	directFS.IntP("count", "c", 10, "item count")
	directFS.StringP("host", "H", "127.0.0.1", "host address")
	if err := directFS.Parse([]string{"-c", "42", "-H", "localhost"}); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: direct flag parsing failed: %v\n", err)
		os.Exit(1)
	}
	countVal, err := directFS.GetInt("count")
	if err != nil || countVal != 42 {
		fmt.Fprintf(os.Stderr, "FAIL: GetInt('count') failed: %v, got %d\n", err, countVal)
		os.Exit(1)
	}
	hostVal, err := directFS.GetString("host")
	if err != nil || hostVal != "localhost" {
		fmt.Fprintf(os.Stderr, "FAIL: GetString('host') failed: %v, got %s\n", err, hostVal)
		os.Exit(1)
	}

	// Assertion 5: Error handling on unknown flag with ContinueOnError
	errFS := pflag.NewFlagSet("err-test", pflag.ContinueOnError)
	errFS.String("known", "val", "known flag")
	if err := errFS.Parse([]string{"--unknown-flag"}); err == nil {
		fmt.Fprintf(os.Stderr, "FAIL: expected error on unknown flag, got nil\n")
		os.Exit(1)
	}

	fmt.Println("PASS: pflag.FlagSet contract passed")
}

Seeder de origen

anónimo