Grok Setup
The Grok tutorial [1] has a great section on Grok setup, and I do not want to duplicate it here, please read "Getting started with Grok" section and come back here. After you have created your project using grokproject, the name of the project used in this tutorial is Poller.
NOTE: When adding the application in the Grok Admin UI, we call it "poller" which is the application name used later in this tutorial.
One small addition to the Grok tutorial setup section, is a small tip on debugging Grok applications: Grok supports Web Server Gateway Interface (WSGI) [2] and includes a nice setup for using z3c.evalexception [3], which is a WSGI middleware package providing interactive AJAX debugger and a post-mortem pdb support. To run a Grok instance with debugging enabled, use the following command:
$ bin/paster serve parts/etc/debug.ini
This command should be run whenever you make changes to Python code, template code is updated automatically. Now that Grok and the application has been set up, we'll start coding in the next section.
| [1] | Grok Tutorial <http://grok.zope.org/doc/current/tutorial.html> |
| [2] | WSGI Web site <http://www.wsgi.org/> |
| [3] | z3c.evalexception Web site <http://pypi.python.org/pypi/z3c.evalexception/> |

