konval

Background
Xác nhận và chuyển đổi dữ liệu.
Các vấn đề về vệ sinh dữ liệu (kiểm tra tính đúng đắn và chuyển đến một hình thức hữu ích) là phổ biến rộng rãi trên khắp các chương trình:
- Làm thế nào để xác minh người dùng nhập vào là chính xác?
- Làm thế nào để tôi munge dữ liệu từ một bảng tính vào ngày tháng và số?
- Làm thế nào để chuyển đổi các lĩnh vực cơ sở dữ liệu thô thành một đối tượng chương trình?
Ian Bicking đến với một thành ngữ hợp lý cho vấn đề này, thể hiện trong thư viện của mình Formencode [formencode]: xác nhận và chuyển đổi là một và giống nhau, và có thể được xử lý bằng cách chuyển dữ liệu thô thông qua một chuỗi các trình xác nhận. Mỗi kiểm tra xác nhận và / hoặc biến đổi dữ liệu và chuyển nó vào tiếp theo.
Trên tinh thần này, konval là một gói phần mềm cung cấp:
- Một thư viện phong phú của các đối tượng xác nhận
- Lớp cơ sở để dễ dàng sản xuất xác nhận tùy chỉnh
- Chức năng để dễ dàng sử dụng xác nhận trong nhiều cách khác nhau
Trạng thái
konval đang trong trạng thái thăm dò, đã được sản xuất để hỗ trợ một gói khác và xem nếu việc sử dụng có thể được nhận ra trong việc tổng quát chuyển đổi. Như vậy. nó vẫn là một phát hành sớm và các API có thể thay đổi. Comment được mời.
Cài đặt
Cách đơn giản nhất để cài đặt konval là qua easy_install [setuptools] hoặc một chương trình tương đương:
easy_install konval
Ngoài ra các tarball có thể được tải về, giải nén và chạy setup.py:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py cài đặt
konval là một mô-đun mà không có điều kiện tiên quyết và nên làm việc với chỉ là về bất kỳ phiên bản của Python.
Sử dụng konval
Một API đầy đủ được bao gồm trong phân phối nguồn.
Ví dụ
Thông thường nhất, konval sẽ được sử dụng để kiểm tra hoặc các giá trị trong sạch. Thất bại dẫn đến trường hợp ngoại lệ được ném:
# Chuyển đổi người dùng nhập vào một số nguyên thực tế
>>> Từ nhập khẩu konval *
>>> Làm vệ sinh ('1.0', ToInt ())
1
>>> Làm vệ sinh ('one', ToInt ())
Traceback (hầu hết cuộc gọi gần đây nhất)
...
ValueError: không thể chuyển đổi '1.0' để nguyên
Một xác nhận đơn hoặc danh sách có thể được thông qua để làm vệ sinh. Thất bại trong bất kỳ sẽ cho kết quả trong bất kỳ trường hợp ngoại lệ:
# Kiểm tra một danh sách có không quá 3 thành viên
>>> Làm vệ sinh (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Kiểm tra một mật khẩu đủ dài
>>> Làm vệ sinh ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (hầu hết cuộc gọi gần đây nhất)
...
ValueError: 6 là thấp hơn so với 8
Bất kỳ vật thể gọi chấp nhận và trả về một giá trị duy nhất có thể được sử dụng như một validator:
>>> Từ chuỗi nhập khẩu *
>>> Làm vệ sinh ("title của tôi", [dải, hoa])
'Tiêu đề của tôi'
Một thư viện phong phú của trình xác nhận dựng sẵn được cung cấp:
>>> Làm vệ sinh ('abcde', IsNonblank ())
'Abcde'
>>> Làm vệ sinh (5, IsInRange (1,6))
5
>>> Làm vệ sinh ('foo', từ đồng nghĩa ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
Xác nhận tùy chỉnh có thể dễ dàng được subclassed từ một lớp cơ sở cung cấp:
lớp IsFoo (BaseValidator):
& Nbsp; def validate_value (self, trị giá):
! & Nbsp; nếu value = 'foo':
& Nbsp; self.raise_validation_error (giá trị)
& Nbsp; return Đúng

là gì mới trong phiên bản này:

• Đổi tên một vài xác nhận vào chương trình nhất quán hơn. Tên phải được cố định ngay bây giờ.

Yêu cầu :

• Python

Hạn chế :

• konval là nhằm vào một biến đổi một chiều của dữ liệu, quay đầu vào sử dụng hoặc lưu trữ dữ liệu vào đối tượng Python. Chắc chắn nó có thể được sử dụng theo hướng ngược lại, nhưng điều này không phải là một trường hợp sử dụng chính. FormEncode là dựa trên hai chiều (khứ hồi) chuyển đổi dữ liệu, do đó có thể là một lựa chọn hữu ích.


• Tên konval đã được lựa chọn bởi vì:
• có đã là một thư viện Python gọi là & quot; sanity & quot;
• ra khỏi & quot; valcon & quot ;, & quot; valkon & quot ;, & quot; conval & quot; vv nó là một với số truy cập ít nhất trên Google