defaults

Overview ¶

Package defaults lets a Go library type declare schema defaults for its inputs in a type-safe, string-free way. A type lists them from a Defaults method, referring to its own fields directly:

func (f File) Defaults() []defaults.Default {
	return []defaults.Default{
		defaults.Value(f.Mode, 0o644),
		defaults.Value(f.Tags, map[string]string{}),
		defaults.NullableValue(f.Profile, "dev"),
	}
}

Value declares that a non-pointer field left out of a body takes the given value. NullableValue does the same for a pointer field while keeping explicit null as null. A field with no default, and not declared as a pointer, is required.

Because the fields are real struct fields, the Go compiler checks that they exist, that a rename updates them, and that a default matches its field's type. unobin reads these declarations from source at compile time (goschema); the methods are never called, so a returned value identifies the rule but not its field, which the compiler provides from source.