pyramid

piramis egy gyors, kicsi, down-to-earth, nyílt forráskódú Python web keretrendszer. & Nbsp; Lehetővé teszi a valós webes alkalmazások fejlesztése és telepítése több móka, kiszámíthatóbb, és termelékenyebb.
piramis a pilonok projekt, és megalapozza a legújabb webes keretrendszerek által termelt Pylons közösség.
piramis korábban ismert volt, mint repoze.bfg.
Támogatás és dokumentáció
Lásd a pilonok Project honlapján, hogy a dokumentációt, hibabejelentés, és támogatást szerezni.
License
piramis mellett kerül sor a BSD-alapú Repoze Public License.

Mi az új ebben a kiadásban:

• mako_templating: hozzáadott védekező Kerülő megoldás nem importability Makó miatt upstream markupsafe csökken Python 3.2 támogatás. Mako sablonozó már nem működik, azzal a kombinációs MarkupSafe 0,17 és Python 3.2 (bár a kombinációs MarkupSafe 0,17 és Python 3.3 vagy bármely támogatott Python 2 verzió fog működni OK).
• A pyramid.config.assets.PackageOverrides objektum végrehajtja a API for __loader__ objektumok meghatározott PEP 302. A proxy a __loader__ be az importőr, ha van; Ellenkező esetben felveti NotImplementedError. Ez teszi Pyramid statikus képet felülbírálások megfelelően működni Python 3.3 (korábban ők nem). Lásd https://github.com/Pylons/pyramid/pull/1015 talál.

Mi az új 1.4-es:

• Fix funkcionális teszteket a ZODB bemutató

Mi az új 1.4-es Beta 3:

• Packaging kiadás, csak nem a kód megváltoztatása. 1.4b2 volt brownbag kiadás miatt hiányzik könyvtárak a csomag.

Mi az új verzióban 1.3.4:

• Ha pyramid.debug_routematch be volt kapcsolva, és az oldalirányú állítmány használták bármilyen úton, a router lenne arra, hogy kivételt, amikor megpróbálja kinyomtatni az útvonal hibakeresési információkat. Ez a bug óta létezik 1.3a1.
• Amikor az oldalirányú állítmány használták bármilyen úton, proutes és pviews konzol szkriptek lenne arra, hogy kivételt, amikor megpróbálja kinyomtatni az útvonal hibakeresési információkat. Ez a bug óta létezik 1.3a1.
• backport bug fix a mester: - Makón sablonok keresést, ellenőrizze az abszolút URI (a Mako könyvtárak), amikor összekeveri öröksége eszköz a szemüveg. https://github.com/Pylons/pyramid/issues/662
• A regisztráció során több nézetben egy fogadni az állítmány egy piramis alkalmazás fellépő mellett Python 3, akkor kaphatott a Típushiba: unorderable típusok: function () & lt; function () kivételével.
• backport a mester: HTTP Accept fejlécek nem normalizálódott ami esetlegesen ellentétes nézetet regisztrációk, hogy nem veszik észre. Két nézet, hogy csak abban különbözik a helyzet ("text / html" vs. "text / HTML) most fel hiba. https://github.com/Pylons/pyramid/pull/620

Mi az új 1.4-es Alpha 1:

• hibajavítások:
• Előre port 1,3 ág: Ha nincs hitelesítés politika volt konfigurálva, egy hívás, hogy pyramid.security.effective_principals lenne feltétel nélkül vissza az üres lista. Ez helytelen volt, meg kellett volna feltétel nélkül vissza [Mindenki], és most nem.
• Explicit url feladó regexes most tartalmazhatnak kettőspontot. https://github.com/Pylons/pyramid/issues/629
• Legalább egy 64-bites Ubuntu rendszer alatt Python 3.2 segítségével a view_config dekoratőr okozott RuntimeError: szótárban megváltozott méretű során iteráció kivétel. Ez már nem végez. Lásd https://github.com/Pylons/pyramid/issues/635 talál.
• Makón sablonok keresést, ellenőrizze, hogy az uri már beállította és hozd vissza az eszköz spec. Általában akkor fordul elő, akiknek öröklött sablonok, vagy alkotóelemeit. https://github.com/Pylons/pyramid/issues/606 https://github.com/Pylons/pyramid/issues/607
• Makón sablonok keresést, ellenőrizze az abszolút URI (a Mako könyvtárak), amikor összekeveri öröksége eszköz a szemüveg. https://github.com/Pylons/pyramid/issues/662
• HTTP Accept fejlécek nem normalizálódott ami esetlegesen ellentétes nézetet regisztrációk, hogy nem veszik észre. Két nézet, hogy csak abban különbözik a helyzet ("text / html" vs. "text / HTML) most fel hiba. https://github.com/Pylons/pyramid/pull/620
• Forward-port 1,3 ág: a regisztráció során több nézetben egy fogadni az állítmány egy piramis alkalmazás fellépő mellett Python 3, akkor kaphatott a Típushiba: unorderable típusok: function () & lt; function () kivételével.
• Tulajdonságok:
• Configurator.add_directive most elfogadja tetszőleges callables, mint partials vagy tárgyak végrehajtási __call__ amely dont __name__ és __doc__ tulajdonítja. Lásd https://github.com/Pylons/pyramid/issues/621 és https://github.com/Pylons/pyramid/pull/647.
• Harmadik fél egyéni nézet, útvonal, és az előfizetői predikátumok most hozzá használatára néző szerzők keresztül pyramid.config.Configurator.add_view_predicate, pyramid.config.Configurator.add_route_predicate és pyramid.config.Configurator.add_subscriber_predicate. Így például, ezt:
• config.add_view_predicate ('abc', my.package.ABCPredicate)
• Lehet, hogy a néző szerző, hogy ezt egy olyan alkalmazást, konfigurálható, hogy az állítmány:
• view_config (abc = 1)
• Hasonló funkciókat létezik add_route, és add_subscriber. & Quot; Harmadik fél bevonása View, Route, vagy Előfizető Predicate & quot; A Horog fejezetben talál.
• Ne feledje, hogy változtatásokat, hogy támogassa a fenti funkció már azt jelenti, hogy kizárólag a regisztrált ugyanazt a & quot; érdekében & quot; összeütközésbe kerülhet egymással. Régen a helyzet, hogy a fellépések regisztrált különböző megrendelések potenciálisan konfliktust, de tudomásom szerint soha semmi nem függött ezt a viselkedést (ez egy kicsit buta).
• Egyéni objektumok könnyen megoldható JSON-serializable a Piramis meghatározásával __json__ módszer az objektum osztály. Ez a módszer visszatérési értékek natívan serializable által json.dumps (mint például ints, listák, szótárak, vonósok, és így tovább).
• A JSON renderelő már lehetővé teszi, hogy meghatározzák az egyéni típusú adapterek átalakítani ismeretlen tárgyak JSON serializations.
• Mivel ez a kiadás, a REQUEST_METHOD állítmány, ha használják, azt is jelenti, hogy fej hallgatólagos használata esetén GET. Például, ha aview_config (REQUEST_METHOD = "GET") egyenértékű aview_config (REQUEST_METHOD = ("GET", "HEAD")). Segítségévelview_config (REQUEST_METHOD = ("GET", "POST") egyenértékű aview_config (REQUEST_METHOD = ("GET", "HEAD", "POST"). Ez azért van, mert HEAD egy változata kap, hogy kihagyja a test, és WebOb különleges támogatást vissza egy üres testet, amikor a fej arra.
• config.add_request_method lett bevezetve, hogy kiterjeszti kérésére objektumot tetszőleges callables. Ez a módszer megnöveli az előző config.set_request_property támogatásával módszerek, valamint tulajdonságai. Ez a módszer már kevésbé okoz kódot kell végrehajtani a kérést a kivitelezési idő, mint config.set_request_property a 1.3-as verzió.
• Ne adjon? Az URL által generált request.resource_url ha a lekérdezés érv áll rendelkezésre, de üres.
• Ne adjon? Az URL által generált request.route_url ha a _query érv áll rendelkezésre, de üres.
• A statikus képet gépek most fel (nem pedig visszatér) HTTPNotFound és HTTPMovedPermanently kivételek, így ezek is fogott a NotFound nézet (és más kivétel megtekintés).
• A Mako renderelő most már támogatja a def név közé eszköz spec. Amikor a def név jelen van az eszköz spec, a rendszer lehetővé teszi majd a sablon def belül a sablont, és visszaadja az eredményt. Egy példa eszköz spec csomag: path / to / template # defname.mako. Ez lehetővé teszi majd a def nevű defname belül template.mako sablon helyett teszi az egész sablont. A régi módon a visszatérő egy tuple formájában ("defname", {}) a nézetet támasztja a visszamenőleges kompatibilitás,
• A Chameleon ZPT renderelő most elfogadja a makró nevét egy eszköz spec. Amikor a makró nevét jelen van az eszköz spec, a rendszer lehetővé teszi majd a makró szerepel az határozza meg, makro- és visszatér az eredmény helyett teszi az egész sablont. Egy példa eszköz spec: a csomag: path / to / template # macroname.pt. Ez lehetővé teszi majd a makró definíció szerint macroname belül template.pt sablon helyett a teljes templae.
• Ha van egy állítmány mismatch kivételével (látható, ha nincs kilátás illeszkedik az adott kérelem miatt predikátumok nem működik), kivéve most már tartalmaz egy szöveges leírást az állítmány, amely nem egyezik.
• Egy add_permission irányelv módszert adtunk a konfigurátor. Ez az irányelv rögzít egy szabadon álló engedélye introspectable a Piramis önvizsgálat rendszer. Keretek beépített tetején Piramis így használja a jogosultságokat introspectable kategóriában adatok építeni egy átfogó engedélyek listáját támogatja a futó rendszer. Mielőtt ezt a módszert adtunk, engedélyek már regisztrált ebben a kategóriában introspectable mellékhatásaként a megnevezve azokat az add_view hívást, ez a módszer csak lehetővé teszi, hogy gondoskodjon engedélyt kell helyezni a jogosultságokat introspectable kategóriában megnevezése nélkül, hogy együtt társult kilátás. Íme egy példa az add_permission:
• config = Configurator ()
• config.add_permission ('view')
• A UnencryptedCookieSessionFactoryConfig most elfogadja signed_serialize és signed_deserialize horgok lehet használni, hogyan befolyásolja az ülésekről felsorakoztatásának (alapértelmezés szerint ez történik a HMAC + lé).
• pyramid.testing.DummyRequest már támogatja módszerek által szolgáltatott pyramid.util.InstancePropertyMixin osztály, mint set_property.
• Request tulajdonságok és módszerek segítségével hozzáadjuk config.set_request_property vagy config.add_request_method már elérhető a kiskamaszok.
• Request tulajdonságok és módszerek segítségével hozzáadjuk config.set_request_property vagy config.add_request_method már elérhető a kérés objektum visszatért pyramid.paster.bootstrap.
• request.context a környezet kérelmeket a bootstrap most a gyökér objektumot, ha a kontextusban még nem állította be a biztosított kérésére.
• A pyramid.decorator.reify funkció most egy API, és hozzáadjuk az API dokumentációt.
• Hozzáadás a pyramid.testing.testConfig összefüggésben manager, amelyeket fel lehet használni, hogy létrehoz egy konfigurátor egy tesztet, pl A testing.testConfig (...):.
• A felhasználók most hivatkozhat a subrequest belül néző kód segítségével új request.invoke_subrequest API.
• Deprecations:
• A pyramid.config.Configurator.set_request_property már dokumentáció-elavult. A módszer marad használható, de annál szolgáltatást nyújtja pyramid.config.Configurator.add_request_method kell használni a helyére (ez az összes azonos képességekkel, de is kiterjeszti a kérés objektum módszerekkel).
• visszafelé Összeférhetetlenség:
• A piramis router már nem teszi hozzá az értékeket bfg.routes.route vagy bfg.routes.matchdict a kérést a WSGI környezetben szótárban. Ezek az értékek docs-elavultnak repoze.bfg 1.0 (gyakorlatilag a hét kisebb kiadások ezelőtt). Ha a kód függött ezeket az értékeket, használja request.matched_route és request.matchdict helyett.
• Ez már nem adhatók át a környezet szótárban közvetlenül pyramid.traversal.ResourceTreeTraverser .__ call__ (aka ModelGraphTraverser .__ call__). Ehelyett meg kell felelnie egy kérés objektum. Ha csak egy környezetben, hanem a kérést generált rosszallás figyelmeztető óta Pyramid 1.1.
• Piramis már nem működik megfelelően, ha használja a webob.request.LegacyRequest a kérést gyárban. Példányainak LegacyRequest osztály van request.path_info, amely visszatér a húr. Ez a piramis kiadás feltételezi, hogy request.path_info feltétel nélkül lehet Unicode.
• A funkciók pyramid.chameleon_zpt és pyramid.chameleon_text elemzi get_renderer, get_template, render_template, és render_template_to_response eltávolították. Ezek kiadott egy rosszallás figyelmeztetésként import, mivel Pyramid 1.0. Használja pyramid.renderers.get_renderer (), pyramid.renderers.get_renderer (). Végrehajtásáról (), pyramid.renderers.render () vagy pyramid.renderers.render_to_response rendre helyett ezeket a funkciókat.
• A pyramid.configuration modul lett eltávolítva. Ez volt óta elavult Pyramid 1.0 és nyomtatott a rosszallás figyelmeztető miként használható. Használja pyramid.config helyett.
• A pyramid.paster.PyramidTemplate API eltávolították. Ez volt óta elavult Pyramid 1.1, és kiadott egy figyelmeztetést import. Ha a kódot ettől függött, állítsa be a kódot az import pyramid.scaffolds.PyramidTemplate helyett.
• A pyramid.settings.get_settings () API eltávolították. Már nyomtat rosszallás figyelmeztető óta Pyramid 1.0. Ha a kódot ettől függött API, használja pyramid.threadlocal.get_current_registry (). Beállítások helyett, vagy használja a beállítások attribútum a registry elérhető a kérelmet (request.registry.settings).
• Ezek az API-k az pyramid.testing modul eltávolították. Ők már nyomtat rosszallás figyelmeztetéseket, mivel Pyramid 1.0:
• registerDummySecurityPolicy, használja pyramid.config.Configurator.testing_securitypolicy helyett.
• registerResources (aka registerModels, használja pyramid.config.Configurator.testing_resources helyett.
• registerEventListener, használja pyramid.config.Configurator.testing_add_subscriber helyett.
• registerTemplateRenderer (aka registerDummyRenderer`), használja pyramid.config.Configurator.testing_add_template helyett.
• registerView, használja pyramid.config.Configurator.add_view helyett.
• registerUtility, használja pyramid.config.Configurator.registry.registerUtility helyett.
• registerAdapter, használja pyramid.config.Configurator.registry.registerAdapter helyett.
• registerSubscriber, használja pyramid.config.Configurator.add_subscriber helyett.
• registerRoute, használja pyramid.config.Configurator.add_route helyett.
• registerSettings, használata pyramid.config.Configurator.add_settings helyett.
• A piramis 1.3 és korábbi, a __call__ módszer a válasz objektum előtt hivatkozni semmilyen kész visszahívások kivégezték. Mivel ez a kiadás, a __call__ módszer a válasz objektum hivatkozni után kész visszahívások hajtják végre. Ez támogatására a request.invoke_subrequest funkciót.
• Dokumentáció:
• Bekerült egy & quot; Frissítés Pyramid & quot; fejezet a narratív dokumentációt. Leírja, hogy megbirkózzanak deprecations és eltávolításához Pyramid API-k és hogyan mutat Pyramid generált rosszallás figyelmeztetések futás közben tesztek és futás közben a szerveren.
• Hozzáadás a & quot; hívása egy Subrequest & quot; fejezetben a dokumentációt. Leírja, hogyan kell használni az új request.invoke_subrequest API.
• A függőségek:
• Pyramid most van szükség WebOb 1.2b3 + (előzetes Pyramid kiadás csak hivatkozni 1.2dev +). Ez biztosítja, hogy kapunk egy változata WebOb, hogy visszatér request.path_info szövegként.

Mi az új a 1.3.2 verzió:

• 1.3.1 verzió volt brownbag kiadás, a legalábbis a Windows és esetleg más operációs rendszeren, mivel létezik egy kóbor & quot; csomag könyvtárába (idézet szerepel) gyökér könyvtárába a 1.3.1 csomag. Ez a könyvtár és tartalma is jelen volt, mert a tar segítségével készítette egy verzióját setuptools-git helyett setuptools-git telepítésre egy pénztárnál. Az egyetlen változás ebben kibocsátás kijavítani a csomagoláson hibát 1.3.1.

Mi az új 1.3 verzió:

• Ha pyramid.wsgi.wsgiapp2 kéri a downstream WSGI app, Az alkalmazás környezet már nem lesz (elavult és félrevezető) bfg.routes.matchdict vagy bfg.routes.route kulcsokat is. A tünete ennek a bug lenne wsgiapp2 tekert Pyramid app megtalálni a hibás nézetet, mert tévesen azt észleli, hogy egy útvonal volt kiegyenlített, amikor valójában nem volt.
• A hiba javítása kérdés https://github.com/Pylons/pyramid/issues/461 (amely lehetővé tette, hogy például módszereket kell alkalmazni, mint néző callables) bevezette a visszafelé inkompatibilitás, amikor módszerek, hogy kijelentette, csak egy kérelmet érv használt. Lásd https://github.com/Pylons/pyramid/issues/503

Mi az új 1.3 verzió Beta 2:

• A módszer pyramid.request.Request.partial_application_url van már nem az API docs. Ez volt a célja, hogy a magán-módszer; kihirdetését dokumentáció, mint egy API módszerrel hiba volt, és ez lett nevezve, hogy valamit magán.
• Ha egy statikus képet jegyezték segítségével abszolút fájlrendszer elérési útját a Windows, a request.static_url funkció nem működik, hogy létrehoz URL-eket, hogy erőforrásait. Tünet: & quot; Nem statikus URL meghatározása megfelelő c: foobarbaz & quot;.
• Legyen minden teszt sikeres Windows XP.
• Bug ACL-hitelesítés ellenőrzése a Python 3: engedélyek és principals_allowed_by_permission módszer pyramid.authorization.ACLAuthenticationPolicy térhettek nem megfelelő True értéket, amikor Engedély ACL volt karakterlánc helyett a sorozatot, és csak akkor, ha az ACL engedélye karakterlánc volt alkarakterláncát engedélye érték függvénynek adjuk át.
• Ez a bug hatások nincs Pyramid telepítési alatt Python 2; ez egy hiba, ami létezik, csak a telepítések futó Python 3. óta létezik Pyramid 1.3a1.
• A hiba jelenléte miatt egy __iter__ attribútuma húrok alatt Python 3, amely nincs jelen alá húrok Python 2.

Mi az új 1.3 verzió Beta 1:

• hibajavítások:
• pyramid.config.Configurator.with_package nem működik, ha a konfigurátor egy régi stílusú pyramid.configuration.Configurator például.
• Pyramid engedély politika nem jelent meg a introspector.
• Deprecations:
• Minden utalásokat a tmpl_context kérésére változó eltávolították a docs. Létezését Pyramid zavaróan hat embert, akiket soha nem pilonok felhasználók. Ez volt hozzá, mint a számhordozás kényelem a pilonok felhasználók Pyramid 1,0, de soha nem fogott, mert a Piramis teszi rendszer egy csomó más, mint pilonok "volt, és alternatív módon léteznek csinálni, mi volt a célja, hogy az a pilonok. Ez továbbra is létezik & quot; örökre & quot; de nem fogják javasolni, vagy szerepel a docs.

követelmények :

• Python