CodeSampleX

샘플

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

검증된 샘플 — golang github.com/magiconair/properties v1.8.1: Decode. go 1.26 · linux debian/x64 · docker에서 contract를 실행해 통과했습니다: (*Properties).Decode populates…

sha256:06d5dce5753e431d75e5c7d3b3f59301635e3a85f63bfde2506bb3225eb87aaf

이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다. 통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다. MIT-0

실행 증거

선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.

증거 기준
서명된 컨트랙트 통과
검증 영수증
1
빌드한 서명 키
1
선언된 환경 linux 24 · ubuntu · glibc 2.39 x64 go

검증 실행 환경

환경 컨트랙트 단계 실행일
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

케이스

HOW
목표
verify Decode in pkg:golang/github.com/magiconair/properties@v1.8.1
패키지
심벌
  • Decode
생성일
2026-10-29T00:27:40Z

컨트랙트

  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

파일

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

소스 아티팩트 내려받기 (tar.gz)

소스

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")
}

오리진 시더

익명