фильтр

Пакет для фильтрации данных на golang, состоящий из ввода данных, форматирования, валидации и вывода.

• Каждый шаг можно настроить с помощью пользовательских сообщений об ошибках.
• Результаты фильтрации могут автоматически присваиваться переменным.
• Поддерживает массовые операции, объединяет код обработки ошибок.
• Можно упаковывать правила фильтрации в функции для повторного использования.

github.com/dxvgef/filter/v2

Примеры

Пожалуйста, обратитесь к коду юнит-тестов в example_test.go. Если вам нужна дополнительная помощь, оставьте запрос в разделе Issues.

Список функций

Ввод

• FromStr() ввод данных типа строка

Форматирование- Trim() удаление пробелов с обоих концов

• RemoveSpace удаление всех пробелов
• ReplaceAll замена всех
• ToUpper перевод всех букв в верхний регистр
• ToLower перевод всех букв в нижний регистр
• HTMLEscape кодирование в символы, отображаемые в HTML
• HTMLUnescape декодирование функции HTMLEscape
• URLPathEscape кодирование в символы, которые могут быть переданы как путь URL
• URLPathUnescape декодирование функции URLPathEscape
• URLQueryEscape кодирование в символы, которые могут быть переданы как параметры запроса URL
• URLQueryUnescape декодирование функции URLQueryEscape
• Base64StdEncode кодирование Base64 std
• Base64StdDecode декодирование Base64 std
• Base64RawStdEncode кодирование Base64 raw std
• Base64RawStdDecode декодирование Base64 raw std
• Base64URLEncode кодирование Base64 URL
• Base64URLDecode декодирование Base64 URL
• Base64RawURLEncode кодирование Base64 raw URL
• Base64RawURLDecode декодирование Base64 raw URL

Проверка

• Require параметр не может быть нулевым значением
• Equal проверяет равенство двух строк
• MatchLength проверяет соответствие длины
• MinLength минимальная длина
• MinUTF8Length минимальная длина в UTF8-кодировке
• MaxLength максимальная длина
• MaxUTF8Length максимальная длина в UTF8-кодировке
• MinInteger минимальное целое значение
• MaxInteger максимальное целое значение
• MinFloat минимальное значение с плавающей точкой
• MaxFloat максимальное значение с плавающей точкой
• IsBool является булевым значением
• IsLower является строчной буквой
• IsUpper является прописной буквой
• IsLetter является буквой- IsUnsigned является беззнаковым числом
• IsLowerOrNumber является строчной буквой или цифрой
• IsUpperOrNumber является прописной буквой или цифрой
• IsLetterOrNumber является буквой или цифрой
• IsChinese является китайским иероглифом
• IsMail является адресом электронной почты
• IsIP является адресом IPv4/v6
• IsTCPAddr является форматом IP:Port
• IsMAC является адресом MAC
• IsJSON является валидным форматом JSON
• IsChinaTel является номером телефона фиксированной связи в Китае
• IsChinaMobile является номером мобильного телефона в Китае
• IsChinaIDNumber является номером удостоверения личности в Китае
• IsSQLObject является именем объекта SQL (база данных, таблица, поле)
• IsSQLObjects является набором имен объектов SQL
• IsUUID является форматом UUID
• IsURL является форматом URL
• HasLetter должен содержать букву
• HasLower должен содержать строчную букву
• HasUpper должен содержать прописную букву
• HasNumber должен содержать цифру
• HasSymbol должен содержать символ
• HasPrefix должен содержать указанный префикс
• HasSuffix должен содержать указанный суффикс
• HasStr должен содержать указанную строку
• EnumStr разрешены только значения из []string
• EnumInt разрешены только значения из []int
• EnumInt32 разрешены только значения из []int32
• EnumInt64 разрешены только значения из []int64
• EnumFloat32 разрешены только значения из []float32
• EnumFloat64 разрешены только значения из []float64- EnumStrSlice преобразует данные в []string и проверяет, содержатся ли его элементы в указанном []string
• EnumIntSlice преобразует данные в []int и проверяет, содержатся ли его элементы в указанном []int
• DenyStr запрещены значения из []string
• DenyInt запрещены значения из []int
• DenyInt32 запрещены значения из []int32
• DenyInt64 запрещены значения из []int64
• DenyFloat32 запрещены значения из []float32
• DenyFloat64 запрещены значения из []float64
• DenyOtherSymbol запрещены символы, отличные от указанных

Отображение

Преобразование типов

• String преобразуется в строковый тип
• DefaultString преобразуется в строковый тип, при ошибке возвращается значение по умолчанию
• SliceString преобразуется в []string тип
• DefaultSliceString преобразуется в []string тип, при ошибке возвращается значение по умолчанию
• Int преобразуется в целочисленный тип
• DefaultInt преобразуется в целочисленный тип, при ошибке возвращается значение по умолчанию
• SliceInt преобразуется в []int тип
• DefaultSliceInt преобразуется в []int тип, при ошибке возвращается значение по умолчанию
• Int8 преобразуется в int8 тип
• DefaultInt8 преобразуется в int8 тип, при ошибке возвращается значение по умолчанию
• SliceInt8 преобразуется в []int8 тип
• DefaultSliceInt8 преобразуется в []int8 тип, при ошибке возвращается значение по умолчанию
• Int16 преобразуется в int16 тип
• DefaultInt16 преобразуется в int16 тип, при ошибке возвращается значение по умолчанию
• SliceInt16 преобразуется в []int16 тип- DefaultSliceInt16 преобразуется в []int16 тип, при ошибке возвращается значение по умолчанию
• Int32 преобразуется в int32 тип
• DefaultInt32 преобразуется в int32 тип, при ошибке возвращается значение по умолчанию
• SliceInt32 преобразуется в []int32 тип
• DefaultSliceInt32 преобразуется в []int32 тип, при ошибке возвращается значение по умолчанию
• Int64 преобразуется в int64 тип
• DefaultInt64 преобразуется в int64 тип, при ошибке возвращается значение по умолчанию
• SliceInt64 преобразуется в []int64 тип
• DefaultSliceInt64 преобразуется в []int64 тип, при ошибке возвращается значение по умолчанию
• Uint преобразуется в беззнаковый целочисленный тип
• DefaultUint преобразуется в беззнаковый целочисленный тип, при ошибке возвращается значение по умолчанию
• SliceUint преобразуется в []uint тип
• DefaultSliceUint преобразуется в []uint тип, при ошибке возвращается значение по умолчанию
• Uint8 преобразуется в uint8 тип
• DefaultUint8 преобразуется в uint8 тип, при ошибке возвращается значение по умолчанию
• SliceUint8 преобразуется в []uint8 тип
• DefaultSliceUint8 преобразуется в []uint8 тип, при ошибке возвращается значение по умолчанию
• Uint16 преобразуется в uint16 тип
• DefaultUint16 преобразуется в uint16 тип, при ошибке возвращается значение по умолчанию
• SliceUint16 преобразуется в []uint16 тип
• DefaultSliceUint16 преобразуется в []uint16 тип, при ошибке возвращается значение по умолчанию
• Uint32 преобразуется в uint32 тип - DefaultUint32 преобразуется в тип uint32, при ошибке возвращается значение по умолчанию
• SliceUint32 преобразуется в тип []uint32
• DefaultSliceUint32 преобразуется в тип []uint32, при ошибке возвращается значение по умолчанию
• Uint64 преобразуется в тип uint64
• DefaultUint64 преобразуется в тип uint64, при ошибке возвращается значение по умолчанию
• SliceUint64 преобразуется в тип []uint64
• DefaultSliceUint64 преобразуется в тип []uint64, при ошибке возвращается значение по умолчанию
• Float32 преобразуется в тип float32
• DefaultFloat32 преобразуется в тип float32, при ошибке возвращается значение по умолчанию
• SliceFloat32 преобразуется в тип []float32
• DefaultSliceFloat32 преобразуется в тип []float32, при ошибке возвращается значение по умолчанию
• Float64 преобразуется в тип float64
• DefaultFloat64 преобразуется в тип float64, при ошибке возвращается значение по умолчанию
• SliceFloat64 преобразуется в тип []float64
• DefaultSliceFloat64 преобразуется в тип []float64, при ошибке возвращается значение по умолчанию
• Bool преобразуется в тип bool
• DefaultBool преобразуется в тип bool, при ошибке возвращается значение по умолчанию

Присваивание

• Set присваивает результат фильтрации в обычную переменную
• SetSlice присваивает результат фильтрации в срез переменной###### Результат
• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理函数中获取
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于自定义处理 функций
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error
• Value возвращает значение параметра текущего состояния,主要用于 пользовательских обработчиков
• IsRequire проверяет, был ли выполнен Require

Пользовательские обработчики

• Custom пользовательский обработчик, подробнее см. тип CustomFunc

Результат

• Error результат фильтрации, возвращает тип error