66 lines
3.8 KiB
Markdown
66 lines
3.8 KiB
Markdown
|
## Домашнее задание №9 «Валидатор структур»
|
|||
|
|
|
|||
|
|
Необходимо реализовать функцию:
|
|||
|
|
```golang
|
|||
|
|
func Validate(v interface{}) error
|
|||
|
|
```
|
|||
|
|
Она должна валидировать публичные поля входной структуры на основе структурного тэга `validate`.
|
|||
|
|
|
|||
|
|
Функция может возвращать
|
|||
|
|
- или программную ошибку, произошедшую во время валидации;
|
|||
|
|
- или `ValidationErrors` - ошибку, являющуюся слайсом структур, содержащих имя поля и ошибку его валидации.
|
|||
|
|
|
|||
|
|
Таким образом, нужно накопить все ошибки валидации, а не прерывать валидацию на первой ошибке.
|
|||
|
|
|
|||
|
|
Если у поля нет структурных тэгов или нет тэга `validate`, то функция игнорирует его.
|
|||
|
|
|
|||
|
|
Типы полей, которые обязательно должны поддерживаться:
|
|||
|
|
- `int`, `[]int`;
|
|||
|
|
- `string`, `[]string`.
|
|||
|
|
|
|||
|
|
_При желании можно дополнительно поддержать любые другие типы (на ваше усмотрение)._
|
|||
|
|
|
|||
|
|
Необходимо реализовать следующие валидаторы:
|
|||
|
|
- Для строк:
|
|||
|
|
* `len:32` - длина строки должна быть ровно 32 символа;
|
|||
|
|
* `regexp:\\d+` - согласно регулярному выражению строка должна состоять из цифр
|
|||
|
|
(`\\` - экранирование слэша);
|
|||
|
|
* `in:foo,bar` - строка должна входить в множество строк {"foo", "bar"}.
|
|||
|
|
- Для чисел:
|
|||
|
|
* `min:10` - число не может быть меньше 10;
|
|||
|
|
* `max:20` - число не может быть больше 20;
|
|||
|
|
* `in:256,1024` - число должно входить в множество чисел {256, 1024};
|
|||
|
|
- Для слайсов валидируется каждый элемент слайса.
|
|||
|
|
|
|||
|
|
_При желании можно дополнительно добавить парочку новых правил (на ваше усмотрение)._
|
|||
|
|
|
|||
|
|
Допускается комбинация валидаторов по логическому "И" с помощью `|`, например:
|
|||
|
|
* `min:0|max:10` - число должно находится в пределах [0, 10];
|
|||
|
|
* `regexp:\\d+|len:20` - строка должна состоять из цифр и иметь длину 20.
|
|||
|
|
|
|||
|
|
**(\*) Дополнительное задание: поддержка валидации вложенных по композиции структур.**
|
|||
|
|
```golang
|
|||
|
|
type User struct {
|
|||
|
|
m Meta `validate:"nested"`
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Критерии оценки
|
|||
|
|
- Пайплайн зелёный - 3 балла
|
|||
|
|
- Добавлены юнит-тесты - до 4 баллов
|
|||
|
|
- Понятность и чистота кода - до 3 баллов
|
|||
|
|
- Дополнительное задание на баллы не влияет
|
|||
|
|
|
|||
|
|
#### Зачёт от 7 баллов
|
|||
|
|
|
|||
|
|
### Подсказки
|
|||
|
|
- `reflect.StructTag`
|
|||
|
|
- `regexp.Compile`
|
|||
|
|
- `errors.Is`
|
|||
|
|
|
|||
|
|
### Частые ошибки
|
|||
|
|
- Отсутствует проверка на то, что входной `interface{}` - структура.
|
|||
|
|
- Нет разделения на программные ошибки (неверный тэг, регулярка и пр.) и ошибки валидации.
|
|||
|
|
- Ошибки валидации не вынесены в отдельные переменные и не завраплены.
|
|||
|
|
- Соответственно в тестах не используется `errors.Is` / `errors.As`.
|