Simplifying String Validation in Go: Introducing validatorgo

A library of string validators and sanitizers, based on the js library ?

Why not use popular Go libraries like ? While both libraries are well-known, validatorgo focuses on standalone string validation and provides an extensive collection of customizable validators inspired by , which validates HTTP requests in Go web applications. Inspired by express-validator, the popular validation library for Node.js and Express, ValidatorGo fills a gap in the Go ecosystem for efficient, customizable, and straightforward string validation. Since other libraries were either overkill, lacked functionality, or didn’t meet my use case, I built validatorgo to offer a practical solution.

Installation

Using go get.

 go get github.com/bube054/validatorgo

Then import the package into your own code.

 import (

   "fmt"

   "github.com/bube054/validatorgo"

 )

If you are unhappy using the long validatorgo package name, you can do this.

 import (

   "fmt"

   vgo "github.com/bube054/validatorgo"

 )

Simple validator example

 func main(){

   id := "5f2a6c69e1d7a4e0077b4e6b"

   validId := vgo.IsMongoID(id)

   fmt.Println(validId) // true

 }

Some Validators

Below is a list of validators provided by the validatorgo package, which covers various string formats and types, making it versatile for multiple validation needs.

This table should cover most validators currently available in validatorgo. Make sure to refer to the , where missing fields are automatically set to defaults, Go uses strict types.

This means missing values will default to false for booleans, 0 for number types, etc.

Not specifying all fields could lead to unexpected behavior if you're used to the JavaScript version.

Examples

  // do this (using the default options specified in the docs)

  ok := validatorgo.IsFQDN("example", nil)



  // or this (explicitly setting all possible fields for the structs)

  ok := validatorgo.IsFQDN("example", &validatorgo.IsFQDNOpts{

    RequireTld: false,

    AllowUnderscores: false,

    AllowTrailingDot: true,

    AllowNumericTld: false,

    IgnoreMaxLength: true

  })



  // but rarely this(not explicitly setting all possible fields)

  ok := validatorgo.IsFQDN("example", &validatorgo.IsFQDNOpts{ RequireTld: false, })

Simple sanitizer example

  import (

   "fmt"

   "github.com/bube054/validatorgo/sanitizer"

 )



 func main(){

   str := sanitizer.Whitelist("Hello123 World!", "a-zA-Z")

   fmt.Println(str) // "HelloWorld"

 }

Sanitizers

These sanitizers are often used to ensure data consistency and security by stripping out or modifying potentially unwanted or dangerous characters.

Make sure to refer to the official validatorgo documentation for specific implementations and examples of each sanitizer.

Summary

validatorgo is the ideal choice if you need:

• 
  Efficient, reflection-free validations for individual fields without the performance costs associated with struct-based reflection.


• 
  Highly customizable validation options that align with modern data formats, providing the same robustness as validator.js.

With validatorgo, you get a tool specifically designed for string validation, supporting both standalone and web application requirements in Go.

Maintainers

• 
  bube054 - Attah Gbubemi David (author)