Cornice

Corniche fournit une classe de service que vous pouvez utiliser pour définir des services Web à Pyramid.
Chaque instance d'une classe de service correspond à un chemin de serveur et vous pouvez mettre en œuvre diverses méthodes HTTP sur le chemin avec décorateurs simples.
Corniche reviendra automatiquement une erreur 405 avec le droit Laissez-tête si une méthode qui n'a pas été mis en œuvre est demandée.
Corniche fournit également une directive Sphinx qui peut être utilisé pour documenter vos services Web. Les itération de vulgarisation sur les services définis et générera automatiquement la documentation de votre service Web.
QuickStart
Pour utiliser Corniche, commencez par inclure dans votre projet avec le ** ** inclure méthode à Pyramid:
& Nbsp; & nbsp; & nbsp; def principales (global_config, ** paramètres):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; config.include ("corniche")
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; retourner config.make_wsgi_app ()
En savoir plus sur comprennent au http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources
Ensuite, vous pouvez commencer à définir des services Web dans vos vues.
Par exemple, nous allons définir un service où vous pouvez GET ** ** et ** ** POST une valeur au ** / valeurs / {valeur} **, où la valeur de * * est une valeur ASCII représentant le nom de la valeur:
& Nbsp; & nbsp; & nbsp; json d'importation
& Nbsp; & nbsp; & nbsp; de corniche service d'importation
& Nbsp; & nbsp; & nbsp; valeurs = Service (name = 'foo', le chemin = '/ valeurs / {valeur}',
                     description = "Corniche Demo")
& Nbsp; & nbsp; & nbsp; _VALUES = {}
& Nbsp; & nbsp; & nbsp; @ Values.get ()
& Nbsp; & nbsp; & nbsp; def get_value (demande):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Retourne la valeur.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['value']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; retourner _VALUES.get (clé)
& Nbsp; & nbsp; & nbsp; @ Values.post ()
& Nbsp; & nbsp; & nbsp; def set_value (demande):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Régler la valeur.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; Retours * vrai * ou * * Faux.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['value']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; essayer:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; _VALUES.set (Clé, json.loads (request.body))
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; exception ValueError:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; return false
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; renvoyer Vrai
Par défaut, Corniche utilise un Json rendu

Ce qui est nouveau dans cette version:.

• Partage de ressources Ajouté Croix-Origin ( CORS) soutien.

Quoi de neuf dans la version 0.12:.

• Fix auto-définir de vues HEAD de GET vues
• Soutien à Passoire héritage (introduit dans les nouvelles versions de Passoire)
• Vérifiez les erreurs dans le corps de la vue et les validateurs (était qu'un contrôle de validateurs auparavant)
• Ajouter un utilitaire de __version__ en corniche / __ __ initialisation. Py

Quoi de neuf dans la version 0.11:

• l'extension sphinx est maintenant fourni par le cornice.ext. Module sphinxext
• Ajout du support pour SPORE
• ajouter un 'error_handler' option pour afficher déclarations.
• Services.default_ {validateurs, filtres} est maintenant utilisé. (Correction # 75)

Ce qui est nouveau dans la version 0.10:.

• l'utilisation pcreate plutôt que paster créer
• permettent d'ajouter des valeurs personnalisées à des erreurs.

Ce qui est nouveau dans la version 0.9:

• Les valeurs de schéma par défaut sont supposées être dans le corps
• refactorisé les API internes de sorte que nous ne utilisons pas plus décorateurs. La définition du service est maintenant séparé de l'enregistrement de service dans le mécanisme de routage.
• les validateurs et les filtres niveau de classe ajouté
• ajouté documentation sur internes corniche
• obsolète l'attribut service.schema. Utilisez service.definitions place.

Quoi de neuf dans la version 0.8:

• Support pour HTTP les 'Options' Verbe ajouté
• Autoriser plusieurs accepte définitions pour un service.
• obtenir l'docstring de validation pour la génération automatique de doc
• non-ASCII fixe problèmes de documentation
• ajouter un moyen d'ignorer certains modules lors de la numérisation avec venusian.scan.

Ce qui est nouveau dans la version 0.7:.

• Mise à jour licence MPL 2.0
• cornice.schemas renommé cornice.errors
• Ajout get_view_wrapper méthode à la classe de service pour soutenir les sous-classes d'emballage les callables vue w / décorateurs
• Support détachable ajoutée
• vues en fonction de la classe ajoutée et le décorateur des ressources
• nous assurer que nous utilisons les exceptions de pyramide. Non.
de WebOb
• ajouté le support des filtres
• le soutien de schéma ajoutée
• a ajouté le support de JSON XSRF
• maintenant le statut des erreurs peut être différent de 400.

Ce qui est nouveau dans la version 0.6:

• Diverses corrections dans le manifeste

Ce qui est nouveau dans la version 0.3:

• Supprimer singleton & quot; _defined & quot; Etat de la classe de service; ce qui permet des définitions de service à charger dans plus d'un configurateur.

Exigences :

• Python