validator

README

Validator

Validator can be executed against any struct / interface to determine if it is valid.

To install:

go get -u github.com/benjivesterby/validator

To use validator

1. import github.com/benjivesterby/validator
2. execute boolean validation: validator.Valid(obj1, obj2, ..., objN)
3. execute validation assertion: validator.Assert(obj1, obj2, ..., objN)

Valid() returns a boolean indicating validity

Assert() returns a nil error if the inputs are valid, and returns an error for invalid arguments, and the error specifies the index of the erroneous value

To implement your own validator use the interface method Validate() bool as shown below:

import "github.com/benjivesterby/validator"

type testStruct struct {
    valid bool
}

// Implement the validate method on your struct
func(this testStruct) Validate() bool {
    return this.valid
}

// This accepts an interface. If the interface passed to it is valid it returns true,
// otherwise it returns false.
validator.Valid(testStruct{true})

This libary will check for nil first on any nillable type, then it uses a type swtich to check for validity on known types.

• For slices it will indicate which element of the slice that is passed in is invalid when using Assert
• Valid will also check individual slice indexes but will not indicate which is invalid since it only returns a bool

Documentation

Overview

Package validator sets up several methods for simple validation as well as setting up an interface which when implemented allows for custom validation logic by the implementor. `Valid()` returns a boolean indicating if the value(s) passed into it are valid based on the different types. `Assert()` returns an error indicating `nil` if the values are valid. Otherwise `Assert()` returns an error indicating the index of the value(s) passed into it as to which was determined to be invalid.

Index

• func Assert(objs ...interface{}) error
• func IsValid(objs ...interface{}) bool
• func Valid(objs ...interface{}) bool

Functions

func Assert

func Assert(objs ...interface{}) error

Assert determines the validity of each value passed in to determine if the inputs are valid. A non-nil error return indicates an invalid assertion and a nil error returns indicates validity

func IsValid

func IsValid(objs ...interface{}) bool

IsValid is DEPRECATED, replaced by Valid. This method will be available until version 1.1.0

func Valid

func Valid(objs ...interface{}) bool

Valid reads in an object, and checks to see if the object implements the validator interface if the object does then it executes the objects validate method and returns that