Blazing fast, zero-allocation, type-safe validation for Go

🚀 Overview

⚡ Why govalid?

🎯 Performance Benefits

👨‍💻 Developer Experience

🔧 Comprehensive Go Support

📊 Performance Comparison

📦 Installation

Defaults to latest @ and version to install specific release

go install github.com/sivchari/govalid/cmd/govalid

# Clone the repositorygit clone https://github.com/sivchari/govalid.git# Navigate to the project directorycd govalid# Install the toolgo install ./...

govalid -h

🎯 Quick Start

1. Define Your Struct

// Add validation markers above your struct// +govalid:requiredtypePersonstruct {Namestring`json:"name"`// +govalid:emailEmailstring`json:"email"`}

2. Generate Validation Code

govalid generate

// Code generated by govalid; DO NOT EDIT.import ("errors""github.com/sivchari/govalid"govaliderrors"github.com/sivchari/govalid/validation/errors""github.com/sivchari/govalid/validation/validationhelper")var (// ErrNilPerson is returned when the Person is nil.ErrNilPerson=errors.New("input Person is nil")// ErrPersonNameRequiredValidation is returned when the Name is required but not provided.ErrPersonNameRequiredValidation= govaliderrors.ValidationError{Reason:"field Name is required",Path:"Person.Name",Type:"required"}// ErrPersonEmailEmailValidation is the error returned when the field is not a valid email address.ErrPersonEmailEmailValidation= govaliderrors.ValidationError{Reason:"field Email must be a valid email address",Path:"Person.Email",Type:"email"})var_ govalid.Validator= (*Person)(nil)funcValidatePerson(t*Person)error {ift==nil {returnErrNilPerson}varerrs govaliderrors.ValidationErrorsift.Name=="" {err:=ErrPersonNameRequiredValidationerr.Value=t.Nameerrs=append(errs,err)}if!validationhelper.IsValidEmail(t.Email) {err:=ErrPersonEmailEmailValidationerr.Value=t.Emailerrs=append(errs,err)}iflen(errs)>0 {returnerrs}returnnil}func (p*Person)Validate()error {returnValidatePerson(p)}

3. Use Generated Validators

funcmain() {p:=&Person{Name:"John",Email:"invalid-email"}iferr:=ValidatePerson(p);err!=nil {log.Printf("Validation failed: %v",err)// Output: Validation failed: field Email must be a valid email addressiferrors.Is(err,ErrPersonEmailEmailValidation) {log.Printf("Email validation failed, handle error as needed: %v",err)}}}

3.1 Handle multiple validation errors

funcmain() {p:=&Person{Name:"",Email:"invalid-email"}iferr:=ValidatePerson(p);err!=nil {log.Printf("Validation failed: %v",err)iferrors.Is(err,ErrPersonEmailEmailValidation) {log.Printf("First email error",err)}iferrors.Is(err,ErrPersonNameRequiredValidation) {log.Printf("Second required error %v",err)}}}

3.2 Validator Interface

funcmain() {p:=&Person{Name:"John",Email:"invalid-email"}iferr:=p.Validate();err!=nil {log.Printf("Validation failed: %v",err)}}

import ("net/http""github.com/sivchari/govalid/validation/middleware")funcCreatePersonHandler(w http.ResponseWriter,r*http.Request) {w.Write([]byte("OK"))}funcmain() {http.HandleFunc("/person", middleware.ValidateRequest[*Person](CreatePersonHandler))http.ListenAndServe(":8080",nil)}

🔧 Advanced Features

Struct-Level Validation

// All fields will be validated as required// +govalid:requiredtypePersonstruct {NamestringEmailstringAgeint}

CEL Expression Support

typeUserstruct {// +govalid:cel=value >= 18 && value <= 120Ageint// +govalid:cel=value >= this.AgeRetirementAgeint}

Collection Support

// +govalid:maxitems=10typeUserListstruct {Users    []User// slice supportUserMapmap[string]User// map supportUserChanchanUser// channel support}

📝 Supported Markers

🚀 Performance Benchmarks

All with0 allocations vs competitors' 0-5 allocations

🔧 Development Setup

make install-lefthook

📄 License