พื้นหลัง
การตรวจสอบและการเปลี่ยนแปลงของข้อมูล
ปัญหาของข้อมูลที่ฆ่าเชื้อ (การตรวจสอบความถูกต้องและเปลี่ยนรูปแบบที่มีประโยชน์) เป็นที่แพร่หลายไปทั่วการเขียนโปรแกรม:
- ฉันจะตรวจสอบผู้ใช้ป้อนข้อมูลที่ถูกต้องเป็นอย่างไร
- ฉันจะ Munge ข้อมูลออกจากสเปรดชีทลงในวันที่และตัวเลข?
- ฉันจะแปลงทุ่งฐานข้อมูลดิบให้เป็นวัตถุโปรแกรม?
เอียน Bicking มากับสำนวนที่เหมาะสมสำหรับปัญหานี้เป็นตัวเป็นตนในห้องสมุด Formencode ของเขา [formencode]: การตรวจสอบและการแปลงเป็นหนึ่งในสิ่งเดียวกันและสามารถจัดการได้โดยการส่งผ่านข้อมูลดิบผ่านห่วงโซ่เครื่องมือตรวจสอบ แต่ละการตรวจสอบตรวจสอบและ / หรือการแปลงข้อมูลและผ่านมันไปต่อไป
ในจิตวิญญาณนี้ konval เป็นแพคเกจที่ให้:
- ห้องสมุดที่อุดมไปด้วยวัตถุการตรวจสอบ
- ชั้นเรียนได้อย่างง่ายดายสำหรับฐานการผลิตที่กำหนดเอง validators
- ฟังก์ชั่นได้อย่างง่ายดายโดยใช้เครื่องมือตรวจสอบในหลากหลายวิธี
สถานะ
konval ที่อยู่ในรัฐสอบสวนได้รับการผลิตเพื่อรองรับการแพคเกจอื่นและดูว่าสามารถใช้งานได้ออกจากแปลง generalising เช่นนี้ ก็ยังคงเป็นรุ่นแรกและ API อาจมีการเปลี่ยนแปลง แสดงความคิดเห็นได้รับเชิญ
การติดตั้ง
วิธีที่ง่ายที่สุดในการติดตั้ง konval ผ่าน easy_install [setuptools] หรือโปรแกรมเทียบเท่า:
easy_install konval
อีกทางเลือกหนึ่ง tarball สามารถดาวน์โหลดและเรียกใช้ห่อ setup.py:
tar zxvf konval.tgz
& nbsp; cd konval
& nbsp; หลาม set.py ติดตั้ง
konval เป็นโมดูลที่มีสิ่งที่จำเป็นและไม่ควรจะทำงานกับเพียงเกี่ยวกับรุ่นใด ๆ ของงูหลาม
การใช้ konval
เต็ม API รวมอยู่ในการกระจายแหล่งที่มา
ตัวอย่าง
มากที่สุด konval จะใช้ในการตรวจสอบหรือค่าทำความสะอาด ความล้มเหลวส่งผลให้เกิดข้อยกเว้นถูกโยน:
# แปลงเข้าของผู้ใช้ที่จะเป็นจำนวนเต็มที่เกิดขึ้นจริง
>>> จากการนำเข้า konval *
>>> sanitize ('1.0' ToInt ())
1
>>> sanitize ('หนึ่ง' ToInt ())
Traceback (โทรล่าสุดที่ผ่านมา)
...
ValueError: ไม่สามารถแปลง '1.0' เป็นจำนวนเต็ม
ตรวจสอบรายชื่อเดียวหรือสามารถส่งผ่านไปฆ่าเชื้อ ความล้มเหลวในการใด ๆ ที่จะส่งผลให้เกิดข้อยกเว้นใด ๆ
# ตรวจสอบรายชื่อได้ไม่เกิน 3 คน
>>> sanitize (['', 'b' 'c'], [ToLength () IsEqualOrLess (3)])
3
# การตรวจสอบรหัสผ่านเป็นเวลานานพอ
>>> sanitize (mypass '[ToLength () IsEqualOrMore (8)])
Traceback (โทรล่าสุดที่ผ่านมา)
...
ValueError: 6 ต่ำกว่า 8
วัตถุใด ๆ callable ที่รับและส่งกลับค่าเดียวสามารถใช้เป็นตัวตรวจสอบ:
>>> นำเข้าจากสตริง *
>>> sanitize ("ชื่อของฉัน" [แถบประโยชน์])
'ชื่อของฉัน'
ห้องสมุดที่อุดมไปด้วยเครื่องมือตรวจสอบที่สร้างไว้ล่วงหน้าจะจัดจำหน่าย:
>>> sanitize (ABCDE 'IsNonblank ())
'ABCDE'
>>> sanitize (5, IsInRange (1,6))
5
>>> sanitize ('foo' พ้อง ({'foo': 'บาร์', 'baz': 'quux'}))
'บาร์'
validators ที่กำหนดเองสามารถจะ subclassed จากระดับฐานที่จัด:
ระดับ IsFoo (BaseValidator):
& nbsp; def validate_value (ตัวเองค่า):
! & nbsp; ถ้าค่า = 'foo':
& nbsp; self.raise_validation_error (ค่า)
& nbsp; กลับมาทรู
มีอะไรใหม่ ในข่าวประชาสัมพันธ์นี้:
- เปลี่ยนชื่อ validators ไม่กี่โครงการสอดคล้องกันมากขึ้น ชื่อควรได้รับการแก้ไขในขณะนี้.
ต้องการ
- งูใหญ่
ข้อ จำกัด
- konval มีวัตถุประสงค์ที่จะเปลี่ยนแปลงทางเดียวของข้อมูลผู้ใช้เปลี่ยนหรือการป้อนข้อมูลที่เก็บไว้ ข้อมูลที่เป็นวัตถุหลาม แน่นอนมันสามารถนำมาใช้ในทิศทางที่ย้อนกลับ แต่นี้ไม่ได้เป็นกรณีที่ใช้หลัก FormEncode มีพื้นฐานมาจากสองทาง (ไปกลับ) การแปลงข้อมูลเพื่อที่ว่าอาจจะเป็นทางเลือกที่มีประโยชน์.
- ชื่อ konval ได้รับเลือกเพราะ:
- มีอยู่แล้วห้องสมุดงูใหญ่ที่เรียกว่า & quot; สติ & quot;
- จาก & quot; & quot Valcon ;, & quot; & quot valkon ;, & quot; conval & quot; ฯลฯ มันเป็นหนึ่งที่มีความนิยมน้อยที่สุดใน Google
ความคิดเห็นที่ไม่พบ