From 24ea3a17b56ff7637a6aff1fbad6aceb48f88d18 Mon Sep 17 00:00:00 2001 From: Aaron Greenlee Date: Sat, 9 Jan 2016 12:30:34 -0500 Subject: [PATCH 1/3] Minor typo corrected in doc.go --- doc.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc.go b/doc.go index d084b83..784c481 100644 --- a/doc.go +++ b/doc.go @@ -25,7 +25,7 @@ They return type error to avoid the issue discussed in the following, where err http://stackoverflow.com/a/29138676/3158232 https://github.com/go-playground/validator/issues/134 -validator only returns nil or ValidationErrors as type error; so in you code all you need to do +validator only returns nil or ValidationErrors as type error; so, in your code all you need to do is check if the error returned is not nil, and if it's not type cast it to type ValidationErrors like so err.(validator.ValidationErrors) From 71d9b9e91c3fe9827ee1669557b4360793598fb8 Mon Sep 17 00:00:00 2001 From: Aaron Greenlee Date: Sat, 9 Jan 2016 13:42:12 -0500 Subject: [PATCH 2/3] Some grammer corrections; Formatting of GoDoc --- doc.go | 1078 +++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 677 insertions(+), 401 deletions(-) diff --git a/doc.go b/doc.go index 784c481..e87d1db 100644 --- a/doc.go +++ b/doc.go @@ -1,12 +1,16 @@ /* -Package validator implements value validations for structs and individual fields based on tags. -It can also handle Cross Field and Cross Struct validation for nested structs and has the ability -to dive into arrays and maps of any type. +Package validator implements value validations for structs and individual fields +based on tags. -Why not a better error message? because this library intends for you to handle your own error messages. +It can also handle Cross-Field and Cross-Struct validation for nested structs +and has the ability to dive into arrays and maps of any type. -Why should I handle my own errors? Many reasons, for us building an internationalized application -I needed to know the field and what validation failed so that I could provide an error in the users specific language. +Why not a better error message? +Because this library intends for you to handle your own error messages. + +Why should I handle my own errors? +Many reasons. We built an internationalized application and needed to know the +field, and what validation failed so we could provide a localized error. if fieldErr.Field == "Name" { switch fieldErr.ErrorTag @@ -16,22 +20,27 @@ I needed to know the field and what validation failed so that I could provide an return "Translated string based on field" } -Validation functions return type error -Doing things this way is actually the way the standard library does, see the file.Open -method here: https://golang.org/pkg/os/#Open. +Validation Functions Return Type error + +Doing things this way is actually the way the standard library does, see the +file.Open method here: + + https://golang.org/pkg/os/#Open. -They return type error to avoid the issue discussed in the following, where err is always != nil: -http://stackoverflow.com/a/29138676/3158232 -https://github.com/go-playground/validator/issues/134 +The authors return type "error" to avoid the issue discussed in the following, +where err is always != nil: -validator only returns nil or ValidationErrors as type error; so, in your code all you need to do -is check if the error returned is not nil, and if it's not type cast it to type ValidationErrors -like so err.(validator.ValidationErrors) + http://stackoverflow.com/a/29138676/3158232 + https://github.com/go-playground/validator/issues/134 + +Validator only returns nil or ValidationErrors as type error; so, in your code +all you need to do is check if the error returned is not nil, and if it's not +type cast it to type ValidationErrors like so err.(validator.ValidationErrors). Custom Functions -Custom functions can be added +Custom functions can be added. Example: // Structure func customFunc(v *Validate, topStruct reflect.Value, currentStructOrField reflect.Value, field reflect.Value, fieldType reflect.Type, fieldKind reflect.Kind, param string) bool { @@ -47,15 +56,31 @@ Custom functions can be added // NOTES: using the same tag name as an existing function // will overwrite the existing one -Cross Field Validation +Cross-Field Validation + +Cross-Field Validation can be done via the following tags: + - eqfield + - nefield + - gtfield + - gtefield + - ltfield + - ltefield + - eqcsfield + - necsfield + - gtcsfield + - ftecsfield + - ltcsfield + - ltecsfield -Cross Field Validation can be done via the following tags: eqfield, nefield, gtfield, gtefield, -ltfield, ltefield, eqcsfield, necsfield, gtcsfield, ftecsfield, ltcsfield and ltecsfield. If -however some custom cross field validation is required, it can be done using a custom validation. +If, however, some custom cross-field validation is required, it can be done +using a custom validation. -Why not just have cross fields validation tags i.e. only eqcsfield and not eqfield; the reason is -efficiency, if you want to check a field within the same struct eqfield only has to find the field -on the same struct, 1 level; but if we used eqcsfield it could be multiple levels down. +Why not just have cross-fields validation tags (i.e. only eqcsfield and not +eqfield)? + +The reason is efficiency. If you want to check a field within the same struct +"eqfield" only has to find the field on the same struct (1 level). But, if we +used "eqcsfield" it could be multiple levels down. Example: type Inner struct { StartDate time.Time @@ -87,7 +112,7 @@ on the same struct, 1 level; but if we used eqcsfield it could be multiple level Multiple Validators -Multiple validators on a field will process in the order defined +Multiple validators on a field will process in the order defined. Example: type Test struct { Field `validate:"max=10,min=1"` @@ -95,7 +120,7 @@ Multiple validators on a field will process in the order defined // max will be checked then min -Bad Validator definitions are not handled by the library +Bad Validator definitions are not handled by the library. Example: type Test struct { Field `validate:"min=10,max=0"` @@ -103,407 +128,658 @@ Bad Validator definitions are not handled by the library // this definition of min max will never succeed -Baked In Validators and Tags +Using Validator Tags -NOTE: Baked In Cross field validation only compares fields on the same struct, -if cross field + cross struct validation is needed your own custom validator -should be implemented. +Baked In Cross-Field validation only compares fields on the same struct. +If Cross-Field + Cross-Struct validation is needed you should implement your +own custom validator. -NOTE2: comma is the default separator of validation tags, if you wish to have a comma -included within the parameter i.e. excludesall=, you will need to use the UTF-8 hex -representation 0x2C, which is replaced in the code as a comma, so the above will -become excludesall=0x2C +Comma (",") is the default separator of validation tags. If you wish to +have a comma included within the parameter (i.e. excludesall=,) you will need to +use the UTF-8 hex representation 0x2C, which is replaced in the code as a comma, +so the above will become excludesall=0x2C. -NOTE3: pipe is the default separator of or validation tags, if you wish to have a pipe -included within the parameter i.e. excludesall=| you will need to use the UTF-8 hex -representation 0x7C, which is replaced in the code as a pipe, so the above will -become excludesall=0x7C + type Test struct { + Field `validate:"excludesall=,"` // BAD! Do not include a comma. + Field `validate:"excludesall=0x2C"` // GOOD! Use the UTF-8 hex representation. + } + +Pipe ("|") is the default separator of validation tags. If you wish to +have a pipe included within the parameter i.e. excludesall=| you will need to +use the UTF-8 hex representation 0x7C, which is replaced in the code as a pipe, +so the above will become excludesall=0x7C + + type Test struct { + Field `validate:"excludesall=|"` // BAD! Do not include a a pipe!. + Field `validate:"excludesall=0x7C"` // GOOD! Use the UTF-8 hex representation. + } + + +Baked In Validators and Tags Here is a list of the current built in validators: - - - Tells the validation to skip this struct field; this is particularily - handy in ignoring embedded structs from being validated. (Usage: -) - - | - This is the 'or' operator allowing multiple validators to be used and - accepted. (Usage: rbg|rgba) <-- this would allow either rgb or rgba - colors to be accepted. This can also be combined with 'and' for example - ( Usage: omitempty,rgb|rgba) - - structonly - When a field that is a nest struct in encountered and contains this flag - any validation on the nested struct will be run, but none of the nested - struct fields will be validated. This is usefull if inside of you program - you know the struct will be valid, but need to verify it has been assigned. - NOTE: only "required" and "omitempty" can be used on a struct itself. - - nostructlevel - Same as structonly tag except that any struct level validations will not run. - - exists - Is a special tag without a validation function attached. It is used when a field - is a Pointer, Interface or Invalid and you wish to validate that it exists. - Example: want to ensure a bool exists if you define the bool as a pointer and - use exists it will ensure there is a value; couldn't use required as it would - fail when the bool was false. exists will fail is the value is a Pointer, Interface - or Invalid and is nil. (Usage: exists) - - omitempty - Allows conditional validation, for example if a field is not set with - a value (Determined by the "required" validator) then other validation - such as min or max won't run, but if a value is set validation will run. - (Usage: omitempty) - - dive - This tells the validator to dive into a slice, array or map and validate that - level of the slice, array or map with the validation tags that follow. - Multidimensional nesting is also supported, each level you wish to dive will - require another dive tag. (Usage: dive) - Example: [][]string with validation tag "gt=0,dive,len=1,dive,required" - gt=0 will be applied to [] - len=1 will be applied to []string - required will be applied to string - Example2: [][]string with validation tag "gt=0,dive,dive,required" - gt=0 will be applied to [] - []string will be spared validation - required will be applied to string - - required - This validates that the value is not the data types default zero value. - For numbers ensures value is not zero. For strings ensures value is - not "". For slices, maps, pointers, interfaces, channels and functions - ensures the value is not nil. - (Usage: required) - - len - For numbers, max will ensure that the value is - equal to the parameter given. For strings, it checks that - the string length is exactly that number of characters. For slices, - arrays, and maps, validates the number of items. (Usage: len=10) - - max - For numbers, max will ensure that the value is - less than or equal to the parameter given. For strings, it checks - that the string length is at most that number of characters. For - slices, arrays, and maps, validates the number of items. (Usage: max=10) - - min - For numbers, min will ensure that the value is - greater or equal to the parameter given. For strings, it checks that - the string length is at least that number of characters. For slices, - arrays, and maps, validates the number of items. (Usage: min=10) - - eq - For strings & numbers, eq will ensure that the value is - equal to the parameter given. For slices, arrays, and maps, - validates the number of items. (Usage: eq=10) - - ne - For strings & numbers, eq will ensure that the value is not - equal to the parameter given. For slices, arrays, and maps, - validates the number of items. (Usage: eq=10) - - gt - For numbers, this will ensure that the value is greater than the - parameter given. For strings, it checks that the string length - is greater than that number of characters. For slices, arrays - and maps it validates the number of items. (Usage: gt=10) - For time.Time ensures the time value is greater than time.Now.UTC() - (Usage: gt) - - gte - Same as 'min' above. Kept both to make terminology with 'len' easier - (Usage: gte=10) - For time.Time ensures the time value is greater than or equal to time.Now.UTC() - (Usage: gte) - - lt - For numbers, this will ensure that the value is - less than the parameter given. For strings, it checks - that the string length is less than that number of characters. - For slices, arrays, and maps it validates the number of items. - (Usage: lt=10) - For time.Time ensures the time value is less than time.Now.UTC() - (Usage: lt) - - lte - Same as 'max' above. Kept both to make terminology with 'len' easier - (Usage: lte=10) - For time.Time ensures the time value is less than or equal to time.Now.UTC() - (Usage: lte) - - eqfield - This will validate the field value against another fields value either within - a struct or passed in field. - usage examples are for validation of a password and confirm password: - Validation on Password field using validate.Struct Usage(eqfield=ConfirmPassword) - Validating by field validate.FieldWithValue(password, confirmpassword, "eqfield") - - eqcsfield - This does the same as eqfield except that it validates the field provided relative - to the top level struct. (Usage: eqcsfield=InnerStructField.Field) - - nefield - This will validate the field value against another fields value either within - a struct or passed in field. - usage examples are for ensuring two colors are not the same: - Validation on Color field using validate.Struct Usage(nefield=Color2) - Validating by field validate.FieldWithValue(color1, color2, "nefield") - - necsfield - This does the same as nefield except that it validates the field provided relative - to the top level struct. (Usage: necsfield=InnerStructField.Field) - - gtfield - Only valid for Numbers and time.Time types, this will validate the field value - against another fields value either within a struct or passed in field. - usage examples are for validation of a Start and End date: - Validation on End field using validate.Struct Usage(gtfield=Start) - Validating by field validate.FieldWithValue(start, end, "gtfield") - - gtcsfield - This does the same as gtfield except that it validates the field provided relative - to the top level struct. (Usage: gtcsfield=InnerStructField.Field) - - gtefield - Only valid for Numbers and time.Time types, this will validate the field value - against another fields value either within a struct or passed in field. - usage examples are for validation of a Start and End date: - Validation on End field using validate.Struct Usage(gtefield=Start) - Validating by field validate.FieldWithValue(start, end, "gtefield") - - gtecsfield - This does the same as gtefield except that it validates the field provided relative - to the top level struct. (Usage: gtecsfield=InnerStructField.Field) - - ltfield - Only valid for Numbers and time.Time types, this will validate the field value - against another fields value either within a struct or passed in field. - usage examples are for validation of a Start and End date: - Validation on End field using validate.Struct Usage(ltfield=Start) - Validating by field validate.FieldWithValue(start, end, "ltfield") - - ltcsfield - This does the same as ltfield except that it validates the field provided relative - to the top level struct. (Usage: ltcsfield=InnerStructField.Field) - - ltefield - Only valid for Numbers and time.Time types, this will validate the field value - against another fields value either within a struct or passed in field. - usage examples are for validation of a Start and End date: - Validation on End field using validate.Struct Usage(ltefield=Start) - Validating by field validate.FieldWithValue(start, end, "ltefield") - - ltecsfield - This does the same as ltefield except that it validates the field provided relative - to the top level struct. (Usage: ltecsfield=InnerStructField.Field) - - alpha - This validates that a string value contains alpha characters only - (Usage: alpha) - - alphanum - This validates that a string value contains alphanumeric characters only - (Usage: alphanum) - - numeric - This validates that a string value contains a basic numeric value. - basic excludes exponents etc... - (Usage: numeric) - - hexadecimal - This validates that a string value contains a valid hexadecimal. - (Usage: hexadecimal) - - hexcolor - This validates that a string value contains a valid hex color including - hashtag (#) - (Usage: hexcolor) - - rgb - This validates that a string value contains a valid rgb color - (Usage: rgb) - - rgba - This validates that a string value contains a valid rgba color - (Usage: rgba) - - hsl - This validates that a string value contains a valid hsl color - (Usage: hsl) - - hsla - This validates that a string value contains a valid hsla color - (Usage: hsla) - - email - This validates that a string value contains a valid email - This may not conform to all possibilities of any rfc standard, but neither - does any email provider accept all posibilities... - (Usage: email) - - url - This validates that a string value contains a valid url - This will accept any url the golang request uri accepts but must contain - a schema for example http:// or rtmp:// - (Usage: url) - - uri - This validates that a string value contains a valid uri - This will accept any uri the golang request uri accepts (Usage: uri) - - base64 - This validates that a string value contains a valid base64 value. - Although an empty string is valid base64 this will report an empty string - 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=@) - - isbn - This validates that a string value contains a valid isbn10 or isbn13 value. - (Usage: isbn) - - isbn10 - This validates that a string value contains a valid isbn10 value. - (Usage: isbn10) - - isbn13 - This validates that a string value contains a valid isbn13 value. - (Usage: isbn13) - - uuid - This validates that a string value contains a valid UUID. - (Usage: uuid) - - uuid3 - This validates that a string value contains a valid version 3 UUID. - (Usage: uuid3) - - uuid4 - This validates that a string value contains a valid version 4 UUID. - (Usage: uuid4) - - uuid5 - This validates that a string value contains a valid version 5 UUID. - (Usage: uuid5) - - ascii - This validates that a string value contains only ASCII characters. - NOTE: if the string is blank, this validates as true. - (Usage: ascii) - - asciiprint - This validates that a string value contains only printable ASCII characters. - NOTE: if the string is blank, this validates as true. - (Usage: asciiprint) - - multibyte - This validates that a string value contains one or more multibyte characters. - NOTE: if the string is blank, this validates as true. - (Usage: multibyte) - - datauri - This validates that a string value contains a valid DataURI. - NOTE: this will also validate that the data portion is valid base64 - (Usage: datauri) - - latitude - This validates that a string value contains a valid latitude. - (Usage: latitude) - - longitude - This validates that a string value contains a valid longitude. - (Usage: longitude) - - ssn - This validates that a string value contains a valid U.S. Social Security Number. - (Usage: ssn) - - ip - This validates that a string value contains a valid IP Adress. - (Usage: ip) - - ipv4 - This validates that a string value contains a valid v4 IP Adress. - (Usage: ipv4) - - ipv6 - This validates that a string value contains a valid v6 IP Adress. - (Usage: ipv6) - - cidr - This validates that a string value contains a valid CIDR Adress. - (Usage: cidr) - cidrv4 - This validates that a string value contains a valid v4 CIDR Adress. - (Usage: cidrv4) +Skip Field + +Tells the validation to skip this struct field; this is particularily +handy in ignoring embedded structs from being validated. (Usage: -) + Usage: - + + +Or Operator + +This is the 'or' operator allowing multiple validators to be used and +accepted. (Usage: rbg|rgba) <-- this would allow either rgb or rgba +colors to be accepted. This can also be combined with 'and' for example +( Usage: omitempty,rgb|rgba) + + Usage: | + +StructOnly + +When a field that is a nested struct is encountered, and contains this flag +any validation on the nested struct will be run, but none of the nested +struct fields will be validated. This is usefull if inside of you program +you know the struct will be valid, but need to verify it has been assigned. +NOTE: only "required" and "omitempty" can be used on a struct itself. + + Usage: structonly + +NoStructLevel + +Same as structonly tag except that any struct level validations will not run. + + Usage: nostructlevel + +Exists + +Is a special tag without a validation function attached. It is used when a field +is a Pointer, Interface or Invalid and you wish to validate that it exists. +Example: want to ensure a bool exists if you define the bool as a pointer and +use exists it will ensure there is a value; couldn't use required as it would +fail when the bool was false. exists will fail is the value is a Pointer, Interface +or Invalid and is nil. + + Usage: exists + +Omit Empty + +Allows conditional validation, for example if a field is not set with +a value (Determined by the "required" validator) then other validation +such as min or max won't run, but if a value is set validation will run. + + Usage: omitempty + +Dive + +This tells the validator to dive into a slice, array or map and validate that +level of the slice, array or map with the validation tags that follow. +Multidimensional nesting is also supported, each level you wish to dive will +require another dive tag. + + Usage: dive + +Example #1 + + [][]string with validation tag "gt=0,dive,len=1,dive,required" + // gt=0 will be applied to [] + // len=1 will be applied to []string + // required will be applied to string + +Example #2 + + [][]string with validation tag "gt=0,dive,dive,required" + // gt=0 will be applied to [] + // []string will be spared validation + // required will be applied to string + +Required + +This validates that the value is not the data types default zero value. +For numbers ensures value is not zero. For strings ensures value is +not "". For slices, maps, pointers, interfaces, channels and functions +ensures the value is not nil. + + Usage: required + +Length + +For numbers, max will ensure that the value is +equal to the parameter given. For strings, it checks that +the string length is exactly that number of characters. For slices, +arrays, and maps, validates the number of items. + + Usage: len=10 + +Maximum + +For numbers, max will ensure that the value is +less than or equal to the parameter given. For strings, it checks +that the string length is at most that number of characters. For +slices, arrays, and maps, validates the number of items. + + Usage: max=10 + +Mininum + +For numbers, min will ensure that the value is +greater or equal to the parameter given. For strings, it checks that +the string length is at least that number of characters. For slices, +arrays, and maps, validates the number of items. + + Usage: min=10 + +Equals + +For strings & numbers, eq will ensure that the value is +equal to the parameter given. For slices, arrays, and maps, +validates the number of items. + + Usage: eq=10 + +Not Equal + +For strings & numbers, eq will ensure that the value is not +equal to the parameter given. For slices, arrays, and maps, +validates the number of items. + + Usage: eq=10 + +Greater Than + +For numbers, this will ensure that the value is greater than the +parameter given. For strings, it checks that the string length +is greater than that number of characters. For slices, arrays +and maps it validates the number of items. + +Example #1 + + Usage: gt=10 + +Example #2 (time.Time) + +For time.Time ensures the time value is greater than time.Now.UTC(). + + Usage: gt + +Greater Than or Equal + +Same as 'min' above. Kept both to make terminology with 'len' easier. + + +Example #1 + + Usage: gte=10 + +Example #2 (time.Time) + +For time.Time ensures the time value is greater than or equal to time.Now.UTC(). + + Usage: gte + +Less Than + +For numbers, this will ensure that the value is less than the parameter given. +For strings, it checks that the string length is less than that number of +characters. For slices, arrays, and maps it validates the number of items. + +Example #1 + + Usage: lt=10 + +Example #2 (time.Time) +For time.Time ensures the time value is less than time.Now.UTC(). + + Usage: lt + +Less Than or Equal + +Same as 'max' above. Kept both to make terminology with 'len' easier. + +Example #1 + + Usage: lte=10 + +Example #2 (time.Time) + +For time.Time ensures the time value is less than or equal to time.Now.UTC(). + + Usage: lte + +Field Equals Another Field + +This will validate the field value against another fields value either within +a struct or passed in field. + +Example #1: + + // Validation on Password field using: + Usage: eqfield=ConfirmPassword + +Example #2: + + // Validating by field: + validate.FieldWithValue(password, confirmpassword, "eqfield") + +Field Equals Another Field (relative) + +This does the same as eqfield except that it validates the field provided relative +to the top level struct. + + Usage: eqcsfield=InnerStructField.Field) + +Field Does Not Equal Another Field + +This will validate the field value against another fields value either within +a struct or passed in field. + +Examples: + + // Confirm two colors are not the same: + // + // Validation on Color field: + Usage: nefield=Color2 + + // Validating by field: + validate.FieldWithValue(color1, color2, "nefield") + +Field Does Not Equal Another Field (relative) + +This does the same as nefield except that it validates the field provided +relative to the top level struct. + + Usage: necsfield=InnerStructField.Field + +Field Greater Than Another Field + +Only valid for Numbers and time.Time types, this will validate the field value +against another fields value either within a struct or passed in field. +usage examples are for validation of a Start and End date: + +Example #1: + + // Validation on End field using: + validate.Struct Usage(gtfield=Start) + +Example #2: + + // Validating by field: + validate.FieldWithValue(start, end, "gtfield") + + +Field Greater Than Another Relative Field + +This does the same as gtfield except that it validates the field provided +relative to the top level struct. + + Usage: gtcsfield=InnerStructField.Field + +Field Greater Than or Equal To Another Field + +Only valid for Numbers and time.Time types, this will validate the field value +against another fields value either within a struct or passed in field. +usage examples are for validation of a Start and End date: + +Example #1: + + // Validation on End field using: + validate.Struct Usage(gtefield=Start) + +Example #2: + + // Validating by field: + validate.FieldWithValue(start, end, "gtefield") + +Field Greater Than or Equal To Another Relative Field + +This does the same as gtefield except that it validates the field provided relative +to the top level struct. + + Usage: gtecsfield=InnerStructField.Field + +Less Than Another Field + +Only valid for Numbers and time.Time types, this will validate the field value +against another fields value either within a struct or passed in field. +usage examples are for validation of a Start and End date: + +Example #1: + + // Validation on End field using: + validate.Struct Usage(ltfield=Start) + +Example #2: + + // Validating by field: + validate.FieldWithValue(start, end, "ltfield") + +Less Than Another Relative Field + +This does the same as ltfield except that it validates the field provided relative +to the top level struct. + + Usage: ltcsfield=InnerStructField.Field + +Less Than or Equal To Another Field + +Only valid for Numbers and time.Time types, this will validate the field value +against another fields value either within a struct or passed in field. +usage examples are for validation of a Start and End date: + +Example #1: + + // Validation on End field using: + validate.Struct Usage(ltefield=Start) + +Example #2: + + // Validating by field: + validate.FieldWithValue(start, end, "ltefield") + +Less Than or Equal To Another Relative Field + +This does the same as ltefield except that it validates the field provided relative +to the top level struct. + + Usage: ltecsfield=InnerStructField.Field + +Alpha Only + +This validates that a string value contains alpha characters only + + Usage: alpha + +Alphanumeric + +This validates that a string value contains alphanumeric characters only + + Usage: alphanum + +Numeric + +This validates that a string value contains a basic numeric value. +basic excludes exponents etc... + + Usage: numeric + +Hexadecimal String + +This validates that a string value contains a valid hexadecimal. + + Usage: hexadecimal + +Hexcolor String + +This validates that a string value contains a valid hex color including +hashtag (#) + + Usage: hexcolor + +RGB String + +This validates that a string value contains a valid rgb color + + Usage: rgb + +RGBA String + +This validates that a string value contains a valid rgba color + + Usage: rgba + +HSL String + +This validates that a string value contains a valid hsl color + + Usage: hsl + +HSLA String + +This validates that a string value contains a valid hsla color + + Usage: hsla + +E-mail String + +This validates that a string value contains a valid email +This may not conform to all possibilities of any rfc standard, but neither +does any email provider accept all posibilities. + + Usage: email + +URL String + +This validates that a string value contains a valid url +This will accept any url the golang request uri accepts but must contain +a schema for example http:// or rtmp:// + + Usage: url + +URI String + +This validates that a string value contains a valid uri +This will accept any uri the golang request uri accepts + + Usage: uri + +Base64 String + +This validates that a string value contains a valid base64 value. +Although an empty string is valid base64 this will report an empty string +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=@ + +Contains Any + +This validates that a string value contains any Unicode code points +in the substring value. + + Usage: containsany=!@#? + +Contains Rune + +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=@ + +Excludes All + +This validates that a string value does not contain any Unicode code +points in the substring value. + + Usage: excludesall=!@#? + +Excludes Rune + +This validates that a string value does not contain the supplied rune value. + + Usage: excludesrune=@ + +International Standard Book Number + +This validates that a string value contains a valid isbn10 or isbn13 value. + + Usage: isbn + +International Standard Book Number 10 + +This validates that a string value contains a valid isbn10 value. + + Usage: isbn10 + +International Standard Book Number 13 + +This validates that a string value contains a valid isbn13 value. + + Usage: isbn13 + + +Universally Unique Identifier UUID + +This validates that a string value contains a valid UUID. + + Usage: uuid + +Universally Unique Identifier UUID v3 + +This validates that a string value contains a valid version 3 UUID. + + Usage: uuid3 + +Universally Unique Identifier UUID v4 + +This validates that a string value contains a valid version 4 UUID. + + Usage: uuid4 + +Universally Unique Identifier UUID v5 + +This validates that a string value contains a valid version 5 UUID. + + Usage: uuid5 + +ASCII + +This validates that a string value contains only ASCII characters. +NOTE: if the string is blank, this validates as true. + + Usage: ascii + +Printable ASCII + +This validates that a string value contains only printable ASCII characters. +NOTE: if the string is blank, this validates as true. + + Usage: asciiprint + +Multi-Byte Characters + +This validates that a string value contains one or more multibyte characters. +NOTE: if the string is blank, this validates as true. + + Usage: multibyte + +Data URL + +This validates that a string value contains a valid DataURI. +NOTE: this will also validate that the data portion is valid base64 + + Usage: datauri + +Latitude + +This validates that a string value contains a valid latitude. + + Usage: latitude + +Longitude + +This validates that a string value contains a valid longitude. + + Usage: longitude + +Social Security Number SSN + +This validates that a string value contains a valid U.S. Social Security Number. + + Usage: ssn + +Internet Protocol Address IP + +This validates that a string value contains a valid IP Adress. + + Usage: ip + +Internet Protocol Address IPv4 + +This validates that a string value contains a valid v4 IP Adress. + + Usage: ipv4 + +Internet Protocol Address IPv6 + +This validates that a string value contains a valid v6 IP Adress. + + Usage: ipv6 + +Classless Inter-Domain Routing CIDR + +This validates that a string value contains a valid CIDR Adress. + + Usage: cidr + +Classless Inter-Domain Routing CIDRv4 + +This validates that a string value contains a valid v4 CIDR Adress. + + Usage: cidrv4 + +Classless Inter-Domain Routing CIDRv6 + +This validates that a string value contains a valid v6 CIDR Adress. + + Usage: cidrv6 + +Media Access Control Address MAC + +This validates that a string value contains a valid MAC Adress. + + Usage: mac + +Note: See Go's ParseMAC for accepted formats and types: - cidrv6 - This validates that a string value contains a valid v6 CIDR Adress. - (Usage: cidrv6) + http://golang.org/src/net/mac.go?s=866:918#L29 - mac - This validates that a string value contains a valid MAC Adress defined - by go's ParseMAC accepted formats and types see: - http://golang.org/src/net/mac.go?s=866:918#L29 - (Usage: mac) + Usage: mac Alias Validators and Tags -NOTE: when returning an error the tag returned in FieldError will be -the alias tag unless the dive tag is part of the alias; everything after the -dive tag is not reported as the alias tag. Also the ActualTag in the before case -will be the actual tag within the alias that failed. +NOTE: When returning an error, the tag returned in "FieldError" will be +the alias tag unless the dive tag is part of the alias. Everything after the +dive tag is not reported as the alias tag. Also, the "ActualTag" in the before +case will be the actual tag within the alias that failed. Here is a list of the current built in alias tags: - iscolor + "iscolor" alias is "hexcolor|rgb|rgba|hsl|hsla" (Usage: iscolor) Validator notes: regex - a regex validator won't be added because commas and = signs can be part of - a regex which conflict with the validation definitions, although workarounds - can be made, they take away from using pure regex's. Furthermore it's quick - and dirty but the regex's become harder to maintain and are not reusable, so - it's as much a programming philosiphy as anything. + a regex validator won't be added because commas and = signs can be part + of a regex which conflict with the validation definitions. Although + workarounds can be made, they take away from using pure regex's. + Furthermore it's quick and dirty but the regex's become harder to + maintain and are not reusable, so it's as much a programming philosiphy + as anything. - In place of this new validator functions should be created; a regex can be - used within the validator function and even be precompiled for better efficiency - within regexes.go. + In place of this new validator functions should be created; a regex can + be used within the validator function and even be precompiled for better + efficiency within regexes.go. - And the best reason, you can submit a pull request and we can keep on adding to the - validation library of this package! + And the best reason, you can submit a pull request and we can keep on + adding to the validation library of this package! Panics -This package panics when bad input is provided, this is by design, bad code like that should not make it to production. +This package panics when bad input is provided, this is by design, bad code like +that should not make it to production. type Test struct { TestField string `validate:"nonexistantfunction=1"` From 0b51ee1e8ed76c29755c7e852b6e19925b122aa5 Mon Sep 17 00:00:00 2001 From: Aaron Greenlee Date: Sat, 9 Jan 2016 13:49:43 -0500 Subject: [PATCH 3/3] Removed duplicate punctuation. --- doc.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc.go b/doc.go index e87d1db..d9a5270 100644 --- a/doc.go +++ b/doc.go @@ -150,7 +150,7 @@ use the UTF-8 hex representation 0x7C, which is replaced in the code as a pipe, so the above will become excludesall=0x7C type Test struct { - Field `validate:"excludesall=|"` // BAD! Do not include a a pipe!. + Field `validate:"excludesall=|"` // BAD! Do not include a a pipe! Field `validate:"excludesall=0x7C"` // GOOD! Use the UTF-8 hex representation. }