konval

רקע
אימות והמרה של נתונים.
הבעיה של חיטוי נתונים (בדיקת תקינות והפיכת לצורה שימושית) היא נפוצה בכל רחבי תכנות:
- כיצד אוכל לאמת קלט משתמש הוא נכון?
- איך אני munge נתונים מגיליון אלקטרוני לתאריכים ומספרים?
- כיצד ניתן להמיר שדות מסד נתונים גולמיים לאובייקט תכנותי?
איאן Bicking בא עם ניב נבון לבעיה זו, גלום בספריית Formencode [formencode]: אימות והמרה היא אחד ואותו דבר, ויכולה להיות מטופלים על ידי העברת נתונים גולמיים באמצעות רשת של תוקף. כל בדיקות ו / או validator הופכת את הנתונים ומעבירים אותו למשנהו.
ברוח זו, konval היא חבילה המספקת:
- ספרייה עשירה של חפצי אימות
- שיעורי בסיס בקלות לייצר validators המותאם אישית
- פונקציות בקלות באמצעות validators במגוון דרכים
סטטוס
konval הוא במדינת גישוש, שהופק לתמוך חבילה אחרת ולראות אם ניתן לי שימוש מהכללת המרה. כמו. זה עדיין שחרור מוקדם וAPI ​​עשוי להשתנות. הערה מוזמנת.
התקנה
הדרך הפשוטה להתקנת konval היא באמצעות easy_install [setuptools] או תכנית שווה ערך:
easy_install konval
לחלופין tarball ניתן להוריד, ארוזה וsetup.py ריצה:
 זפת zxvf konval.tgz
& Nbsp; konval CD
& Nbsp; פיתון set.py להתקין
konval הוא מודול שאין תנאים מוקדמים וצריך לעבוד עם כמעט כל גרסה של פיתון.
konval שימוש ב
API מלא כלול בהפצת המקור.
דוגמאות
הנפוץ ביותר, konval ישמש לבדוק או ערכים נקיים. כישלונות לגרום נזרקו חריגים:
# להמיר קלט משתמש למספר שלם בפועל
>>> מיבוא konval *
>>> לטהר ("1.0", ToInt ())
1
>>> לטהר ('אחד', ToInt ())
Traceback (השיחה האחרונה האחרונה)
...
ValueError: לא ניתן להמיר '1.0 "למספר שלם
Validator או רשימה אחת יכול להיות מועבר ללטהר. כישלון בכל יגרום כל יוצא מן הכלל:
# לבדוק יש רשימה לא יותר מ 3 חברים
>>> לטהר ([, 'ב' '', 'ג'], [ToLength (), IsEqualOrLess (3)])
3
# לבדוק סיסמא הוא ארוך מספיק
>>> לטהר ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (השיחה האחרונה האחרונה)
...
ValueError: 6 הוא נמוך יותר מאשר 8
כל אובייקט callable שמקבל ומחזיר ערך אחד יכול לשמש כvalidator:
>>> מיבוא מחרוזת *
>>> לטהר ("הכותרת שלי", [רצועה, לנצל])
"הכותרת שלי"
ספרייה עשירה של validators מוכנים מראש מסופקת:
>>> לטהר ("abcde", IsNonblank ())
"Abcde '
>>> לטהר (5, IsInRange (1,6))
5
>>> לטהר ("foo", שמות נוספים ({'foo': 'בר', 'באז': 'quux'}))
'בר'
בקלות ניתן subclassed validators המותאם אישית ממחלקת בסיס שסופקה:
הכיתה IsFoo (BaseValidator):
& Nbsp; def validate_value (עצמי, ערך):
! & Nbsp; אם ערך = 'foo':
& Nbsp; self.raise_validation_error (ערך)
& Nbsp; לחזור נכון

מה חדש בהודעה זו :