konval

Background
Pagpapatunay at conversion ng data.
Ang problema ng sanitizing data (checking kawastuhan at pagbabago sa isang kapaki-pakinabang na form) ay laganap sa buong programming:
- Paano ko i-verify ang mga user input ay tama?
- Paano ko munge data mula sa isang spreadsheet sa mga petsa at numero?
- Paano ko-convert ng raw database ng mga patlang sa isang programmatic object?
Ian Bicking dumating sa isang kapansin-pansin na wika para sa mga problemang ito, katawanin sa kanyang Formencode library [formencode]: pagpapatunay at conversion ay isa at sa parehong bagay, at maaaring hawakan sa pamamagitan ng pagpasa raw data sa pamamagitan ng isang kadena ng validators. Bawat tseke at / o mga validator nakapagpapabago ng data at pumasa ito sa susunod.
Sa diwang ito, konval ay isang pakete na nagbibigay ng:
- Isang rich na library ng pagpapatunay bagay
- Base klase para sa madaling paggawa ng custom validators
- Pag-andar para sa madaling paggamit validators sa isang iba't ibang mga paraan
Katayuan
konval ay nasa isang pagsubok ng estado, pagiging ginawa upang suportahan ang iba pang pakete at makita kung ang paggamit ay maaaring nakuha sa labas ng generalising conversion. Bilang tulad. ito ay pa rin sa isang maagang release at maaaring baguhin ang mga API. Puna ay inimbitahan.
Pag-install
Ang pinakasimpleng paraan upang i-install konval ay sa pamamagitan easy_install [setuptools] o isang katumbas na programa:
easy_install konval
Bilang kahalili maaari ma-download ang tarball, nabuklat at setup.py tumakbo:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py install
konval ay isang module na ito ay walang mga kinakailangan at dapat gumana sa mga lamang tungkol sa anumang mga bersyon ng Python.
Ang paggamit ng konval
Ang isang buong API ay kasama sa mga distribution source.
Mga halimbawa
Pinaka-karaniwang, konval ay gagamitin upang i-check o malinis na mga halaga. Nagtagumpay magresulta sa exceptions hagis:
# Convert input ng user sa isang aktwal na integer
>>> Mula konval import *
>>> Sanitize ('1.0', ToInt ())
1
>>> Sanitize ('isa', ToInt ())
Traceback (pinakahuling call huling)
...
ValueError: Hindi maaaring i-convert '1.0' sa integer
Ang nag-iisang validator o listahan ay maaaring maipasa sa sanitize. Pagkabigo sa anumang resulta sa anumang exception:
# Suriin ang isang listahan ay hindi hihigit sa 3 miyembro
>>> Sanitize (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Suriin ang isang password ay may sapat na katagalan
>>> Sanitize ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (pinakahuling call huling)
...
ValueError: 6 ay mas mababa sa 8
Anumang callable object na tumatanggap at nagbabalik ng isang solong halaga ay maaaring gamitin bilang isang validator:
>>> Mula string import *
>>> Sanitize ("ang aking mga pamagat", [strip, magsamantala])
'My title'
Ang isang rich na library ng prebuilt validators ay ibinibigay:
>>> Sanitize ('abcde', IsNonblank ())
'Abcde'
>>> Sanitize (5, IsInRange (1,6))
5
>>> Sanitize ('foo', Singkahulugan ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
Custom validators maaaring madaling subclassed mula sa isang ibinigay na batayang uri:
klase IsFoo (BaseValidator):
& Nbsp; def validate_value (self, halaga):
! & Nbsp; kung value = 'foo':
& Nbsp; self.raise_validation_error (halaga)
& Nbsp; bumalik True

Ano ang bago sa release na ito:

• Pinalitan ng pangalan ang ilang validators sa mas pare-pareho na pamamaraan. Mga pangalan ay dapat na naayos ngayon.

Kinakailangan :

• sawa

Limitasyon :

• konval ay naglalayong sa isang one-way na pagbabago ng data, sa pamamagitan ng pagpapaandar ng user input o naka-imbak data sa Python bagay. Totoong ito ay maaaring gamitin sa reverse direksyon, ngunit ito ay hindi isang pangunahing gamitin kaso. FormEncode ay batay sa paligid ng dalawang-daan (round trip) conversion ng data, kaya na maaaring maging isang kapaki-pakinabang na alternatibo.


• Ang pangalan konval ay pinili dahil:
• may naka isang sawa library na tinatawag na & quot; katinuan & quot;
• sa labas ng & quot; valcon & quot ;, & quot; valkon & quot ;, & quot; conval & quot; atbp ito ay ang isa na may pinakakaunting mga hit sa Google