Cornice

Kroonlijst biedt een service klasse die u kunt gebruiken om webservices te definiëren in Pyramid.
Elk exemplaar van een Dienst klasse komt overeen met een server pad en je kunt verschillende methoden HTTP op het pad met eenvoudige decorateurs implementeren.
Kroonlijst automatisch terug een 405 error met de juiste Laat header als een methode die niet werd geïmplementeerd wordt gevraagd.
Kroonlijst biedt ook een Sphinx richtlijn die kan worden gebruikt voor het documenteren van uw web services. De uitbreiding doorloopt gedefinieerde diensten en genereert automatisch uw webservice documentatie.
QuickStart
Om Cornice gebruiken, start door het in uw project met de ** omvatten ** methode Piramide:
& Nbsp; & nbsp; & nbsp; def main (global_config, ** instellingen):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; config.include ("kroonlijst")
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; config.make_wsgi_app terug ()
Meer informatie over onder andere op http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources
Dan kun je beginnen om web services te definiëren in uw uitzicht.
Bijvoorbeeld, laten we definiëren een dienst waar u kunt ** GET ** en ** POST ** een waarde op ** / waarden / {waarde} **, waar * waarde * is een ASCII-waarde die de naam van de waarde:
& Nbsp; & nbsp; & nbsp; import json
& Nbsp; & nbsp; & nbsp; uit kroonlijst import service
& Nbsp; & nbsp; & nbsp; waarden = Dienst (naam = 'foo', path = '/ waarden / {waarde}',
                     description = "Cornice Demo")
& Nbsp; & nbsp; & nbsp; _VALUES = {}
& Nbsp; & nbsp; & nbsp; @ Values.get ()
& Nbsp; & nbsp; & nbsp; def get_value (aanvraag):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Geeft de waarde.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['waarde']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; terug _VALUES.get (key)
& Nbsp; & nbsp; & nbsp; @ Values.post ()
& Nbsp; & nbsp; & nbsp; def set_value (aanvraag):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Stel de waarde.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; Retourneren * True * of * Valse *.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['waarde']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; Probeer het volgende:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; _VALUES.set (Key, json.loads (request.body))
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; behalve ValueError:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; return false
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; return true
Standaard kroonlijst maakt gebruik van een Json gerenderd

Wat is nieuw in deze release:.

• Toegevoegde Cross-Origin Resource Sharing ( CORS) ondersteuning.

Wat is nieuw in versie 0.12:.

• Fix auto-definiëren van standpunten HEAD van GET uitzicht
• Ondersteuning voor Vergiet erfenis (geïntroduceerd in nieuwe versies van vergiet)
• Controleer voor fouten in het lichaam van het uitzicht en in validatoren (werd alleen inchecken validatoren eerder)
• Voeg een __version__ nut in kroonlijst / __ init __. Py

Wat is nieuw in versie 0.11:

• de sfinx extensie wordt nu verzorgd door de cornice.ext. sphinxext module
• ondersteuning toevoegen voor SPORE
• voeg een optionele 'error_handler' om verklaringen te geven.
• Services.default_ {validatoren, filters} wordt nu gebruikt. (Fix # 75)

Wat is nieuw in versie 0.10:.

• gebruik pcreate eerder dan paster maken
• maken het mogelijk om aangepaste waarden om fouten toe te voegen.

Wat is nieuw in versie 0.9:

• standaard schema waarden worden aangenomen dat in het lichaam
• refactored de interne API's, zodat we niet meer gebruiken decorateurs. De service definitie is nu gescheiden van de dienst registratie in de routing-mechanisme.
• toegevoegd klasse-niveau validatoren en filters
• toegevoegd documentatie over kroonlijst internals
• deprecated het attribuut service.schema. Gebruik service.definitions plaats.

Wat is nieuw in versie 0.8:

• ondersteuning toegevoegd voor de 'Opties' HTTP Verb
• kunnen meerdere accepteren definities voor een dienst.
• krijgen docstring validator voor de automatische doc generatie
• vaste niet-ascii documentatie problemen
• voeg een manier om een ​​aantal modules te negeren bij het scannen met venusian.scan.

Wat is nieuw in versie 0.7:.

• update licentie naar MPL 2.0
• omgedoopt cornice.schemas om cornice.errors
• Toegevoegd get_view_wrapper methode naar Service klasse subklassen wikkelen het uitzicht callables ondersteunen w / decorateurs
• toegevoegd buildout ondersteuning
• toegevoegd uitzicht-class-based en de resource decorateur
• ervoor zorgen dat we uitzonderingen Piramide's gebruiken. Niet Webob's.
• filters ondersteuning toegevoegd
• toegevoegd schema ondersteuning
• toegevoegd json XSRF ondersteuning
• nu fouten status kan verschillen van 400 zijn.

Wat is nieuw in versie 0.6:

• Diverse fixes in MANIFEST

Wat is nieuw in versie 0.3:

• Verwijder singleton & quot; _defined & quot; staat van dienst klasse; Dit maakt het mogelijk dienst definities in meer dan één Configurator worden geladen.

Eisen

• Python