check

Package check provides request form checking.

Installing
Usage

Installing

Get package:
```
go get -u github.com/gowww/check
```
Import it in your code:
```
import "github.com/gowww/check"
```

Usage

Make a Checker with rules for keys:

userChecker := check.Checker{
	"email":   {check.Required, check.Email, check.Unique(db, "users", "email", "?")},
	"phone":   {check.Phone},
	"picture": {check.MaxFileSize(5000000), check.Image},
}

The rules order is significant so for example, it's smarter to check the format of a value before its uniqueness, avoiding some useless database requests.

Check data:

From a values map, with Checker.CheckValues:

errs := userChecker.CheckValues(map[string][]string{
	"name":  {"foobar"},
	"phone": {"0012345678901"},
})

From an http.Request, with Checker.CheckRequest:
```
errs := userChecker.CheckRequest(r)
```

Handle errors:

if errs.NotEmpty() {
	fmt.Println(errs)
}

JSON

Use Errors.JSON to get errors in a map under errors key, ready to be JSON formatted (as an HTTP API response, for example):

if errs.NotEmpty() {
	errsjs, _ := json.Marshal(errs.JSON())
	w.Write(errsjs)
}

Internationalization

Internationalization is handled by gowww/i18n and there are built-in translations for all errors.

Use Errors.T with an i18n.Translator (usually stored in the request context) to get translated errors:

if errs.NotEmpty() {
	transErrs := errs.T(i18n.RequestTranslator(r))
	fmt.Println(transErrs)
}

You can provide custom translations for each error type under keys like "error + RuleName":

var locales = i18n.Locales{
	language.English: {
		"hello": "Hello!",

		"errorMaxFileSize": "File too big (%v max.)",
		"errorRequired":    "Required field",
	},
}

If the i18n.Translator is nil or a custom translation is not found, the built-in translation of error is used.

Rules