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 ())
'А Б В Г Д'
>>> 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