konval

Background
Validasi dan konversi data.
Masalah sanitasi data (memeriksa kebenaran dan mengubah ke bentuk yang berguna) tersebar luas di seluruh pemrograman:
- Bagaimana cara memverifikasi input pengguna sudah benar?
- Bagaimana cara munge data dari spreadsheet ke tanggal dan nomor?
- Bagaimana cara mengkonversi bidang database baku menjadi objek program?
Ian Bicking datang dengan idiom yang masuk akal untuk masalah ini, diwujudkan dalam perpustakaan Formencode nya [formencode]: validasi dan konversi adalah satu dan hal yang sama, dan dapat ditangani dengan melewatkan data mentah melalui rantai validator. Setiap cek validator dan / atau mengubah data dan dibagikan ke berikutnya.
Dalam semangat ini, konval adalah paket yang menyediakan:
- Perpustakaan yang kaya objek validasi
- Kelas dasar untuk dengan mudah memproduksi validator kustom
- Fungsi untuk dengan mudah menggunakan validator dalam berbagai cara
Status
konval dalam keadaan eksplorasi, yang telah diproduksi untuk mendukung paket lain dan melihat apakah penggunaan dapat keluar dari generalising konversi. Seperti. masih merupakan rilis awal dan API dapat berubah. Komentar diundang.
Instalasi
Cara paling mudah untuk menginstal konval adalah melalui easy_install [setuptools] atau program setara:
easy_install konval
Atau tarball dapat didownload, membongkar dan setup.py run:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py menginstal
konval adalah modul yang tidak memiliki prasyarat dan harus bekerja dengan hampir setiap versi Python.
Menggunakan konval
Sebuah API penuh termasuk dalam distribusi sumber.
Contoh
Paling umum, konval akan digunakan untuk memeriksa atau nilai bersih. Kegagalan menghasilkan pengecualian dilemparkan:
# Mengkonversi input pengguna untuk integer aktual
>>> Dari impor konval *
>>> Sanitasi ('1.0', ToInt ())
1
>>> Sanitasi ('satu', ToInt ())
Traceback (paling panggilan terakhir terakhir)
...
ValueError: tidak dapat mengkonversi '1.0' ke integer
Sebuah validator tunggal atau daftar bisa dilalui untuk membersihkan. Kegagalan dalam akan menghasilkan terkecuali:
# Memeriksa daftar memiliki tidak lebih dari 3 anggota
>>> Sanitasi (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Memeriksa password cukup panjang
>>> Sanitasi ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (paling panggilan terakhir terakhir)
...
ValueError: 6 lebih rendah dari 8
Setiap objek callable yang menerima dan mengembalikan nilai tunggal dapat digunakan sebagai validator:
>>> Dari string impor *
>>> Sanitasi ("judul saya", [strip, memanfaatkan])
'Judul saya'
Sebuah perpustakaan yang kaya validator prebuilt disediakan:
>>> Sanitasi ('abcde', IsNonblank ())
'Abcde'
>>> Sanitasi (5, IsInRange (1,6))
5
>>> Sanitasi ('foo', Sinonim ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
Validator kustom dapat dengan mudah subclassed dari kelas dasar yang disediakan:
kelas IsFoo (BaseValidator):
& Nbsp; def validate_value (self, nilai):
! & Nbsp; jika nilai = 'foo':
& Nbsp; self.raise_validation_error (nilai)
& Nbsp; kembali Benar

Apa yang baru dalam rilis ini:

• Berganti nama beberapa validator untuk skema yang lebih konsisten. Nama harus diperbaiki sekarang.

Persyaratan :

• Python

Keterbatasan :

• konval bertujuan transformasi satu arah dari data, mengubah input pengguna atau disimpan data ke dalam objek Python. Tentu saja dapat digunakan dalam arah sebaliknya, tapi ini bukan kasus penggunaan utama. FormEncode didasarkan sekitar dua arah (round trip) konversi data, sehingga dapat menjadi alternatif yang berguna.


• Nama konval dipilih karena:
• sudah ada perpustakaan Python disebut & quot; kewarasan & quot;
• dari & quot; & quot ;, Valcon & quot; & quot ;, valkon & quot; Conval & quot; dll itu adalah satu dengan hits paling sedikit di Google