govalid

govalid is a powerful tool designed for Go developers, enabling the generation of type-safe validation code based on struct field markers. It provides a validation process that eliminates runtime overhead and reflection costs, ensuring optimal performance and faster validation.

Key Features

• Zero Allocations: govalid ensures that all validation processes are executed without heap allocations, enhancing efficiency.
• High Performance: Compared to traditional reflection-based validators, govalid operates 5 to 44 times faster, making it one of the quickest validation tools available.
• Type Safety: Validation errors are caught at the code generation stage rather than at runtime, which significantly reduces the risk of runtime failures.
• Comprehensive Collection Support: govalid accommodates various collection types including maps, channels, slices, and arrays, providing full flexibility for most use cases.
• Advanced Validation Capabilities: By leveraging Common Expression Language (CEL), intricate validation rules can be implemented, thus enhancing the validation process.

Quick Start Guide

1. Define Your Struct with Markers: Use built-in markers to specify validation rules directly within your struct definition.

   //govalid:required
   type Person struct {
       Name  string `json:"name"`
       //govalid:email
       Email string `json:"email"`
   }
   

2. Generate Validation Code: Running the command will create the necessary validation code automatically.

　govalid ./... ```

3. Utilize the Validator: Integrate validation checks in your application logic, which will handle validation effortlessly.

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

Supported Validation Markers

Markers are a vital part of defining validation rules. Here’s a brief look at some of the available markers:

• required: Ensures the field cannot be zero value.
• gt: Validates the field to be greater than a specified value.
• email: Checks for a correctly formatted email address.
• And many others, including support for collection size validations with markers like maxitems and minitems.

Performance Metrics

govalid has demonstrated exceptional performance metrics in various validation scenarios:

Validator	govalid	Other Validators	Improvement
Required	1.9ns	85.5ns	44x
GT/LT	1.9ns	63.0ns	32x
MaxLength	15.7ns	73.5ns	5x
Email	38.2ns	649.4ns	17x

For detailed benchmark results, refer to the benchmarking documentation.

govalid streamlines the validation process in Go projects significantly, ensuring effective performance and reliability while maintaining type safety. Perfect for developers looking to implement efficient validation frameworks without sacrificing performance.