~cbehrens/nova/lp844160-build-works-with-zones

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'><html lang="en" xmlns="http://www.w3.org/1999/xhtml">

<head>

<title>Twisted Documentation: rpy scripts (or, how to save yourself some typing)</title>

</head>

<h1 class="title">rpy scripts (or, how to save yourself some typing)</h1>

The goal of this installment is to show you another way to run a Twisted Web

server with a custom resource which doesn't require as much code as the previous

examples.

The feature in question is called an <code>rpy script</code>. An rpy script

is a Python source file which defines a resource and can be loaded into a

Twisted Web server. The advantages of this approach are that you don't have to

write code to create the site or set up a listening port with the reactor. That

means fewer lines of code that aren't dedicated to the task you're trying to

accomplish.

There are some disadvantages, though. An rpy script must have the extension

<code>.rpy</code>. This means you can't import it using the usual Python import

statement. This means it's hard to re-use code in an rpy script. This also means

you can't easily unit test it. The code in an rpy script is evaluated in an

unusual context. So, while rpy scripts may be useful for testing out ideas,

they're not recommend for much more than that.

Okay, with that warning out of the way, let's dive in. First, as mentioned,

rpy scripts are Python source files with the <code>.rpy</code> extension. So,

open up an appropriately named file (for example, <code>example.rpy</code>) and

put this code in it:

<pre class="python"> 1

import time

from twisted.web.resource import Resource

class ClockPage(Resource):

isLeaf = True

def render_GET(self, request):

return "%s" % (time.ctime(),)

resource = ClockPage()

</pre>

You may recognize this as the resource from the <a href="dynamic-content.html" shape="rect">first dynamic rendering example</a>. What's

different is what you don't see: we didn't import <code>reactor</code> or

<code>Site</code>. There are no calls to <code>listenTCP</code> or

<code>run</code>. Instead, and this is the core idea for rpy scripts, we just

bound the name <code>resource</code> to the resource we want the script to

serve. Every rpy script must bind this name, and this name is the only thing

Twisted Web will pay attention to in an rpy script.

All that's left is to drop this rpy script into a Twisted Web server. There

are a few ways to do this. The simplest way is with <code>twistd</code>:

$ twistd -n web --path .

</pre>

Hit <a href="http://localhost:8080/example.rpy" shape="rect">http://localhost:8080/example.rpy</a>

to see it run. You can pass other arguments here too. <code>twistd web</code>

has options for specifying which port number to bind, whether to set up an HTTPS

server, and plenty more. Other options you can pass to <code>twistd</code> allow

you to configure logging to work differently, to select a different reactor,

etc. For a full list of options, see <code>twistd --help</code> and <code>twistd

web --help</code>.

</div>

<a href="../index.html">Index</a>

Version: 10.0.0

</body>

</html>

b'\\ No newline at end of file'

Older »