术语表

ACE

访问控制条目 . 访问控制项是 ACL . 访问控制项是一个三元组,它描述了三件事:一个 行动 (其中之一) AllowDeny a) principal (描述用户或组的字符串),以及 permission . 例如ace, (Allow, 'bob', 'read') 是表示主体 bob 允许的权限 read 针对ACL附加到的资源。

ACL

访问控制列表 . ACL是 ACE 元组。ACL附加到资源实例。ACL的一个示例是 [ (Allow, 'bob', 'read'), (Deny, 'fred', 'write')] . 如果一个ACL连接到一个资源实例,并且该资源可以通过上下文资源进行查找,那么将参考任何活动的安全策略,以确定给定 authentication 请求中的信息。

Chameleon

chameleon 是一个属性语言模板编译器,它支持 ZPT 模板规范。这本书是由马耳他·博奇撰写和维护的。它有几个扩展,例如使用括号的能力(mako风格) ${{name}} 语法。它也比zpt的引用实现快得多。 Pyramid 提供变色龙模板的开箱即用的zpt和文本风格。

CPython

Python语言的C实现。这是大多数人称之为“python”的引用实现; Jython ,谷歌的应用引擎,以及 PyPy 是非基于C的Python实现的示例。

CSRF存储策略

一种实现 pyramid.interfaces.ICSRFStoragePolicy 负责将CSRF令牌分配给用户,并验证提供的令牌是否可接受。

dotted Python name

使用字符串按名称引用python对象,格式为 path.to.modulename:attributename . 通常用于Pyramid和设置工具配置。变量用在配置器方法参数中的点状名称中,该参数用于命名对象(例如“添加视图”方法的“视图”和“上下文”属性):冒号 (: )不使用;它的位置是一个点。

HTTP异常

在中定义的异常类集 pyramid.httpexceptions . 这些可用于在从 view callable .

参见

也见 HTTP异常 .

JQuery

流行的 Javascript library .

JSON

JavaScript Object Notation 是数据序列化格式。

Jython公司

A Python implementation 为Java虚拟机编写的。

METAL

Macro Expansion for TAL <https://zope.readthedocs.io/en/latest/zopebook/AppendixC.html#metal-overview> 是,一部分 ZPT 这样就可以在模板之间共享相同的外观和感觉。

mod_wsgi

mod_wsgi 是Graham Dumpleton开发的Apache模块。它允许 WSGI 应用程序(例如使用 Pyramid )使用Apache Web服务器提供服务。

PasteDeploy

PasteDeploy 类库被 Pyramid 这样就可以配置 WSGI 在一个 .ini 文件。它是由伊恩·比金发明的。

pkg_resources

随附的模块 Setuptools 它提供了在Python中寻址“资产文件”的API package 。资产文件是静电文件、模板文件等;基本上,任何位于Python包中的非Python源代码都可以被认为是资产文件。

PyPy

pypy是“Python语言的另一种实现”:http://pypypy.org/

Pyramid 技术体系说明手册

关于Pyramid的其他基于社区的文件,介绍了Pyramid的主题和实际用途: Pyramid Community Cookbook

pyramid_debugtoolbar

一个Pyramid加载项,它在应用程序呈现的HTML页面顶部显示一个有用的调试工具栏,显示请求、路由和数据库信息。 pyramid_debugtoolbar 配置为 development.ini 所有使用Pyramid的应用程序 cookiecutter . 有关详细信息,请参阅https://docs.pylonsproject.org/projects/pyramid-debugtoolbar/en/latest/。

pyramid_exclog

将Pyramid应用程序异常(错误)信息记录到标准python记录器中的包。此加载项在生产应用程序中使用时最有用,因为可以将记录器配置为记录到文件、UNIX系统日志、Windows事件日志,甚至电子邮件。见其 documentation .

pyramid_handlers

允许 Pyramid 用户创建类似于桥塔1“控制器”的类。请参见https://docs.pylonsproject.org/projects/pyramid-handlers/en/latest/。

pyramid_jinja2

Jinja2 Pyramid的模板系统绑定,记录在https://docs.pylonsproject.org/projects/pyramid-jinja2/en/latest/上。这个包还包括一个名为 pyramid_jinja2_starter 创建了一个基于jinja2模板系统的应用程序包。

pyramid_redis_sessions

Eric Rasmussen提供的一个包,允许您将Pyramid会话数据存储在Redis数据库中。有关详细信息,请参阅https://pypi.org/project/pyramid-redis-sessions/。

pyramid_zcml

附加程序包 Pyramid 允许通过以下方式配置应用程序 ZCML . 它在上有售 PyPI . 如果你使用 pyramid_zcml ,您可以使用zcml作为 imperative configurationconfiguration decoration .

Python

这个 programming language 在哪儿 Pyramid 是书面的。

python打包机构

这个 Python Packaging Authority (PyPA) 是一个工作组,在Python打包中维护许多相关项目。

repoze.catalog

索引和搜索功能(字段化和全文化)基于 zope.index . 见 the documentation 更多信息。

repoze.lemonade

Zope2 CMF data structures and helper facilities 对于基于CA和ZODB的应用程序 Pyramid 应用。

repoze.who

Authentication middleware 对于 WSGI 应用。它可以被 Pyramid 提供身份验证信息。

repoze.workflow

Barebones workflow for Python apps . 它可以被 Pyramid 形成一个工作流系统。

SQLAlchemy

SQLAlchemy 是此文档中教程中使用的对象关系映射器。

URL调度

替代 traversal 作为定位 context A资源 view . 当你使用 route 在你 Pyramid 通过A应用 route configuration ,您正在使用URL调度。见 URL调度 更多信息。

Waitress

A WSGI 在Unix和Windows上运行的、在python 2.7+和python 3.3+下运行的服务器。通过Pyramidcookiecutter器生成的项目使用服务生作为wgsi服务器。有关详细信息,请参阅https://docs.pylonsproject.org/projects/waitress/en/latest/。

WebOb

WebOb 是由IanBicking创建的wsgi请求/响应库。

WebTest

WebTest 是一个可以帮助您为WSGi应用程序编写功能测试的包。

WSGI

Web Server Gateway Interface <https://wsgi.readthedocs.io/en/latest/> ②这是一个用于将Web应用程序连接到Web服务器的Python标准,类似于Java servlet的概念。 Pyramid 要求您的应用程序作为wsgi应用程序。

ZCML

Zope Configuration Markup Language <http://muthukadan.net/docs/zca.html#zcml> _ Zope和 pyramid_zcml 用于配置任务。

ZODB

Zope Object Database <http://www.zodb.org/en/latest/> _持久的python对象存储。

Zope组件架构

这个 Zope Component Architecture (aka zca)是一个允许应用程序可插入性和基于对象的复杂调度的系统,该对象实现 interface . Pyramid 使用zca“UndertheHood”执行视图调度和其他应用程序配置任务。

ZPT

这个 Zope Page Template 模板语言。

上下文管理器

上下文管理器是一个对象,它定义在执行 with python中的语句。上下文管理器处理执行代码块所需的运行时上下文的入口和出口。上下文管理器通常使用 with 语句,但也可以通过直接调用它们的方法来使用。Pyramid为添加上下文管理器 pyramid.config.Configuratorpyramid.interfaces.IRouter.request_context()pyramid.paster.bootstrap()pyramid.scripting.prepare()pyramid.testing.testConfig() . 另请参见python文档 With Statement Context ManagersPEP 343 .

不变的

在python中,如果值不能更改,则该值是不可变的。 Python strinttuple 数据类型都是 immutable .

中间件

中间件 是一个 WSGI 概念。它是一个同时充当服务器和应用程序的wsgi组件。中间件有一些有趣的用途,如缓存、内容传输编码和其他功能。见 WSGI documentationPyPI 为您的应用程序找到中间件。

丹戈

A full-featured Python web framework <https://www.djangoproject.com/> _.

主要的

A 主要的 是表示实体的字符串,通常是用户或组。主体由 authentication policy . 例如,如果用户具有 userid bob ,并且是两个名为 group foogroup bar ,则请求可能附带信息,指示Bob由三个主体代表: bobgroup foogroup bar .

事件

向零或更多广播的对象 subscriber 正常情况下可调用 Pyramid 应用程序生命周期内的系统操作。应用程序代码可以使用中描述的订阅服务器功能订阅这些事件。 使用事件 .

会话工厂

一个可调用的,当用一个名为 request (A) request 对象),返回 session 对象。参见 使用默认会话工厂使用备用会话工厂pyramid.config.Configurator.set_session_factory() 更多信息。

位置

对象的路径 resource tree . 见 位置感知资源 有关如何创建资源对象的详细信息 location-aware .

元史

XML templating language 克里斯托弗·伦茨。

入口点

A Setuptools 间接,在Setuptools中定义 distribution (通常在 setup.pysetup.cfg )。它通常是指由发行版持有的包中某个地方的函数的名称。

全局状态

一组可供整个程序使用的值。

冲突解决

Pyramid试图通过自动冲突解决来解决应用程序开发人员做出的不明确的配置语句。自动冲突解决在 自动冲突解决 . 如果Pyramid无法解析不明确的配置语句,则可以按照中的说明手动解析它们。 手动解决冲突 .

分布

Setuptools/Python打包术语。表示可安装库或应用程序的文件。分发通常是后缀为 .whl.tar.gz ,或 .zip 。发行版是打包相关命令的目标,例如 pip install

前置发生器

预产生器是由开发人员与 route . 它被称为 route_url() 为了调整用户为特殊目的传递给它的参数集。它将影响由返回的URL route_url() . 见 pyramid.interfaces.IRoutePregenerator 更多信息。

副作用

语句或函数在其自身范围之外更改值时会产生副作用。换句话说,如果你能从一个函数的外部观察到它所做的改变,它就有副作用。

磁盘上包含 __init__.py 文件,使其可被python识别为 import -d.存在一个包含 module 文件夹。

匹普

这个 Python Packaging Authority 用于安装python包的推荐工具。

区域名称

类字符串 enen_USdede_AT 它唯一地标识特定的区域设置。

可反省的

实现中描述的属性和方法的对象。 pyramid.interfaces.IIntrospectable . 自省被 introspector 显示正在运行的Pyramid应用程序的配置信息。反省与 action 凭借 pyramid.config.Configurator.action() 方法。

吐温

位于Pyramid路由器的主要请求处理功能和上游使用的wsgi组件之间的一点代码。 Pyramid 作为它的“应用程序”。“tween”这个词是“between”的缩写。Pyramid框架扩展可以使用中间层,例如,提供Pyramid特定的视图计时支持、在返回上游WSGi应用程序之前检查异常的簿记代码,或各种其他功能。吐温的表现有点像 WSGI middleware 但是他们有在一个他们可以进入Pyramid的环境中运行的好处 application registry 以及Pyramid渲染设备。见 登记吐温 .

命令式配置

使用python调用 Configurator 为了增加每个 configuration declaration 您的申请要求。

响应

由返回的对象 view callable 表示返回到请求用户代理的响应数据。它必须实现 pyramid.interfaces.IResponse 接口。响应对象通常是 pyramid.response.Response 类或子类,如 pyramid.httpexceptions.HTTPFound . 见 请求和响应对象 有关响应对象的信息。

响应回调

用户定义的回调由 router 在一个点之后 response 已成功创建对象。

参见

也见 使用响应回调 .

响应工厂

提供了一个 request 作为单个位置参数,返回与Pyramid兼容的响应。见 pyramid.interfaces.IResponseFactory .

响应适配器

接受任意对象并将其“转换”为 pyramid.response.Response 对象。参见 更改金字塔处理视图响应的方式 更多信息。

国产化

在特定语言或文化背景下显示国际化应用程序的用户界面的过程。通常缩写为“l10n”(因为“本地化”一词是l,10个字母,然后是n)。

参见

也见 Internationalization .

国际化

创建具有用户界面的软件的行为,该用户界面可能显示在多种语言或文化背景中。通常缩写为“i18n”(因为“国际化”一词是i,18个字母,然后是n)。

参见

也见 Localization .

塔柱

A lightweight Python web framework Pyramid的前身。

声明性配置

您使用的配置模式 configuration decoration 和A scan 配置Pyramid应用程序。

多重字典

一种有序字典,每个键可以有多个值。添加方法 getallgetonemixedadddict_of_lists 到普通字典接口。见 多重字典pyramid.interfaces.IMultiDict .

媒人

词典附在 request 对象AS request.matchdict 当A URL dispatch 路线已匹配。其键是路由模式中标识的名称;其值是每个模式名称匹配的值。

媒体类型

表示某些内容类型的标签。媒体类型是包含顶级类型和子类型的嵌套结构。或者,媒体类型也可以包含特定于该类型的参数。见 RFC 6838 有关媒体类型的详细信息。

子路径

router 对视图执行了成功的遍历。子路径是一系列字符串,例如 ['left', 'over', 'names'] . 在使用URL调度而不是遍历的Pyramid应用程序中,可以使用 *subpath 在路径模式中影响子路径。见 使用 *subpath 以路线模式 更多信息。

安全策略

安全策略 Pyramid 术语是实现 pyramid.interfaces.ISecurityPolicy 标识与当前请求关联的用户的API(可能通过cookie或 Authorization 标头),并确定是否允许该用户访问请求的资源。

定位器

类的实例 pyramid.i18n.Localizer 为应用程序提供翻译和多元化服务。它是通过 pyramid.i18n.get_localizer() 功能。

导入时间

在Python中,模块在 import 语句。此时,该模块范围内(左边)的所有语句都将被执行。将语句放入具有 side effect 在进口时。

已完成回调

用户定义的回调由 router 在请求处理的最后无条件地进行。见 使用完成的回调 .

巴别塔

A collection of tools 用于将Python应用程序国际化。 Pyramid 不依赖babel来操作,但是如果安装了babel,应用程序就可以使用其他的区域设置功能。

应用服务器

The Z Object Publishing Framework <https://www.zope.org/> _一个功能齐全的python web框架。

应用程序注册表

配置信息注册表 Pyramid 服务应用程序时。应用程序注册表将资源类型映射到视图,并容纳其他特定于应用程序的组件注册。每个 Pyramid 应用程序有一个(并且只有一个)应用程序注册表。

异常响应

A response 由于引发的异常被 exception view .

异常视图

异常视图是 view callable 可由调用 Pyramid 在请求处理过程中引发异常时。见 自定义异常视图 更多信息。

执行政策

包含 router 通过创建请求对象并通过请求管道发送。见 pyramid.config.Configurator.set_execution_policy .

扫描

使用的术语 Pyramid 为定义导入和检查python包或模块中所有代码的过程 configuration decoration .

授权

确定用户是否可以执行特定操作的操作。在Pyramid术语中,这意味着确定对于给定的资源,是否 principal 与请求相关联的(或主体)具有 permission 允许请求继续。授权 Pyramid 通过ITS执行 authorization policy .

授权策略

中的授权策略 Pyramid 术语是一段代码,它具有一个API,该API根据在 context 资源。

自 2.0 版本弃用: 授权策略已被弃用,取而代之的是 security policy .

控制台脚本

一个写在 bin (在UNIX上,或 Scripts 在Windows上)python安装目录或 virtual environment 因为跑步 pip installpip install -e . .

新闻报道

代码覆盖率的一种度量,通常表示为在哪些行上执行了哪些行的可执行代码的百分比,通常在测试执行期间运行。

无代理咨询

由保罗·埃弗里特、特雷斯·西弗和克里斯·麦克多诺组成的咨询机构。

参见

也见 Agendaless Consulting .

易变的

在python中,如果可以更改某个值,则该值是可变的 就位 . Python listdict 类型是可变的。当向其中一个实例添加值或从中删除值时,原始对象将保持不变。易变的反面是 immutable .

未找到视图

exception view 被调用 Pyramid 当开发人员显式引发 pyramid.httpexceptions.HTTPNotFound 来自内部的异常 view 代码或 root factory 或者当当前请求与任何 view configuration . Pyramid 提供未找到视图的默认实现;它可以被重写。见 更改未找到视图 .

构造函数

返回Pyramid的函数 WSGI 应用。每个Pyramid应用程序都有一个名为 main . 它返回Pyramid router 由A生成 configurator 是你写的。Pyramid构造函数是应用程序的 entry point .

查看可调用

“View Callable”是一个可调用的python对象,它与 view configuration 它返回一个 response 对象。可调用视图接受单个参数: request ,它将是 request 对象。备用调用约定允许将视图定义为接受一对参数的可调用视图: contextrequest :此调用约定对于基于遍历的应用程序很有用,其中 context 总是非常重要的。视图可调用是开发人员在其中编写用户界面代码的主要机制 Pyramid . 见 意见 有关的详细信息 Pyramid 查看可调用文件。

查看配置

视图配置是将 view callable 配置信息。此配置信息有助于映射给定的 request 对特定的可调用视图,它会影响可调用视图的响应。 Pyramid 可通过以下方式配置视图: imperative configuration 或通过一个特殊的 @view_config 装饰器与 scan . 见 查看配置 有关视图配置的详细信息。

目标 traversal 开始时 Pyramid 搜索一个 context 资源(用于) URL Dispatch 根是 总是 上下文资源,除非 traverse= 参数用于路由配置)。

根工厂

A的“根工厂” Pyramid 对发送到应用程序的每个请求调用应用程序。根工厂返回应用程序的遍历根。它是按惯例命名的 get_root . 应用程序可以将根工厂提供给 Pyramid 在施工期间 Configurator . 如果未提供根工厂,应用程序将使用 default root factory .

格罗克

A web framework based on Zope 3 <https://web.archive.org/web/20180615015013/http://grok.zope.org> _.

模块

python源文件;文件系统上通常以扩展名结尾的文件 .py.pyc . 模块通常位于 package .

模板

具有可替换部分的文件,在呈现时能够表示某些文本、XML或HTML。

法西弦

表示值的字符串 False . 可接受值为 ffalsennooff0 .

洪水季

Akhet 是一个Pyramid类库和演示应用程序与塔架一样的感觉。它最著名的是它以前的应用程序支架,它帮助用户从塔架过渡到更喜欢像API这样的塔架。脚手架已经退役,但演示程序也起着类似的作用。

消息标识符

本地化期间用作翻译查找键的字符串。这个 msgid 对A的论证 translation string 是消息标识符。消息标识符也存在于 message catalog .

消息目录

A gettext .mo 包含翻译的文件。

渲染器

一个序列化程序,它转换非 -Response 从返回值 view 变成一个字符串,最后变成一个响应,通常通过 view configuration . 使用渲染器可以减少编写需要模板化或其他序列化的视图(如JSON)的繁琐工作。见 正在写入使用渲染器的视图可调用文件 更多信息。

渲染器全局

值作为名称注入到渲染器中 pyramid.event.BeforeRender 事件。

渲染器工厂

创建一个 renderer . 见 添加和更改渲染器 更多信息。

灰泥

plaster 类库被 Pyramid 它在命令行脚本和用于加载 WSGI 组件和应用程序设置。默认情况下 Pyramid 船舶与 plaster_pastedeploy 已安装的库,它为加载 PasteDeploy ini文件。

炊具

一个命令行实用程序,用于创建项目 cookiecutters (项目模板),例如,从一个python包项目模板创建一个python包项目。

在 1.8 版本加入: 添加了CookieCutter支持。

在 1.10 版本发生变更: 合并的功能来自 pyramid-cookiecutter-alchemypyramid-cookiecutter-zodb 在一个厨艺人的统治下, pyramid-cookiecutter-starter .

自 1.10 版本弃用: pyramid-cookiecutter-alchemypyramid-cookiecutter-zodb 不再支持。使用 pyramid-cookiecutter-starter 往前走。

物理根源

应用程序返回的对象 root factory . 不像 virtual root 对于请求,它不受 虚拟主机 :它始终是根工厂返回的实际对象,而不是子对象。

物理路径

解析 resourcephysical root . 例如,的物理路径 abc 物理根对象的子对象是 /abc . 物理路径也可以指定为元组,其中第一个元素是空字符串(表示根),而其他每个元素都是Unicode字符串,例如。 ('', 'abc') . 物理路径有时也称为“遍历路径”。

犯罪

应用于 configurator . 提交检查中的冲突 configuration declaration 如果没有找到,则应用所有挂起的 action S.尽管不一定推荐,但可以调用 commit 使用 pyramid.config.Configurator.commit()manually resolve 配置冲突。

独生子女

singleton是一个类,它将只具有一个实例。因为只有一个,所以它由所有其他代码共享。这使它成为 global state .

使用单件是 considered a poor design choice. AS mutable 全局状态,它可以被任何其他代码更改,因此它所代表的值不能被合理地考虑或测试。

现场谈判者

提供策略的对象,确定 locale name 最佳代表给定 request . 它被 pyramid.i18n.get_locale_name()pyramid.i18n.negotiate_locale_name() 以及间接地 pyramid.i18n.get_localizer() . 这个 pyramid.i18n.default_locale_negotiator() 函数是一个区域设置协商器的例子。

用户

接受 event . 可呼叫通过以下方式成为订户: imperative configuration 或通过 configuration decoration . 见 使用事件 更多信息。

用户标识

A 用户标识 是一个 identity . 就像标识一样,它应该标识与当前请求相关联的用户。通常这是数据库中用户对象的ID。

界面

A Zope interface 对象。在 Pyramid ,接口可以附加到 resource 对象或 request 对象,以标识该对象是“类型的”。接口由内部使用 Pyramid 执行视图查找和其他策略查找。在 view configuration 通过 context 论点 request_type 参数和 containment 参数。当应用程序开发人员使用 event 系统。从根本上说, Pyramid 程序员可以把一个接口看作是可以附加到一个对象上的东西,这个对象用一个与底层python类型无关的“类型”来标记它。接口也可用于描述对象的行为(其方法和属性),但除非它们选择, Pyramid 程序员不需要理解或使用接口的这个特性。

皮皮

The Python Package Index <https://pypi.org/> _一组可用于python的软件。

看法

普通白话 view callable .

真实字符串

表示值的字符串 True . 可接受值为 ttrueyyeson1 .

禁止视图

exception view 被调用 Pyramid 当开发人员显式引发 pyramid.httpexceptions.HTTPForbidden 来自内部的异常 view 代码或 root factory 或者当 view configurationauthorization policy 为请求找到不允许特定视图调用。 Pyramid 提供禁用视图的默认实现;它可以被重写。见 更改禁止的视图 .

管道

这个 PasteDeploy 用于wsgi服务器、wsgi应用程序的单个配置的术语,其中包含一组 middleware 介于两者之间。

线程局部

线程局部变量本质上是一个全局变量,就如何访问和处理线程局部变量而言,每个变量都是全局变量。 thread 应用程序使用的值对于同一个“全局”变量可能不同。 Pyramid 使用少量线程局部变量,如中所述 线程局部 .

参见

也见 stdlib documentation 更多信息。

缓存中断

为可缓存Static Assets提供服务以强制客户端查询资产的新版本时使用的技术。见 缓存中断 更多信息。

翻新

“repoze”本质上是由 Agendaless Consulting 以及一组贡献者。这个术语没有特殊的内在含义。项目的 website 有更多信息。“在品牌下”开发的软件可在 Subversion repository . 金字塔最初被称为 repoze.bfg .

翻译上下文

表示“上下文”的字符串,其中在给定的 translation domain . 请参见GetText文档, 11.2.5 Using contexts for solving ambiguities 更多信息。

翻译域

表示进行翻译的“上下文”的字符串。例如,如果翻译域是“编程语言”,如果翻译域是“咖啡”的话,“Java”一词可能会被不同地翻译。翻译域由以下集合表示: .mo 一个或多个文件中的文件 translation directory 目录。

翻译家

接受 translation string 并返回为实现国际化而转换的字符串。一 localizerPyramid 通过ITS访问应用程序 translate 方法。

翻译目录

翻译目录是 gettext 翻译目录。它包含语言文件夹,这些文件夹本身包含 LC_MESSAGES 文件夹,其中包含 .mo 文件夹。各 .mo 文件表示语言的一组翻译 translation domain . 的名字 .mo 文件(减去.mo扩展名)是翻译域名。

自省者

具有以下描述的方法的对象 pyramid.interfaces.IIntrospector 它在配置代码(用于注册)和运行时(用于查询)中都可用,允许开发人员内省配置语句和这些语句之间的关系。

由Wichert Akkerman提供的包 pot-create 命令从python源文件和chameleon zpt模板文件中提取可翻译的消息。

获得文本

GNU gettext 库,由 Pyramid 翻译机器。

蒸馏器

Alembic 是一个轻量级的数据库迁移工具,可与用于Python的SQLAlchemy数据库工具包一起使用。

虚拟根

表示请求的“虚拟”根的资源对象;这通常是 physical root 对象,除非 虚拟主机 正在使用中。

虚拟环境

一个独立的python环境,允许安装包供特定应用程序使用,而不是在系统范围内安装。

虚拟现实

这个 virtualenv tool 这样就可以创建虚拟环境。在python 3.3及更高版本中, venv 是首选工具。

注意:每当遇到以 $VENV (UNIX)或 %VENV (Windows),知道这是一个环境变量,其值是相关虚拟环境的根。

血统

基于“:term:location-aware”资源的有序对象序列。任何给定的血统 resource 是由它本身、它的父对象、它的父对象的父对象等组成的。序列的顺序是:首先是资源,然后是资源的父级,然后是其父级的父级,依此类推。沿袭中资源的父级可用作 __parent__ 属性。

行动

表示通过调用 configuration directive . 当 pyramid.config.Configurator.commit() 被称为。

装饰者

python函数或类的包装,它接受函数或类作为第一个参数,并返回一个任意对象。 Pyramid 提供多个修饰符,用于配置和返回值修改目的。

参见

也见 PEP 318 .

视图名称

视图的“URL名称”,例如 index.html . 如果视图配置时没有名称,则其名称被视为空字符串(这意味着 default view

视图处理程序

视图处理程序连接在一起 pyramid.config.Configurator.add_route()pyramid.config.Configurator.add_view() 以便在使用时更方便地将视图集合注册为单个类 URL dispatch . 将处理程序作为 pyramid_handlers 附加组件。

视图推导程序

视图派生器是视图管道的可组合组件,用于创建 view callable . 视图派生器是实现 pyramid.interfaces.IViewDeriver 接口。内置派生器的示例包括视图映射器、权限检查器以及将渲染器应用于从视图返回的字典。

视图映射器

视图映射器是实现 pyramid.interfaces.IViewMapperFactory 接口,执行视图参数和返回值映射。这是扩展构建器的一个插接点,通常不被“平民”使用。

视图查找

发现和调用“最佳”的行为 view callable ,给定一个 request 和A context 资源。

视图谓词

一个论点 view configuration 其计算结果为 TrueFalse 对于给定的 request . 附加到视图配置的所有谓词的值必须为true,关联视图才能被视为给定请求的可能调用。

认证

确定用户在特定请求期间提供的凭证是“良好”的行为。中的身份验证 Pyramid 通过 authentication policy .

许可

一个字符串,表示对 context 资源。开发人员将权限与视图名称和资源类型相关联。资源用安全声明装饰(例如 ACL ,也引用了这些令牌。活动安全策略使用权限将视图权限与资源的语句相匹配,以说明在上下文中将哪些权限授予哪些主体,以便回答“是否允许此用户执行此操作”的问题。权限示例: readview_blog_entries .

设置

设置控制Pyramid应用程序的运行时行为。它们是配置文件声明、流程环境值、Pyramid或其附加组件生成的其他附加项的聚合,以及 tween 以及由您自己的代码生成的值。在应用程序启动时收集设置。它们可以影响组成应用程序的所有组件。Pyramid本身,使用的任何花呢或Pyramid附加组件,以及 your own code may reference 并根据设置进行操作。

设置工具

Setuptools 基于python的 distutils 提供更容易的库和应用程序的构建、分发和安装。

语境

资源树中在 traversalURL dispatch 基于URL数据;如果是通过遍历找到的,通常是 resource 对象,它是资源树的一部分;如果通过 URL dispatch ,它是代表路线“工厂”制造的物品。上下文资源成为 view ,并且经常会附加安全信息。见 遍历 章和 URL调度 有关如何将URL解析为上下文资源的详细信息,请参阅第章。

请求

表示HTTP请求的对象,通常是 pyramid.request.Request 类。见 请求和响应对象 (叙事)和 pyramid.request (API文档)获取有关请求对象的信息。

请求工厂

提供了一个 WSGI 环境作为单个位置参数,返回与Pyramid兼容的请求。

请求类型

属性 request 它允许基于任意分类对视图调用进行专门化。每一个 request 对象 Pyramid 生成和操作具有一个或多个 interface 附加到它的对象。附加到请求对象的默认接口是 pyramid.interfaces.IRequest .

谓词工厂

第三方在注册路由、视图或订阅服务器谓词以扩展配置系统期间使用的可调用文件。见 添加自定义视图、路由或订阅服务器谓词 更多信息。

谓语

返回的测试 TrueFalse . 有两种不同类型的谓词存在于 Pyramid 答: view predicate 和A route predicate . 视图谓词附加到 view configuration 路由谓词附加到 route configuration .

谷歌应用引擎

Google App Engine (又称“gae”)是一种由谷歌提供的python应用程序托管服务。 Pyramid 在GAE上运行。

资产

python中包含的任何文件 package 哪个是 not 一个python源代码文件。

资产描述符

表示 asset specification 提供的 pyramid.path.AssetResolver.resolve() 方法。它支持中记录的方法和属性 pyramid.interfaces.IAssetDescriptor .

资产规格

以冒号分隔的标识符 asset . 结肠把 Python 分开 package 包子路径中的名称。例如,资产规格 my.package:static/baz.css 标识名为的文件 baz.cssstatic 的子目录 my.package Python package . 见 了解资产规格 更多信息。

资源

表示中节点的对象 resource tree 应用程序的。如果 traversal 资源是系统遍历的资源树中的元素。当使用遍历时,资源将变为 context A的 view . 如果 URL dispatch 如果使用,则为每个请求生成一个资源,并将其用作视图的上下文资源。

资源位置

定位 context 资源给定 request . TraversalURL dispatch 资源位置子系统是否由 Pyramid .

资源树

一组嵌套的类似字典的对象,每个对象都是 resource . 行为 traversal 使用资源树查找 context 资源。

路由前缀

路由前缀是一个路径前缀,用于在活动时配置的任何路由。可以通过以下方式设置路由前缀: pyramid.config.Configurator.include()pyramid.config.Configurator.route_prefix_context() .

路由器

这个 WSGI 启动时创建的应用程序 Pyramid 应用。路由器拦截请求,调用遍历和/或URL调度,调用视图函数,并代表您的 Pyramid 应用。

路由映射器

将请求中的路径信息与一组有序的路由模式进行比较的对象。见 URL调度 .

路由谓词

一个论点 route configuration 这意味着一个值的计算结果为 TrueFalse 对于给定的 request . 所有附加到 route configuration 必须计算为 True 关联的路由以“匹配”当前请求。如果路由与当前请求不匹配,将尝试下一个路由(按定义顺序)。

路由配置

路由配置是将请求参数与特定的 route 使用模式匹配和 route predicate 声明。见 URL调度 有关路由配置的详细信息。

路线

A system by Ben Bangert 它解析URL并将其与许多用户定义的映射进行比较。中的URL模式匹配语法 Pyramid 灵感来自于Routes语法(灵感来自RubyonRails模式语法)。

路线

一个与 URL dispatch 子系统,通常解析为 root factory (然后最终 view

参见

也见 URL dispatch .

身份

标识是标识与当前请求关联的用户的对象。对象可以是任意形状,例如简单的ID字符串或ORM对象。

身份验证策略

中的身份验证策略 Pyramid 术语是一段代码,它有一个确定当前 principal 与请求关联的(或主体)。

自 2.0 版本弃用: 身份验证策略已被弃用,取而代之的是 security policy .

转换字符串

的实例 pyramid.i18n.TranslationString ,这是一个行为类似于字符串的类,但具有多个额外属性,例如 domainmsgidmapping 翻译时使用。翻译字符串通常是在软件中手工创建的,但有时是代表系统创建的,用于自动模板翻译。有关详细信息,请参阅 国际化与本土化 .

迪斯妥尔

包装和分发python包的标准系统。有关详细信息,请参阅https://docs.python.org/2/distutils/index.html。 Setuptools 实际上是一个 延伸 在distutils中。

遍历

从根资源中“向上”下降一个资源对象树以查找 context 资源。这个 Pyramid routerroot factory 指定。见 遍历 第章了解更多信息。可以执行遍历 相反 属于 URL dispatch 或者可以组合 with URL调度。见 结合遍历和URL调度 有关组合遍历和URL调度(高级)的详细信息。

部署设置

部署设置是传递给 Configurator 作为一个 settings 参数。稍后可通过 request.registry.settings 视图或as中的字典 config.registry.settings 在配置代码中。部署设置可以用作全局应用程序值。

配置器

用来做的对象 configuration declaration 在应用程序中。最常见的配置程序是 pyramid.config.Configurator 类。

配置声明

configuration directive ,例如注册 view configuration (通过 add_view() 配置器的方法)或 route configuration (通过 add_route() 配置器的方法)。一组配置声明也由 configuration decoration 由A检测 scan 包中的代码。

配置指令

一种方法 Configurator 这将导致发生配置操作。方法 pyramid.config.Configurator.add_view() 是一个配置指令,应用程序开发人员可以根据需要添加自己的指令(请参见 通过向配置器添加方法 add_directive

配置装饰

元数据表示一个或多个 configuration declaration 调用。通常由配置python设置 decorator 属性,例如 pyramid.view.view_config ,又名 @view_config .

重构文本

A plain text markup format 这是记录Python项目的defacto标准。金字塔文档是用restructuredtext编写的。

金星的

Venusian 是一个允许框架作者推迟decorator操作的库。而不是在执行函数(或类)修饰符时执行操作 import time ,通常由装饰器采取的操作将延迟到单独的“扫描”阶段。 Pyramid 依靠金星人为其 scan 特征。

金沙2号

A text templating language 阿敏·罗纳赫。

鉴别器

的唯一标识符 action .

阶段

对于一段连续活动有效的命名空间,可用于表示用户与Web应用程序的交互。

附加的

Python distribution 它使用Pyramid的可扩展性来插入Pyramid应用程序并提供额外的可配置服务。

静脉注射

这个 Python Packaging Authority 在Python3.3及更高版本上创建虚拟环境的推荐工具。

注意:每当遇到以 $VENV (UNIX)或 %VENV (Windows),知道这是一个环境变量,其值是相关虚拟环境的根。

项目

Setuptools/Python打包术语。磁盘上的目录,其中包含 setup.py 和/或 pyproject.toml 文件和一个或多个Python包。项目文件包含允许安装、分发和测试软件包的元数据。

领域模型

与应用程序相关的持久数据。例如,存储在关系数据库中的数据。在某些应用中, resource tree 充当域模型。

鲭鲨

Mako 是一种模板语言,它使用带有Python作用域和调用语义的Python来改进组件化布局和继承的熟悉思想。

黑角兽

阿卡 gunicorn 快速 WSGI 在UNIX上以python 2.6+或python 3.4+运行的服务器。有关详细信息,请参阅https://gunicorn.org/。

默认区域设置名称

这个 locale name 在未设置显式区域设置名称时由应用程序使用。见 与本地化相关的部署设置 .

默认权限

A permission 它被注册为整个应用程序的默认值。当默认权限生效时,每个 view configuration 在系统中注册的将被有效地修改为 permission 需要执行用户拥有默认权限才能成功执行关联的 view callable .

参见

也见 设置默认权限 .

默认根工厂

如果应用程序没有注册 root factory 在Pyramid配置时,a 违约 根工厂用于创建默认根对象。默认根对象的使用在使用 URL dispatch 对于所有要查看代码映射的URL,不要(有意地)使用遍历。

默认视图

默认视图 resourceview name 是空字符串 ('' )在这种情况下 traversal 在请求返回 context 资源。