Cornice

Cornice giver en service klasse, du kan bruge til at definere web services i Pyramid.
Hver forekomst af en service klasse svarer til en server sti, og du kan implementere forskellige metoder HTTP på vejen med enkle dekoratører.
Cornice automatisk returnere en 405 fejl med højre Tillad header hvis en metode, der ikke er blevet gennemført ønskes.
Cornice giver også en Sphinx direktiv, som kan bruges til at dokumentere dine web services. De udvidelse gentager end definerede tjenester og vil automatisk generere din webservice dokumentation.
QuickStart
Hvis du vil bruge Cornice, starte med at integrere det i dit projekt med ** omfatte ** metode Pyramid:
& Nbsp; & nbsp; & nbsp; def vigtigste (global_config, ** indstillinger):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; config.include ("gesims")
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; tilbage config.make_wsgi_app ()
Lær mere om omfatte http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources
Derefter kan du begynde at definere web services i dine synspunkter.
For eksempel, lad os definere en service, hvor du kan ** FÅ ** og ** POST ** en værdi på ** / værdier / {værdi} **, hvor * værdi * er en ASCII-værdi, der repræsenterer navnet på værdi:
& Nbsp; & nbsp; & nbsp; import JSON
& Nbsp; & nbsp; & nbsp; fra gesims import service
& Nbsp; & nbsp; & nbsp; værdier = Tjeneste (name = "foo", path = '/ værdier / {værdi}',
                     beskrivelse = "Cornice Demo")
& Nbsp; & nbsp; & nbsp; _VALUES = {}
& Nbsp; & nbsp; & nbsp; @ Values.get ()
& Nbsp; & nbsp; & nbsp; def get_value (anmodning):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Returnerer værdien.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['værdi']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; tilbage _VALUES.get (nøgle)
& Nbsp; & nbsp; & nbsp; @ Values.post ()
& Nbsp; & nbsp; & nbsp; def set_value (anmodning):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Indstil værdien.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; Retur * True * eller * Falsk *.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['værdi']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; prøv:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; _VALUES.set (Nøgle, json.loads (request.body))
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; undtagen ValueError:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; return false
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; returnere sandt
Som standard bruger Cornice en JSON afsmeltet

Hvad er nyt i denne udgivelse:.

• Tilføjet Cross-Origin Resource Sharing ( CORS) støtte.

Hvad er nyt i version 0.12:.

• Fix automatisk definere synspunkter hoved fra GET visninger
• Støtte til salatslynge arv (indført i nye versioner af salatslynge)
• Kontroller for fejl i selve visningen og i validatorer (var kun tjekker validatorer tidligere)
• Tilføj en __version__ nytte i gesims / __ init __. Py

Hvad er nyt i version 0.11:

• Sphinx udvidelse nu leveres af cornice.ext. sphinxext modul
• Tilføj støtte til SPORE
• tilføje en valgfri "error_handler" for at se erklæringer.
• Services.default_ {validator, filtre} bruges nu. (Fix # 75)

Hvad er nyt i version 0.10:.

• brug pcreate stedet Paster skabe
• gør det muligt at tilføje brugerdefinerede værdier til fejl.

Hvad er nyt i version 0.9:

• standard skema værdier antages at være i kroppen
• refactored de interne API'er, så vi ikke længere ved hjælp af dekoratører. Definition Servicen er nu adskilt fra tjenesten registrering i routing mekanisme.
• tilføjede klasse niveau validator og filtre
• tilføjede dokumentation om gesims interne
• frarådet det service.schema attribut. Brug service.definitions stedet.

Hvad er nyt i version 0.8:

• tilføjet støtte til de »MULIGHEDER HTTP Verb
• tillade flere acceptere definitioner for en tjeneste.
• få validator s docstrengen til automatisk doc generation
• fast ikke-ASCII dokumentation problemer
• tilføje en måde at ignorere nogle moduler, når du scanner med venusian.scan.

Hvad er nyt i version 0,7:.

• opdatering licens til MPL 2.0
• omdøbte cornice.schemas til cornice.errors
• Tilføjet get_view_wrapper metode til service klasse til at støtte underklasser indpakning view konverterbare m / dekoratører
• tilføjet udbygningsblok support
• tilføjet klassebaserede synspunkter og ressourcen dekoratør
• Kontroller, vi bruger Pyramid s undtagelser. Ikke Webob s.
• tilføjede filtre støtte
• tilføjet skema support
• tilføjede JSON xsrf support
• nu fejl status kan være forskellig fra 400.

Hvad er nyt i version 0.6:

• Diverse rettelser i MANIFEST

Hvad er nyt i version 0.3:

• Fjern singleton & quot; _defined & quot; tilstand fra service klasse; dette kan tjenesteudbydere definitioner, der skal indlæses i flere Configurator.

Krav :

• Python