pyramid

piramide is 'n vinnige, klein, plat-op-die-aarde, open source Python web ontwikkelingsraamwerk & nbsp;. Dit maak die werklike wêreld web aansoek ontwikkeling en implementering meer pret, meer voorspelbaar, en meer produktief.
piramide is 'n Pilone projek, en onderskryf die nuutste web raamwerke wat deur die Pilone gemeenskap.
piramide was voorheen bekend as repoze.bfg.
Ondersteuning en Dokumentasie
Sien die Pilone Projek webwerf dokumentasie, verslag foute te sien, en om ondersteuning te kry.
License
piramide word aangebied onder die BSD-afgeleide Repoze Public License

Wat is nuut in hierdie release:.

• mako_templating: bygevoeg verdedigende oplossing vir nie-importability van Mako weens stroomop markupsafe laat val Python 3.2 ondersteuning. Mako template sal nie meer werk onder die kombinasie van MarkupSafe 0.17 en Python 3.2 (hoewel die kombinasie van MarkupSafe 0.17 en Python 3.3 of enige ondersteun Python 2 weergawe sal werk OK).
• Maak die pyramid.config.assets.PackageOverrides beswaar die API vir __loader__ voorwerpe wat in PEP 302. Volmagte aan die __loader__ wat deur die invoerder implementeer, indien teenwoordig; anders, verhoog NotImplementedError. Dit maak Pyramid statiese siening oorheers werk behoorlik onder Python 3.3 (voorheen sou hulle nie). Sien https://github.com/Pylons/pyramid/pull/1015 vir meer inligting.

Wat is nuut in die weergawe 1.4:

• Fix funksionele toetse in die ZODB handleiding

Wat is nuut in die weergawe 1.4 Beta 3:

• Packaging release net, geen kode verander. 1.4b2 was 'n brownbag release weens ontbreek dopgehou in die tarball.

Wat is nuut in die weergawe 1.3.4:

• Wanneer pyramid.debug_routematch is aangeskakel en die traverse predikaat is gebruik in enige roete, die router sal 'n uitsondering maak wanneer ek probeer om die roete ontfouting inligting te druk. Hierdie fout het bestaan ​​sedert 1.3a1.
• Wanneer die deurkruis gesegde is gebruik in enige roete, sou proutes en pviews konsole skrifte 'n uitsondering maak wanneer ek probeer om die roete ontfouting inligting te druk. Hierdie fout het bestaan ​​sedert 1.3a1.
• backport bugfix van meester: - In Mako Templates lookup, kyk vir absolute uri (met behulp van Mako dopgehou) wanneer meng erfenis saam met bate specs. https://github.com/Pylons/pyramid/issues/662

Unorderable tipes:
• By registrasie verskeie menings met 'n aanvaar gesegde in 'n piramide aansoek runing onder Python 3, kan jy 'n TypeError ontvang het funksie () & lt; funksie () uitsondering nie.
• backport van meester: HTTP Aanvaar kop is nie genormaliseer veroorsaak potensieel botsende oog registrasies ongesiens te gaan. Twee standpunte wat verskil net in die geval ('text / html' teen 'teks / HTML) sal nou verhoog 'n fout. https://github.com/Pylons/pyramid/pull/620

Wat is nuut in die weergawe 1.4 Alpha 1:

• Bug fixes:
• Stuur hawe van 1,3 tak: Wanneer geen verifikasie beleid is ingestel, 'n oproep tot pyramid.security.effective_principals sou onvoorwaardelik terug die leë lys. Dit was verkeerd, dit onvoorwaardelik moet teruggekeer [Almal], en nou doen.
• Explicit url versending regexes kan nou ook dubbelpunte. https://github.com/Pylons/pyramid/issues/629
• Op ten minste een 64-bit Ubuntu stelsel onder Python 3.2, met behulp van die view_config versierder veroorsaak 'n RuntimeError: woordeboek verander grootte tydens iterasie uitsondering nie. Dit doen nie meer nie. Sien https://github.com/Pylons/pyramid/issues/635 vir meer inligting.
• In Mako Templates lookup, kyk of die uri is reeds aangepas en bring dit terug na 'n bate spec. Gewoonlik kom met geërf templates of ingesluit komponente. https://github.com/Pylons/pyramid/issues/606 https://github.com/Pylons/pyramid/issues/607
• In Mako Templates lookup, kyk vir absolute uri (met behulp van Mako dopgehou) wanneer meng erfenis saam met bate specs. https://github.com/Pylons/pyramid/issues/662
• HTTP Aanvaar kop is nie genormaliseer veroorsaak potensieel botsende oog registrasies ongesiens te gaan. Twee standpunte wat verskil net in die geval ('text / html' teen 'teks / HTML) sal nou verhoog 'n fout. https://github.com/Pylons/pyramid/pull/620
• Stuur-hawe van 1,3 tak: unorderable tipes: wanneer registreer verskeie menings met 'n aanvaar gesegde in 'n piramide aansoek runing onder Python 3, kan jy 'n TypeError ontvang het funksie () & lt; funksie () uitsondering nie.
• Kenmerke:
• Configurator.add_directive aanvaar nou arbitrêre callables soos alen of voorwerpe implementering __call__ wat nie het __name__ en __doc__ eienskappe. Sien https://github.com/Pylons/pyramid/issues/621 en https://github.com/Pylons/pyramid/pull/647.
• Derdeparty-persoonlike ondervinding, roete, en intekenaar predicaten kan nou vir gebruik bygevoeg word deur die lig skrywers via pyramid.config.Configurator.add_view_predicate, pyramid.config.Configurator.add_route_predicate en pyramid.config.Configurator.add_subscriber_predicate. So, byvoorbeeld, om dit te doen:
• config.add_view_predicate ('ABC', my.package.ABCPredicate)
• kan toelaat dat 'n oog skrywer om dit te doen in 'n program wat opgestel wat gesegde:
• view_config (ABC = 1)
• Soortgelyke funksies bestaan ​​vir add_route en add_subscriber. Sien & quot; toevoeging van 'n Derde Party View, Route, of intekenaar Predikaat & quot; in die Hooks hoofstuk vir meer inligting.
• Let daarop dat veranderinge gemaak bogenoemde funksie te ondersteun beteken nou dat slegs aksies geregistreer met behulp van dieselfde & quot; om & quot; kan konflik met mekaar. Dit word gebruik om die geval dat die aksies wat geregistreer is by verskillende ordes kan potensieel konflik nie, maar om my kennis niks ooit daarvan afgehang gedrag (dit was 'n bietjie dom) te wees.
• Custom voorwerpe kan maklik into-serialiseerbaar gemaak word in Pyramid deur die definisie van 'n __json__ metode op die voorwerp se klas. Hierdie metode moet waardes native serialiseerbaar deur json.dumps terugkeer (soos SY, lyste, woordeboeke, snare, en so meer).
• Die into vertoning laat nou vir die definisie van persoonlike tipe adapters onbekende voorwerpe te omskep into serializations.
• As van hierdie uitgawe, die request_method gesegde, wanneer dit gebruik word, sal ook impliseer dat HEAD geïmpliseer wanneer jy gebruik. Byvoorbeeld, met behulp vanview_config (request_method = 'Kry') is gelykstaande aan die gebruik vanview_config (request_method = ('kry', 'HEAD')). Met behulp vanview_config (request_method = ('kry', 'post') is gelykstaande aan die gebruik vanview_config (request_method = ('kry', 'HEAD', 'post'). Dit is omdat kop is 'n variant van kry dat die versuim om die liggaam en WebOb het spesiale ondersteuning 'n leë liggaam om terug te keer wanneer 'n kop is gebruik.
• config.add_request_method is ingestel uitbreiding versoek voorwerpe met arbitrêre callables te ondersteun. Hierdie metode brei uit op die vorige config.set_request_property deur die ondersteuning van metodes sowel as eienskappe. Hierdie metode veroorsaak nou minder kode op versoek konstruksie tyd as config.set_request_property in weergawe 1.3 uitgevoer word.
• Moenie 'n voeg? te URLs wat deur request.resource_url indien die navraag argument is voorsien maar leeg.
• Moenie 'n voeg? te URLs wat deur request.route_url indien die _query argument is voorsien maar leeg.
• Die statiese siening masjinerie verhoog nou (eerder as opbrengste) HTTPNotFound en HTTPMovedPermanently uitsonderings, so dit kan deur die NotFound oog (en ander uitsondering views) gevang word.
• Die Mako vertoning ondersteun nou 'n def naam in 'n bate spec. Wanneer die def naam is teenwoordig in die bate spec, sal die stelsel die sjabloon def binne die sjabloon lewer en sal die resultaat terug. 'N voorbeeld bate spec is pakket: pad / na / template # defname.mako. Dit sal die def naam defname binne die template.mako sjabloon plaas van die lewering van die hele sjabloon lewer. Die ou manier van terugkeer 'n tal in die vorm ('defname', {}) van die siening word ondersteun vir agtertoe verenigbaarheid,
• Die Chameleon ZPT vertoning aanvaar nou 'n makro naam in 'n bate spec. Wanneer die makro naam is teenwoordig in die bate spec, sal die stelsel die makro gelys as 'n definieer-makro lewer en die standaard van die resultaat in plaas van die lewering van die hele sjabloon. 'N voorbeeld bate spec: pakket: pad / na / template # macroname.pt. Dit sal die makro gedefinieer as macroname binne die template.pt sjabloon plaas van die hele templae lewer.
• Wanneer daar 'n gesegde mismatch uitsondering (sien wanneer daar geen oog wedstryde vir 'n gegewe versoek weens predicaten nie werk nie), die uitsondering bevat nou 'n tekstuele beskrywing van die gesegde wat nie ooreenstem nie.
• 'n add_permission richtlijn metode is bygevoeg na die Configurator. Hierdie richtlijn registreer 'n vrystaande toestemming introspectable in die piramide introspeksie stelsel. Raamwerke gebou bo Pyramid kan dus gebruik om die die regte introspectable kategorie data 'n omvattende lys van regte deur 'n lopende stelsel te bou. Voordat hierdie metode is bygevoeg, regte is reeds geregistreer in hierdie introspectable kategorie as 'n newe-effek van die benaming van hulle in 'n add_view oproep, hierdie metode maak dit net moontlik om te reël vir 'n toestemming het om in die regte geplaas word introspectable kategorie sonder die noem dit saam met 'n verband sien. Hier is 'n voorbeeld van die gebruik van add_permission:
• config = Configurator ()
• config.add_permission ('View')
• Die UnencryptedCookieSessionFactoryConfig aanvaar nou signed_serialize en signed_deserialize hakies wat gebruik kan word om te bepaal hoe die sessies word marshalled (standaard is dit gedoen met HMAC + piekel).
• pyramid.testing.DummyRequest ondersteun nou metodes wat deur die pyramid.util.InstancePropertyMixin klas soos set_property.
• Versoek eienskappe en metodes bygevoeg via config.set_request_property of config.add_request_method is nou beskikbaar vir tweens.
• Versoek eienskappe en metodes bygevoeg via config.set_request_property of config.add_request_method is nou beskikbaar in die versoek voorwerp teruggekeer van pyramid.paster.bootstrap.
• request.context omgewing aanvraag gedurende bootstrap is nou die wortel voorwerp as 'n konteks nie, is alreeds ingestel op 'n voorwaarde versoek.
• Die pyramid.decorator.reify funksie is nou 'n API, en is by die API dokumentasie.
• Bygevoeg die pyramid.testing.testConfig konteks bestuurder, wat gebruik kan word om 'n configurator te genereer in 'n toets, bv met testing.testConfig (...).
• Gebruikers kan nou roep 'n subrequest van binne oog kode deur middel van 'n nuwe request.invoke_subrequest API.
• Deprecations:
• Die pyramid.config.Configurator.set_request_property is dokumentasie-afgekeur. Die metode bruikbaar bly maar hoe meer featureful pyramid.config.Configurator.add_request_method moet in die plek daarvan (dit het al van dieselfde vermoëns, maar kan ook die versoek voorwerp met metodes verleng) gebruik word.
• Backwards Onverenigbaar:
• Die piramide router nie meer dra die waardes bfg.routes.route of bfg.routes.matchdict die versoek se WSGI omgewing woordeboek. Hierdie waardes is docs-afgekeur in repoze.bfg 1.0 (effektief sewe minderjarige vrystellings gelede). As jou kode afgehang hierdie waardes, gebruik request.matched_route en request.matchdict plaas.
• Dit is nie meer moontlik om 'n omge woordeboek direk slaag om pyramid.traversal.ResourceTreeTraverser .__ call__ (aka ModelGraphTraverser .__ call__). In plaas daarvan, moet jy 'n versoek voorwerp slaag. Verby 'n omgewing in plaas van 'n versoek het gegenereer 'n afkeuring waarskuwing sedert Pyramid 1.1.
• piramide sal nie meer behoorlik werk as jy die webob.request.LegacyRequest as 'n versoek fabriek. Gevalle van die LegacyRequest klas het 'n request.path_info wat terugkeer om 'n string. Dit Pyramid release aanvaar dat request.path_info sal onvoorwaardelik wees Unicode.
• Die funksies van pyramid.chameleon_zpt en pyramid.chameleon_text naam get_renderer, get_template, render_template en render_template_to_response verwyder is. Hierdie het 'n afkeuring waarskuwing op die invoer wat sedert Pyramid 1.0. Gebruik pyramid.renderers.get_renderer (), pyramid.renderers.get_renderer implementering (), pyramid.renderers.render () of pyramid.renderers.render_to_response onderskeidelik (). In plaas van hierdie funksies.
• Die pyramid.configuration module is verwyder. Dit is afgekeur sedert Pyramid 1.0 en druk 'n afkeuring waarskuwing aan die gebruik daarvan. Gebruik pyramid.config plaas.
• Die pyramid.paster.PyramidTemplate API is verwyder. Dit is afgekeur sedert Pyramid 1.1 en 'n waarskuwing uitgereik oor die invoer. As jou kode afgehang, pas jou kode pyramid.scaffolds.PyramidTemplate te voer in plaas.
• Die pyramid.settings.get_settings () API is verwyder. Dit was die druk van 'n afkeuring waarskuwing sedert Pyramid 1.0. As jou kode afgehang API, gebruik pyramid.threadlocal.get_current_registry (). Instellings plaas of gebruik die instellings kenmerk van die register beskikbaar by die versoek (request.registry.settings).
• Hierdie APIs uit die pyramid.testing module is verwyder. Hulle is die druk van afkeuring waarskuwings sedert Pyramid 1.0:
• registerDummySecurityPolicy, gebruik pyramid.config.Configurator.testing_securitypolicy plaas.
• registerResources (aka registerModels, gebruik pyramid.config.Configurator.testing_resources plaas.
• registerEventListener, gebruik pyramid.config.Configurator.testing_add_subscriber plaas.
• registerTemplateRenderer (aka registerDummyRenderer`), gebruik pyramid.config.Configurator.testing_add_template plaas.
• registerView, gebruik pyramid.config.Configurator.add_view plaas.
• registerUtility, gebruik pyramid.config.Configurator.registry.registerUtility plaas.
• registerAdapter, gebruik pyramid.config.Configurator.registry.registerAdapter plaas.
• registerSubscriber, gebruik pyramid.config.Configurator.add_subscriber plaas.
• registerRoute, gebruik pyramid.config.Configurator.add_route plaas.
• registerSettings, gebruik pyramid.config.Configurator.add_settings plaas.
• In Pyramid 1.3 en vorige, die __call__ metode van 'n Reaksie voorwerp is begin voordat enige finale verifikasie is tereggestel. Soos van hierdie uitgawe, is die __call__ metode van 'n Reaksie voorwerp drie maande ná finale verifikasie word uitgevoer. Dit is ter ondersteuning van die request.invoke_subrequest funksie.
• Dokumentasie:
• Added n & quot; Die opgradering van Pyramid & quot; hoofstuk aan die vertelling dokumentasie. Dit beskryf hoe om te gaan met deprecations en verskuiwings van Pyramid API's en hoe Pyramid-gegenereerde afkeuring waarskuwings te wys terwyl hy loop toetse en terwyl jy 'n bediener.
• Bygevoeg 'n & quot; Invoking n Subrequest & quot; hoofstuk na die dokumentasie. Dit beskryf hoe die nuwe request.invoke_subrequest API te gebruik.
• Afhanklikhede:
• Pyramid vereis nou WebOb 1.2b3 + (die vorige piramide release net staatgemaak op 1.2dev +). Dit is om te verseker dat ons kry 'n weergawe van WebOb wat terugkeer request.path_info as teks.

Wat is nuut in die weergawe 1.3.2:

• Weergawe 1.3.1 'n brownbag release, by minste op Windows en moontlik op ander bedryfstelsels, te danke aan die bestaan ​​van 'n verdwaalde & quot; pakket gids (kwotasie ingesluit) in die hoofdmap van die 1.3.1 tarball. Hierdie gids en die inhoud daarvan was teenwoordig, want die tarball is geskep met behulp van 'weergawe van setuptools-git eerder as 'n setuptools-git geïnstalleer vanaf 'n afhandeling. Die enigste verandering in hierdie weergawe is die verpakking fout in 1.3.1 te stel.

Wat is nuut in die weergawe 1.3:

• Wanneer pyramid.wsgi.wsgiapp2 noem die stroomaf WSGI app, die jeug se omgewings sal nie langer (afgekeur en potensieel misleidend) bfg.routes.matchdict of bfg.routes.route sleutels in dit. A simptoom van hierdie fout sou 'n wsgiapp2 toegedraai Pyramid app vind die verkeerde siening wees, want dit verkeerdelik ontdek dat 'n roete is gekoppel wanneer, in werklikheid, dit was nie.
• Die oplossing vir probleem https://github.com/Pylons/pyramid/issues/461 (wat dit moontlik gemaak het byvoorbeeld metodes te gebruik word as die lig callables) het 'n agteruit onverenigbaarheid wanneer metodes wat verklaar net 'n versoek argument was gebruik. Sien https://github.com/Pylons/pyramid/issues/503

Wat is nuut in die weergawe 1.3 Beta 2:

• Die metode pyramid.request.Request.partial_application_url is nie meer in die API docs. Dit is bedoel om 'n private metode te wees; sy publikasie in die dokumentasie as 'n API metode was 'n fout gemaak het, en dit is herdoop na iets privaat.
• As 'n statiese siening is geregistreer met 'n absolute lêerstelsel pad op Windows, het die request.static_url funksie nie werk nie URLs sy hulpbronne te genereer. Simptoom: & quot; Geen statiese URL definisie ooreenstem c:. Foobarbaz & quot;
• Maak alle toetse slaag op Windows XP.
• Bug in ACL verifikasie nagaan op Python 3: die permitte en principals_allowed_by_permission metode van pyramid.authorization.ACLAuthenticationPolicy kan 'n onvanpaste Ware waarde teruggee wanneer 'n toestemming op 'n ACL was 'n string eerder as 'n reeks, en dan slegs indien die ACL toestemming string was 'n substring van die toestemming waarde geslaag om die funksie.
• Hierdie fout effekte geen Pyramid ontplooiing onder Python 2; dit is 'n fout wat bestaan ​​slegs in ontplooi loop op Python 3. Dit bestaan ​​sedert Pyramid 1.3a1.
• Hierdie fout was as gevolg van die teenwoordigheid van 'n __iter__ kenmerk op strykers onder Python 3 wat onder snare in Python 2 teenwoordig is nie.

Wat is nuut in die weergawe 1.3 Beta 1:

• Bug fixes:
• pyramid.config.Configurator.with_package nie werk nie indien die Configurator was 'n ou-styl pyramid.configuration.Configurator byvoorbeeld.
• Pyramid magtiging beleid het nie wys in die introspector.
• Deprecations:
• Alle verwysings na die tmpl_context versoek veranderlike is van die dokumente verwyder. Sy bestaan ​​in Pyramid is verwarrend vir mense wat nooit kragpale gebruikers. Dit is bygevoeg as 'n porting gerief vir Pilone gebruikers in Pyramid 1.0, maar dit het nooit gevang op omdat die piramide lewering stelsel is 'n baie anders as Pilone 'was, en die alternatiewe maniere bestaan ​​om te doen wat dit ontwerp is om aan te bied Pilone. Dit sal voortgaan om te bestaan ​​& quot; vir ewig & quot; maar dit sal nie aanbeveel word of wat in die dokumente.

Vereistes :

• Python