konval

Arka Plan
Doğrulama ve veri dönüşüm.
veri sanitasyon (doğruluğunun kontrol ve kullanışlı bir forma dönüştürülmesi) sorunu programlanması boyunca yaygın:
- Nasıl kullanıcı girişi doğru olduğunu doğrularım?
- Nasıl tarihleri ​​ve sayıları içine bir elektronik verileri gizleyin mı?
- Nasıl bir programatik nesne haline ham veritabanı alanları dönüştürebilirim?
Ian Bicking onun Formencode kütüphanesinde [formencode] somutlaşan bu sorun için bir mantıklı deyim ile geldi: doğrulama ve dönüşüm bir ve aynı şey olduğunu ve doğrulayıcılar bir zinciri yoluyla ham veriyi geçirerek ele alınabilir. Her validator kontrolleri ve / veya veri dönüşümleri ve sonraki bunu geçer.
Bu ruhla, konval sağlayan bir pakettir:
- Geçerlilik nesnelerin zengin bir kütüphanesi
- Kolayca özel doğrulayıcılar üretmek için temel sınıfları
- Kolay şekillerde çeşitli validatörleri kullanılarak fonksiyonları
Durum
konval, bir keşif durumdadır başka bir paket desteklemek ve kullanım dönüşüm generalising çıktı edilebilir olmadığını görmek için üretilmiştir edilerek. Gibi. hala erken bir sürümüdür ve API değişebilir. Yorum davet edilir.
Kurulum
konval yüklemek için basit yolu easy_install [setuptools] veya eşdeğer bir program aracılığıyla geçerli:
easy_install konval
Alternatif arşivini, indirilen çözdükten ve setup.py çalıştırmak olabilir:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python install set.py
konval hiçbir önkoşul vardır ve Python sadece herhangi bir sürümü çalışmalıdır bir modül.
Kullanma konval
Tam API kaynak dağıtımında yer almaktadır.
Örnekler
En sık, konval kontrol etmek veya temiz değerler kullanılacaktır. Hataları istisnalar atılan sonuçlanır:
# Bir gerçek tamsayıya kullanıcı girişi dönüştürmek
>>> Konval import *
>>> Mikroptan arindirilir ('1.0', ToInt ())
1
>>> Mikroptan arindirilir ('tek', ToInt ())
Traceback (en son çağrı son)
...
ValueError: tamsayı '1.0' dönüştürmek olamaz
Tek bir doğrulayıcı veya liste sterilize etmek için geçirilebilir. Herhangi başarısızlık herhangi istisna neden olur:
# Bir liste en fazla 3 üyesi var kontrol
>>> Sterilize (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Bir şifreyi kontrol yeterince uzun
>>> Sterilize ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (en son çağrı son)
...
ValueError: 6 8 daha düşüktür
Tek bir değer kabul eder ve döner herhangi çağrılabilir nesnesi validator olarak kullanılabilir:
>>> Dize import *
>>> Mikroptan arindirilir ("benim başlık", [şerit, büyük harfle])
'My başlığı'
Prebuilt doğrulayıcıları zengin bir kütüphanesi verilir:
>>> Mikroptan arindirilir ('abcde' IsNonblank ())
'Abcde'
>>> Sterilize (5, IsInRange (1,6))
5
>>> Mikroptan arindirilir ('foo', eşanlamlılar ({'foo': 'bar', 'baz': 'guguk'}))
'Bar'
Özel doğrulayıcılar kolayca verilen temel sınıf sınıflandırma yapılabilir:
sınıf IsFoo (BaseValidator):
& Nbsp; def validate_value (self, değer):
! & Nbsp; eğer value = 'foo':
& Nbsp; self.raise_validation_error (değer)
& Nbsp; return true

Bu sürümdeki yeni Nedir:

• Bir kaç doğrulayıcılar daha tutarlı düzeni yeniden adlandırıldı. İsimler artık sabit olmalıdır.

Gereksinimleri :

• Python

Sınırlamalar :

• konval kullanıcı girişi dönüm verilerin tek yönlü dönüşümü hedefleniyor veya saklı Python nesneleri içine veri. Kuşkusuz bu ters yönde kullanılabilir, ancak bu birincil kullanımı söz konusu değildir edilebilir. Bu yararlı bir alternatif olabilir bu yüzden FormEncode, iki yönlü (gidiş-dönüş) veri dönüşüm etrafında dayanır.


• isim konval seçildi çünkü:
• zaten adlandırılan bir Python kütüphanesi var; aklı & quot;

Ve & quot dışında
• ; valcon & quot ;, & quot; & quot ;, valkon & quot; Conval & quot; vb öyleydi Google'da en az hit ile tek