pyramid

pyramida je rychlý, malý, dole na zemi, open source framework pro vývoj Python web & nbsp;. To je v reálném světě vývoj a nasazení více zábavy, více předvídatelné, a produktivnější webových aplikací.
pyramida je projekt stožáry, a je základem nejnovější webových frameworků produkované pylony komunitou.
pyramida byl dříve znám jako repoze.bfg.
Podpora a dokumentace
Podívejte se na webové stránky Pylons projektu pro zobrazení dokumentace, hlášení chyb, a získat podporu.
License
pyramida je nabízen pod BSD odvozené Repoze Public License

Co je nového v této verzi:.

• mako_templating: přidáno defenzivní Řešení pro non-importability z mako v důsledku těžební markupsafe vhození Python 3.2 podporu. Mako šablon bude nadále pracovat v kombinaci MarkupSafe 0,17 a Python 3.2 (i když kombinace MarkupSafe 0.17 a Python 3.3 nebo jakékoli podporované verze Python 2 bude fungovat OK).
• Make pyramid.config.assets.PackageOverrides námitky provést API pro __loader__ objekty uvedené v PEP 302. proxy na __loader__ stanovené dovozcem, pokud je přítomen; jinak, vyvolává NotImplementedError. Tím Pyramid statický pohled přepíše správně fungovat v Pythonu 3.3 (dříve, že ne). Viz https://github.com/Pylons/pyramid/pull/1015 pro více informací.

Co je nového ve verzi 1.4:

• Fix funkční testy v tutoriálu ZODB

Co je nového ve verzi 1.4 Beta 3:

• vydání Packaging jen žádné změny kódu. 1.4b2 byl brownbag propuštění kvůli chybějící adresáře v tarballu.

Co je nového ve verzi 1.3.4:

• Při pyramid.debug_routematch zapnutí a traverze predikát byl použit v každé trati router by vyvolat výjimku při pokusu o tisk informace o trase ladění. Tato chyba existuje již od roku 1.3a1.
• Pokud byl traverz predikát používá v každé trati proutes a pviews konzole skripty by vyvolat výjimku při pokusu o tisk informace o trase ladění. Tato chyba existuje již od roku 1.3a1.
• portovat bug fix od mistra: - V Mako Šablony vyhledávání, zkontrolujte, zda absolutní URI (pomocí Mako adresáře) při míchání se dědictví s specifikace aktiv. https://github.com/Pylons/pyramid/issues/662
• Při registraci více pohledů s přijímám přísudku v aplikaci Pyramid runing v Pythonu 3, možná jste obdrželi TypeError: unorderable typy: function () & lt; Funkce () výjimka.
• portovat od mistra: HTTP hlavičky Accept nebyli normalizovány příčinou potenciálně konfliktní zobrazení registrací zůstat bez povšimnutí. Dva pohledy, které se liší pouze v případě ("text / html" vs. "text / html"), nyní bude zvyšovat chybu. https://github.com/Pylons/pyramid/pull/620

Co je nového ve verzi 1.4 Alpha 1:

• Opravy chyb:
• předávání portu od 1,3 větve: Když byl nakonfigurován žádná politika autentizace, volání pyramid.security.effective_principals by se bezpodmínečně vrátit prázdný seznam. To bylo nesprávné, že by měl mít bezpodmínečně vráceny [Všichni], a teď dělá.
• Explicit url expedici regexes mohou nyní obsahovat dvojtečky. https://github.com/Pylons/pyramid/issues/629
• na alespoň jednom 64-bitovém systému Ubuntu pod Python 3.2, pomocí view_config dekoratér způsobil RuntimeError: slovník změnil velikost během iterace výjimky. Je již nemá. Viz https://github.com/Pylons/pyramid/issues/635 pro více informací.
• V Mako Šablony vyhledávání, zkontrolujte, zda URI je již nastavena a přivést ji zpět do spec majetku. Obvykle se vyskytuje s zděděnými šablony nebo zahrnuty komponenty. https://github.com/Pylons/pyramid/issues/606 https://github.com/Pylons/pyramid/issues/607
• V Mako Šablony vyhledávání, zkontrolujte, zda absolutní URI (pomocí Mako adresáře) při míchání do dědictví se specifikací aktiv. https://github.com/Pylons/pyramid/issues/662
• HTTP hlavičky Accept nebyli normalizovány příčinou potenciálně konfliktní zobrazení registrací zůstat bez povšimnutí. Dva pohledy, které se liší pouze v případě ("text / html" vs. "text / html"), nyní bude zvyšovat chybu. https://github.com/Pylons/pyramid/pull/620
• Forward-Port od 1.3 větve: při registraci více pohledů se přijímají predikát v aplikaci Pyramid podnožka pod Pythonu 3, možná jste obdrželi TypeError: unorderable typy: function () & lt; Funkce () výjimka.
• Vlastnosti:
• Configurator.add_directive nyní přijímá libovolný callables jako partials a předmětů prováděcích __call__ které nemáte __name__ a __doc__ atributy. Viz https://github.com/Pylons/pyramid/issues/621 a https://github.com/Pylons/pyramid/pull/647.
• na zakázku zobrazení třetích stran, trasy, a účastnické predikáty mohou být nyní přidán k použití pohledu autorů přes pyramid.config.Configurator.add_view_predicate, pyramid.config.Configurator.add_route_predicate a pyramid.config.Configurator.add_subscriber_predicate. Tak například, dělá toto:
• config.add_view_predicate ("abc", my.package.ABCPredicate)
• by mohly umožnit autor pohled to udělat v aplikaci, která nakonfigurované, že predikát:
• view_config (abc = 1)
• Podobné vlastnosti existují pro add_route a add_subscriber. Viz & quot; přidání třetí strany Pohled, cestu, nebo účastník predikátu & quot; v kapitole háčky pro více informací.
• Uvědomte si, že změny na podporu výše uvedené funkce znamená, že nyní jen akce registrována stejného & quot; pořádek & quot; může být v rozporu s jedním jiný. To bylo případ, že akce zapsané v různých řádů by potenciálně v rozporu, ale pokud vím, nikdy nic závisí na toto chování (to bylo trochu hloupé).
• Vlastní objekty mohou být snadno JSON-serializable v pyramidě o definování metody __json__ na třídu objektu. Tato metoda by měla vracet hodnoty nativně serializovatelné by json.dumps (jako ints, seznamy, slovníky, řetězce, a tak dále).
• JSON renderer nyní umožňuje definování vlastní typ adaptérů převést neznámé objekty JSON serializations.
• Od tohoto vydání, REQUEST_METHOD predikát, pokud se použije, bude rovněž znamenat, že HEAD je naznačeno při použití GET. Například pomocíview_config (REQUEST_METHOD = "GET"), je ekvivalentní použitíview_config (REQUEST_METHOD = ("GET", "vedoucí")). Použitíview_config (REQUEST_METHOD = ("GET", "POST"), je ekvivalentní použitíview_config (REQUEST_METHOD = ("GET", "vedoucí", "POST"). Je to proto, že HEAD je varianta dostat, že vynechává tělo, a WebOb má zvláštní podporu vrátit prázdné tělo, když se používá HEAD.
• config.add_request_method byl přijat na podporu požadavku o prodloužení předměty s libovolnými callables. Tato metoda rozšiřuje na předchozí config.set_request_property o podpůrné metody, stejně jako vlastnosti. Tato metoda nyní způsobuje méně kód musí být prováděny na žádost doby výstavby, než config.set_request_property ve verzi 1.3.
• Nepřidávejte? na adresy URL vytvořené request.resource_url, pokud je argument dotaz je k dispozici, ale prázdná.
• Nepřidávejte? na adresy URL vytvořené request.route_url pokud _query argument k dispozici, ale prázdná.
• statický pohled stroje se zvyšuje (spíše než přiznání) HTTPNotFound a HTTPMovedPermanently výjimek, takže tyto mohou být zachyceny pohledu NOTFOUND (a jiné názory výjimkou).
• Mako Vykreslování nyní podporuje jméno def v spec aktiv. Je-li přítomen ve spec aktiv název def, systém vykreslení šablony DEF v šabloně a vrátí výsledek. Spec Příkladem aktivum je balíček: cesta / k / šablony # defname.mako. To bude vykreslení def názvem defname uvnitř template.mako šablony namísto vykreslování celého šablonu. Starý způsob vracení n-tice ve tvaru ("defname", {}) z pohledu je podporován z důvodu zpětné kompatibility,
• Chameleon ZPT Vykreslování nyní přijímá název makra v spec aktiv. Když je ve spec aktiv název makra, bude systém vykreslení makro uveden jako definovat, makro a vrátí výsledek namísto vykreslování celého šablonu. Spec Příklad aktivum: Balík: cesta / k / šablony # macroname.pt. Takto bude možné makro definované jako jménomakra v template.pt šablony namísto celého templae.
• Pokud je neshoda predikát výjimka (vidět, když není pohled na utkání na danou žádost kvůli predikáty nefunguje), výjimka nyní obsahuje textový popis predikátu, který se neshoduje.
• metoda směrnice add_permission byl přidán do konfigurátoru. Tato směrnice registruje volně stojící oprávnění introspekce do introspekci systému pyramidy. Rámce postavené na vrcholu pyramidy tak mohou využít oprávnění introspekce data kategorii vytvořit úplný seznam oprávnění podporovaných běžícím systému. Předtím, než byla přidána tato metoda, povolení bylo již registrováno v této kategorii introspekce jako vedlejší efekt jejich názvů v add_view hovoru, tato metoda pouze umožňuje zařídit povolení k uvedení do oprávněními introspekce kategorii, aniž by ji pojmenoval spolu s spojený pohled. Zde je příklad použití add_permission:
• config = Configurator ()
• config.add_permission ("view")
• UnencryptedCookieSessionFactoryConfig nyní přijímá signed_serialize a signed_deserialize háčky, které mohou být použity pro ovlivnit, jak jsou zasedání seřadil (ve výchozím nastavení je to provedeno s HMAC + okurka).
• pyramid.testing.DummyRequest nyní podporuje metody dodané třídy pyramid.util.InstancePropertyMixin, jako set_property.
• vlastnosti vyžádání a metody přidané přes config.set_request_property nebo config.add_request_method jsou nyní k dispozici k doplnění.
• vlastnosti vyžádání a metody přidané přes config.set_request_property nebo config.add_request_method jsou nyní k dispozici ve požadavek objekt vrátil z pyramid.paster.bootstrap.
• request.context žádosti na životní prostředí během bootstrap je nyní kořenový objekt, pokud kontext není již nastaven na předpokladu vyžádání.
• pyramid.decorator.reify funkce je nyní API, a přidá se k dokumentaci API.
• přidáno kontextové správce pyramid.testing.testConfig, který může být použit pro generování konfigurátor v testu, např s testing.testConfig (...):.
• Uživatelé nyní mohou vyvolat subrequest zevnitř pohledu kódu pomocí nové request.invoke_subrequest API.
• Deprecations:
• pyramid.config.Configurator.set_request_property byla dokumentace, nepoužívá. Metoda je stále použitelný, ale více featureful pyramid.config.Configurator.add_request_method by měly být použity na jeho místě (to má všechny se stejnými schopnostmi, ale také rozšířit požadavek objekt s metodami).
• minulá Inkompatibility:
• Pyramid router již dodává hodnoty bfg.routes.route nebo bfg.routes.matchdict na žádost jeho WSGI prostředí slovníku. Tyto hodnoty byly docs-zastaralé v repoze.bfg 1.0 (efektivně sedmi menšími verzemi před). Pokud váš kód závisí na těchto hodnotách, použijte request.matched_route a request.matchdict místo.
• Je to již není možné předat životního slovník přímo pyramid.traversal.ResourceTreeTraverser .__ call__ (aka ModelGraphTraverser .__ call__). Místo toho je nutné předat požadavek objekt. Předávání prostředí namísto žádosti vyvolalo varování odmítání od pyramidy 1.1.
• Pyramid nebude správně fungovat, pokud budete používat webob.request.LegacyRequest jako žádost továrny. Instance LegacyRequest třídy mají request.path_info, který vrátí řetězec. Tato verze Pyramid předpokládá, že request.path_info bude bezpodmínečně být Unicode.
• byly odstraněny Funkce z pyramid.chameleon_zpt a pyramid.chameleon_text jménem get_renderer, get_template, render_template a render_template_to_response. Ty vydaly odmítání varování při dovozu od Pyramid 1.0. Použít pyramid.renderers.get_renderer (), pyramid.renderers.get_renderer (). (), Provádění pyramid.renderers.render () nebo pyramid.renderers.render_to_response respektive místo těchto funkcí.
• pyramid.configuration modul byl odstraněn. To bylo zastaralé, protože pyramida 1,0 a vytiskli odmítání varování jeho užívání. Místo toho použijte pyramid.config.
• pyramid.paster.PyramidTemplate API byl odstraněn. To bylo zastaralé, protože pyramidy 1.1 a vydal varování při dovozu. Pokud váš kód závisí na tom, upravte kód importovat pyramid.scaffolds.PyramidTemplate místo.
• pyramid.settings.get_settings () API byl odstraněn. Bylo tisku varování odmítání od roku pyramida 1.0. Pokud váš kód závisí na tomto API, použijte pyramid.threadlocal.get_current_registry (). Nastavení namísto nebo pomocí atributu nastavení registru k dispozici od požadavku (request.registry.settings).
• Tato rozhraní API z pyramid.testing modulu byly odstraněny. Byly tisku varování odmítání od pyramidy 1,0:
• registerDummySecurityPolicy, použijte pyramid.config.Configurator.testing_securitypolicy místo.
• registerResources (aka registerModels, použijte pyramid.config.Configurator.testing_resources místo.
• registerEventListener, použijte pyramid.config.Configurator.testing_add_subscriber místo.
• registerTemplateRenderer (aka registerDummyRenderer`), použijte pyramid.config.Configurator.testing_add_template místo.
• registerView, použijte pyramid.config.Configurator.add_view místo.
• registerUtility, použijte pyramid.config.Configurator.registry.registerUtility místo.
• registerAdapter, použijte pyramid.config.Configurator.registry.registerAdapter místo.
• registerSubscriber, použijte pyramid.config.Configurator.add_subscriber místo.
• registerRoute, použijte pyramid.config.Configurator.add_route místo.
• registerSettings, použijte pyramid.config.Configurator.add_settings místo.
• V pyramidě 1.3 a předchozí, byla vyvolána metoda __call__ objektu Response předtím, než byly provedeny nějaké hotové zpětná volání. Od této verze, je vyvolána metoda __call__ objektu Response po hotové zpětná volání jsou provedeny. To je na podporu request.invoke_subrequest funkce.
• Documentation:
• Added & quot; Aktualizace pyramida & quot; kapitola v dokumentaci k vyprávění. Popisuje, jak se vypořádat s deprecations a zrušení Pyramid API a jak ukázat Pyramid generované varování odmítání při běhu testy a při spuštění serveru.
• Přidáno & quot; Vyvolání Subrequest & quot; kapitola dokumentace. Popisuje, jak používat nové request.invoke_subrequest API.
• Závislosti:
• Pyramid nyní vyžaduje WebOb 1.2b3 + (před Pyramid vydání spoléhal jen na 1.2dev +). To má zajistit, že získáme verzi WebOb, který vrací request.path_info jako text.

Co je nového ve verzi 1.3.2:

• Version 1.3.1 byl brownbag vydání, na Přinejmenším na systému Windows a případně na jiných operačních systémech, v důsledku existence zatoulané & quot; adresáře balíčku (citát v ceně) v kořenovém adresáři 1.3.1 archivu. Tento adresář a jeho obsah byl přítomen, protože archiv byl vytvořen pomocí prodejní verzi setuptools-git spíše než setuptools-Git nainstalován z pokladny. Jediná změna v této verzi je opravit chybu obalů v bodu 1.3.1.

Co je nového ve verzi 1.3:

• Při pyramid.wsgi.wsgiapp2 volá po proudu WSGI aplikace, APP se obklopit nebude mít (zastaralé a potenciálně zavádějící) bfg.routes.matchdict nebo bfg.routes.route klíče v něm. Příznakem této chyby by wsgiapp2 zabalené Pyramid app najít nesprávný názor, protože se mylně zjistí, že cesta byla vyrovnaná, když ve skutečnosti to nebylo.
• Oprava problému https://github.com/Pylons/pyramid/issues/461 (který dělal to možné metody instance mají být použity jako zobrazení callables) zavedla zpět, neslučitelnost, když prohlásil, že metody, pouze žádost argumentem bylo použity. Viz https://github.com/Pylons/pyramid/issues/503

Co je nového ve verzi 1.3 Beta 2:

• metoda pyramid.request.Request.partial_application_url je již v docs API. To měl být soukromý metoda; jeho zveřejnění v dokumentaci jako metodu API byla chyba, a to byl přejmenován na něco soukromého.
• Když byl statický pohled registrována absolutní souborového systému cestu na Windows, funkce request.static_url nefungoval generovat URL do svých zdrojů. Příznak: & quot; No statický odpovídající definice URL c:. Foobarbaz & quot;
• Make všechny testy projít v systému Windows XP.
• Chyba v ověření ACL kontrole na Pythonu 3: povolení a principals_allowed_by_permission způsob pyramid.authorization.ACLAuthenticationPolicy by se mohl vrátit nevhodný skutečnou hodnotu, pokud oprávnění na ACL byl řetězec spíše než sekvence, a to pouze v případě, že oprávnění ACL string byl podřetězec hodnoty oprávnění předaný funkci.
• Tato chyba účinky žádný nasazení Pyramid v Pythonu 2; to je chyba, která existuje pouze v nasazení běží na Python 3. Je existuje již od Pyramid 1.3a1.
• Tato chyba byla způsobena přítomností atributu __iter__ na řetězce pod Pythonu 3, který je obsažen v řetězce v Pythonu 2.

Co je nového ve verzi 1.3 Beta 1:

• Opravy chyb:
• pyramid.config.Configurator.with_package nefungovalo, pokud Configurator byl ve starém stylu pyramid.configuration.Configurator instance.
• politiky povolování Pyramid neukázal v Introspector.
• Deprecations:
• Všechny odkazy na proměnné požadavku tmpl_context byly odstraněny z Docs. Její existence v pyramidě je matoucí pro lidi, kteří byli nikdy pylony uživatele. To byl přidán jako přenesení pohodlí pro uživatele sloupy v pyramidě 1,0, ale to nikdy pochopilo, protože vykreslování systém pyramida je hodně jiný, než závěsníků "byl, a alternativní způsoby, jak existují proto, aby to, co to bylo navrhnuto, aby nabídnout Pylons. To bude i nadále existovat & quot; navždy & quot; ale to se nedoporučuje ani uvedeny v docs.

Požadavky na :

• Python