github.com/Masterminds/semver/v3 v3.2.0: semver.IncPatch

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 semver.IncPatch in pkg:golang/github.com/Masterminds/semver/v3@v3.2.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/Masterminds/semver/v3@v3.2.0
Demonstrate these symbols/APIs:
  - semver.IncPatch

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:25c26fd9669744edfbd6a128cf17d954404654975413643ea5db52ddb28ca74e","contract":["semver.IncPatch increments the patch component of standard semantic versions while leaving the original version instance unmodified","semver.IncPatch strips prerelease identifiers and build metadata from prerelease versions upon patch promotion"],"goal":"verify semver.IncPatch in pkg:golang/github.com/Masterminds/semver/v3@v3.2.0","kind":"HOW","packages":["pkg:golang/github.com/Masterminds/semver/v3@v3.2.0"],"schemaVersion":1,"symbols":["semver.IncPatch"]},"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/Masterminds/semver/v3@v3.2.0"],"schemaVersion":1,"subject":"pkg:golang/github.com/Masterminds/semver/v3@v3.2.0","symbols":["semver.IncPatch"],"verifierAdapter":"golang@1"}

module example.com/semver-incpatch-sample

go 1.22.0

require github.com/Masterminds/semver/v3 v3.2.0

github.com/Masterminds/semver/v3 v3.2.0 h1:3MEsd0SM6jqZojhjLWWeBY+Kcjy9i6MQAeY7YgDP83g=
github.com/Masterminds/semver/v3 v3.2.0/go.mod h1:qvl/7zhW3nngYb5+80sSMF+FG2BjYrf8m9wsX0PNOMQ=

package semverpatch

import (
	"fmt"

	"github.com/Masterminds/semver/v3"
)

// BumpPatch parses a semantic version string and returns the version with its patch component incremented.
// Any prerelease tags or build metadata are cleared upon patch increment.
func BumpPatch(versionStr string) (string, error) {
	v, err := semver.NewVersion(versionStr)
	if err != nil {
		return "", fmt.Errorf("invalid semver: %w", err)
	}
	next := v.IncPatch()
	return next.String(), nil
}

// NextPatchVersion returns a new Version instance with its patch number incremented.
func NextPatchVersion(v *semver.Version) semver.Version {
	if v == nil {
		return semver.Version{}
	}
	return v.IncPatch()
}

{
  "schemaVersion": 1,
  "goal": "verify semver.IncPatch in pkg:golang/github.com/Masterminds/semver/v3@v3.2.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/Masterminds/semver/v3@v3.2.0"
  ],
  "symbols": [
    "semver.IncPatch"
  ]
}

package main

import (
	"fmt"
	"os"

	semverpatch "example.com/semver-incpatch-sample"
	"github.com/Masterminds/semver/v3"
)

func main() {
	// Assertion 1: IncPatch increments the patch component of a standard release version
	v1, err := semver.NewVersion("1.2.3")
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: failed to parse 1.2.3: %v\n", err)
		os.Exit(1)
	}
	inc1 := v1.IncPatch()
	if inc1.String() != "1.2.4" || inc1.Major() != 1 || inc1.Minor() != 2 || inc1.Patch() != 4 {
		fmt.Fprintf(os.Stderr, "FAIL: expected 1.2.4, got %s (major: %d, minor: %d, patch: %d)\n",
			inc1.String(), inc1.Major(), inc1.Minor(), inc1.Patch())
		os.Exit(1)
	}

	// Assertion 2: Original version is immutable and remains unchanged
	if v1.String() != "1.2.3" || v1.Patch() != 3 {
		fmt.Fprintf(os.Stderr, "FAIL: original version modified: %s (patch: %d)\n", v1.String(), v1.Patch())
		os.Exit(1)
	}

	// Assertion 3: IncPatch on a prerelease version strips prerelease/build metadata while keeping patch for release
	v2, err := semver.NewVersion("2.0.1-rc.1+build.99")
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: failed to parse 2.0.1-rc.1+build.99: %v\n", err)
		os.Exit(1)
	}
	inc2 := v2.IncPatch()
	if inc2.String() != "2.0.1" || inc2.Prerelease() != "" || inc2.Metadata() != "" || inc2.Patch() != 1 {
		fmt.Fprintf(os.Stderr, "FAIL: expected 2.0.1 with cleared prerelease and metadata, got %s (pre: %s, meta: %s)\n",
			inc2.String(), inc2.Prerelease(), inc2.Metadata())
		os.Exit(1)
	}

	// Assertion 4: IncPatch on the released version then increments to next patch
	inc2Next := inc2.IncPatch()
	if inc2Next.String() != "2.0.2" || inc2Next.Patch() != 2 {
		fmt.Fprintf(os.Stderr, "FAIL: expected 2.0.2, got %s\n", inc2Next.String())
		os.Exit(1)
	}

	// Assertion 5: IncPatch on zero version increments patch to 1
	v3, err := semver.NewVersion("0.0.0")
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: failed to parse 0.0.0: %v\n", err)
		os.Exit(1)
	}
	inc3 := v3.IncPatch()
	if inc3.String() != "0.0.1" || inc3.Patch() != 1 {
		fmt.Fprintf(os.Stderr, "FAIL: expected 0.0.1, got %s\n", inc3.String())
		os.Exit(1)
	}

	// Assertion 6: BumpPatch helper correctly increments standard version
	bumped, err := semverpatch.BumpPatch("3.4.5")
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: BumpPatch failed: %v\n", err)
		os.Exit(1)
	}
	if bumped != "3.4.6" {
		fmt.Fprintf(os.Stderr, "FAIL: BumpPatch returned %s, expected 3.4.6\n", bumped)
		os.Exit(1)
	}

	// Assertion 7: BumpPatch helper on prerelease removes prerelease tag
	bumpedPre, err := semverpatch.BumpPatch("3.4.5-beta.2")
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: BumpPatch failed on prerelease: %v\n", err)
		os.Exit(1)
	}
	if bumpedPre != "3.4.5" {
		fmt.Fprintf(os.Stderr, "FAIL: BumpPatch on prerelease returned %s, expected 3.4.5\n", bumpedPre)
		os.Exit(1)
	}

	// Assertion 8: BumpPatch returns error on invalid semantic version
	if _, err := semverpatch.BumpPatch("not-a-valid-semver"); err == nil {
		fmt.Fprintf(os.Stderr, "FAIL: BumpPatch expected error on invalid semver, got nil\n")
		os.Exit(1)
	}

	// Assertion 9: NextPatchVersion helper handles pointer version
	v4 := semver.MustParse("5.10.99")
	inc4 := semverpatch.NextPatchVersion(v4)
	if inc4.String() != "5.10.100" || inc4.Patch() != 100 {
		fmt.Fprintf(os.Stderr, "FAIL: NextPatchVersion expected 5.10.100, got %s\n", inc4.String())
		os.Exit(1)
	}

	fmt.Println("PASS: semver.IncPatch contract passed")
}