github.com/subosito/gotenv v1.6.0: StrictParse

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/subosito/gotenv.StrictParse in pkg:golang/github.com/subosito/gotenv@v1.6.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/subosito/gotenv@v1.6.0
Demonstrate these symbols/APIs:
  - github.com/subosito/gotenv.StrictParse

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.

{"case":{"caseId":"case:sha256:23aafe2e9ca959a3a5987ee48d2d43a24819dd8411cee2031bfd360ad3de00b0","contract":["gotenv.StrictParse decodes valid key-value pairs from an io.Reader into an Env map","gotenv.StrictParse handles quoted values and variable expansion within values","gotenv.StrictParse supports colon delimiters and export prefixes","gotenv.StrictParse returns an error when encountering malformed lines without delimiters","gotenv.StrictParse returns an error when multiline quoted values have missing closing quotes","gotenv.StrictParse does not mutate the process environment"],"goal":"verify github.com/subosito/gotenv.StrictParse in pkg:golang/github.com/subosito/gotenv@v1.6.0","kind":"HOW","packages":["pkg:golang/github.com/subosito/gotenv@v1.6.0"],"schemaVersion":1,"symbols":["github.com/subosito/gotenv.StrictParse"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","language":"go","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/subosito/gotenv@v1.6.0"],"schemaVersion":1,"subject":"pkg:golang/github.com/subosito/gotenv@v1.6.0","symbols":["github.com/subosito/gotenv.StrictParse"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

require github.com/subosito/gotenv v1.6.0

require golang.org/x/text v0.12.0 // indirect

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/stretchr/testify v1.7.5 h1:s5PTfem8p8EbKQOctVV53k6jCJt3UX4IEJzwh+C324Q=
github.com/stretchr/testify v1.7.5/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8=
github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
golang.org/x/text v0.12.0 h1:k+n5B8goJNdU7hSvEtMUz3d1Q6D/XW4COJSJR6fN0mc=
golang.org/x/text v0.12.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package main

import (
	"fmt"
	"strings"

	"github.com/subosito/gotenv"
)

func main() {
	rawEnv := "APP_NAME=example-service\nPORT=8080\nDEBUG=true\n"
	env, err := gotenv.StrictParse(strings.NewReader(rawEnv))
	if err != nil {
		fmt.Printf("failed to parse environment: %v\n", err)
		return
	}

	fmt.Printf("Parsed %d environment entries:\n", len(env))
	for k, v := range env {
		fmt.Printf("  %s=%s\n", k, v)
	}
}

{
  "schemaVersion": 1,
  "goal": "verify github.com/subosito/gotenv.StrictParse in pkg:golang/github.com/subosito/gotenv@v1.6.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/subosito/gotenv@v1.6.0"
  ],
  "symbols": [
    "github.com/subosito/gotenv.StrictParse"
  ]
}

package main

import (
	"fmt"
	"os"
	"strings"

	"github.com/subosito/gotenv"
)

func main() {
	// Assertion 1: gotenv.StrictParse decodes valid key-value pairs from an io.Reader into an Env map
	{
		raw := "PORT=8080\nHOST=localhost\nDEBUG=false\n# Comment line\n"
		env, err := gotenv.StrictParse(strings.NewReader(raw))
		if err != nil {
			fmt.Fprintf(os.Stderr, "assertion 1 failed: unexpected error: %v\n", err)
			os.Exit(1)
		}
		if env["PORT"] != "8080" || env["HOST"] != "localhost" || env["DEBUG"] != "false" {
			fmt.Fprintf(os.Stderr, "assertion 1 failed: unexpected values: %+v\n", env)
			os.Exit(1)
		}
		if len(env) != 3 {
			fmt.Fprintf(os.Stderr, "assertion 1 failed: expected 3 entries, got %d\n", len(env))
			os.Exit(1)
		}
	}

	// Assertion 2: gotenv.StrictParse handles quoted values and variable expansion within values
	{
		raw := "GREETING=\"hello world\"\nNAME='service'\nBASE_URL=http://localhost:8080\nAPI_URL=\"${BASE_URL}/v1\"\n"
		env, err := gotenv.StrictParse(strings.NewReader(raw))
		if err != nil {
			fmt.Fprintf(os.Stderr, "assertion 2 failed: unexpected error: %v\n", err)
			os.Exit(1)
		}
		if env["GREETING"] != "hello world" {
			fmt.Fprintf(os.Stderr, "assertion 2 failed: double quote value mismatch: %q\n", env["GREETING"])
			os.Exit(1)
		}
		if env["NAME"] != "service" {
			fmt.Fprintf(os.Stderr, "assertion 2 failed: single quote value mismatch: %q\n", env["NAME"])
			os.Exit(1)
		}
		if env["API_URL"] != "http://localhost:8080/v1" {
			fmt.Fprintf(os.Stderr, "assertion 2 failed: expanded variable mismatch: %q\n", env["API_URL"])
			os.Exit(1)
		}
	}

	// Assertion 3: gotenv.StrictParse supports colon delimiters and export prefixes
	{
		raw := "export FEATURE_FLAG=enabled\nTIMEOUT: 30s\n"
		env, err := gotenv.StrictParse(strings.NewReader(raw))
		if err != nil {
			fmt.Fprintf(os.Stderr, "assertion 3 failed: unexpected error: %v\n", err)
			os.Exit(1)
		}
		if env["FEATURE_FLAG"] != "enabled" || env["TIMEOUT"] != "30s" {
			fmt.Fprintf(os.Stderr, "assertion 3 failed: colon or export mismatch: %+v\n", env)
			os.Exit(1)
		}
	}

	// Assertion 4: gotenv.StrictParse returns an error when encountering malformed lines without delimiters
	{
		raw := "VALID=1\nTHIS_LINE_HAS_NO_DELIMITER\nANOTHER=2\n"
		env, err := gotenv.StrictParse(strings.NewReader(raw))
		if err == nil {
			fmt.Fprintf(os.Stderr, "assertion 4 failed: expected error for missing delimiter, got nil (env=%+v)\n", env)
			os.Exit(1)
		}
	}

	// Assertion 5: gotenv.StrictParse returns an error when multiline quoted values have missing closing quotes
	{
		raw := "UNCLOSED=\"unclosed string value\n"
		_, err := gotenv.StrictParse(strings.NewReader(raw))
		if err == nil {
			fmt.Fprintf(os.Stderr, "assertion 5 failed: expected error for unclosed quotes, got nil\n")
			os.Exit(1)
		}
	}

	// Assertion 6: gotenv.StrictParse does not mutate the process environment
	{
		key := "CSX_TEST_ISOLATION_CHECK_STRICT_PARSE"
		os.Unsetenv(key)
		raw := fmt.Sprintf("%s=should_not_leak_to_env\n", key)
		env, err := gotenv.StrictParse(strings.NewReader(raw))
		if err != nil {
			fmt.Fprintf(os.Stderr, "assertion 6 failed: unexpected error: %v\n", err)
			os.Exit(1)
		}
		if env[key] != "should_not_leak_to_env" {
			fmt.Fprintf(os.Stderr, "assertion 6 failed: env map missing key: %+v\n", env)
			os.Exit(1)
		}
		if val, present := os.LookupEnv(key); present {
			fmt.Fprintf(os.Stderr, "assertion 6 failed: process environment was mutated: %s=%s\n", key, val)
			os.Exit(1)
		}
	}

	fmt.Println("All contract assertions passed successfully.")
}