grok 5.0

什么是Grok？

Grok是一个基于Zope工具包技术的出色网络框架。

Grok使用组件架构，并建立在Zope的概念之上，如内容对象（模型）、视图和适配器。其简单性在于使用组件连接时的约定优于配置和合理的默认值。这意味着创建一个Grok网络应用不需要ZCML之类的配置语言或大量的重复工作。

您可以在我们的网站上了解更多关于Grok的信息。

谁在用Grok？

Grok是一个来自旧石器时代的友好穴居人。他有一根大棍子，用它来猎捕猛犸象。他也会用这根棍子砸碎他不喜欢的东西。

“ME GROK SMASH ZCML！”

获取Grok

开始使用Grok的最简单方法是安装grokproject包（例如，通过easy_install grokproject），然后通过以下方式调用grokproject脚本来创建一个新的项目区域

$ grokproject MyProject
... many lines of output here

这将创建一个位于MyProject中的项目区域以及下载和安装Grok。

您还可以从GitHub获取Grok

git clone https://github.com/zopefoundation/grok.git

然后按照INSTALL.rst中的说明操作。

5.0 (2024-01-29)

4.0 (2023-12-19)

• 添加对Python 3.11、3.12的支持。

• 更新生命周期事件的导入路径。

• 删除对Python 2.7、3.5、3.6的支持。

3.3 (2022-09-01)

• 添加对Python 3.9、3.10的支持。

• 修复弃用警告。

3.2 (2020-09-02)

• 修复DeprecationWarnings。

• 使用zopefoundation/meta/config来协调包结构。

• 删除对Python 3.4的支持，添加3.7 + 3.8。

• 删除一些向后兼容的导入。

3.1 (2018-05-09)

• 公开grok.ignore以允许在模块中不使用Grok。

3.0.1 (2018-01-17)

• 将grok.implements()的使用替换为全范围的@grok.implementer()指令。

3.0.0 (2018-01-16)

• Python 3兼容性。

1.15 (2017-05-30)

• 宣传LazyAnnotation和LazyAnnotationProperty。

1.14.1 (2016-02-15)

• 更新测试。

1.14 (2015-06-11)

注意：有一些变更破坏了与旧版本的向后兼容性。

• 推广来自grokcore.site的install_on指令。

• 将ApplicationInitializedEvent替换为来自grokcore.site的ApplicationAddedEvent。

• 引入一个新的事件DatabaseCreatedEvent，当数据库创建时仅触发一次。对于现有应用程序升级到这个新版本，升级时仍会发送事件。

• 将grok.util.create_application替换为来自grokcore.site.util的版本。现在可以直接从grok导入。

1.13 (2015-06-04)

• 推广来自grokcore.content的ObjectEditedEvent。

1.12 (2014-10-20)

• 从grokcore.annotation添加grok.queryAnnotation()和grok.deleteAnnotation()。

1.11.3 (2013-04-03)

• 修复了调用application_url()的问题，使其在API定义了关键字参数时使用关键字参数。

1.11.2 (2013-04-03)

• 修复了brown paper bag发布中未包含所有资源的问题。再次。

1.11.1 (2013-04-03)

• 修复了brown paper bag发布中未包含所有资源的问题。

1.11 (2013-04-03)

• 更新grok.util.application_url()，使其与grokcore.view.util.url()正确工作。

1.10.3 (2012-05-10)

• 确保也能为布局感知表单组件检索正确的布局。

1.10.2 (2012-05-10)

• 将grokcore.layout.layout指令也导入到grok命名空间中。

1.10.1 (2012-05-02)

• 更新版本要求。

1.10 (2012-05-02)

• 将应用程序组件和local_utility指令从grok分离出来到grokcore.site。为应用程序留下向后兼容的导入。

• 将目录和索引组件从grok分离到grokcore.catalog。

• 将permissions()指令、Permission组件和Role组件从grok移动到grokcore.security。grok包导入这些组件，因此仍可以通过grok API访问它们。

1.9 (2011-09-06)

• 添加了用于补充Subscriptions和MultiSubscriptions组件的函数的导入：querySubscriptions()、queryMultiSubscriptions()、queryOrderedSubscriptions()和queryOrderedMultiSubscriptions()。

1.8 (2011-07-14)

• 合并grokcore.chameleon，并默认配置。

• 公开由grokcore.layout带来的Layout、Page、AddFormPage、EditFormPage、DisplayFormPage和FormPage组件。公开了在grok的viewish组件中通常找到的mixin应用程序_url()和flash()功能。

• 公开来自grokcore.layout的ExecptionPage、NotFoundPage和UnauthorizedPage组件。

• 公开来自grokcore.view的ContentProvider组件。

• 声明“index”名称为错误视图的默认视图名称。

1.7 (2011-05-26)

• 直接依赖于zope.app.wsgi并对其进行配置，以便注册有用的IResult适配器（用于（暂时）文件）。

• 导入grokcore.component.global_adapter。

1.6 (2011-04-04)

• 修复了依赖于较旧版本的zope.testbrowser的测试。

• 添加了grok.index.Value组件。

1.5 (2011-02-14)

• 添加了Subscription和MultiSubscription组件的导入。

1.4.3 (2011-02-08)

• 现在错误视图不再默认提供ISystemErrorView，修复了测试。

1.4.2 (2011-01-20)

• 应该将IApplication也列为grok API的一部分。

1.4.1 (2011-01-20)

• Grok仍然应该在grok API中提供IApplication，即使它已经移动到grokcore.site.interfaces。

1.4 (2011-01-20)

• 为IException、INotFound和IUnauthorized错误定义错误视图基类：grok.ExceptionView、grok.NotFoundView、grok.UnauthorizedView。取消了zope.app.http和zope.app.exception的间接依赖。

• 将XMLRPC、REST组件移动到单独的包grokcore.xmlrpc和grokcore.rest中。因此，Grok定义的定制遍历组件也移动到grokcore.traverser。Grok-the-python-package更像是一个导入中心。

• 现在我们使用collective.recipe.sphinxbuilder而不是我们自己的早期黑客（去掉grokdocs子包）。Buildout现在生成grokdocs2html和grokdocs2pdf，它们应该做你所想的事情。

• IApplication 接口和 getApplication() 方法已移动到 grokcore.site。

1.3 (2010-11-03)

• IGrokSecurityView 接口已移动到 grokcore.view。

• util 函数 make_checker 已移动到 grokcore.view。

• 基本发布者已移动到 grokcore.view，作为一个可选特性：security_publication。

• JSON 组件和 grokker 现已移动到 grokcore.json。Grok 现在依赖于这个新的 grokore 包。

• 更新到最新版本的 martian 和 grokcore.component。

1.2.1 (2010-10-26)

• Grok 教程示例项目已更新。

• 更新文档以准备 Grok 工具包 1.2 版本的发布。

• 使用 zc.buildout-1.5.2。

1.2 (2010-10-13)

• 无需进行任何更改。

1.2a (2010-10-07)

• Grok 和 Grok 工具包现在使用 zc.buildout-1.5.1，这应该显著简化 Grok 的安装过程。现在可以使用系统 Python 安装 Grok。这已使 virtualenv 要求过时。

• Grok 和 Grok 工具包将使用 ZTK-1.0 版本。请注意，尽管如此，一些包的版本已被覆盖，以包含错误修复版本。

• 各种依赖关系已更新。

• 从 grok.testing 中删除了 z3c.testsetup 特定的测试收集器。您仍然可以使用 z3c.testsetup 与 grok 一起使用，但必须在项目的 setup.py 中明确声明依赖关系。

• grok.View 组件现在使用 grokcore.message 包的 flash 方法。

• Grok 测试 zcml 现明确设置了默认视图名称（到 index.html）。这是添加的，因为我们不再依赖于像 zope.app.zcmlfiles 这样的包，这些包曾经负责该配置步骤。

• 角色标题和描述的国际化不再丢失。

• 在键重复的情况下，create_application 现在引发一个 KeyError，以匹配 zope.container 的行为。已相应地调整了测试。

• 向现有的 DuplicationError 添加了 KeyError 错误处理，以适应 zope.container 的更改。已相应地调整了测试。

1.1.1 (2010-05-30)

• 利用包括 Grok 依赖关系的几个错误修复版本在内的 groktoolkit 1.1.1，例如

  • zope.password，其中 SSHAPasswordManager 已修复。

  • zope.publisher，修复了长期存在的 XML-RPC “挂起”错误。

• 清理了 buildout 部分。

• 删除 zope.app.twisted。

1.1 (2010-05-18)

• 将 zope.pluggablauth 添加为依赖项。

1.1rc1 (2010-02-25)

• 现在使用 grokcore.content 作为基本内容类型：Model、Container 和 OrderedContainer。

• 取消了对 zope.app.authentication 的依赖，并改为依赖 zope.password。

• 取消了对已弃用的包 zope.app.error、zope.app.securitypolicy 和 zope.app.session 的依赖。

除了这些更改外，还进行了很多工作，以尽可能从 Grok 本身及其依赖关系中去掉对“较旧”的 zope.app.* 包的依赖。这项工作尚未完成。

1.1a2 (2009-12-22)

• 更新了 z3c.recipe.compattest 的版本，并使用它用于 bin/compattest，该工具测试 grok 及其所有依赖关系。

• 添加了 grok.getApplication()，类似于 grok.getSite()，检索“最近”封装的 grok.Application 对象。

• 使用 zope.container 而不是 zope.app.container。

• 使用 zope.catalog 而不是 zope.app.catalog。

• 使用 zope.intid 而不是 zope.app.intid。

• 使用 zope.keyreference 而不是 zope.app.keyreference。

1.1a1 (2009-11-17)

• 此版本依赖于 grokcore.view 1.13a1。

• 添加 ZTK 支持（目前为 ZTK 1.0dev）。

• Grokdocs 现在使用 ZTK 锁定版本。

• grok.permissions()，在 grok.Role 组件中使用，现在接受 grok.Permission 类的引用，而不仅仅是权限 ID。此行为现在与 grok.require() 指令的行为对称。

• 添加了一个工具函数 create_application，用于创建应用程序并在过程中触发正确的事件。

• Grok 现在提供了一个以应用程序为中心的事件，用于完成 zope.lifecycle 的事件。此事件 ApplicationInitializedEvent，旨在在应用程序被添加到容器之后触发。在这一特定步骤，应用程序被认为可以安全地创建额外内容。

• 使用 grokcore.site 和 grokcore.annotation 代替内置实现。

• 更新引用以提及 zope.View。

• 更新引用以提及在 grok.require 和 grok.permissions 中对 grok.Role 的直接权限引用。

• 修复了文档中的一个错误，其中虚拟环境没有正确解释。

• 从 etc/site.zcml.in 中移除了 grok.View 权限声明，应该已经在 1.0b2 中移除。

1.0 (2009-10-07)

• 再次移除了 IReRaiseException 适配器的注册，以支持使用 grokcore.startup 的可配置 debug_application_factory WSGI 应用程序工厂函数。

• 使用更新版本的 simplejson 和 pytz。

  另请参阅 https://bugs.launchpad.net/grok/+bug/432115

1.0b2 (2009-09-17)

请参阅： upgrade_notes_1.0b2，了解升级到此版本的特殊说明。

• 恢复到旧版本的 grokui.admin，该版本未对 grok.View 权限以及 View/CodeView 分割进行任何更改，并且仍然具有从较新版本中删除的内省器。

• grokcore.view、grokcore.viewlet、grokcore.formlib 和 Grok 本身都已更新，以撤销我们在 Grok 1.0a4 之后开发版本中暂时引入的 View/CodeView 分割。这意味着 grok.View 的行为与 Grok 1.0a4 相同。这里没有看到任何东西！

• 将默认权限更改为 zope.View 而不是 zope.Public。这意味着如果您正在升级现有的基于 Grok 的项目，则需要对您的 site.zcml 进行修改。有关更多信息，请参阅升级说明。

  另请参阅 https://bugs.launchpad.net/grok/+bug/387332

• 将使用的 zope.app.wsgi 版本（现在：3.4.2）升级以支持 zope.conf 文件中的 product-configs，并修复与 paster 相关的 paster.httpserver 相关的 bug。修复 https://bugs.launchpad.net/grok/+bug/220440

• grok 样本应用程序的数据.fs 和日志文件的默认位置现在是 var/filestorage/ 和 var/log/，而不是 parts/data/ 和 parts/log/。

• 将使用的 z3c.testsetup 版本（现在：0.4）升级。修复 https://bugs.launchpad.net/grok/+bug/395125

• 将使用的 ZODB3 版本（现在：3.8.3）升级。修复 https://bugs.launchpad.net/grok/+bug/410703 和 https://bugs.launchpad.net/grok/+bug/424335

• 添加了 zope.publisher.interfaces.IReRaiseException 适配器用于 IUnauthorized 异常。关闭 https://bugs.launchpad.net/grok/+bug/332061

• 从 versions.cfg 中删除了 docutils 和 Pygment。两者都在 grokdocs 子包中锁定。关闭 https://bugs.launchpad.net/grok/+bug/340170

• 修正了 Content-type；JSON 视图现在报告 'application/json'。

• 更新 zope.publisher 依赖项到 3.4.8（修复 XMLRPC、PUT 中的 paster.httpserver 相关错误）

• 将 buildout 切换到基于 paster 的模板（类似于 grokproject 默认模板）https://bugs.launchpad.net/grok/+bug/307197

• 将解释器名称从 'python' 更改为 'grokpy'。

• 对升级和变更文档进行了重构，现在它们将通过 Sphinx 生成为单独的文件。

1.0b1 (2009-09-14)

• 此版本已发布，但并未真正完全完成。请参阅 1.0b2 的发布说明。

1.0a4 (2009-05-21)

• 将 grokcore.view 固定到 1.7。

• 从其实际定义而不是重新导入中导入 zope.app.container 接口。

• JSON 视图现在报告 Content-type: text/json。请参阅 https://bugs.launchpad.net/bugs/362902

1.0a3 (2009-04-10)

• 将 grokui.admin 固定到 0.3.2。

• 将 grokcore.view 固定到 1.5。

• 将 grokcore.component 固定到 1.6。

1.0a2 (2009-04-08)

• 更新了文档和文档字符串。

• 将 grokui.admin 固定到 0.3。

• 将 grokcore.view 固定到 1.4。

• 将 versions.cfg 与最新的 KGS 版本同步，可在以下位置找到： http://download.zope.org/zope3.4/3.4.0/versions.cfg

• 在 grok 命名空间中公开 IBeforeTraverseEvent 以供导入。

1.0a1 (2009-01-08)

请参阅：upgrade_notes_1.0a1 了解升级到此版本的特别说明。

0.14 (2008-09-29)

请参阅：upgrade_notes_0.14 了解升级到此版本的特别说明。

0.13 (2008-06-23)

参见：升级说明_0.13了解升级到此版本的特殊说明。

0.12 (2008-04-22)

请参阅：upgrade_notes_0.12 了解升级到此版本的特别说明。

0.11 (2007-11-08)

参阅：upgrade_notes_0.11了解升级到此版本的特别说明。

0.10.2 (2007-10-24)

错误修复

• 从版本要求中移除了zc.recipe.egg、zc.recipe.filestorage、zc.recipe.testrunner、zc.zope3recipes。

• 需要zope.app.error = 3.5.1

0.10.1 (2007-10-10)

错误修复

• buildout.cfg通过扩展versions.cfg来锁定依赖树的版本。这应该可以避免我们发布Grok、某些依赖变更，而Grok因此出现故障的情况。与此相关，我们还将发布一个新的grokproject版本，该版本默认使用此版本基础设施。

  有关此更改的更多信息，请参阅： http://grok.zope.org/releaseinfo/readme.html

0.10 (2007-08-21)

0.9系列（2007年早期至2007年7月）

特性变更

在此期间，Grok通过SVN以“持续发布”模式发布。

0.1系列（2006年9月至2007年早期）

特性变更

2006年9月创建了Grok。