pyramid

金字塔是一种快速，体积小，脚踏实地，扎扎实实，开源Python的web开发框架＆NBSP;它使现实世界的Web应用程序开发和部署更多的乐趣，更可预测和更富有成效。
金字塔是一个塔项目，underlies由塔社区产生的最新的Web框架。
金字塔以前被称为repoze.bfg。
支持和文档
看到主塔项目网站，查看文档，bug报告，并获得支持。
许可
金字塔是BSD衍生Repoze公共许可证下提供

什么在此版本中是新的：

• 在mako_templating：增加防御解决方法非可输入真子的由于上游markupsafe下探的Python 3.2的支持。 Mako的模板将不再受MarkupSafe 0.17和Python 3.2（虽然MarkupSafe 0.17和Python 3.3或任何支持的Python版本2的组合，将工作OK）相结合的工作。
• 请在pyramid.config.assets.PackageOverrides对象实施的PEP 302代理指定的__loader__由进口商设定__loader__对象的API，如果存在的话;否则，引发NotImplementedError。这使得金字塔静态视图覆盖下正确的Python 3.3（以前他们也不会）工作。见https://github.com/Pylons/pyramid/pull/1015了解更多信息。

什么在1.4版本的新：

• 在修复功能测试在ZODB教程

什么版本的新 1.4 Beta 3的：

• 在包装的释放而已，没有代码的变化。 1.4b2是一个brownbag释放因压缩包丢失的目录。

什么在1.3.4版本新：

• 在当pyramid.debug_routematch被打开和遍历谓语用在任何途径，试图打印路线调试信息时，路由器会引发异常。因为1.3a1此错误一直存在。
• 当遍历谓词在任何途径使用，proutes和pviews控制台脚本将要打印的路线调试信息时，抛出一个异常。因为1.3a1此错误一直存在。
• 从主反向移植bug修正： - 在Mako的模板查找，当继承混合了资产规范检查的绝对URI（使用灰鲭目录）。 https://github.com/Pylons/pyramid/issues/662
• 在注册时，在一个金字塔的应用程序的Python 3下乳宁在接受谓词多个视图，你可能会收到一个类型错误：unorderable类型：功能（）＆LT; （）的函数例外。
• 从主反向移植：HTTP接受头没有被归引起潜在冲突的观点注册被忽视。两种观点，只有在不同的情况下（“text / html的'与'文本/ HTML'）现在将引发一个错误。 https://github.com/Pylons/pyramid/pull/620

什么是版本1.4的Alpha 1的新：

• 在错误修正：

从1.3分支
• 在转发端口：当在没有配置认证策略，调用pyramid.security.effective_principals会无条件返回空列表。这是不正确的，它应该有无条件退换[所有人]，和现在一样。
• 在显式URL派遣正则表达式现在可以包含冒号。 https://github.com/Pylons/pyramid/issues/629
• 在至少一个64位的Ubuntu的Python 3.2系统下，使用view_config装饰造成抛出一个RuntimeError：字典中迭代的异常改变大小。它不再一样。见https://github.com/Pylons/pyramid/issues/635了解更多信息。
• 在真子模板查找，检查URI已经调整，并把它带回资产规范。通常发生在继承模板或包含的组件。 https://github.com/Pylons/pyramid/issues/606 https://github.com/Pylons/pyramid/issues/607
• 在真子模板查找，检查绝对URI（使用灰鲭目录），当混合了继承与资产规格。 https://github.com/Pylons/pyramid/issues/662
• 在HTTP Accept标头没有被归引起潜在冲突的观点注册被忽视。两种观点，只有在不同的情况下（“text / html的'与'文本/ HTML'）现在将引发一个错误。 https://github.com/Pylons/pyramid/pull/620
• 转发端口从1.3分支：注册多个视图时，与接受谓词在金字塔的Python应用程序下3乳宁，你可能会收到一个类型错误：unorderable类型：功能（）＆LT; （）的函数例外。
• 特点：
• 在Configurator.add_directive现在接受任意可调用就像它不具有__name__和__doc__属性谐音或实现__call__对象。见https://github.com/Pylons/pyramid/issues/621和https://github.com/Pylons/pyramid/pull/647。
• 在第三方的自定义视图，路径和用户谓词现在可以供通过pyramid.config.Configurator.add_view_predicate，pyramid.config.Configurator.add_route_predicate和pyramid.config.Configurator.add_subscriber_predicate观点的作者补充说。因此，举例来说，这样做的：
• 在config.add_view_predicate（“ABC”，my.package.ABCPredicate）
• 在可能允许笔者认为要做到这一点在配置的谓词的应用程序：
• 在@view_config（ABC = 1）
• 类似的功能add_route和add_subscriber存在。见＆QUOT;添加第三方查看，路线，或认购谓词＆QUOT;在钩一章以获取更多信息。
• 在注意变化作出支持上述功能现在意味着只有行动，使用相同的＆QUOT登记;以＆QUOT;可彼此冲突。它曾经是行动登记在不同的订单可能会发生冲突，但就我所知，从来都没有依赖这种行为（这是一个有点傻了）的情况。
• 在自定义对象可以通过定义的对象类__json__方法进行轻松JSON序列化的金字塔。此方法应返回值由json.dumps本身可序列化（如整数，列表，字典，字符串等）。
• 的JSON渲染器现在允许自定义类型的适配器的定义不明物体转换成JSON序列化。
• 在截至本新闻稿发布之时，REQUEST_METHOD谓语，使用时，也将意味着，当您使用GET的HEAD是隐含的。例如，使用@view_config（REQUEST_METHOD =“GET”）等同于使用@view_config（REQUEST_METHOD =（“GET”，“HEAD”））。使用@view_config（REQUEST_METHOD =（“GET”，“POST”）等同于使用@view_config（REQUEST_METHOD =（“GET”，“HEAD”，“POST”），这是因为HEAD是GET的一个变种，省略了身体，WebOb具有特殊支持，返回一个空的身体的时候，一个头被使用。
• 在config.add_request_method已经推出了支持任意可调用扩展的请求对象。该方法通过支持方法以及属性扩展了先前的config.set_request_property。这种方法现在会导致更少的代码在要求施工时间比config.set_request_property在1.3版中执行。
• 请不要加？由request.resource_url产生如果提供查询的说法，但空的URL。
• 请不要加？由request.route_url产生的，如果提供了_query说法，但空的URL。
• 在静态视图机器现在提升（而不是返回）HTTPNotFound和HTTPMovedPermanently例外，所以这些可以被捕获的NOTFOUND视图（和其他异常的看法）。
• 在尖吻鲭鲨渲染器现在支持在资产规范一个高清的名字。当DEF名存在于所述资产规范，系统会呈现在模板内模板DEF和将返回结果。一个例子资产规范是包：路径/要/模板＃defname.mako。这会使得template.mako模板，而不是渲染整个模板内DEF命名值defname。形式返回一个元组的老办法（'值defname'，{}）从视图支持向后兼容性，
• 在变色龙ZPT渲染器现在可以接受的资产规范宏名。当宏名称存在于资产规范，系统将呈现列为限定宏宏并返回呈现整个模板的结果代替。一个例子资产规格：包装：路径/要/模板＃macroname.pt。这会使定义为template.pt模板而不是整个templae内宏名宏。
• 当有一个不匹配谓词异常（当没有视图，由于不工作谓词相匹配的给定请求看到的），异常现在包含谓词其中没有匹配的文本描述。
• 在一个add_permission指令的方法添加到配置。该指令注册一个独立的许可introspectable进入金字塔的反思制度。因此之上构建金字塔框架可以使用权限introspectable类别数据建立了一个正在运行的系统支持权限的完整列表。之前加入这种方法，权限已经在这个introspectable类别作为命名他们的add_view调用的副作用注册，这种方法只能够安排一个允许投入权限introspectable类别没有随着它的命名相关联的图。这里是add_permission的使用的一个示例：
• 在配置=配置（）
• 在config.add_permission（'查看'）
• 在该UnencryptedCookieSessionFactoryConfig现在接受signed_serialize和signed_deserialize挂钩可以用来影响如何会话编组（默认情况下这是与HMAC +咸菜做的）。
• 在pyramid.testing.DummyRequest现在支持通过pyramid.util.InstancePropertyMixin类中提供的方法，如set_property。

通过config.set_request_property或config.add_request_method添加
• 在请求属性和方法现已充斥着。

可通过config.set_request_property或config.add_request_method添加
• 在请求的属性和方法，现已在请求对象从pyramid.paster.bootstrap返回。
• 在自举过程中环境的要求request.context现在是根对象，如果上下文尚未在提供的请求设置。
• 的pyramid.decorator.reify功能是现在的API，并加入到该API文档。
• 添加了pyramid.testing.testConfig上下文管理器，它可用于生成设备配置在一个测试中，如与testing.testConfig（...）：

从内部来看代码中使用新的API request.invoke_subrequest
• 在现在，用户可以调用子请求。
• 弃用：
• 在该pyramid.config.Configurator.set_request_property一直文档，不推荐使用。该方法仍然可用，但更多的其他功能pyramid.config.Configurator.add_request_method应在它的位置（它具有所有相同的功能，但也可以延长带有方法请求对象）可以使用。
• 在向下不兼容的问题：
• 在金字塔的路由器不再增加值bfg.routes.route或bfg.routes.matchdict请求的WSGI环境的字典。这些值是文档，不赞成在repoze.bfg 1.0（有效7次要版本前）。如果你的代码依赖于这些值，使用request.matched_route和request.matchdict代替。
• 在它不再是可以直接传递一个ENVIRON字典pyramid.traversal.ResourceTreeTraverser .__ call__（又名ModelGraphTraverser .__ call__）。相反，你必须通过请求对象。传递请求的环境，而不是因为金字塔1.1已经产生了弃用警告。
• 在金字塔将不再正常工作，如果你使用webob.request.LegacyRequest作为请求工厂。在LegacyRequest类的实例有一个request.path_info其返回一个字符串。这个金字塔的释放假定request.path_info将无条件是Unicode。
• 从pyramid.chameleon_zpt和pyramid.chameleon_text命名get_renderer，get_template，render_template和render_template_to_response的功能已被删除。因为金字塔1.0这些都在发出一个进口弃用警告。分别使用，而不是这些功能pyramid.renderers.get_renderer（），pyramid.renderers.get_renderer（）（）实现，pyramid.renderers.render（）或pyramid.renderers.render_to_response。
• 在该pyramid.configuration模块被移除。因为金字塔1.0，它已被弃用并打印在它的使用折旧警告。使用pyramid.config代替。
• 在该pyramid.paster.PyramidTemplate API被删除。因为金字塔1.1，它已被弃用，并发出进口警报。如果你的代码依赖于这个，调整你的代码导入pyramid.scaffolds.PyramidTemplate代替。
• 在该pyramid.settings.get_settings（）API被删除。它已被打印，因为金字塔1.0弃用警告。如果你的代码依赖于这个API，使用pyramid.threadlocal.get_current_registry（）设置，而不是或使用注册表中的可用设置属性的请求（request.registry.settings）。
• 从pyramid.testing模块这些API被拆除。他们已经打印废弃警告，因为金字塔1.0：
• 在registerDummySecurityPolicy，使用pyramid.config.Configurator.testing_securitypolicy代替。
• 在registerResources（又名registerModels，使用pyramid.config.Configurator.testing_resources代替。
• 在registerEventListener，使用pyramid.config.Configurator.testing_add_subscriber代替。
• 在registerTemplateRenderer（又名registerDummyRenderer`），使用pyramid.config.Configurator.testing_add_template代替。
• 在registerView，使用pyramid.config.Configurator.add_view代替。
• 在registerUtility，使用pyramid.config.Configurator.registry.registerUtility代替。
• 在registerAdapter，使用pyramid.config.Configurator.registry.registerAdapter代替。
• 在registerSubscriber，使用pyramid.config.Configurator.add_subscriber代替。
• 在registerRoute，使用pyramid.config.Configurator.add_route代替。
• 在registerSettings，使用pyramid.config.Configurator.add_settings代替。
• 在金字塔1.3及以前，一个Response对象的__call__方法，任何成品回调被处决之前调用。截至本次发行，成品回调执行后调用一个Response对象的__call__方法。这是支持request.invoke_subrequest功能。
• 文档：
• 在添加了一个＆QUOT;升级金字塔＆QUOT;章叙述文档。它描述了如何应对弃用和金字塔的API清除以及如何显示金字塔产生的废弃警告，同时运行测试，并在运行的服务器。
• 新增了＆QUOT;调用一个子请求＆QUOT;章文档。它描述了如何使用新的API request.invoke_subrequest。
• 相关性：
• 在金字塔现在要求WebOb 1.2b3 +（事先金字塔发布仅依靠1.2dev +）。这是为了确保我们得到一个版本WebOb那request.path_info返回为文本。

什么在1.3.2版本新：

• 在版本1.3.1是一个brownbag的释放，在最起码在Windows上，可能在其他操作系统上，由于杂散＆QUOT的存在;包目录（包括引号）在1.3.1压缩包的根目录下。该目录及其内容存在，因为压缩包使用的setuptools的-git的发行版，而不是从收银台安装了setuptools的-git的创建。本新闻稿中的唯一的变化是纠正1.3.1包装错误。

什么版本1.3是新的：

• 在当pyramid.wsgi.wsgiapp2调用下游WSGI应用程序，应用程序的ENVIRON将不再有（不推荐使用，并可能误导）在它bfg.routes.matchdict或bfg.routes.route键。这个错误的症状会是一个wsgiapp2包裹的金字塔应用程序找到了错误的观点，因为它错误地检测到路由相匹配的时候，其实，事实并非如此。
• 在签发https://github.com/Pylons/pyramid/issues/461（这使我们可以为实例方法用作视图可调用）的修复引入了向后不兼容时，该方法只声明的请求参数分别为使用。见https://github.com/Pylons/pyramid/issues/503

什么版本的新 1.3 Beta 2的：

• 在该方法pyramid.request.Request.partial_application_url是不再API文档。这本来是一个私有方法;它的文档作为API方法出版物是一个错误，它已更名为私人的东西。
• 当一个静态视图是使用Windows上的绝对文件系统路径注册的request.static_url功能没有工作产生的URL资源。症状：[否静态URL定义匹配C：foobarbaz＆QUOT;
• 请所有的测试都通过了在Windows XP。
• 在错误的ACL认证检查了Python 3：pyramid.authorization.ACLAuthenticationPolicy的许可证和principals_allowed_by_permission方法可以返回一个不恰当的真值时，在一个ACL权限是一个字符串，而不是一个序列，然后仅在ACL权限字符串是传递给函数允许值的字符串。
• 在此bug影响的Python 2下没有金字塔部署;这是只有在Python 3的运行，因为金字塔1.3a1它已经存在了存在于部署的错误。
• 在此错误是由于一个__iter__属性对Python的3​​串下存在哪些不存在下，在Python 2串。

什么版本的新 1.3 Beta 1的：

• 在错误修正：
• 在pyramid.config.Configurator.with_package没有工作，如果配置是一个旧式pyramid.configuration.Configurator实例。
• 在金字塔的授权政策并没有在内部检查中显示。
• 弃用：
• 来的tmpl_context请求变量的所有引用是从文档中删除。它的存在在金字塔是混乱的人谁从来没有挂架的用户。它增加了一个移植方便用户主塔在金字塔1.0，但它从来没有流行起来，因为金字塔的渲染系统是一个比很多不同的主塔“是，和其他方法存在做它的目的是要提供在塔。它将继续存在＆QUOT;永远＆QUOT;但它不会被推荐或提到的文档。

要求：

• 在Python中