Simplifying String Validation in Go: Introducing validatorgo
Nov 14, 2024 pm 08:20 PMA library of string validators and sanitizers, based on the js library validator.js
Why Choose validatorgo?
Why not use popular Go libraries like Package validator or govalidator? While both libraries are well-known, validatorgo focuses on standalone string validation and provides an extensive collection of customizable validators inspired by validator.js, which neither of these Go libraries fully implement.
Here’s how validatorgo stands out compared to go-playground/validator and govalidator:
1. Compared to go-playground/validator
Direct String Validation: go-playground/validator is primarily built for validating struct fields using tags, which is ideal for handling JSON or struct-based data. However, it’s not designed for validating individual strings, which ValidatorGo does seamlessly, without the need for struct tags or additional setup.
Performance: go-playground/validator relies on reflection to dynamically inspect struct tags. While powerful, reflection can introduce performance overhead—especially when large or complex data structures are validated. validatorgo avoids reflection, which boosts performance, making it faster and more efficient for scenarios where single-field validations are needed.
2. Compared to asaskevich/govalidator
- Customization and Flexibility: govalidator provides a range of validators for strings, but validatorgo enhances flexibility by allowing specific options and configurations for individual validators. For example, date formats or locale specifications can be customized, giving developers more control over validation rules tailored to project needs.
Project Motivation
I created validatorgo to serve as a dependency for another Go library called ginvalidator, 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.
go get github.com/bube054/validatorgo
Simple validator example
import ( "fmt" "github.com/bube054/validatorgo" )
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.
Validator | Description |
---|---|
Contains | Checks if a string contains a specified substring. |
Equals | Validates if a string is exactly equal to a comparison string. |
IsAbaRouting | Checks if the string is a valid ABA routing number (US bank accounts). |
IsAfter | Validates if a date string is after a specified date. |
IsAlpha | Ensures the string contains only letters (a-zA-Z). |
IsAlphanumeric | Validates if a string contains only letters and numbers. |
IsAscii | Checks if the string contains only ASCII characters. |
IsBase32 | Checks if the string is a valid Base32 encoded value. |
IsBase64 | Validates if a string is in Base64 encoding. |
IsBefore | Ensures the date is before a specified date. |
IsBoolean | Checks if the string is either "true" or "false". |
IsCreditCard | Validates if the string is a valid credit card number. |
IsCurrency | Checks if the string is a valid currency format. |
IsDate | Validates if a string is a valid date. |
IsDecimal | Ensures the string represents a valid decimal number. |
IsEmail | Checks if the string is a valid email address format. |
IsEmpty | Validates if a string is empty. |
IsFQDN | Checks if the string is a fully qualified domain name. |
IsFloat | Ensures the string represents a floating-point number. |
IsHexColor | Validates if a string is a valid hex color (e.g., #FFFFFF). |
IsIP | Checks if the string is a valid IP address (IPv4 or IPv6). |
IsISO8601 | Validates if the string is in ISO8601 date format. |
IsLength | Checks if the string’s length is within a specified range. |
IsMimeType | Validates if the string is a valid MIME type. |
IsMobilePhone | Checks if the string is a valid mobile phone number for specified locales. |
IsMongoID | Validates if the string is a valid MongoDB ObjectID. |
IsNumeric | Ensures the string contains only numeric characters. |
IsPostalCode | Checks if the string is a valid postal code for specified locale. |
IsRFC3339 | Validates if the string is in RFC3339 date format. |
IsSlug | Checks if the string is URL-friendly (only letters, numbers, and dashes). |
IsStrongPassword | Ensures the string meets common password strength requirements. |
IsURL | Validates if the string is a URL. |
IsUUID | Checks if the string is a valid UUID (versions 1-5). |
IsUpperCase | Ensures the string is all uppercase. |
IsVAT | Checks if the string is a valid VAT number for specified countries. |
Matches | Validates if the string matches a specified regular expression. |
This table should cover most validators currently available in validatorgo. Make sure to refer to the package's documentation for more detailed usage of each validator.
? Caution
When using a validator that requires an options struct (either a pointer or non-pointer), always provide values for all the struct fields explicitly.
Unlike in validator.js, 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
go get github.com/bube054/validatorgo
Simple sanitizer example
import ( "fmt" "github.com/bube054/validatorgo" )
Sanitizers
Sanitizer | Description |
---|---|
Trim | Removes whitespace from both ends of the string. |
LTrim | Removes whitespace from the left side of the string. |
RTrim | Removes whitespace from the right side of the string. |
ToLower | Converts the entire string to lowercase. |
ToUpper | Converts the entire string to uppercase. |
Escape | Escapes HTML characters in the string to prevent injection attacks. |
Unescape | Reverts escaped HTML characters back to normal characters. |
NormalizeEmail | Standardizes an email address, e.g., removing dots in Gmail addresses. |
Blacklist | Removes characters from the string that match specified characters or patterns. |
Whitelist | Retains only characters in the string that match specified characters or patterns. |
Replace | Replaces occurrences of a substring with a specified replacement. |
StripLow | Removes control characters, optionally allowing some specified ones. |
TrimSpace | Trims all types of whitespace from both ends of the string. |
ToBoolean | Converts common truthy and falsy values in strings into boolean true or false. |
ToInt | Converts a numeric string into an integer, if possible. |
ToFloat | Converts a numeric string into a floating-point number, if possible. |
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)
The above is the detailed content of Simplifying String Validation in Go: Introducing validatorgo. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics

Go compiles the program into a standalone binary by default, the main reason is static linking. 1. Simpler deployment: no additional installation of dependency libraries, can be run directly across Linux distributions; 2. Larger binary size: Including all dependencies causes file size to increase, but can be optimized through building flags or compression tools; 3. Higher predictability and security: avoid risks brought about by changes in external library versions and enhance stability; 4. Limited operation flexibility: cannot hot update of shared libraries, and recompile and deployment are required to fix dependency vulnerabilities. These features make Go suitable for CLI tools, microservices and other scenarios, but trade-offs are needed in environments where storage is restricted or relies on centralized management.

To create a buffer channel in Go, just specify the capacity parameters in the make function. The buffer channel allows the sending operation to temporarily store data when there is no receiver, as long as the specified capacity is not exceeded. For example, ch:=make(chanint,10) creates a buffer channel that can store up to 10 integer values; unlike unbuffered channels, data will not be blocked immediately when sending, but the data will be temporarily stored in the buffer until it is taken away by the receiver; when using it, please note: 1. The capacity setting should be reasonable to avoid memory waste or frequent blocking; 2. The buffer needs to prevent memory problems from being accumulated indefinitely in the buffer; 3. The signal can be passed by the chanstruct{} type to save resources; common scenarios include controlling the number of concurrency, producer-consumer models and differentiation

Goensuresmemorysafetywithoutmanualmanagementthroughautomaticgarbagecollection,nopointerarithmetic,safeconcurrency,andruntimechecks.First,Go’sgarbagecollectorautomaticallyreclaimsunusedmemory,preventingleaksanddanglingpointers.Second,itdisallowspointe

Go is ideal for system programming because it combines the performance of compiled languages ??such as C with the ease of use and security of modern languages. 1. In terms of file and directory operations, Go's os package supports creation, deletion, renaming and checking whether files and directories exist. Use os.ReadFile to read the entire file in one line of code, which is suitable for writing backup scripts or log processing tools; 2. In terms of process management, the exec.Command function of the os/exec package can execute external commands, capture output, set environment variables, redirect input and output flows, and control process life cycles, which are suitable for automation tools and deployment scripts; 3. In terms of network and concurrency, the net package supports TCP/UDP programming, DNS query and original sets.

In Go language, calling a structure method requires first defining the structure and the method that binds the receiver, and accessing it using a point number. After defining the structure Rectangle, the method can be declared through the value receiver or the pointer receiver; 1. Use the value receiver such as func(rRectangle)Area()int and directly call it through rect.Area(); 2. If you need to modify the structure, use the pointer receiver such as func(r*Rectangle)SetWidth(...), and Go will automatically handle the conversion of pointers and values; 3. When embedding the structure, the method of embedded structure will be improved, and it can be called directly through the outer structure; 4. Go does not need to force use getter/setter,

In Go, an interface is a type that defines behavior without specifying implementation. An interface consists of method signatures, and any type that implements these methods automatically satisfy the interface. For example, if you define a Speaker interface that contains the Speak() method, all types that implement the method can be considered Speaker. Interfaces are suitable for writing common functions, abstract implementation details, and using mock objects in testing. Defining an interface uses the interface keyword and lists method signatures, without explicitly declaring the type to implement the interface. Common use cases include logs, formatting, abstractions of different databases or services, and notification systems. For example, both Dog and Robot types can implement Speak methods and pass them to the same Anno

In Go language, string operations are mainly implemented through strings package and built-in functions. 1.strings.Contains() is used to determine whether a string contains a substring and returns a Boolean value; 2.strings.Index() can find the location where the substring appears for the first time, and if it does not exist, it returns -1; 3.strings.ReplaceAll() can replace all matching substrings, and can also control the number of replacements through strings.Replace(); 4.len() function is used to obtain the length of the bytes of the string, but when processing Unicode, you need to pay attention to the difference between characters and bytes. These functions are often used in scenarios such as data filtering, text parsing, and string processing.

TheGoiopackageprovidesinterfaceslikeReaderandWritertohandleI/Ooperationsuniformlyacrosssources.1.io.Reader'sReadmethodenablesreadingfromvarioussourcessuchasfilesorHTTPresponses.2.io.Writer'sWritemethodfacilitateswritingtodestinationslikestandardoutpu
