Cornice

KARNIZAI teikia paslaugas klasė galite naudoti apibrėžti interneto paslaugas piramidės.
Kiekvienas paslaugų klasės atvejis atitinka serverio kelią ir jūs galite įgyvendinti įvairius metodus HTTP kelyje su paprasta dekoratorių.
KARNIZAI automatiškai grįš, jeigu metodas, kuris nebuvo įgyvendintas prašoma 405 klaida su teise Leiskite antraštę.
KARNIZAI taip pat suteikia Sphinx direktyvą, kuri gali būti naudojama siekiant dokumentuoti savo interneto paslaugas. Pratęsimo kartojasi per apibrėžtų paslaugų ir automatiškai generuoti savo interneto paslaugų dokumentus.
QuickStart
Norėdami naudoti karnizo, pradėti įskaitant jį į savo projektą su ** apima ** metodas piramidės:
& Nbsp; & nbsp; & nbsp; Def pagrindiniai (global_config ** nustatymai):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; config.include (karnizo)
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; grįžti config.make_wsgi_app ()
Sužinokite daugiau apie "apima ne http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources
Tada galite pradėti apibrėžti interneto paslaugas savo nuomonę.
Pavyzdžiui, galime apibrėžti paslaugas, kur Jūs galite ** GET ** ir ** PO ** vertė ** / vertybės / {value} **, kur * * vertė yra ASCII reikšmė atkartojantis vertės vardą:
& Nbsp; & nbsp; & nbsp; importo JSON
& Nbsp; & nbsp; & nbsp; nuo karnizo importo tarnyba
& Nbsp; & nbsp; & nbsp; vertė = tarnyba (vardas = 'foo ", path =' / vertybės / {value}"
                     Description = "KARNIZAI Demo")
& Nbsp; & nbsp; & nbsp; _VALUES = {}
& Nbsp; & nbsp; & nbsp; @ Values.get ()
& Nbsp; & nbsp; & nbsp; Def get_value (prašymas):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Grąžina reikšmę.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; klavišas = request.matchdict ["vertė"]
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; grįžti _VALUES.get (pagrindinis)
& Nbsp; & nbsp; & nbsp; @ Values.post ()
& Nbsp; & nbsp; & nbsp; Def set_value (prašymas):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Nustatyti vertę.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; Grąžinimas * True * arba * Neteisingų *.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; klavišas = request.matchdict ["vertė"]
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; pabandykite:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; _VALUES.set (Raktinės, json.loads (request.body))
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; išskyrus ValueError:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; grįžti Neteisingų
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; grąžina true
Pagal nutylėjimą, KARNIZAI naudoja JSON suteiktas

Kas naujo , šioje laidoje:.

• Pridėta Kryžminis Kilmė išteklių naudojimas ( CORS) parama.

Kas naujo versija 0,12:.

• Nustatyti automatiškai nustatyti galvos vaizdu iš GET nuomonę
• Parama kiaurasamtis paveldėjimo (įvestas naujas versijas kiaurasamtis)
• Tikrinti, ar nėra klaidų, susijusių su mano kūnu ir tvirtintojus (buvo tik tikrinimas tvirtintojus anksčiau)
• Pridėti __version__ naudingumą karnizo / __ __ init. PY

Kas naujo versija 0,11:

• sfinksas pratęsimas dabar teikiamos cornice.ext. sphinxext modulis
• Pridėti paramą Spore "
• įdėti pasirinktinį "error_handler", kad galėtumėte peržiūrėti deklaracijas.
• Services.default_ {autentiškumo tikrinimo, filtrai} dabar naudojamas. (Fix # 75)

Kas naujo versija 0,10:.

• Naudoti pcreate o ne Lipdukas sukurti
• , kad būtų galima įtraukti pasirinktinius vertybes klaidų.

Kas naujo versijoje 0.9:

• Numatytieji schemų vertės prielaida, kad organizme
• išimant vidaus API todėl nenaudoja dekoratoriai nebėra. Paslaugų apibrėžimas dabar atskirtos nuo paslaugų registracijos maršruto mechanizmas.
• pridūrė klasės lygio autentiškumo tikrinimo ir filtrai
• pridėjo dokumentus apie karnizo vidinės
• atšaukia service.schema atributas. Naudokite service.definitions vietoj.

Kas naujo versijoje 0.8:

• papildoma parama "Parinktys" HTTP Veiksmažodis
• leisti kelis priimti apibrėžimus paslaugą.
• gauti tvirtintojas anketa docstring automatinio dok kartos "
• fiksuotas ne ASCII dokumentai problemos
• įdėti būdą ignoruoti kai modulius, kai nuskaitoma su venusian.scan.

Kas naujo versijoje 0.7:.

• atnaujinimas licencija MPL 2.0
• pervadintas cornice.schemas į cornice.errors
• Pridėta get_view_wrapper metodą paslaugų klasę remti poklasių vyniojimo peržiūrėti callables w / dekoratorių
• Katilinės statyba įtraukta parama
• pridėti klasės pagrindu svečiai ir išteklių dekoratorius
• įsitikinkite, mes naudojame piramidės išimtis. Ne Webob anketa.
• pridūrė filtrai parama
• pridėta schema, paramos
• pridūrė JSON xsrf parama
• dabar klaidos būklė gali skirtis nuo 400.

Kas naujo versijoje 0.6:

• Įvairūs pataisymai akivaizdžiai

Kas naujo 0.3 versijos:

• Pašalinti Singleton & quot; _defined & quot; valstybė iš tarnybos klasei; tai leidžia paslaugų apibrėžimai turi būti kraunamos į daugiau nei vieną konfigūratorių.

Reikalavimai :

• Python