GROK

XML-RPC using Grok

Author: Kushal Das

What is XML-RPC ?

From the site (http://xmlrpc.com): it's a spec and a set of implementations that allow software running on disparate operating systems, running in different environments to make procedure calls over the Internet.

So, What is Grok?

From the site: Grok is a web application framework for Python developers. It is aimed at both beginners and very experienced web developers. Grok has an emphasis on agile development. Grok is easy and powerful.

Grok accomplishes this by being based on Zope 3, an advanced object-oriented web framework. While Grok is based on Zope 3, and benefits a lot from it, you do not need to know Zope at all in order to get productive with Grok.

So, it is cool, isn't it? :)

Installation

To install the latest grok, give the following command:

$ sudo easy_install grokproject

This will download and install grok for you. After this we are ready to rock...

Creating our first project

Let's create the project named "Foo". For that give the command:

$ grokproject Foo

This will create a subdirectory in the current directory named "Foo", then it will download Zope3 and install Grok with that which you can start working with. It will ask you a few questions like:

Enter module (Name of a demo Python module placed into the package) ['app.py']:

Press Enter for the default value. Then:

Enter user (Name of an initial administrator user): grok
Enter passwd (Password for the initial administrator user): grok

We typed "grok" for both the user and password.

Starting up Zope

Switch to the Foo directory, and give the command:

$ bin/zopectl fg

This will startup Zope for you, you can access it through a web browser pointing to http://localhost:8080/ . Then add an application named foo.

You can access it by http://localhost:8080/foo, it will show:

Congratulations!

Your Grok application is up and running. Edit foo/app_templates/index.pt to
change this page.

Now we are going to write our xmlrpc stuffs inside it.

XML-RPC class

Now you can open the file src/foo/app.py in a text editor. The default is shown below:

import grok

class Foo(grok.Application, grok.Container):
    pass

class Index(grok.View):
    pass # see app_templates/index.pt

We will another class which will be available through this application class, the new class should inherit grok.XMLRPC for this, and we will write a say() method. It will return "Hello World!". So, the changed file:

import grok

class Foo(grok.Application, grok.Container):
    pass

class Index(grok.View):
    pass # see app_templates/index.pt

class FooXMLRPC(grok.XMLRPC):
    """The methods in this class will be available as XMLRPC methods
       on 'Foo' applications."""

    def say(self):
        return 'Hello world!'

The name of the class doesn't matter, so you can give it any name. Restart the Zope in the console, and you can connect to it through any xmlrpc client. Below is an example (fooclient.py):

#!/usr/bin/env python
import xmlrpclib

s = xmlrpclib.Server('http://localhost:8080/foo')
print s.say()

Run this and see !!

Class in a different file

What if you want to write the class in a different file in the src/foo directory and still want to have the methods to be available under Foo application. For that you need to tell grok explicitly that the new class to associate it to the Foo model by using the grok.context class annotation.

What is a class annotation?

A class annotation is a declarative way to tell grok something about a Python class. Let's see the example, we write a Boom.py with a Boom class:

import grok
from app import Foo

class Boom(grok.XMLRPC):
    grok.context(Foo)

    def dance(self):
        return "Boom is dancing!!"

Look at the line where it says grok.context(Foo) this is doing all the magic. In the fooclient.py you just need to call s.dance() instead of s.say().

So, now write your dream system...