~justin-fathomdb/nova/justinsb-openstack-api-volumes

<?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: Serving Static Content From a Directory</title>

</head>

<h1 class="title">Serving Static Content From a Directory</h1>

The goal of this example is to show you how to serve static content

from a filesystem. First, we need to import some objects:

<ul>

<li>

<code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.web.server.Site.html" title="twisted.web.server.Site">Site</a></code>, an <code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.internet.interfaces.IProtocolFactory.html" title="twisted.internet.interfaces.IProtocolFactory">IProtocolFactory</a></code> which

glues a listening server port (<code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.internet.interfaces.IListeningPort.html" title="twisted.internet.interfaces.IListeningPort">IListeningPort</a></code>) to the <code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.web.http.HTTPChannel.html" title="twisted.web.http.HTTPChannel">HTTPChannel</a></code>

implementation:

<pre class="python">1

from twisted.web.server import Site

</pre>

</li>

<li>

<code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.web.static.File.html" title="twisted.web.static.File">File</a></code>, an <code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.web.resource.IResource.html" title="twisted.web.resource.IResource">IResource</a></code> which glues

the HTTP protocol implementation to the filesystem:

<pre class="python">1

from twisted.web.static import File

</pre>

</li>

<li>

The <code class="API"><a href="http://twistedmatrix.com/documents/10.0.0/api/twisted.internet.reactor.html" title="twisted.internet.reactor">reactor</a></code>, which

drives the whole process, actually accepting TCP connections and

moving bytes into and out of them:

<pre class="python">1

from twisted.internet import reactor

</pre>

</li>

</ul>

Next, we create an instance of the File resource pointed at the

directory to serve:

<pre class="python">1

resource = File("/tmp")

</pre>

Then we create an instance of the Site factory with that resource:

<pre class="python">1

factory = Site(resource)

</pre>

Now we glue that factory to a TCP port:

<pre class="python">1

reactor.listenTCP(8888, factory)

</pre>

Finally, we start the reactor so it can make the program work:

<pre class="python">1

reactor.run()

</pre>

And that's it. Here's the complete program:

<pre class="python">1

from twisted.web.static import File

from twisted.internet import reactor

resource = File('/tmp')

factory = Site(resource)

reactor.listenTCP(8888, factory)

reactor.run()

</pre>

Bonus example! For those times when you don't actually want to

write a new program, the above implemented functionality is one of the

things the command line <code>twistd</code> tool can do. In this case,

the command

twistd -n web --path /tmp

</pre>

will accomplish the same thing as the above server. See <a href="../../../core/howto/basics.html" shape="rect">helper programs</a> in the

Twisted Core documentation for more information on using

<code>twistd</code>.

</div>

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

100

Version: 10.0.0

101

</body>

102

</html>

b'\\ No newline at end of file'

Older »