Cornice

Κορνίζα παρέχει μία κλάση υπηρεσίας μπορείτε να χρησιμοποιήσετε για να καθορίσει τις διαδικτυακές υπηρεσίες Πυραμίδα.
Κάθε στιγμιότυπο της κλάσης υπηρεσίας αντιστοιχεί σε ένα μονοπάτι διακομιστή και μπορεί να εφαρμόσει διάφορες μεθόδους HTTP στο δρόμο με απλές διακοσμητές.
Κορνίζα θα επιστρέψει αυτόματα ένα σφάλμα 405 με το δικαίωμα Αφήστε κεφαλίδα, εάν ζητηθεί μια μέθοδος που δεν υλοποιήθηκε.
Κορνίζα παρέχει επίσης μια οδηγία Σφίγγα που μπορεί να χρησιμοποιηθεί για την τεκμηρίωση των υπηρεσιών web σας. Οι επαναλαμβάνεται επέκταση σε καθορισμένες υπηρεσίες και θα δημιουργήσει αυτόματα την τεκμηρίωση διαδικτυακή υπηρεσία σας.
QuickStart
Για να χρησιμοποιήσετε κορνιζών, ξεκινήστε με τη συμπερίληψή τους στο έργο σας με το ** ** περιλαμβάνουν μέθοδο στην Πυραμίδα:
& Nbsp? & Nbsp? & Nbsp? def κύρια (global_config, ** ρυθμίσεις):
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? ...
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? config.include («κορνίζα»)
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? ...
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? config.make_wsgi_app επιστρέψει ()
Μάθετε περισσότερα σχετικά περιλαμβάνει http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources
Στη συνέχεια, μπορείτε να αρχίσετε να καθορίσουν τις υπηρεσίες web κατά την άποψή σας.
Για παράδειγμα, ας ορίσουμε μια υπηρεσία όπου μπορείτε ** ** GET και POST ** ** μια αξία στο ** / αξίες / {value} **, όπου * αξία * είναι μια τιμή ASCII που αντιπροσωπεύει το όνομα της τιμής:
& Nbsp? & Nbsp? & Nbsp? JSON εισαγωγής
& Nbsp? & Nbsp? & Nbsp? από γείσο Υπηρεσία των εισαγωγών
& Nbsp? & Nbsp? & Nbsp? τιμές = Υπηρεσία (όνομα = "foo", τη διαδρομή = '/ αξίες / {} αξία »,
                     Περιγραφή = "Κορνίζα Demo")
& Nbsp? & Nbsp? & Nbsp? _VALUES = {}
& Nbsp? & Nbsp? & Nbsp? @ Values.get ()
& Nbsp? & Nbsp? & Nbsp? def get_value (αίτηση):
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? "" "Επιστρέφει την τιμή.
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? "" "
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? κλειδί = request.matchdict [«αξία»]
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? επιστρέψει _VALUES.get (κλειδί)
& Nbsp? & Nbsp? & Nbsp? @ Values.post ()
& Nbsp? & Nbsp? & Nbsp? def set_value (αίτηση):
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? "" "Ρυθμίστε την τιμή.
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? Επιστροφές * * True ή False * *.
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? "" "
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? κλειδί = request.matchdict [«αξία»]
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? δοκιμάσετε:
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? _VALUES.set (Κλειδί, json.loads (request.body))
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? εκτός ValueError:
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? return false
& Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? & Nbsp? return true
Από προεπιλογή, κορνιζών χρησιμοποιεί ένα Json καθίσταται

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

• Sharing Προστέθηκε Cross-Origin Resource ( CORS) υποστήριξη.

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

• Fix Auto-καθορίζουν απόψεων κεφαλής από την GET θέα
• Υποστήριξη για Σουρωτήρι κληρονομιάς (που εισάγεται σε νέες εκδόσεις του Σουρωτήρι)
• Έλεγχος για τα λάθη στο σώμα του άποψη και συστημάτων αναγνώρισης (μόνο το check-in validators προηγουμένως)
• Προσθέστε ένα βοηθητικό πρόγραμμα __version__ στο γείσο / __ __ init. Py

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

• η σφίγγα επέκταση παρέχονται πλέον από την cornice.ext. sphinxext ενότητα
• Προσθήκη υποστήριξης για SPORE
• προσθέσετε ένα προαιρετικό «error_handler 'για να δείτε τις δηλώσεις.
• Services.default_ {συστημάτων αναγνώρισης, φίλτρα} χρησιμοποιείται σήμερα. (Fix # 75)

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

• χρήση pcreate παρά Παστέρ δημιουργούν
• επιτρέπουν να προσθέσετε προσαρμοσμένες τιμές σε σφάλματα.

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

• Οι προεπιλεγμένες τιμές σχήμα υποτίθεται ότι είναι στο σώμα
• refactored τα εσωτερικά APIs έτσι δεν χρησιμοποιείτε πια διακοσμητές. Ο ορισμός των υπηρεσιών διαχωρίζεται πλέον από την εγγραφή υπηρεσία στο μηχανισμό δρομολόγησης.
• επικυρωτών προστεθεί τάξη επιπέδου και φίλτρα
• πρόσθεσε τεκμηρίωση σχετικά με τα εσωτερικά γείσο
• καταργηθεί το χαρακτηριστικό service.schema. Χρησιμοποιήστε service.definitions αντ 'αυτού.

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

• προστεθεί υποστήριξη για HTTP 'Επιλογές' Ρήμα
• επιτρέπουν πολλαπλές αποδέχονται τους ορισμούς για μια υπηρεσία.
• να πάρει docstring επικύρωσης για την αυτόματη παραγωγή doc
• σταθερό μη-ascii προβλήματα τεκμηρίωσης
• να προσθέσετε έναν τρόπο να αγνοήσει κάποιες ενότητες κατά τη σάρωση με venusian.scan.

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

• άδεια ενημέρωση στο MPL 2.0
• μετονομάστηκε cornice.schemas να cornice.errors
• Προστέθηκε get_view_wrapper μέθοδος για την κατηγορία υπηρεσιών για την υποστήριξη υποκατηγορίες περιτύλιξη των θέα callables w / διακοσμητές
• προστιθέμενη υποστήριξη buildout
• προστεθούν απόψεις ταξικά και ο διακοσμητής πόρων
• Βεβαιωθείτε ότι χρησιμοποιούμε εξαιρέσεις πυραμίδας. Δεν Webob του.
• προστιθέμενη υποστήριξη φίλτρα
• προστιθέμενη υποστήριξη schema
• πρόσθετη υποστήριξη JSON xsrf
• τώρα τα λάθη του καθεστώτος μπορεί να είναι διαφορετικό από το 400.

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

• Διάφορες διορθώσεις σε MANIFEST

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

• Κατάργηση μονήρεις & quot? _defined & Quot? κατάσταση από την κατηγορία υπηρεσιών? Αυτό επιτρέπει ορισμούς των υπηρεσιών που πρόκειται να φορτωθούν σε περισσότερα από ένα Διαμορφωτής.

Απαιτήσεις :

• Python