Skip to main content

Grok: Now even cavemen can use Zope 3!

Project description


What is grok?

Grok makes it easier to get started with a Zope 3 web application.

Grok uses the Component Architecture and builds on Zope 3 concepts like content objects (models), views, and adapters. Its simplicity lies in using convention over configuration and sensible defaults when wiring components together. That means neither a configuration language like ZCML nor a lot of repetition are needed to create a web application with grok.

You can find out much more about Grok at our website.

Who is grok?

Grok is a friendly caveman from the Stone Age. He has a big club that he hunts mammoths with. He will also use this club to smash anything he doesn’t like.


Getting grok

The easiest way to get started with grok is to install the grokproject package (e.g. via easy_install grokproject) and then create a new project area by calling the grokproject script like so:

$ grokproject MyProject
... many lines of output here

This will create a project area in MyProject as well as download and install grok and Zope 3 (the application server grok is built on).

You can also get grok from the subversion repository:

svn co svn:// grok

Then follow the instructions of INSTALL.txt.

Grok changes

0.11.2 (2008-12-12)

Bug fixes

  • Port fix of zope.formlib to correctly adapt the context to a FormField’s interface, not the field’
  • Fix serious security issue.

0.11.1 (2008-01-20)

Bug fixes

  • Do not register the publishTraverse and browserDefault methods of the JSON component as views.
  • Methods with names that start with an ‘_’ are not registered as views for XMLRPC, REST and JSON components.
  • Use a configuration action for the registration of the static directory.
  • Fix grok.testing.grok() now also loads the ZPT template factories so that unit tests that need to configure views with ZPT templates continue to work.
  • Changed a few remaining references to grok.grok and grok.grok_component to their correct equivalents in grok.testing.
  • grok.testing.grok_component() could not be used in a pure doctest. This needed a bugfix in Martian (since 0.9.2). Add a test that demonstrates this problem.
  • Fix grok.Form and its subclasses did not implement IBrowserView.

0.11 (2007-11-08)

Feature changes

  • Integrated skins and layers: grok.layer, grok.IGrokLayer, grok.Skin.
  • Grok now supports hooking in new template languages without much work. See also doc/minitutorials/template-languages.txt. See Restructuring below for more techinical info.
  • Accessing a template macro via context/@@the_view/the_template is now deprecated for the standard ZPT story of using context/@@the_view/macro/the_template.
  • There is now a directive that can be used on GlobalUtilities to mark that the class provides the utility interface directly and need no instantiation.
  • Removed grok.define_permission in favor of the grok.Permission component base class. You should now subclass this base class to define permissions. See also doc/minitutorials/permissions.txt
  • Added the grok.Role component base class to define roles.
  • The admin UI now displays and offers deletion of broken objects.
  • Removed support for defining model schemas using an inner class with the special name fields. This was abandoned in favor the usual Zope 3 way of defining schemas in interfaces and implementing them in our Grok models.
  • Integrated REST support. See doc/minitutorials/rest.txt for usage information.

Bug fixes

  • Remove zc.recipe.egg, zc.recipe.filestorage, zc.recipe.testrunner, zc.zope3recipes from version requirements.
  • The admin UI now shows interfaces in modules.
  • handle... is not a special function name anymore.
  • Views no longer need a custom AbsoluteURL view to determine their URL, since each instance now properly gets a __name__ attribute.
  • buildout.cfg extends versions.cfg to pin down the versions of the dependency tree. See also


  • Grokkers now emit configuration actions, much like ZCML directive handlers do. If you defined custom grokkers, see doc/upgrade.txt for more information.
  • The new pluggable template language support includes some restructuring:
    • GrokPageTemplate is now split up into two. BaseTemplate, on which all templates need to be based, and GrokTemplate, which also provides a set of methods for easy integration of templating languages.
    • All objects based on GrokTemplate are now grokked, instead of having separate grokkers for each type of template.
    • The View is now completely template-language agnostic, which makes it easy to hook in new page template languages.
    • There are now new interfaces (ITemplate and ITemplateFileFactory) used when you implement support for a new templating language.
  • Changed the way grok’s functional tests are set up. Instead of each test case doing its own test setup, it is now done once by the ftesting layer. This avoids ordering problems when some ftests would influence the environment of other ftests that were run later in time.

0.10.2 (2007-10-24)

Bug fixes

  • Remove zc.recipe.egg, zc.recipe.filestorage, zc.recipe.testrunner, zc.zope3recipes from version requirements.
  • Require = 3.5.1

0.10.1 (2007-10-10)

Bug fixes

  • buildout.cfg extends versions.cfg to pin down the versions of the dependency tree. This should avoid the situation where we release Grok, some dependency changes, and Grok breaks as a result. In conjunction with this we will also be releasing a new version of grokproject that will use this version infrastructure by default.

    For more information about this change, see:

0.10 (2007-08-21)

Feature changes

  • Integrated admin user interface.
  • Configuration using Martian (
  • Flash message infrastructure included.
  • Adjust dependencies for Grok so that grokproject should work on Windows.

Bug fixes

  • A fix in Martian where multiple grok.Model or grok.Container classes could result in something being found as a context twice.

0.9 series (early 2007 until July 2007)

Feature changes

Grok was released in “continuous release” mode from SVN during this period.

0.1 series (September 2006 until early 2007)

Feature changes

Grok was created in September 2006.


Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for grok, version 0.11.2
Filename, size File type Python version Upload date Hashes
Filename, size grok-0.11.2.tar.gz (383.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page