CodeSampleX

Ejemplo

github.com/magiconair/properties v1.8.1: Decode

Muestra verificada para golang github.com/magiconair/properties v1.8.1: Decode. El contrato se ejecutó en go 1.26 · linux debian/x64 · docker y pasó.

sha256:06d5dce5753e431d75e5c7d3b3f59301635e3a85f63bfde2506bb3225eb87aaf

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 linux 24 · ubuntu · glibc 2.39 x64 go

Entornos de las ejecuciones de verificación

Entorno Contrato Etapas Ejecución
go 1.26 · linux debian/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1golang:1.26@sha256:e30143be198a…
2026-10-29

Caso

HOW
Objetivo
verify Decode in pkg:golang/github.com/magiconair/properties@v1.8.1
Paquetes
Símbolos
  • Decode
Creado
2026-10-29T00:27:40Z

Contrato

  1. (*Properties).Decode populates exported struct fields from properties using struct tags, default= values, semicolon-separated slice values (trimmed of whitespace and ignoring empty segments), time.Duration values, nested struct prefixes, and string-keyed maps while ignoring fields tagged with properties:"-"
  2. (*Properties).Decode applies semicolon-separated default values on slice and nested struct fields when the corresponding property keys are absent
  3. (*Properties).Decode returns an error when a required struct field without a default value is missing, when a property value cannot be converted to the target field type, or when the target argument is not a pointer to a struct

Archivos

  • PROMPT.md
  • csx.json
  • go.mod
  • go.sum
  • main.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 Decode in pkg:golang/github.com/magiconair/properties@v1.8.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/magiconair/properties@v1.8.1
Demonstrate these symbols/APIs:
  - Decode

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:e0244ab15fd2a9027561d0fa1211fdd133a11d676984962451c4e146c6e99db1","contract":["(*Properties).Decode populates exported struct fields from properties using struct tags, default= values, semicolon-separated slice values (trimmed of whitespace and ignoring empty segments), time.Duration values, nested struct prefixes, and string-keyed maps while ignoring fields tagged with properties:\"-\"","(*Properties).Decode applies semicolon-separated default values on slice and nested struct fields when the corresponding property keys are absent","(*Properties).Decode returns an error when a required struct field without a default value is missing, when a property value cannot be converted to the target field type, or when the target argument is not a pointer to a struct"],"goal":"verify Decode in pkg:golang/github.com/magiconair/properties@v1.8.1","kind":"HOW","packages":["pkg:golang/github.com/magiconair/properties@v1.8.1"],"schemaVersion":1,"symbols":["Decode"]},"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/magiconair/properties@v1.8.1"],"schemaVersion":1,"subject":"pkg:golang/github.com/magiconair/properties@v1.8.1","symbols":["Decode"],"verifierAdapter":"golang@1"}
go.mod
module example.com/sample

go 1.21

require github.com/magiconair/properties v1.8.1
go.sum
github.com/magiconair/properties v1.8.1 h1:ZC2Vc7/ZFkGmsVC9KvOjumD+G5lXy2RtTKyzRKO2BQ4=
github.com/magiconair/properties v1.8.1/go.mod h1:PppfXfuXeibc/6YijjN8zIbojt8czPbwD3XqdrwzmxQ=
main.go
package main

import (
	"fmt"
	"time"

	"github.com/magiconair/properties"
)

type ServerConfig struct {
	Host    string        `properties:"host"`
	Port    int           `properties:"port,default=8080"`
	Timeout time.Duration `properties:"timeout,default=5s"`
	Tags    []string      `properties:"tags"`
	Ignored string        `properties:"-"`
}

func DecodeServerConfig(input string) (ServerConfig, error) {
	var cfg ServerConfig
	p, err := properties.LoadString(input)
	if err != nil {
		return cfg, err
	}
	err = p.Decode(&cfg)
	return cfg, err
}

func main() {
	cfg, err := DecodeServerConfig("host=localhost\ntags=api;v1\n")
	if err != nil {
		panic(err)
	}
	fmt.Printf("%s:%d timeout=%s tags=%v\n", cfg.Host, cfg.Port, cfg.Timeout, cfg.Tags)
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify Decode in pkg:golang/github.com/magiconair/properties@v1.8.1",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/magiconair/properties@v1.8.1"
  ],
  "symbols": [
    "Decode"
  ]
}
test/contract.go
package main

import (
	"fmt"
	"os"
	"reflect"
	"time"

	"github.com/magiconair/properties"
)

type InnerConfig struct {
	Enabled bool `properties:"enabled,default=true"`
}

type FullConfig struct {
	Host    string            `properties:"host"`
	Port    int               `properties:"port,default=8080"`
	Timeout time.Duration     `properties:"timeout,default=3s"`
	Tags    []string          `properties:"tags,default=alpha;beta"`
	Nested  InnerConfig       `properties:"nested"`
	Labels  map[string]string `properties:"labels"`
	Skipped string            `properties:"-"`
}

func fail(msg string, args ...interface{}) {
	fmt.Fprintf(os.Stderr, "FAIL: "+msg+"\n", args...)
	os.Exit(1)
}

func main() {
	// 1. Decode populates struct fields using property keys, defaults, semicolon-separated slices, durations, nested structs, maps, and ignores "-" tags.
	p, err := properties.LoadString(`
host = example.com
timeout = 10s
tags = web ; api ; ; prod
nested.enabled = false
labels.env = staging
labels.tier = backend
Skipped = should-not-be-set
`)
	if err != nil {
		fail("LoadString failed: %v", err)
	}

	var cfg FullConfig
	cfg.Skipped = "keep"
	if err := p.Decode(&cfg); err != nil {
		fail("Decode failed on valid properties: %v", err)
	}

	if cfg.Host != "example.com" {
		fail("expected Host=example.com, got %q", cfg.Host)
	}
	if cfg.Port != 8080 {
		fail("expected default Port=8080, got %d", cfg.Port)
	}
	if cfg.Timeout != 10*time.Second {
		fail("expected Timeout=10s, got %v", cfg.Timeout)
	}
	expectedTags := []string{"web", "api", "prod"}
	if !reflect.DeepEqual(cfg.Tags, expectedTags) {
		fail("expected Tags=%v, got %v", expectedTags, cfg.Tags)
	}
	if cfg.Nested.Enabled != false {
		fail("expected Nested.Enabled=false, got true")
	}
	expectedLabels := map[string]string{"env": "staging", "tier": "backend"}
	if !reflect.DeepEqual(cfg.Labels, expectedLabels) {
		fail("expected Labels=%v, got %v", expectedLabels, cfg.Labels)
	}
	if cfg.Skipped != "keep" {
		fail("expected Skipped field with properties:\"-\" to remain unchanged, got %q", cfg.Skipped)
	}

	// 2. Decode applies semicolon-separated slice defaults when key is absent.
	pDefaults := properties.LoadMap(map[string]string{"host": "localhost"})
	var cfgDefaults FullConfig
	if err := pDefaults.Decode(&cfgDefaults); err != nil {
		fail("Decode with defaults failed: %v", err)
	}
	if !reflect.DeepEqual(cfgDefaults.Tags, []string{"alpha", "beta"}) {
		fail("expected default Tags=[alpha beta], got %v", cfgDefaults.Tags)
	}
	if cfgDefaults.Nested.Enabled != true {
		fail("expected default Nested.Enabled=true, got false")
	}

	// 3. Decode returns an error when a required field without a default is missing, when a value fails type conversion, or when target is not a struct pointer.
	pMissing := properties.LoadMap(map[string]string{"port": "9000"})
	var cfgMissing FullConfig
	if err := pMissing.Decode(&cfgMissing); err == nil {
		fail("expected Decode to return an error when required key 'host' is missing")
	}

	pInvalid := properties.LoadMap(map[string]string{"host": "localhost", "port": "not-an-int"})
	var cfgInvalid FullConfig
	if err := pInvalid.Decode(&cfgInvalid); err == nil {
		fail("expected Decode to return an error on invalid int conversion")
	}

	if err := pDefaults.Decode(cfgDefaults); err == nil {
		fail("expected Decode to return an error when passed a non-pointer struct value")
	}

	fmt.Println("contract ok")
}

Seeder de origen

anónimo