doc.go

/*
Package govalidate provides struct validation using Go struct tags.
It supports 20+ built-in rules, nested struct validation, slice element
validation, custom rule registration, and JSON field name support —
all with zero external dependencies.

# Quick Start

	type User struct {
	    Name     string `json:"name"     validate:"required,min=3,max=50"`
	    Email    string `json:"email"    validate:"required,email"`
	    Age      int    `json:"age"      validate:"gte=0,lte=150"`
	    Password string `json:"password" validate:"required,min=8"`
	}

	errs := govalidate.Validate(User{Name: "Jo", Email: "bad"})
	if errs.HasErrors() {
	    for _, e := range errs.Errors {
	        fmt.Printf("%s: %s\n", e.Field, e.Message)
	    }
	}

# Built-in Rules

String: required, min, max, len, email, url, ip, alpha, alphanum,
numeric, lowercase, uppercase, contains, startswith, endswith, oneof,
regex, datetime.

Numeric: min, max, gt, gte, lt, lte.

Slice/Map: min (min items), max (max items), len (exact count).

# Nested Structs

GoValidate automatically recurses into nested structs and reports
errors with dot-notation field names:

	type Order struct {
	    Customer Customer `validate:"required"`
	    Items    []Item   `validate:"min=1"`
	}

	// Error: "customer.name: is required"
	// Error: "Items[0].Price: must be > 0"

# Custom Rules

	govalidate.RegisterRule("even", func(v reflect.Value, param string) string {
	    if v.Kind() == reflect.Int && v.Int()%2 != 0 {
	        return "must be an even number"
	    }
	    return ""
	})

	type Config struct {
	    Workers int `validate:"even,min=2"`
	}

# Error Handling

The [ValidationError] type provides field-level error access:

	errs.HasErrors()            // any errors?
	errs.HasField("email")      // specific field?
	errs.FieldErrors("email")   // all errors for field
	errs.Map()                  // map[string][]string for API responses
	errs.Error()                // combined error string
*/
package govalidate