خلفية
التحقق من صحة وتحويل البيانات.
مشكلة التعقيم البيانات (التحقق من صحة وتحول إلى شكل مفيد) على نطاق واسع في جميع أنحاء البرمجة:
- كيف يمكنني التحقق من إدخال المستخدم هو الصحيح؟
- كيف يمكنني munge البيانات من جدول إلى التواريخ والأرقام؟
- كيف يمكنني تحويل حقول قاعدة البيانات الخام إلى كائن برنامجي؟
جاء إيان Bicking حتى مع لغة معقول لهذه المشكلة، والتي تتجسد في مكتبة Formencode له [formencode]: التحقق من صحة والتحويل هي واحدة ونفس الشيء، ويمكن التعامل معها عن طريق تمرير البيانات الخام من خلال سلسلة من المصادقون. كل الشيكات المصادقة و / أو تحول البيانات ويمرره الى المرحلة التالية.
ومن هذا المنطلق، konval هو الحزمة التي تنص على:
- مكتبة غنية من الكائنات التحقق من صحة
- الفئات الأساسية لإنتاج بسهولة المصادقون مخصصة
- وظائف لسهولة باستخدام المصادقون في مجموعة متنوعة من الطرق
حالة
konval هو في حالة استكشافية، بعد أن تم إنتاجها لدعم حزمة أخرى ومعرفة ما إذا كان يمكن استخدام خرج من تعميم التحويل. كما. فإنه لا يزال الإفراج المبكر، ويمكن تغيير واجهة برمجة التطبيقات. تم تعليق المدعوين.
تركيب
أبسط طريقة لتثبيت konval هو عن طريق easy_install [setuptools] أو برنامج مكافئ:
easy_install konval
بدلا من كتل القطران يمكن تحميلها، تفكيك وتشغيل setup.py:
القطران zxvf konval.tgz
على & nbsp؛ مؤتمر نزع السلاح konval
على & nbsp؛ الثعبان set.py تثبيت
konval هو وحدة الذي لا يوجد لديه شروط مسبقة ويجب أن تعمل مع عادل عن أي نسخة من بيثون.
باستخدام 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
أي كائن استدعاء أن يقبل وإرجاع قيمة واحدة يمكن أن تستخدم المصادقة:
>>> من استيراد سلسلة *
>>> تطهير ("لقبي"، [الشريط، استفادة])
"لقبي"
يتم توفير مكتبة غنية من المصادقون التي سبق إنشاؤها:
>>> تطهير ('ABCDE "، IsNonblank ())
"ABCDE"
>>> تطهير (5، IsInRange (1،6))
5
>>> تطهير ('فو'، والمترادفات ({'فو': 'بار'، 'الباز': 'quux'}))
"بار"
يمكن بسهولة المصادقون مخصصة يكون subclassed من الفئة الأساسية الموردة:
فئة IsFoo (BaseValidator):
على & nbsp؛ مواطنه validate_value (النفس، قيمة):
! & nbsp؛ إذا قيمة = 'فو':
على & nbsp؛ self.raise_validation_error (القيمة)
على & nbsp؛ العودة الحقيقية
ما هو الجديد في هذا الإصدار:
تسمية بضعة المصادقون مخطط لأكثر اتساقا. ينبغي أن تكون ثابتة أسماء الآن.
المتطلبات:
بيثون
القيود:
konval يهدف إلى تحول في اتجاه واحد من البيانات، وتحول إدخال المستخدم أو البيانات المخزنة في الأجسام بيثون. ومن المؤكد أنه يمكن استخدامها في الاتجاه المعاكس، ولكن هذه ليست حالة استخدام الأولية. ويستند FormEncode حول اتجاهين (ذهابا وإيابا) تحويل البيانات، بحيث قد يكون بديلا مفيدا.
وقد تم اختيار اسم konval للأسباب التالية:
هناك بالفعل مكتبة بايثون دعا ومثل؛ التعقل ومثل؛
من ومثل؛ valcon ومثل ؛، & مثل؛ valkon ومثل ؛، & مثل؛ conval ومثل؛ وما كان واحد مع أقل عدد من الضربات على جوجل
لم يتم العثور على التعليقات