add contains, contains any, contains rune, excludes, excludes and excludesrune validation functions + tests + docuemtation

for #43

baked_in.go

@@ -5,43 +5,77 @@ import (
 	"net/url"
 	"reflect"
 	"strconv"
+	"strings"
 	"time"
+	"unicode/utf8"
 )
 
 // BakedInValidators is the default map of ValidationFunc
 // you can add, remove or even replace items to suite your needs,
 // or even disregard and use your own map if so desired.
 var BakedInValidators = map[string]Func{
-	"required":    hasValue,
-	"len":         hasLengthOf,
-	"min":         hasMinOf,
-	"max":         hasMaxOf,
-	"eq":          isEq,
-	"ne":          isNe,
-	"lt":          isLt,
-	"lte":         isLte,
-	"gt":          isGt,
-	"gte":         isGte,
-	"eqfield":     isEqField,
-	"nefield":     isNeField,
-	"gtefield":    isGteField,
-	"gtfield":     isGtField,
-	"ltefield":    isLteField,
-	"ltfield":     isLtField,
-	"alpha":       isAlpha,
-	"alphanum":    isAlphanum,
-	"numeric":     isNumeric,
-	"number":      isNumber,
-	"hexadecimal": isHexadecimal,
-	"hexcolor":    isHexcolor,
-	"rgb":         isRgb,
-	"rgba":        isRgba,
-	"hsl":         isHsl,
-	"hsla":        isHsla,
-	"email":       isEmail,
-	"url":         isURL,
-	"uri":         isURI,
-	"base64":      isBase64,
+	"required":     hasValue,
+	"len":          hasLengthOf,
+	"min":          hasMinOf,
+	"max":          hasMaxOf,
+	"eq":           isEq,
+	"ne":           isNe,
+	"lt":           isLt,
+	"lte":          isLte,
+	"gt":           isGt,
+	"gte":          isGte,
+	"eqfield":      isEqField,
+	"nefield":      isNeField,
+	"gtefield":     isGteField,
+	"gtfield":      isGtField,
+	"ltefield":     isLteField,
+	"ltfield":      isLtField,
+	"alpha":        isAlpha,
+	"alphanum":     isAlphanum,
+	"numeric":      isNumeric,
+	"number":       isNumber,
+	"hexadecimal":  isHexadecimal,
+	"hexcolor":     isHexcolor,
+	"rgb":          isRgb,
+	"rgba":         isRgba,
+	"hsl":          isHsl,
+	"hsla":         isHsla,
+	"email":        isEmail,
+	"url":          isURL,
+	"uri":          isURI,
+	"base64":       isBase64,
+	"contains":     contains,
+	"containsany":  containsAny,
+	"containsrune": containsRune,
+	"excludes":     excludes,
+	"excludesall":  excludesAll,
+	"excludesrune": excludesRune,
+}
+
+func excludesRune(top interface{}, current interface{}, field interface{}, param string) bool {
+	return !containsRune(top, current, field, param)
+}
+
+func excludesAll(top interface{}, current interface{}, field interface{}, param string) bool {
+	return !containsAny(top, current, field, param)
+}
+
+func excludes(top interface{}, current interface{}, field interface{}, param string) bool {
+	return !contains(top, current, field, param)
+}
+
+func containsRune(top interface{}, current interface{}, field interface{}, param string) bool {
+	r, _ := utf8.DecodeRuneInString(param)
+
+	return strings.ContainsRune(field.(string), r)
+}
+
+func containsAny(top interface{}, current interface{}, field interface{}, param string) bool {
+	return strings.ContainsAny(field.(string), param)
+}
+
+func contains(top interface{}, current interface{}, field interface{}, param string) bool {
+	return strings.Contains(field.(string), param)
 }
 
 func isNeField(top interface{}, current interface{}, field interface{}, param string) bool {

doc.go

@@ -333,6 +333,30 @@ Here is a list of the current built in validators:
 		as an error, if you wish to accept an empty string as valid you can use
 		this with the omitempty tag. (Usage: base64)
 
+	contains
+		This validates that a string value contains the substring value.
+		(Usage: contains=@)
+
+	containsany
+		This validates that a string value contains any Unicode code points
+		in the substring value. (Usage: containsany=!@#?)
+
+	containsrune
+		This validates that a string value contains the supplied rune value.
+		(Usage: containsrune=@)
+
+	excludes
+		This validates that a string value does not contain the substring value.
+		(Usage: excludes=@)
+
+	excludesall
+		This validates that a string value does not contain any Unicode code
+		points in the substring value. (Usage: excludesall=!@#?)
+
+	excludesrune
+		This validates that a string value does not contain the supplied rune value.
+		(Usage: excludesrune=@)
+
 Validator notes:
 
 	regex

validator_test.go

@@ -142,6 +142,76 @@ func isEqualFunc(val interface{}, current interface{}, field interface{}, param
 	return current.(string) == field.(string)
 }
 
+func (ms *MySuite) TestExcludesRuneValidation(c *C) {
+
+	s := "a☺b☻c☹d"
+	s2 := "abcd"
+
+	err := validate.Field(s, "excludesrune=☻")
+	c.Assert(err, NotNil)
+
+	err = validate.Field(s2, "excludesrune=☻")
+	c.Assert(err, IsNil)
+}
+
+func (ms *MySuite) TestExcludesAllValidation(c *C) {
+
+	s := "abcd@!jfk"
+	s2 := "abcdefg"
+
+	err := validate.Field(s, "excludesall=@!{}[]")
+	c.Assert(err, NotNil)
+
+	err = validate.Field(s2, "excludesall=@!{}[]")
+	c.Assert(err, IsNil)
+}
+
+func (ms *MySuite) TestExcludesValidation(c *C) {
+
+	s := "abcd@!jfk"
+
+	err := validate.Field(s, "excludes=@")
+	c.Assert(err, NotNil)
+
+	err = validate.Field(s, "excludes=q")
+	c.Assert(err, IsNil)
+}
+
+func (ms *MySuite) TestContainsRuneValidation(c *C) {
+
+	s := "a☺b☻c☹d"
+	s2 := "abcd"
+
+	err := validate.Field(s, "containsrune=☻")
+	c.Assert(err, IsNil)
+
+	err = validate.Field(s2, "containsrune=☻")
+	c.Assert(err, NotNil)
+}
+
+func (ms *MySuite) TestContainsAnyValidation(c *C) {
+
+	s := "abcd@!jfk"
+	s2 := "abcdefg"
+
+	err := validate.Field(s, "containsany=@!{}[]")
+	c.Assert(err, IsNil)
+
+	err = validate.Field(s2, "containsany=@!{}[]")
+	c.Assert(err, NotNil)
+}
+
+func (ms *MySuite) TestContainsValidation(c *C) {
+
+	s := "abcd@!jfk"
+
+	err := validate.Field(s, "contains=@")
+	c.Assert(err, IsNil)
+
+	err = validate.Field(s, "contains=q")
+	c.Assert(err, NotNil)
+}
+
 func (ms *MySuite) TestIsNeFieldValidation(c *C) {
 
 	var j uint64