konval

Background
Валидиране и конвертиране на данни.
Проблемът за саниране на данни (контрол коректност и трансформира в полезна форма) е широко разпространена в целия програмен:
- Как да се провери приноса на потребителите е правилно?
- Как мога да Мъндж данни от електронна таблица в дати и цифри?
- Как мога да конвертирате суровини полета от базата в програмна обект?
Ian Bicking излезе с разумно идиом за този проблем, въплътена в неговата Formencode библиотека [formencode]: валидиране и конверсия са едно и също нещо, и могат да бъдат манипулирани чрез преминаване необработени данни чрез верига от валидатори. Всеки Валидатор проверки и / или преобразува данните и да ги предава на следващия.
В този дух, konval е пакет, който предвижда:
- Богата библиотека на обекти за валидиране
- базови класове за лесно производство на потребителски валидатори
- Функции за лесно използване валидатори по различни начини
<Силен> Status
konval е в проучвателно-членка, след като са създадени да подкрепят друг пакет и да видим дали може да се използва слезе от генерализиране реализация. Като такъв. тя все още е на ранен освобождаване и API може да се промени. Коментар е поканен.
<Силен> Инсталиране
Най-простият начин да се инсталира konval е направо easy_install [setuptools] или равностоен програма:
easy_install konval
Алтернативно смъкнатия файл може да бъде изтеглен, неопаковани и setup.py писта:
 катран zxvf konval.tgz
& Nbsp; CD konval
& Nbsp; питон set.py инсталиране
konval е модул, който все още няма предпоставки и трябва да работи с почти всяка версия на Python.
<Силен> Използване konval
Една пълна API е включена в дистрибуцията на сорса.
<Силни> Примери
Най-често, konval ще бъде използван, за да проверите или чисти стойности. Повреди доведат изключения изхвърлени:
# Конвертирате приноса на потребителите до реалното число
>>> От konval внос *
>>> Хигиенизирам ("1.0", ToInt ())
1
>>> Хигиенизирам ("едно", ToInt ())
Traceback (последното повикване последна)
...
ValueError: Не можете да конвертирате "1.0" в цяло число
Един единствен валидатор или списък може да бъде прехвърлено към дезинфекцирайте. Неуспех на който ще доведе до изключение:
# Провери списък има не повече от 3 членове
>>> Хигиенизирам (["а", "б", "в"], [ToLength (), IsEqualOrLess (3)])
3
# Провери парола е достатъчно дълъг
>>> Хигиенизирам ("mypass", [ToLength (), IsEqualOrMore (8)])
Traceback (последното повикване последна)
...
ValueError: 6 е по-ниска от 8
Всяко изискуем обект, който приема и връща една стойност може да се използва като валидатор:
>>> От низ внос *
>>> Хигиенизирам ("титлата си", [лента, се възползва])
"My заглавието"
Богата библиотека от предварително създадени валидатори се доставя:
>>> Хигиенизирам ("ABCDE", IsNonblank ())
"ABCDE"
>>> Хигиенизирам (5, IsInRange (1,6))
5
>>> Хигиенизирам ("Foo", синоними ({"Foo": "Бар", "Баз": "quux '}))
"Бар"
Персонализирани валидатори може лесно да бъде subclassed от комплекта базов клас:
клас IsFoo (BaseValidator):
& Nbsp; Def validate_value (самостоятелно, стойност):
! & Nbsp; ако стойност = "Foo":
& Nbsp; self.raise_validation_error (стойност)
& Nbsp; върне True

Какво ново в тази версия:

• Преименувана няколко валидатори за по-последователна схема. Наименования трябва да бъдат фиксирани сега.

<силни> Изисквания

• Python

<силни> Ограничения

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

<Ли клас = "bbli"> konval The име е избрано, защото:
• вече има Python библиотека, наречена & quot; разсъдъка & quot;
• от & quot; valcon & quot ;, & quot; valkon & quot ;, & quot; conval & quot; и т.н., че е този с най-малко попадения за Google