pyramid

pyramide er en rask, liten, down-to-earth, åpen kildekode Python web utviklingsmiljø. & Nbsp; Det gjør real-world web programutvikling og distribusjon morsommere, mer forutsigbar og mer produktiv.
pyramide er en Kjegler prosjekt, og ligger til grunn for de nyeste nett rammer produsert av Kjegler samfunnet.
pyramiden var tidligere kjent som repoze.bfg.
Brukerstøtte og dokumentasjon
Se Kjegler Prosjekt hjemmeside for å se dokumentasjon, rapport bugs, og få støtte.
License
pyramide tilbys under BSD-avledet Repoze Public License

Hva er nytt i denne utgaven:.

• mako_templating: lagt defensiv Løsning for ikke-importability av mako grunn oppstrøms markupsafe slippe Python 3.2-støtte. Mako templating vil ikke lenger arbeide under kombinasjonen av MarkupSafe 0,17 og Python 3.2 (selv om kombinasjonen av MarkupSafe 0,17 og Python 3.3 eller hvilken som helst støttet Python 2-versjonen vil fungere OK).
• Gjør de pyramid.config.assets.PackageOverrides objekt implementere API for __loader__ objekter oppgitt i PEP 302. Fullmakter til __loader__ satt av importøren, hvis det finnes; ellers hever NotImplementedError. Dette gjør Pyramid statisk visning styrer fungerer riktig under Python 3.3 (tidligere de ikke ville). Se https://github.com/Pylons/pyramid/pull/1015 for mer informasjon.

Hva er nytt i versjon 1.4:

• Fix funksjonelle tester i ZODB opplæringen

Hva er nytt i versjon 1.4 Beta 3:

• Emballasje utgivelsen bare, ingen kodeendringer. 1.4b2 var en brownbag utgivelse på grunn av manglende kataloger i tarball.

Hva er nytt i versjon 1.3.4:

• Når pyramid.debug_routematch ble slått på og traversen predikat ble brukt i noen rute, ruteren ville heve et unntak når du prøver å skrive ut ruten debugging informasjon. Denne feilen har eksistert siden 1.3a1.
• Når traversen predikat ble brukt i noen rute, ville proutes og pviews konsoll skript heve et unntak når du prøver å skrive ut ruten feilsøkingsinformasjon. Denne feilen har eksistert siden 1.3a1.
• anvende i en eldre bug fix fra mester: - I Mako Maler oppslag, sjekk for absolutt uri (med mako kataloger) når du blander opp arven med aktiva specs. https://github.com/Pylons/pyramid/issues/662
• Når du registrerer flere visninger med en akseptere predikat i en pyramide program runing henhold Python 3, du kan ha mottatt en Feiltype: unorderable typer: function () & lt; funksjon () unntak.
• anvende i en eldre fra mester: HTTP Godta overskrifter ikke ble normalisert forårsaker potensielt motstridutsnittsregistreringer for å gå ubemerket hen. To visninger som bare skiller seg i saken ('text / html' vs. 'text / html') vil nå heve en feil. https://github.com/Pylons/pyramid/pull/620

Hva er nytt i versjon 1.4 Alpha 1:

• feilrettinger:
• Forward port fra 1,3 gren: Når ingen autentiseringspolitikk ble konfigurert, vil et kall til pyramid.security.effective_principals ubetinget returnere tom liste. Dette var feil, det bør ha ubetinget returnert [Alle], og nå gjør.
• Eksplisitt url ekspedere regexes kan nå inneholde kolon. https://github.com/Pylons/pyramid/issues/629
• På minst en 64-bit Ubuntu systemet under Python 3.2, ved hjelp av view_config dekoratør forårsaket en RuntimeError: ordbok endret størrelse i løpet av iterasjon unntak. Det ikke lenger gjør. Se https://github.com/Pylons/pyramid/issues/635 for mer informasjon.
• I Mako Maler oppslag, sjekke om uri er allerede justert og bringe den tilbake til en eiendel spec. Normalt skjer med arvet maler eller inkluderte komponenter. https://github.com/Pylons/pyramid/issues/606 https://github.com/Pylons/pyramid/issues/607
• I Mako Maler oppslag, sjekk for absolutt uri (med mako kataloger) når du blander opp arven med aktiva specs. https://github.com/Pylons/pyramid/issues/662
• HTTP Godta overskrifter ikke ble normalisert forårsaker potensielt motstridutsnittsregistreringer for å gå ubemerket hen. To visninger som bare skiller seg i saken ('text / html' vs. 'text / html') vil nå heve en feil. https://github.com/Pylons/pyramid/pull/620
• Forward-port fra 1,3 gren: når du registrerer flere visninger med en akseptere predikat i en pyramide program runing henhold Python 3, du kan ha mottatt en Feiltype: unorderable typer: function () & lt; funksjon () unntak.
• Egenskaper:
• Configurator.add_directive aksepterer nå vilkår callables som partials eller objekter som implementerer __call__ som ikke har __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 predikater kan nå legges til bruk ved 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, gjør dette:
• config.add_view_predicate ('abc', my.package.ABCPredicate)
• Kan tillate en visning forfatteren å gjøre dette i et program som er konfigurert som predikat:
• view_config (abc = 1)
• Lignende funksjoner finnes for add_route, og add_subscriber. Se & quot; Legge til en tredjeparts View, Route, eller Subscriber Predicate & quot; i Hooks kapittel for mer informasjon.
• Merk at endringer gjort for å støtte de ovennevnte funksjonen innebærer nå at bare handlinger registrert bruker samme & quot; for & quot; kan komme i konflikt med hverandre. Det pleide å være slik at handlinger registrert på forskjellige ordrer kan potensielt konflikt, men så vidt jeg vet ingenting noensinne var avhengig av denne atferden (det var litt dumt).
• Egendefinerte objekter kan gjøres enkelt JSON-serial i Pyramid ved å definere en __json__ metoden på objektets klasse. Denne metoden skal returnere verdier opprinnelig serializable av json.dumps (som ints, lister, ordbøker, strykere, og så videre).
• JSON renderer tillater nå for definisjonen av tilpassede typen adaptere for å konvertere ukjente gjenstander til JSON seriefunksjoner.
• Etter denne utgivelsen, den request_method predikatet, når de brukes, vil også innebære at HEAD er underforstått når du bruker GET. For eksempel brukerview_config (request_method = 'GET') tilsvarer å brukeview_config (request_method = ('GET', 'HEAD')). Ved hjelpview_config (request_method = ('GET', 'POST') tilsvarer å brukeview_config (request_method = ('GET', 'HEAD', 'POST'). Dette er fordi HEAD er en variant av GET som utelater kroppen, og WebOb har spesiell støtte til å returnere en tom kroppen når en HEAD brukes.
• config.add_request_method har blitt introdusert for å støtte strekker forespørsel objekter med vilkår callables. Denne metoden utvider på den forrige config.set_request_property ved støtte metoder samt egenskaper. Denne metoden fører nå mindre kode å bli henrettet ved forespørsel byggetid enn config.set_request_property i versjon 1.3.
• Ikke legg til en? til nettadresser som genereres av request.resource_url hvis søket argument er gitt, men tom.
• Ikke legg til en? til nettadresser som genereres av request.route_url hvis _query argument er gitt, men tom.
• statisk visning maskiner hever nå (snarere enn avkastning) HTTPNotFound og HTTPMovedPermanently unntak, slik at disse kan bli fanget av NotFound view (og andre visninger unntak).
• Mako renderer støtter nå et def navn i en eiendel spec. Når def navn er til stede i eiendelen spec, vil systemet gi malen def i malen og vil returnere resultatet. Et eksempel eiendel spec er pakken: bane / til / mal # defname.mako. Dette vil gjengi def heter defname inne i template.mako mal i stedet for å gjengi hele malen. Den gamle måten å returnere et tuppel i form ('defname', {}) fra synet støttes for bakoverkompatibilitet
• The Chameleon ZPT renderer aksepterer nå et makronavn i en eiendel spec. Når makronavn er tilstede i aktiva spec, vil systemet gi makro oppført som definerer-makro og returnere produktet i stedet for å gjengi hele malen. Et eksempel eiendel spec: pakke: bane / til / mal # macroname.pt. Dette vil gjengi makro definert som macroname innenfor template.pt mal i stedet for hele templae.
• Når det er et predikat mismatch unntak (sett når ingen utsikt kamper for en gitt forespørsel på grunn av predikater ikke fungerer), inneholder unntak nå en tekstlig beskrivelse av predikatet som ikke samsvarte.
• En add_permission direktiv metoden ble lagt til Configurator. Dette direktivet registrerer en frittstående tillatelse introspectable inn i pyramiden introspeksjon system. Rammeverk bygget på toppen av pyramiden kan dermed bruke de tillatelser introspectable kategoridata for å bygge en omfattende liste over tillatelser som støttes av et kjørende system. Før denne metoden ble innført, ble tillatelser allerede er registrert i denne introspectable kategori som en bivirkning av å navngi dem i en add_view samtale, denne metoden gjør nettopp det mulig å arrangere en tillatelse til å bli satt inn i tillatelsene introspectable kategori uten å navngi den sammen med en tilknyttet visning. Her er et eksempel på bruk av add_permission:
• config = Configurator ()
• config.add_permission ('view')
• UnencryptedCookieSessionFactoryConfig aksepterer nå signed_serialize og signed_deserialize kroker som kan brukes til å påvirke hvordan øktene blir formidlet (som standard er dette gjort med HMAC + pickle).
• pyramid.testing.DummyRequest støtter nå metoder levert av pyramid.util.InstancePropertyMixin klasse som set_property.
• Be om egenskaper og metoder lagt via config.set_request_property eller config.add_request_method er nå tilgjengelig for tweens.
• Be om egenskaper og metoder lagt via config.set_request_property eller config.add_request_method er nå tilgjengelig i anmodningen objektet returnert fra pyramid.paster.bootstrap.
• request.context miljø forespørsel under bootstrap er nå roten objekt hvis en sammenheng ikke allerede er satt på en gitt forespørsel.
• Den pyramid.decorator.reify Funksjonen er nå en API, og ble lagt til API-dokumentasjon.
• Lagt pyramid.testing.testConfig sammenheng manager, som kan brukes til å generere en konfigurator i en test, for eksempel med testing.testConfig (...).
• Brukere kan nå påberope en subrequest innenfra utsikt koden ved hjelp av en ny request.invoke_subrequest API.
• Deprecations:
• pyramid.config.Configurator.set_request_property har vært dokumentasjon-foreldet. Metoden er fortsatt brukbare, men mer featureful pyramid.config.Configurator.add_request_method bør brukes i stedet (det har alle de samme mulighetene, men kan også forlenge forespørsel objekt med metoder).
• Backwards Uforlikeligheter:
• The Pyramid router ikke lenger legger verdiene bfg.routes.route eller bfg.routes.matchdict til forespørselen er WSGI miljø ordbok. Disse verdiene var docs-nedgraderte i repoze.bfg 1,0 (effektivt sju mindre utgivelser siden). Hvis koden din var avhengig av disse verdiene, bruker request.matched_route og request.matchdict i stedet.
• Det er ikke lenger mulig å passere et miljø ordbok direkte til pyramid.traversal.ResourceTreeTraverser .__ call__ (aka ModelGraphTraverser .__ call__). I stedet må du passere en forespørsel objekt. Passerer et miljø i stedet for en forespørsel har generert en nedgraderingen advarsel siden Pyramid 1.1.
• Pyramid vil ikke lenger fungere skikkelig hvis du bruker webob.request.LegacyRequest som en forespørsel fabrikken. Forekomster av LegacyRequest klassen har en request.path_info som returnerer en streng. Dette Pyramid utgivelsen forutsetter at request.path_info vil ubetinget være Unicode.
• Funksjonene fra pyramid.chameleon_zpt og pyramid.chameleon_text heter get_renderer, get_template, render_template, og render_template_to_response har blitt fjernet. Disse har utstedt en nedgraderingen advarsel ved import siden Pyramid 1.0. Bruk pyramid.renderers.get_renderer (), pyramid.renderers.get_renderer (). Implementering (), pyramid.renderers.render () eller pyramid.renderers.render_to_response henholdsvis i stedet for disse funksjonene.
• pyramid.configuration modulen ble fjernet. Det hadde blitt frarådet siden Pyramid 1.0 og skrevet en nedgraderingen advarsel på bruken. Bruk pyramid.config i stedet.
• pyramid.paster.PyramidTemplate API ble fjernet. Det hadde blitt frarådet siden Pyramid 1.1 og utstedte en advarsel på import. Hvis koden din var avhengig av dette, justere koden din for å importere pyramid.scaffolds.PyramidTemplate i stedet.
• De pyramid.settings.get_settings () API ble fjernet. Skriver det hadde blitt en nedgraderingen advarsel siden Pyramid 1.0. Hvis koden din var avhengig av denne API, bruke pyramid.threadlocal.get_current_registry (). Innstillingene i stedet eller bruke innstillingene egenskap av registeret tilgjengelig fra forespørsel (request.registry.settings).
• Disse APIer fra pyramid.testing modulen ble fjernet. De har blitt utskrift avskrivnings advarsler siden Pyramid 1.0:
• registerDummySecurityPolicy, bruker pyramid.config.Configurator.testing_securitypolicy i stedet.
• registerResources (aka registerModels, bruker pyramid.config.Configurator.testing_resources i stedet.
• registerEventListener, bruker pyramid.config.Configurator.testing_add_subscriber i stedet.
• registerTemplateRenderer (aka registerDummyRenderer`), bruker pyramid.config.Configurator.testing_add_template i stedet.
• registerView, bruker pyramid.config.Configurator.add_view i stedet.
• registerUtility, bruker pyramid.config.Configurator.registry.registerUtility i stedet.
• registerAdapter, bruker pyramid.config.Configurator.registry.registerAdapter i stedet.
• registerSubscriber, bruker pyramid.config.Configurator.add_subscriber i stedet.
• registerRoute, bruker pyramid.config.Configurator.add_route i stedet.
• registerSettings, bruk pyramid.config.Configurator.add_settings i stedet.
• I Pyramid 1.3 og tidligere, den __call__ metoden for en Response objekt ble startet før noen ferdige callbacks ble henrettet. Fra og med denne utgivelsen, er __call__ metoden for en Response objekt påberopes etter ferdige callbacks blir henrettet. Dette er til støtte for request.invoke_subrequest funksjonen.
• Dokumentasjon:
• Lagd en & quot; Oppgradering Pyramid & quot; kapittel til dokumentasjon fortelling. Den beskriver hvordan du kan takle deprecations og fjerning av Pyramid APIer og hvordan å vise Pyramid genererte avskrivnings advarsler mens du kjører tester og mens du kjører en server.
• Lagt til en & quot; Starte en Subrequest & quot; kapittel til dokumentasjon. Den beskriver hvordan du bruker den nye request.invoke_subrequest API.
• Avhengig:
• Pyramid krever nå WebOb 1.2b3 + (tidligere Pyramid utgivelsen bare stolt på 1.2dev +). Dette er for å sikre at vi får en versjon av WebOb som returnerer request.path_info som tekst.

Hva er nytt i versjon 1.3.2:

• Versjon 1.3.1 var en brownbag utgivelse, på minste på Windows og muligens på andre operativsystemer, på grunn av eksistensen av en bortkommen & quot; pakke katalogen (sitat inkludert) i rotkatalogen på 1.3.1 tarball. Denne katalogen og innholdet var til stede fordi tarball ble opprettet ved hjelp av en utgitt versjon av setuptools-git snarere enn en setuptools-git installeres fra en kassen. Den eneste endringen i denne utgivelsen er å rette emballasjen feil i 1.3.1.

Hva er nytt i versjon 1.3:

• Når pyramid.wsgi.wsgiapp2 kaller nedstrøms WSGI app, appens miljø vil ikke lenger ha (deprecated og potensielt misvisende) bfg.routes.matchdict eller bfg.routes.route nøkler i den. Et symptom på denne feilen ville være en wsgiapp2-innpakket Pyramid app finne feil syn fordi det feilaktig oppdager at en rute ble matchet da, faktisk, det var det ikke.
• fix for problemet https://github.com/Pylons/pyramid/issues/461 (som gjorde det mulig for instansmetoder som skal brukes som visnings callables) introduserte en baklengs inkompatibilitet når metoder som erklærte bare en forespørsel argument var anvendes. Se https://github.com/Pylons/pyramid/issues/503

Hva er nytt i versjon 1.3 Beta 2:

• Metoden pyramid.request.Request.partial_application_url er ikke lenger i API-docs. Det var ment å være en privat metoden; sin publisering i dokumentasjonen som en API metoden var en feil, og det har blitt omdøpt til noe privat.
• Når en statisk visning ble registrert ved hjelp av en absolutt filsystem banen på Windows, gjorde request.static_url funksjonen ikke arbeide for å generere nettadresser til sine ressurser. Symptom: & quot; No statisk URL definisjon matchende c:. Foobarbaz & quot;
• Gjør alle tester passere på Windows XP.
• Bug i ACL autentisering sjekke på Python 3: tillatelser og principals_allowed_by_permission metode for pyramid.authorization.ACLAuthenticationPolicy kan returnere en upassende Sanne verdi når en tillatelse på en ACL var en streng snarere enn en sekvens, og da bare hvis ACL tillatelse string var en delstreng av tillatelse verdi sendes til funksjonen.
• Denne feilen effekter ingen Pyramid distribusjon i henhold Python 2; det er en bug som bare finnes i distribusjoner som kjører på Python 3. Det har eksistert siden Pyramid 1.3a1.
• Denne feilen var på grunn av tilstedeværelsen av en __iter__ attributt på strenger i henhold Python 3 som ikke er tilstede i henhold strenger i Python 2.

Hva er nytt i versjon 1.3 Beta 1:

• feilrettinger:
• pyramid.config.Configurator.with_package fungerte ikke hvis Configurator var en gammel stil pyramid.configuration.Configurator eksempel.
• Pyramid autorisasjonsregler ikke dukket opp i introspector.
• Deprecations:
• Alle referanser til tmpl_context forespørsel variabel ble fjernet fra docs. Sin eksistens i Pyramid er forvirrende for folk som aldri ble Kjegler brukere. Det ble lagt til som en porting bekvemmelighet for Kjegler brukere i Pyramid 1.0, men det har aldri fanget på fordi Pyramid rende systemet er mye annerledes enn Kjegler "var, og alternative måter eksisterer for å gjøre det den er designet for å tilby i Kjegler. Den vil fortsette å eksistere & quot; alltid & quot; men det vil ikke bli anbefalt eller nevnt i docs.

Krav :

• Python