konval

Фон
Проверка и преобразование данных.
Проблема санитарной данные (проверка правильности и преобразования в полезную форму) широко распространена программирования:
- Как я могу проверить пользовательский ввод является правильным?
- Как я munge данные из таблицы в дат и чисел?
- Как преобразовать сырые поля базы данных в программной объекта?
Ян Bicking подошел с разумным идиомы для данной задачи, воплощенные в его библиотеке FormEncode [FormEncode]: проверка и преобразование одно и то же, и могут быть обработаны путем передачи исходных данных через цепочку валидаторов. Каждый валидатор проверяет и / или преобразует данные и передает его на следующий.
В этом духе, konval это пакет, который обеспечивает:
- Богатая библиотека объектов проверки
- Базовые классы для создания пользовательских легко валидаторы
- Функции для легко с помощью валидаторов в различных способов
Статус
konval в поисковом состоянии, будучи произведены для поддержки другой пакет и посмотреть, если использование можно получить из обобщения преобразования. Как таковой. он по-прежнему досрочное освобождение и API может измениться. Комментарий предлагается.
Установка
Самый простой способ установить konval это с помощью easy_install [Setuptools] или эквивалентной программы:
easy_install konval
Альтернативно архив можно скачать, распаковать и запустить setup.py:
 тар zxvf konval.tgz
& NBSP; кд konval
& NBSP; питона set.py установить
konval это модуль, который не имеет предпосылок и должны работать с любой версией Python.
Использование konval
Полный API включен в исходный дистрибутив.
Примеры
Чаще всего, konval будет использоваться для проверки или чистые ценности. Неудачи приводят исключения бросали:
# Конвертировать вход пользователя в реальной числа
>>> От импорта konval *
>>> Sanitize ('1,0', ToInt ())
1
>>> Sanitize ("один", ToInt ())
Traceback (самый последний вызов последнего)
...
ValueError: не может конвертировать '1.0' в целое
Один валидатор или список может быть принят, чтобы дезинфицировать. Отказ в любой приведет в любом исключением:
# Проверить список имеет не более 3 пользователей
>>> Sanitize (['а', 'б', 'C'], [ToLength (), IsEqualOrLess (3)])
3
# Проверить пароль достаточно длинный
>>> Sanitize ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (самый последний вызов последнего)
...
ValueError: 6 меньше, чем 8
Любой объект, который можно вызывать принимает и возвращает одно значение может быть использовано в качестве проверки подлинности:
>>> От импорта строки *
>>> Sanitize ("мой титул" [полоса, выгоду])
"Мое название"
Обширная библиотека готовых валидаторов поставляется:
>>> Sanitize ("ABCDE", IsNonblank ())
"ABCDE"
>>> Sanitize (5, IsInRange (1,6))
5
>>> Sanitize ('Foo', синонимы ({'Foo': 'бар', 'Баз': 'quux'}))
'бар'
Пользовательские валидаторы могут быть легко подклассы от поставляемого базового класса:
класс IsFoo (BaseValidator):
& NBSP; Def validate_value (я, значение):
! & NBSP; если значение = 'Foo':
& NBSP; self.raise_validation_error (значение)
& NBSP; вернуться True

Что нового В этом выпуске:

• переименовали несколько валидаторов в более последовательной схеме. Имена должны быть исправлена.

Требования

• Python

Ограничения

• konval направлена ​​на односторонней преобразования данных, превращая вход пользователя или храниться Данные в объекты Python. Конечно, можно было бы использовать в обратном направлении, но это не является основным случай использования. FormEncode базируется на двух направлениях (туда и обратно) преобразования данных, так что может быть полезной альтернативой.

<класс Li = "bbli"> Имя konval был выбран потому, что:
• уже есть библиотека Python называется & Quot; здравомыслие и Quot;
• из-Quot; VALCON & Quot ;, & Quot; valkon & Quot ;, & Quot; conval & Quot; и т.д., это был один с наименьшим количеством хитов на Google