pyramid

pyramide er en hurtig, lille, nede-på-jorden, open source framework Python webudvikling. & Nbsp; Det gør den virkelige verden web-applikation udvikling og udbredelse sjovere, mere forudsigelig og mere produktive.
pyramide er et Pyloner projekt, og ligger til grund de nyeste web rammer produceret af pylonerne fællesskabet.
pyramide var tidligere kendt som repoze.bfg.
Support og dokumentation
Se pylonerne Project hjemmeside for at se dokumentation, rapportere bugs, og få support.
License
pyramide tilbydes under BSD-afledte Repoze Public License

Hvad er nyt i denne udgivelse:.

• mako_templating: tilføjet defensiv løsning på manglende importability af Mako grund opstrøms markupsafe droppe Python 3.2 support. Mako templating vil ikke længere arbejde under kombinationen af ​​MarkupSafe 0,17 og Python 3.2 (selvom kombinationen af ​​MarkupSafe 0,17 og Python 3.3 eller enhver understøttet Python 2 version vil arbejde OK).
• Gør pyramid.config.assets.PackageOverrides objekt gennemføre API for __loader__ genstande er specificeret i PEP 302. Fuldmagter til __loader__ indstillet af importøren, hvis til stede; ellers rejser NotImplementedError. Dette gør Pyramid statisk syn tilsidesættelser arbejde ordentligt under Python 3.3 (tidligere ville de ikke). Se https://github.com/Pylons/pyramid/pull/1015 for mere information.

Hvad er nyt i version 1.4:

• Fix funktionelle tests i ZODB tutorial

Hvad er nyt i version 1.4 Beta 3:

• release Emballage kun, ingen kode ændringer. 1.4b2 var en brownbag udgivelse på grund af manglende biblioteker i tar-arkivet.

Hvad er nyt i version 1.3.4:

• Når pyramid.debug_routematch blev tændt og traversen prædikat blev brugt i enhver rute routeren ville rejse en undtagelse, når du forsøger at udskrive ruten debugging information. Denne fejl har eksisteret siden 1.3a1.
• Når travers prædikat blev brugt i enhver rute ville proutes og pviews konsol scripts hæve en undtagelse, når du forsøger at udskrive ruten fejlfindingsoplysninger. Denne fejl har eksisteret siden 1.3a1.
• tilbageføre bug fix fra master: - I Mako Skabeloner opslag, så tjek for absolut uri (ved hjælp af Mako biblioteker), når blande arv med aktiver specs. https://github.com/Pylons/pyramid/issues/662
• Ved tilmelding af flere synspunkter med en acceptere prædikat i en Pyramid ansøgning runing under Python 3, du kan have modtaget en TypeError: unorderable typer: function () & lt; funktion () undtagelse.
• tilbageføre fra master: HTTP Accepter overskrifter ikke blev normaliseret forårsager potentielt modstridende udpluksregistreringer at gå ubemærket hen. To visninger, der kun adskiller sig i sagen ("text / html" vs. "tekst / HTML) vil nu rejse en fejl. https://github.com/Pylons/pyramid/pull/620

Hvad er nyt i version 1.4 Alpha 1:

• Fejlrettelser:
• Forward port fra 1,3 filial: Når der ikke autentificeringspolitik blev konfigureret, vil et opkald til pyramid.security.effective_principals ubetinget returnere den tomme liste. Det var forkert, det bør have ubetinget returneres [Alle], og nu gør.
• Eksplicit url ekspeditionscentre regexes kan nu indeholde koloner. https://github.com/Pylons/pyramid/issues/629
• På mindst én 64-bit Ubuntu system under Python 3.2, ved hjælp af view_config dekoratør forårsagede en Runtimeerror: ordbog ændrede størrelse i løbet iteration undtagelse. Det er ikke længere gør. Se https://github.com/Pylons/pyramid/issues/635 for mere information.
• I Mako Skabeloner opslag, kontrollere, om uri allerede er justeret og bringe den tilbage til et aktiv spec. Normalt opstår med nedarvede skabeloner eller indgår komponenter. https://github.com/Pylons/pyramid/issues/606 https://github.com/Pylons/pyramid/issues/607
• I Mako Skabeloner opslag, så tjek for absolut uri (ved hjælp af Mako mapper), når blande arv med aktiver specs. https://github.com/Pylons/pyramid/issues/662
• HTTP Accepter overskrifter ikke blev normaliseret forårsager potentielt modstridende udpluksregistreringer at gå ubemærket hen. To visninger, der kun adskiller sig i sagen ("text / html" vs. "tekst / HTML) vil nu rejse en fejl. https://github.com/Pylons/pyramid/pull/620
• Fremadrettede port fra 1,3 filial: når du registrerer flere visninger med en acceptere prædikat i en Pyramid ansøgning runing under Python 3, du kan have modtaget en TypeError: unorderable typer: function () & lt; funktion () undtagelse.
• Features:
• Configurator.add_directive nu accepterer vilkårlige konverterbare som deltoner eller genstande til gennemførelse __call__ der dont have __name__ og __doc__ attributter. Se https://github.com/Pylons/pyramid/issues/621 og https://github.com/Pylons/pyramid/pull/647.
• Tredjeparts tilpasset visning, rute, og abonnent prædikater kan nu tilføjes til brug for visning forfattere via pyramid.config.Configurator.add_view_predicate, pyramid.config.Configurator.add_route_predicate og pyramid.config.Configurator.add_subscriber_predicate. Så for eksempel, at gøre dette:
• config.add_view_predicate ("ABC", my.package.ABCPredicate)
• kunne give en visning forfatter til at gøre dette i et program, der er konfigureret, at prædikatet:
• view_config (abc = 1)
• Lignende funktioner findes for add_route, og add_subscriber. Se & quot; at tilføje en tredje part View, rute eller Subscriber prædikat & quot; i krogene kapitlet for mere information.
• Bemærk, at ændringer foretaget for at støtte den ovennævnte funktion betyder nu, at kun handlinger registreret ved hjælp af den samme & quot; orden & quot; kan være i strid med hinanden. Det plejede at være sådan, at aktioner, der er registreret på forskellige ordrer kan potentielt konflikt, men så vidt jeg ved intet nogensinde afhang denne adfærd (det var lidt fjollet).
• Brugerdefinerede objekter kan gøres let JSON-serializable Pyramid ved at definere en __json__ metode på objektets klasse. Denne metode skal returnere værdier indbygget Serializable af json.dumps (såsom int'er, lister, ordbøger, strygere osv).
• JSON renderer giver nu mulighed for definitionen af ​​brugerdefinerede typen adaptere til at konvertere ukendte objekter til JSON serializations.
• Fra denne udgivelse, den request_method prædikat, når de bruges, vil også indebære, at hovedet er underforstået, når du bruger GET. For eksempel ved hjælpview_config (request_method = 'GET ") svarer til at brugeview_config (request_method = (' get ',' hovedet ')). Brugview_config (request_method = ('get', 'POST') svarer til at brugeview_config (request_method = ('get', 'hovedet', 'POST "). Dette skyldes, HEAD er en variant af GET der udelader krop, og WebOb har særlig støtte til at returnere en tom krop, når en HEAD bruges.
• config.add_request_method er blevet indført for at støtte strækker anmodning objekter med vilkårlige konverterbare. Denne metode udvider på den foregående config.set_request_property ved understøttende metoder samt ejendomme. Denne metode medfører nu mindre kode, der skal udføres på anmodning byggetid end config.set_request_property i version 1.3.
• Du må ikke tilføje en? til webadresser genereret af request.resource_url hvis forespørgslen argument er forudsat, men tom.
• Du må ikke tilføje en? til webadresser genereret af request.route_url hvis _query argument er forudsat, men tom.
• Den statiske udsigt maskiner nu rejser (i stedet for afkast) HTTPNotFound og HTTPMovedPermanently undtagelser, så disse kan fanges af notfound visning (og andre visninger undtagelse).
• Mako renderer understøtter nu en def navn i et aktiv spec. Når def navn er til stede i aktiv spec, vil systemet gøre skabelonen def i skabelonen og vil vende tilbage resultatet. Et eksempel asset spec er pakken: sti / til / skabelon # defname.mako. Dette vil gøre def navngivne defname inde i template.mako skabelon i stedet for at gøre hele skabelonen. Den gamle måde at returnere en tupel i form (»defname« {}) fra synspunkt støttes for bagudkompatibilitet,
• Chameleon ZPT renderer accepterer nu en makro navn i et aktiv spec. Når makroen navn er til stede i aktivet spec, vil systemet gøre makroen opført som en define-makro og returnere resultatet i stedet for at gøre hele skabelonen. Et eksempel asset spec: pakke: sti / til / skabelon # macroname.pt. Dette vil gøre makroen defineret som MakroNavn i template.pt skabelon i stedet for hele templae.
• Når der er et prædikat mismatch undtagelse (ses, når ingen visning kampe for en given anmodning på grund af prædikater ikke arbejder), indeholder undtagelsen nu en beskrivelse af prædikatet som ikke svarede.
• En add_permission direktiv metode blev tilføjet til konfiguratoren. Dette direktiv registrerer en fritstående tilladelse introspectable i Pyramid introspektion system. Rammer bygget oven Pyramid kan således bruge tilladelsesindstillingerne introspectable kategoridata at opbygge en omfattende liste over tilladelser, der understøttes af et kørende system. Før blev tilføjet denne metode blev tilladelser allerede er registreret i denne introspectable kategori som en bivirkning af at navngive dem i en add_view opkald, denne metode gør det blot muligt at sørge for en tilladelse til at blive sat i tilladelserne introspectable kategori uden at nævne det sammen med en tilknyttet visning. Her er et eksempel på brugen af ​​add_permission:
• config = Configurator ()
• config.add_permission ('Vis')
• UnencryptedCookieSessionFactoryConfig nu accepterer signed_serialize og signed_deserialize kroge, som kan anvendes til at påvirke, hvordan de sessioner der rangeres (som standard dette gøres med HMAC + lage).
• pyramid.testing.DummyRequest understøtter nu metoder leveret af pyramid.util.InstancePropertyMixin klassen såsom set_property.
• Request egenskaber og metoder tilføjes via config.set_request_property eller config.add_request_method er nu tilgængelige for tweens.
• Request egenskaber og metoder tilføjes via config.set_request_property eller config.add_request_method er nu tilgængelige i objektet anmodningen tilbage fra pyramid.paster.bootstrap.
• request.context anmodning miljø under bootstrap er nu roden objekt, hvis en kontekst ikke allerede er angivet på en forudsat anmodning.
• pyramid.decorator.reify funktion er nu en API, og blev sat til API-dokumentation.
• Tilføjet pyramid.testing.testConfig sammenhæng manager, som kan anvendes til at generere en konfigurator i en test, fx med testing.testConfig (...):.
• Brugere kan nu påberåbe sig en subrequest indefra udsigt kode ved hjælp af en ny request.invoke_subrequest API.
• Deprecations:
• pyramid.config.Configurator.set_request_property har været dokumentation-forældet. Metoden er stadig brugbar, men den mere funktionsfyldt pyramid.config.Configurator.add_request_method bør anvendes i stedet (det har alle de samme funktioner, men kan også udvide anmodningen objekt med metoder).
• Backwards Uforligeligheder:
• Pyramid router ikke længere lægger værdierne bfg.routes.route eller bfg.routes.matchdict til anmodningen er WSGI miljø ordbog. Disse værdier var docs-frarådede i repoze.bfg 1,0 (effektivt syv mindre udgivelser siden). Hvis din kode afhang disse værdier, skal du bruge request.matched_route og request.matchdict i stedet.
• Det er ikke længere muligt at bestå en miljø ordbog direkte til pyramid.traversal.ResourceTreeTraverser .__ call__ (aka ModelGraphTraverser .__ call__). I stedet skal du bestå en anmodning objekt. Passing et miljø i stedet for en anmodning har genereret en afskrivninger advarsel siden Pyramid 1.1.
• Pyramid vil ikke længere korrekt, hvis du bruger webob.request.LegacyRequest som en anmodning fabrik. Forekomster af LegacyRequest klasse har en request.path_info som returnerer en streng. Denne pyramide udgivelse forudsætter, at request.path_info ubetinget vil være Unicode.
• Funktionerne fra pyramid.chameleon_zpt og pyramid.chameleon_text opkaldt get_renderer, get_template, render_template og render_template_to_response er fjernet. Disse har udsendt en afskrivninger advarsel ved import siden Pyramid 1.0. Brug pyramid.renderers.get_renderer (), pyramid.renderers.get_renderer (). Gennemførelse (), pyramid.renderers.render () eller pyramid.renderers.render_to_response henholdsvis i stedet for disse funktioner.
• pyramid.configuration modul blev fjernet. Det havde været forældet siden Pyramid 1.0 og udskrives en afskrivninger advarsel ved dets brug. Brug pyramid.config i stedet.
• pyramid.paster.PyramidTemplate API blev fjernet. Det havde været forældet siden Pyramid 1.1 og udsendte en advarsel på import. Hvis din kode afhang dette, justere din kode til at importere pyramid.scaffolds.PyramidTemplate i stedet.
• pyramid.settings.get_settings () API blev fjernet. Det havde været at udskrive en afskrivninger advarsel siden Pyramid 1.0. Hvis din kode afhang denne API, brug pyramid.threadlocal.get_current_registry (). Indstillinger i stedet eller brug indstillingerne attribut i registreringsdatabasen til rådighed fra anmodningen (request.registry.settings).
• Disse API'er fra pyramid.testing modulet blev fjernet. De er blevet udskrivning deprecation advarsler siden Pyramid 1.0:
• registerDummySecurityPolicy Brug pyramid.config.Configurator.testing_securitypolicy i stedet.
• registerResources (aka registerModels, bruger pyramid.config.Configurator.testing_resources i stedet.
• registerEventListener Brug pyramid.config.Configurator.testing_add_subscriber i stedet.
• registerTemplateRenderer (aka registerDummyRenderer`), brug pyramid.config.Configurator.testing_add_template i stedet.
• registerView Brug pyramid.config.Configurator.add_view i stedet.
• registerUtility Brug pyramid.config.Configurator.registry.registerUtility i stedet.
• registerAdapter Brug pyramid.config.Configurator.registry.registerAdapter i stedet.
• registerSubscriber Brug pyramid.config.Configurator.add_subscriber i stedet.
• registerRoute Brug pyramid.config.Configurator.add_route i stedet.
• registerSettings, brug pyramid.config.Configurator.add_settings stedet.
• Pyramid 1.3 og tidligere, den __call__ metode et svar objekt blev påberåbes ved nogen færdige tilbagekald blev henrettet. Fra denne udgivelse er __call__ metode et svar objekt påberåbes efter færdige tilbagekald udføres. Det er til støtte for request.invoke_subrequest funktion.
• Dokumentation:
• Tilføjet en & quot; Opgradering Pyramid & quot; kapitel til narrative dokumentationen. Den beskriver, hvordan til at håndtere deprecations og optag Pyramid API'er og hvordan at vise Pyramid genererede deprecation advarsler, mens den kører test og mens du kører en server.
• Tilføjet en & quot; Start en Subrequest & quot; kapitel til dokumentationen. Den beskriver, hvordan man bruger den nye request.invoke_subrequest API.
• Afhængigheder:
• Pyramid nu kræver WebOb 1.2b3 + (forudgående Pyramid udgivelse kun har påberåbt sig 1.2dev +). Dette er for at sikre, at vi får en version af WebOb der returnerer request.path_info som tekst.

Hvad er nyt i version 1.3.2:

• Version 1.3.1 var en brownbag udgivelse, på mindste på Windows og eventuelt på andre operativsystemer, på grund af eksistensen af ​​en vildfaren & quot; pakke mappe (citat inkluderet) i rodmappen på 1.3.1 tarball. Denne mappe og dens indhold var til stede, da tar blev oprettet ved hjælp en version af setuptools-git i stedet for en setuptools-git installeres fra en kassen. Den eneste ændring i denne udgivelse er at korrigere emballagen fejl i 1.3.1.

Hvad er nyt i version 1.3:

• Når pyramid.wsgi.wsgiapp2 kalder den nedstrøms WSGI app, appens miljø vil ikke længere have (forældet og potentielt vildledende) bfg.routes.matchdict eller bfg.routes.route nøgler i den. Et symptom på denne fejl ville være en wsgiapp2-indpakket Pyramide app at finde den forkerte opfattelse, fordi det fejlagtigt registrerer, at en rute er blevet matchet, når det i virkeligheden var det ikke.
• Løs problemet https://github.com/Pylons/pyramid/issues/461 (hvilket gjorde det muligt for eksempel, der skal anvendes som view konverterbare) indført en baglæns kompatibilitet, hvis metoder, erklærede blot en anmodning argument var anvendes. Se https://github.com/Pylons/pyramid/issues/503

Hvad er nyt i version 1.3 Beta 2:

• Metoden pyramid.request.Request.partial_application_url er ikke længere i API docs. Det var ment som en privat metode; offentliggørelsen i dokumentationen som en API metode var en fejl, og det er blevet omdøbt til noget privat.
• Når en statisk synspunkt blev registreret ved hjælp af en absolut filsystem sti på Windows, har request.static_url funktionen ikke at generere URL'er til dets ressourcer. Symptom: & quot; Ingen statisk definition URL matching c:. Foobarbaz & quot;
• Gør alle tests videregive Windows XP.
• Bug i ACL-godkendelse kontrol på Python 3: tilladelser og principals_allowed_by_permission metode pyramid.authorization.ACLAuthenticationPolicy kunne returnere en uhensigtsmæssig Ægte værdi, når en tilladelse på en ACL var en streng i stedet for en sekvens, og derefter kun hvis ACL tilladelse streng var en delstreng af tilladelse værdi overføres til funktionen.
• Denne fejl effekter ingen Pyramid indsættelse under Python 2; Det er en fejl, der kun findes i installationer, der kører på Python 3. Det har eksisteret siden Pyramid 1.3a1.
• Denne fejl skyldtes tilstedeværelsen af ​​en __iter__ attribut på strenge under Python 3, som ikke er til stede under strenge i Python 2.

Hvad er nyt i version 1.3 Beta 1:

• Fejlrettelser:
• pyramid.config.Configurator.with_package fungerede hvis Configurator var en gammeldags pyramid.configuration.Configurator instans.
• politikker Pyramid tilladelse ikke vise i introspector.
• Deprecations:
• Alle henvisninger til den variable tmpl_context anmodning blev fjernet fra docs. Dets eksistens i Pyramid er forvirrende for folk, der aldrig er blevet pyloner brugere. Den blev tilføjet som en portering bekvemmelighed for pyloner brugere i Pyramid 1.0 men desværre fanget på fordi Pyramid rendering system er meget anderledes end Pyloner "var, og alternative måder eksisterer for at gøre, hvad det var designet til at byde på Pyloner. Den vil fortsætte med at eksistere & quot; for evigt & quot; men det vil ikke blive anbefalet eller nævnt i docs.

Krav :

• Python