konval

Ιστορικό
Επικύρωση και τη μετατροπή των δεδομένων.
Το πρόβλημα της απολύμανσης δεδομένων (έλεγχος ορθότητας και μετατροπή σε χρήσιμη μορφή) είναι ευρέως διαδεδομένη σε όλο τον προγραμματισμό:
- Πώς μπορώ να επαληθεύσω εισόδου του χρήστη είναι σωστή;
- Πώς μπορώ να munge δεδομένα από ένα υπολογιστικό φύλλο σε ημερομηνίες και αριθμούς;
- Πώς μπορώ να μετατρέψετε πρώτες πεδία της βάσης δεδομένων σε μια προγραμματική αντικείμενο;
Ο Ian Bicking ήρθε με ένα λογικό ιδίωμα για αυτό το πρόβλημα, που ενσωματώνονται στη βιβλιοθήκη του Formencode [formencode]: η επικύρωση και η μετατροπή είναι ένα και το ίδιο πράγμα, και μπορεί να αντιμετωπιστεί με το πέρασμα των πρώτων δεδομένων μέσω μιας αλυσίδας επικύρωσης. Κάθε έλεγχοι επικύρωσης ή / και μετατρέπει τα δεδομένα και περνά στην επόμενη.
Σε αυτό το πνεύμα, konval είναι ένα πακέτο που προσφέρει:
- Μια πλούσια βιβλιοθήκη αντικειμένων επικύρωσης
- Τάξεις βάση για την παραγωγή εύκολα έθιμο επικύρωσης
- Λειτουργίες για τη χρήση εύκολα επικύρωσης σε μια ποικιλία τρόπων
Κατάσταση
konval βρίσκεται σε μια διερευνητική κατάσταση, έχουν παραχθεί για να υποστηρίξει ένα άλλο πακέτο και να δούμε αν η χρήση μπορεί να πήρε από τη γενίκευση της μετατροπής. Ως τέτοια. εξακολουθεί να είναι μια πρόωρη απελευθέρωση και η API μπορεί να αλλάξει. Σχόλιο καλείται.
installation
Ο απλούστερος τρόπος για να εγκαταστήσετε konval είναι μέσω easy_install [setuptools] ή ισοδύναμο πρόγραμμα:
easy_install konval
Εναλλακτικά, το συμπιεσμένο αρχείο μπορείτε να το κατεβάσετε, αποσυμπιέζεται και setup.py τρέξιμο:
 πίσσα zxvf konval.tgz
& Nbsp? Cd konval
& Nbsp? Python set.py εγκαταστήσετε
konval είναι μια ενότητα που δεν έχει προαπαιτούμενα και πρέπει να εργαστεί με ακριβώς για οποιαδήποτε έκδοση της Python.
Χρήση konval
Ένα πλήρες API περιλαμβάνεται στη διανομή πηγή.
Παραδείγματα
Πιο συχνά, konval θα χρησιμοποιηθεί για να ελέγξει ή να καθαρίσετε τις τιμές. Αποτυχίες οδηγήσει σε εξαιρέσεις που ρίχνονται:
# Μετατρέψει την είσοδο του χρήστη σε πραγματικό ακέραιο
>>> Από konval εισαγωγής *
>>> Απολύμανσης («1,0», ToInt ())
1
>>> Απολύμανσης («ένα», ToInt ())
Traceback (πιο πρόσφατη κλήση τελευταία)
...
ValueError: δεν μπορεί να μετατρέψει «1,0» σε ακέραιο
Μια ενιαία επικύρωσης ή λίστα μπορεί να περάσει για να αποστειρώνουν. Η αποτυχία σε οποιαδήποτε θα οδηγήσει σε καμία εξαίρεση:
# Ελέγξετε μια λίστα δεν έχει περισσότερα από 3 μέλη
>>> Απολύμανσης (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Ελέγξετε έναν κωδικό πρόσβασης είναι αρκετά μεγάλη
>>> Απολύμανσης («mypass», [ToLength (), IsEqualOrMore (8)])
Traceback (πιο πρόσφατη κλήση τελευταία)
...
ValueError: 6 είναι μικρότερη από 8
Κάθε απαιτητών αντικείμενο που δέχεται και επιστρέφει μια μεμονωμένη τιμή δεν μπορεί να χρησιμοποιηθεί ως επικύρωσης:
>>> Από την εισαγωγή εγχόρδων *
>>> Απολύμανσης ("τον τίτλο μου", [λωρίδα, κεφαλαιοποιήσει])
«Ο τίτλος μου»
Μια πλούσια βιβλιοθήκη του προκατασκευασμένα επικύρωσης παρέχεται:
>>> Απολύμανσης («ABCDE», IsNonblank ())
'Α Β Γ Δ Ε'
>>> Απολύμανσης (5, IsInRange (1,6))
5
>>> Απολύμανσης ('foo', Συνώνυμα ({'foo': «μπαρ», «Baz»: «quux '}))
«Μπαρ»
Προσαρμοσμένη αναγνώρισης μπορεί εύκολα να subclassed από μία παρεχόμενη βασική κλάση:
κατηγορία IsFoo (BaseValidator):
& Nbsp? Def validate_value (self, τιμή):
! & Nbsp? Αν value = "foo":
& Nbsp? Self.raise_validation_error (αξία)
& Nbsp? Επιστρέψει True

Τι είναι καινούργιο σε αυτή την έκδοση:

• Μετονομάστηκε μερικά επικύρωσης στη συνεπέστερη σύστημα. Τα ονόματα θα πρέπει να καθοριστεί τώρα.

Απαιτήσεις :

• Python

Περιορισμοί :

• konval απευθύνεται σε ένα μονόδρομο μετασχηματισμό των δεδομένων, μετατρέποντας την είσοδο του χρήστη ή αποθηκεύονται δεδομένα σε Python αντικείμενα. Βέβαια θα μπορούσε να χρησιμοποιηθεί στην αντίστροφη κατεύθυνση, αλλά αυτό δεν είναι ένα πρωτογενές περίπτωση χρήσης. FormEncode βασίζεται σε αμφίδρομη (μετ 'επιστροφής) τη μετατροπή των δεδομένων, έτσι ώστε να μπορεί να είναι μια χρήσιμη εναλλακτική λύση.


• Η konval όνομα επιλέχτηκε επειδή:
• υπάρχει ήδη μια βιβλιοθήκη Python που ονομάζεται & quot? Λογική & quot?
• από & quot? Valcon & quot ;, & quot? Valkon & quot ;, & quot? Conval & quot? κλπ ήταν το ένα με τις λιγότερες επισκέψεις στο Google